Genarrative/server-rs/crates/module-combat/README.md

module-combat 独立模块 package 占位说明

日期：2026-04-20

1. package 职责

module-combat 是战斗规则模块 package，后续负责：

1. battle_state 等战斗状态模型
2. 战斗指令、伤害结算、战斗阶段推进规则
3. 与 story action 主循环的战斗联动
4. 与 apps/spacetime-module 的战斗表、reducer、view 聚合对接

2. 当前阶段说明

当前提交仅完成目录占位，不提前进入具体战斗规则与数值实现。

后续与本 package 直接相关的任务包括：

1. 设计 battle_state
2. 设计 resolve_combat_action
3. 对齐 battle 结果与兼容响应结构
4. 接入 story 主循环的战斗型 action 结算

3. 边界约束

1. module-combat 保持纯规则、纯状态计算，不直接承接 HTTP、LLM、OSS 或其他外部副作用。
2. 战斗联动通过明确 reducer 与模块边界协作，不回到散落在多个 service 的过程式写法。
3. 前端兼容输出由 apps/api-server 暴露，战斗真相由 apps/spacetime-module 聚合。