docs: add combat module package placeholder

This commit is contained in:
2026-04-21 00:46:43 +08:00
parent 9fba8a3191
commit 3fd86bd1d2
3 changed files with 50 additions and 20 deletions

View File

@@ -0,0 +1,29 @@
# 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` 聚合。