30 lines
1.1 KiB
Markdown
30 lines
1.1 KiB
Markdown
# 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` 聚合。
|