diff --git a/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md b/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md index abeab2ca..30f010c8 100644 --- a/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md +++ b/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md @@ -57,7 +57,8 @@ 交付物:[../server-rs/packages/module-story/README.md](../server-rs/packages/module-story/README.md) - [x] 创建 `packages/module-combat` 交付物:[../server-rs/packages/module-combat/README.md](../server-rs/packages/module-combat/README.md) -- [ ] 创建 `packages/module-inventory` +- [x] 创建 `packages/module-inventory` + 交付物:[../server-rs/packages/module-inventory/README.md](../server-rs/packages/module-inventory/README.md) - [ ] 创建 `packages/module-npc` - [ ] 创建 `packages/module-progression` - [ ] 创建 `packages/module-quest` diff --git a/server-rs/README.md b/server-rs/README.md index 2d2b14a2..997e3820 100644 --- a/server-rs/README.md +++ b/server-rs/README.md @@ -14,7 +14,7 @@ ## 2. 当前阶段说明 -当前目录已经完成以下九项初始化: +当前目录已经完成以下十项初始化: 1. 为新后端预留正式目录并把路径固定到仓库结构中。 2. 创建虚拟 workspace `Cargo.toml`,后续 package 会逐项挂入。 @@ -25,26 +25,26 @@ 7. 创建 `packages/module-runtime/` 目录占位,固定运行时状态基座模块 package 落位。 8. 创建 `packages/module-story/` 目录占位,固定故事主循环模块 package 落位。 9. 创建 `packages/module-combat/` 目录占位,固定战斗规则模块 package 落位。 +10. 创建 `packages/module-inventory/` 目录占位,固定背包与物品变更模块 package 落位。 后续任务会继续在本目录内按顺序补齐: -1. `packages/module-inventory` -2. `packages/module-npc` -3. `packages/module-progression` -4. `packages/module-quest` -5. `packages/module-runtime-item` -6. `packages/module-custom-world` -7. `packages/module-assets` -8. `packages/module-editor` -9. `packages/module-ai` -10. `packages/shared-contracts` -11. `packages/shared-kernel` -12. `packages/platform-auth` -13. `packages/platform-oss` -14. `packages/platform-llm` -15. `packages/spacetime-client` -16. `packages/tests-support` -17. `scripts/*` +1. `packages/module-npc` +2. `packages/module-progression` +3. `packages/module-quest` +4. `packages/module-runtime-item` +5. `packages/module-custom-world` +6. `packages/module-assets` +7. `packages/module-editor` +8. `packages/module-ai` +9. `packages/shared-contracts` +10. `packages/shared-kernel` +11. `packages/platform-auth` +12. `packages/platform-oss` +13. `packages/platform-llm` +14. `packages/spacetime-client` +15. `packages/tests-support` +16. `scripts/*` ## 3. 已冻结边界 diff --git a/server-rs/packages/module-inventory/README.md b/server-rs/packages/module-inventory/README.md new file mode 100644 index 00000000..32c22f0a --- /dev/null +++ b/server-rs/packages/module-inventory/README.md @@ -0,0 +1,29 @@ +# module-inventory 独立模块 package 占位说明 + +日期:`2026-04-20` + +## 1. package 职责 + +`module-inventory` 是背包与物品变更模块 package,后续负责: + +1. `inventory_slot` 等背包状态模型 +2. 物品获得、消耗、赠礼、背包变更规则 +3. 与 story action、runtime item、NPC 交互的背包联动 +4. 与 `apps/spacetime-module` 的背包表、reducer、view 聚合对接 + +## 2. 当前阶段说明 + +当前提交仅完成目录占位,不提前进入具体背包规则与读模型实现。 + +后续与本 package 直接相关的任务包括: + +1. 设计 `inventory_slot` +2. 设计 `apply_inventory_mutation` +3. 对齐背包 patch、奖励结果与兼容响应结构 +4. 接入 story action 主循环的背包联动 + +## 3. 边界约束 + +1. `module-inventory` 负责物品状态真相与背包规则,不把外部 AI、OSS 或 HTTP 协议塞进模块内部。 +2. 与 `module-story`、`module-runtime-item`、`module-npc` 的协作通过明确 reducer 或投影边界完成。 +3. 前端兼容输出由 `apps/api-server` 暴露,背包状态真相由 `apps/spacetime-module` 聚合。