init with react+axum+spacetimedb

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

@@ -0,0 +1,45 @@
+# 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`