Genarrative/server-rs/crates/module-runtime-item

module-runtime-item 运行时宝藏模块说明

日期：2026-04-21

1. package 职责

module-runtime-item 是运行时物品子域 crate，当前已经承接宝藏奖励快照与背包桥接相关的纯领域能力：

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 已经提供：

1. treasure_record 首版领域 contract
2. 运行时奖励物品到 module-inventory::InventoryItemSnapshot 的显式映射 helper
3. 中文错误语义与最小测试
4. 供 crates/spacetime-module 在 resolve_treasure_interaction 中把宝藏奖励同步写入 inventory_slot 的桥接规则

补充说明：

1. 当前 crate 仍保持“纯领域规则”定位，不直接依赖 SpacetimeDB reducer context 或 Axum。
2. spacetime-types feature 只用于在 spacetime-module 中复用这些类型做表字段和 reducer 输入。

3. 边界约束

1. 当前 crate 只负责任务奖励/宝藏奖励与 inventory 的字段桥接，不承接 story 编排或前端 DTO。
2. 宝藏、任务、交易等不同奖励入口若要写入 inventory_slot，优先复用这里与 module-inventory 的桥接口径，而不是各自重新拼装物品字段。
3. 当前真实工程口径以 docs/technical/M4_RUNTIME_ITEM_TREASURE_SPACETIMEDB_BASELINE_2026-04-21.md 为准。