docs: add progression module package placeholder

This commit is contained in:
2026-04-21 00:48:32 +08:00
parent 6a0415fbb5
commit 4ad172637a
3 changed files with 47 additions and 17 deletions

View File

@@ -61,7 +61,8 @@
交付物:[../server-rs/packages/module-inventory/README.md](../server-rs/packages/module-inventory/README.md)
- [x] 创建 `packages/module-npc`
交付物:[../server-rs/packages/module-npc/README.md](../server-rs/packages/module-npc/README.md)
- [ ] 创建 `packages/module-progression`
- [x] 创建 `packages/module-progression`
交付物:[../server-rs/packages/module-progression/README.md](../server-rs/packages/module-progression/README.md)
- [ ] 创建 `packages/module-quest`
- [ ] 创建 `packages/module-runtime-item`
- [ ] 创建 `packages/module-custom-world`

View File

@@ -14,7 +14,7 @@
## 2. 当前阶段说明
当前目录已经完成以下十项初始化:
当前目录已经完成以下十项初始化:
1. 为新后端预留正式目录并把路径固定到仓库结构中。
2. 创建虚拟 workspace `Cargo.toml`,后续 package 会逐项挂入。
@@ -27,24 +27,24 @@
9. 创建 `packages/module-combat/` 目录占位,固定战斗规则模块 package 落位。
10. 创建 `packages/module-inventory/` 目录占位,固定背包与物品变更模块 package 落位。
11. 创建 `packages/module-npc/` 目录占位,固定 NPC 状态与互动模块 package 落位。
12. 创建 `packages/module-progression/` 目录占位,固定成长与章节推进模块 package 落位。
后续任务会继续在本目录内按顺序补齐:
1. `packages/module-progression`
2. `packages/module-quest`
3. `packages/module-runtime-item`
4. `packages/module-custom-world`
5. `packages/module-assets`
6. `packages/module-editor`
7. `packages/module-ai`
8. `packages/shared-contracts`
9. `packages/shared-kernel`
10. `packages/platform-auth`
11. `packages/platform-oss`
12. `packages/platform-llm`
13. `packages/spacetime-client`
14. `packages/tests-support`
15. `scripts/*`
1. `packages/module-quest`
2. `packages/module-runtime-item`
3. `packages/module-custom-world`
4. `packages/module-assets`
5. `packages/module-editor`
6. `packages/module-ai`
7. `packages/shared-contracts`
8. `packages/shared-kernel`
9. `packages/platform-auth`
10. `packages/platform-oss`
11. `packages/platform-llm`
12. `packages/spacetime-client`
13. `packages/tests-support`
14. `scripts/*`
## 3. 已冻结边界

View File

@@ -0,0 +1,29 @@
# module-progression 独立模块 package 占位说明
日期:`2026-04-20`
## 1. package 职责
`module-progression` 是成长与章节推进模块 package后续负责
1. `player_progression``chapter_progression` 等成长状态模型
2. 等级、章节推进、敌对强度与进程规则
3. 与 runtime、story、quest 的成长联动
4.`apps/spacetime-module` 的成长表、reducer、view 聚合对接
## 2. 当前阶段说明
当前提交仅完成目录占位,不提前进入成长规则、投影与兼容接口实现。
后续与本 package 直接相关的任务包括:
1. 设计 `player_progression``chapter_progression`
2. 设计 `update_progression_state`
3. 对齐章节推进、成长变化与兼容输出结构
4. 接入 runtime 与 story 的成长联动
## 3. 边界约束
1. `module-progression` 保持纯领域规则与状态建模,不直接承接 LLM、OSS 或 HTTP 协议。
2. 成长状态作为 runtime 与 story 的公共领域组件,不能再次散落回单个 handler 或临时 service 中。
3. 前端兼容输出由 `apps/api-server` 暴露,成长状态真相由 `apps/spacetime-module` 聚合。