docs: add inventory module package placeholder
This commit is contained in:
@@ -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`
|
||||
|
||||
@@ -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. 已冻结边界
|
||||
|
||||
|
||||
29
server-rs/packages/module-inventory/README.md
Normal file
29
server-rs/packages/module-inventory/README.md
Normal file
@@ -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` 聚合。
|
||||
Reference in New Issue
Block a user