后端重写提交

server-rs/crates/module-runtime-item/README.md

@@ -1,30 +1,33 @@
-# module-runtime-item 独立模块 package 占位说明
+# module-runtime-item 运行时宝藏模块说明
 
-日期：`2026-04-20`
+日期：`2026-04-21`
 
 ## 1. package 职责
 
-`module-runtime-item` 是运行时物品模块 package，后续负责：
+`module-runtime-item` 是运行时物品子域 crate，当前已经承接宝藏奖励快照与背包桥接相关的纯领域能力：
 
-1. `treasure_record` 等运行时物品与宝藏状态模型
-2. 奖励解析、宝藏逻辑、运行时物品结算规则
-3. 与 story、inventory、quest 的运行时物品联动
-4. 与 `apps/api-server` 的运行时物品兼容接口对接
-5. 与 `apps/spacetime-module` 的运行时物品表、reducer、view 聚合对接
+1. `TreasureResolveInput / TreasureRecordSnapshot / TreasureInteractionAction`
+2. 宝藏奖励物品 `RuntimeItemRewardItemSnapshot` 的字段校验与归一化
+3. `build_treasure_record_snapshot`
+4. `build_inventory_item_snapshot_from_reward_item`
+5. 供 `crates/spacetime-module` 聚合表与 reducer 复用的纯 Rust 规则函数
 
 ## 2. 当前阶段说明
 
-当前提交仅完成目录占位，不提前进入奖励解析、意图生成与兼容接口实现。
+当前 crate 已经提供：
 
-后续与本 package 直接相关的任务包括：
+1. `treasure_record` 首版领域 contract
+2. 运行时奖励物品到 `module-inventory::InventoryItemSnapshot` 的显式映射 helper
+3. 中文错误语义与最小测试
+4. 供 `crates/spacetime-module` 在 `resolve_treasure_interaction` 中把宝藏奖励同步写入 `inventory_slot` 的桥接规则
 
-1. 设计 `treasure_record`
-2. 设计运行时物品结算与宝藏交互 reducer
-3. 对齐奖励、宝藏、patch 与兼容输出结构
-4. 接入 story action 主循环的运行时物品联动
+补充说明：
+
+1. 当前 crate 仍保持“纯领域规则”定位，不直接依赖 SpacetimeDB reducer context 或 Axum。
+2. `spacetime-types` feature 只用于在 `spacetime-module` 中复用这些类型做表字段和 reducer 输入。
 
 ## 3. 边界约束
 
-1. `module-runtime-item` 负责运行时物品状态真相与奖励规则，生成型物品意图与外部 AI 编排不直接塞进模块内部。
-2. 奖励与宝藏状态最终回写到 `apps/spacetime-module` 聚合的状态模型中，前端兼容接口由 `apps/api-server` 暴露。
-3. 运行时物品逻辑不能再次散落到 story、inventory 或 route handler 中分别维护。
+1. 当前 crate 只负责任务奖励/宝藏奖励与 inventory 的字段桥接，不承接 story 编排或前端 DTO。
+2. 宝藏、任务、交易等不同奖励入口若要写入 `inventory_slot`，优先复用这里与 `module-inventory` 的桥接口径，而不是各自重新拼装物品字段。
+3. 当前真实工程口径以 `docs/technical/M4_RUNTIME_ITEM_TREASURE_SPACETIMEDB_BASELINE_2026-04-21.md` 为准。