Close DDD cleanup and tests-support closure

server-rs/crates/module-quest/src/domain.rs

@@ -1,4 +1,282 @@
-//! 任务领域模型过渡落位。
+//! 任务领域模型。
 //!
-//! 后续迁移任务记录、步骤、目标、奖励和日志规则时，只保留任务聚合内部变化；
-//! 奖励发放和成长记账通过事件交给外层事务编排。
+//! 本文件承载任务状态、步骤、奖励、叙事绑定和进度信号等稳定值对象。
+
+use serde::{Deserialize, Serialize};
+#[cfg(feature = "spacetime-types")]
+use spacetimedb::SpacetimeType;
+
+pub const QUEST_LOG_ID_PREFIX: &str = "questlog_";
+
+#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
+#[derive(Clone, Copy, Debug, PartialEq, Eq, Serialize, Deserialize)]
+pub enum QuestStatus {
+    Active,
+    ReadyToTurnIn,
+    Completed,
+    TurnedIn,
+    Failed,
+    Expired,
+}
+
+#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
+#[derive(Clone, Copy, Debug, PartialEq, Eq, Serialize, Deserialize)]
+pub enum QuestNarrativeType {
+    Bounty,
+    Escort,
+    Investigation,
+    Retrieval,
+    Relationship,
+    Trial,
+}
+
+#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
+#[derive(Clone, Copy, Debug, PartialEq, Eq, Serialize, Deserialize)]
+pub enum QuestObjectiveKind {
+    DefeatHostileNpc,
+    InspectTreasure,
+    SparWithNpc,
+    TalkToNpc,
+    ReachScene,
+    DeliverItem,
+}
+
+#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
+#[derive(Clone, Copy, Debug, PartialEq, Eq, Serialize, Deserialize)]
+pub enum QuestRewardItemRarity {
+    Common,
+    Uncommon,
+    Rare,
+    Epic,
+    Legendary,
+}
+
+#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
+#[derive(Clone, Copy, Debug, PartialEq, Eq, Serialize, Deserialize)]
+pub enum QuestNarrativeOrigin {
+    AiCompiled,
+    FallbackBuilder,
+}
+
+#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
+#[derive(Clone, Copy, Debug, PartialEq, Eq, Serialize, Deserialize)]
+pub enum QuestLogEventKind {
+    Accepted,
+    Progressed,
+    Completed,
+    CompletionAcknowledged,
+    TurnedIn,
+}
+
+#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
+#[derive(Clone, Copy, Debug, PartialEq, Eq, Serialize, Deserialize)]
+pub enum QuestSignalKind {
+    HostileNpcDefeated,
+    TreasureInspected,
+    NpcSparCompleted,
+    NpcTalkCompleted,
+    SceneReached,
+    ItemDelivered,
+}
+
+#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
+#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
+pub struct QuestRewardItem {
+    pub item_id: String,
+    pub category: String,
+    pub name: String,
+    pub description: Option<String>,
+    pub quantity: u32,
+    pub rarity: QuestRewardItemRarity,
+    pub tags: Vec<String>,
+    pub stackable: bool,
+    pub stack_key: String,
+    pub equipment_slot_id: Option<QuestRewardEquipmentSlot>,
+}
+
+#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
+#[derive(Clone, Copy, Debug, PartialEq, Eq, Serialize, Deserialize)]
+pub enum QuestRewardEquipmentSlot {
+    Weapon,
+    Armor,
+    Relic,
+}
+
+#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
+#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
+pub struct QuestRewardIntel {
+    pub rumor_text: String,
+    pub unlocked_scene_id: Option<String>,
+}
+
+#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
+#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
+pub struct QuestRewardSnapshot {
+    pub affinity_bonus: i32,
+    pub currency: i64,
+    pub experience: Option<u32>,
+    pub items: Vec<QuestRewardItem>,
+    pub intel: Option<QuestRewardIntel>,
+    pub story_hint: Option<String>,
+}
+
+#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
+#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
+pub struct QuestNarrativeBindingSnapshot {
+    pub origin: QuestNarrativeOrigin,
+    pub narrative_type: QuestNarrativeType,
+    pub dramatic_need: String,
+    pub issuer_goal: String,
+    pub player_hook: String,
+    pub world_reason: String,
+    pub followup_hooks: Vec<String>,
+}
+
+#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
+#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
+pub struct QuestObjectiveSnapshot {
+    pub kind: QuestObjectiveKind,
+    pub target_hostile_npc_id: Option<String>,
+    pub target_npc_id: Option<String>,
+    pub target_scene_id: Option<String>,
+    pub target_item_id: Option<String>,
+    pub required_count: u32,
+}
+
+#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
+#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
+pub struct QuestStepSnapshot {
+    pub step_id: String,
+    pub kind: QuestObjectiveKind,
+    pub target_hostile_npc_id: Option<String>,
+    pub target_npc_id: Option<String>,
+    pub target_scene_id: Option<String>,
+    pub target_item_id: Option<String>,
+    pub required_count: u32,
+    pub progress: u32,
+    pub title: String,
+    pub reveal_text: String,
+    pub complete_text: String,
+}
+
+#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
+#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
+pub struct QuestRecordSnapshot {
+    pub quest_id: String,
+    pub runtime_session_id: String,
+    pub story_session_id: Option<String>,
+    pub actor_user_id: String,
+    pub issuer_npc_id: String,
+    pub issuer_npc_name: String,
+    pub scene_id: Option<String>,
+    pub chapter_id: Option<String>,
+    pub act_id: Option<String>,
+    pub thread_id: Option<String>,
+    pub contract_id: Option<String>,
+    pub title: String,
+    pub description: String,
+    pub summary: String,
+    pub objective: QuestObjectiveSnapshot,
+    pub progress: u32,
+    pub status: QuestStatus,
+    pub completion_notified: bool,
+    pub reward: QuestRewardSnapshot,
+    pub reward_text: String,
+    pub narrative_binding: QuestNarrativeBindingSnapshot,
+    pub steps: Vec<QuestStepSnapshot>,
+    pub active_step_id: Option<String>,
+    pub visible_stage: u32,
+    pub hidden_flags: Vec<String>,
+    pub discovered_fact_ids: Vec<String>,
+    pub related_carrier_ids: Vec<String>,
+    pub consequence_ids: Vec<String>,
+    pub created_at_micros: i64,
+    pub updated_at_micros: i64,
+    pub completed_at_micros: Option<i64>,
+    pub turned_in_at_micros: Option<i64>,
+}
+
+#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
+#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
+pub struct QuestHostileNpcDefeatedSignal {
+    pub scene_id: Option<String>,
+    pub hostile_npc_id: String,
+}
+
+#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
+#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
+pub struct QuestTreasureInspectedSignal {
+    pub scene_id: Option<String>,
+}
+
+#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
+#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
+pub struct QuestNpcSparCompletedSignal {
+    pub npc_id: String,
+}
+
+#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
+#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
+pub struct QuestNpcTalkCompletedSignal {
+    pub npc_id: String,
+}
+
+#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
+#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
+pub struct QuestSceneReachedSignal {
+    pub scene_id: String,
+}
+
+#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
+#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
+pub struct QuestItemDeliveredSignal {
+    pub npc_id: String,
+    pub item_id: String,
+    pub quantity: u32,
+}
+
+#[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
+#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
+pub enum QuestProgressSignal {
+    HostileNpcDefeated(QuestHostileNpcDefeatedSignal),
+    TreasureInspected(QuestTreasureInspectedSignal),
+    NpcSparCompleted(QuestNpcSparCompletedSignal),
+    NpcTalkCompleted(QuestNpcTalkCompletedSignal),
+    SceneReached(QuestSceneReachedSignal),
+    ItemDelivered(QuestItemDeliveredSignal),
+}
+
+impl QuestStatus {
+    pub fn is_terminal(self) -> bool {
+        matches!(self, Self::TurnedIn | Self::Failed | Self::Expired)
+    }
+
+    pub fn is_reward_ready(self) -> bool {
+        matches!(self, Self::ReadyToTurnIn | Self::Completed)
+    }
+}
+
+impl QuestLogEventKind {
+    pub fn as_str(self) -> &'static str {
+        match self {
+            Self::Accepted => "accepted",
+            Self::Progressed => "progressed",
+            Self::Completed => "completed",
+            Self::CompletionAcknowledged => "completion_ack",
+            Self::TurnedIn => "turned_in",
+        }
+    }
+}
+
+impl From<&QuestProgressSignal> for QuestSignalKind {
+    fn from(value: &QuestProgressSignal) -> Self {
+        match value {
+            QuestProgressSignal::HostileNpcDefeated(_) => Self::HostileNpcDefeated,
+            QuestProgressSignal::TreasureInspected(_) => Self::TreasureInspected,
+            QuestProgressSignal::NpcSparCompleted(_) => Self::NpcSparCompleted,
+            QuestProgressSignal::NpcTalkCompleted(_) => Self::NpcTalkCompleted,
+            QuestProgressSignal::SceneReached(_) => Self::SceneReached,
+            QuestProgressSignal::ItemDelivered(_) => Self::ItemDelivered,
+        }
+    }
+}