后端重写提交

server-rs/crates/module-inventory/Cargo.toml

@@ -0,0 +1,14 @@
+[package]
+name = "module-inventory"
+edition.workspace = true
+version.workspace = true
+license.workspace = true
+
+[features]
+default = []
+spacetime-types = ["dep:spacetimedb"]
+
+[dependencies]
+serde = { version = "1", features = ["derive"] }
+shared-kernel = { path = "../shared-kernel" }
+spacetimedb = { workspace = true, optional = true }

server-rs/crates/module-inventory/README.md

@@ -1,29 +1,45 @@
-# module-inventory 独立模块 package 占位说明
+# module-inventory 独立模块 package 说明
 
-日期：`2026-04-20`
+日期：`2026-04-21`
 
 ## 1. package 职责
 
-`module-inventory` 是背包与物品变更模块 package，后续负责：
+`module-inventory` 是背包与物品变更模块 package，当前负责：
 
-1. `inventory_slot` 等背包状态模型
-2. 物品获得、消耗、赠礼、背包变更规则
-3. 与 story action、runtime item、NPC 交互的背包联动
-4. 与 `apps/spacetime-module` 的背包表、reducer、view 聚合对接
+1. 冻结 `inventory_slot` 的首版领域字段与枚举类型。
+2. 提供 `apply_inventory_mutation` 纯规则入口，先覆盖：
+   - `GrantItem`
+   - `ConsumeItem`
+   - `EquipItem`
+   - `UnequipItem`
+3. 冻结 `RuntimeInventoryStateQueryInput / RuntimeInventoryStateSnapshot / RuntimeInventoryStateRecord`
+4. 为 `spacetime-module` 的背包表、procedure 与 reducer 聚合提供可复用契约。
 
 ## 2. 当前阶段说明
 
-当前提交仅完成目录占位，不提前进入具体背包规则与读模型实现。
+当前提交已经从“目录占位”推进到“真实 crate 基座”，但仍然只落最小背包主链，不提前扩成完整玩法迁移。
 
-后续与本 package 直接相关的任务包括：
+本轮已落地：
 
-1. 设计 `inventory_slot`
-2. 设计 `apply_inventory_mutation`
-3. 对齐背包 patch、奖励结果与兼容响应结构
-4. 接入 story action 主循环的背包联动
+1. `InventorySlotSnapshot` / `InventoryMutationInput` / `InventoryMutationOutcome`
+2. 背包堆叠、扣减、装备切换、卸下回包的纯规则
+3. `runtime_session_id + actor_user_id` 作用域下的最小 inventory state query contract
+4. 与 `spacetime-module` 对接所需的 `SpacetimeType` 兼容类型
 
-## 3. 边界约束
+本轮明确未做：
 
-1. `module-inventory` 负责物品状态真相与背包规则，不把外部 AI、OSS 或 HTTP 协议塞进模块内部。
+1. `UseItem / Craft / Dismantle / Reforge`
+2. `npc_trade / npc_gift / quest_turn_in` 的专属 reducer
+3. 前端背包 view 或 Axum façade
+4. 旧 `GameState.playerInventory / playerEquipment` 全量兼容
+
+## 3. 当前冻结边界
+
+1. `module-inventory` 只负责物品状态真相与背包规则，不把外部 AI、OSS 或 HTTP 协议塞进模块内部。
 2. 与 `module-story`、`module-runtime-item`、`module-npc` 的协作通过明确 reducer 或投影边界完成。
-3. 前端兼容输出由 `apps/api-server` 暴露，背包状态真相由 `apps/spacetime-module` 聚合。
+3. 背包真相由 `spacetime-module` 聚合，对外兼容输出后续由 `api-server` 或 view 补齐。
+
+## 4. 关联文档
+
+1. `docs/technical/M4_RPG_RUNTIME_INVENTORY_SPACETIMEDB_BASELINE_2026-04-21.md`
+2. `backend-rewrite-tasklist/03_M4_STORY_AND_GAMEPLAY.md`