46 lines
1.8 KiB
Markdown
46 lines
1.8 KiB
Markdown
# module-inventory 独立模块 package 说明
|
||
|
||
日期：`2026-04-21`
|
||
|
||
## 1. package 职责
|
||
|
||
`module-inventory` 是背包与物品变更模块 package，当前负责：
|
||
|
||
1. 冻结 `inventory_slot` 的首版领域字段与枚举类型。
|
||
2. 提供 `apply_inventory_mutation` 纯规则入口，先覆盖：
|
||
- `GrantItem`
|
||
- `ConsumeItem`
|
||
- `EquipItem`
|
||
- `UnequipItem`
|
||
3. 冻结 `RuntimeInventoryStateQueryInput / RuntimeInventoryStateSnapshot / RuntimeInventoryStateRecord`
|
||
4. 为 `spacetime-module` 的背包表、procedure 与 reducer 聚合提供可复用契约。
|
||
|
||
## 2. 当前阶段说明
|
||
|
||
当前提交已经从“目录占位”推进到“真实 crate 基座”，但仍然只落最小背包主链，不提前扩成完整玩法迁移。
|
||
|
||
本轮已落地：
|
||
|
||
1. `InventorySlotSnapshot` / `InventoryMutationInput` / `InventoryMutationOutcome`
|
||
2. 背包堆叠、扣减、装备切换、卸下回包的纯规则
|
||
3. `runtime_session_id + actor_user_id` 作用域下的最小 inventory state query contract
|
||
4. 与 `spacetime-module` 对接所需的 `SpacetimeType` 兼容类型
|
||
|
||
本轮明确未做：
|
||
|
||
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. 背包真相由 `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`
|