From 4ad172637a6f86e4f471b65bd83cf8298ff58f45 Mon Sep 17 00:00:00 2001
From: kdletters <kdletters@qq.com>
Date: Tue, 21 Apr 2026 00:48:32 +0800
Subject: [PATCH] docs: add progression module package placeholder

---
 .../01_M0_M2_FOUNDATION_AND_AUTH.md           |  3 +-
 server-rs/README.md                           | 32 +++++++++----------
 .../packages/module-progression/README.md     | 29 +++++++++++++++++
 3 files changed, 47 insertions(+), 17 deletions(-)
 create mode 100644 server-rs/packages/module-progression/README.md

diff --git a/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md b/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md
index eb6dc878..5a4dfbcf 100644
--- a/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md
+++ b/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md
@@ -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`
diff --git a/server-rs/README.md b/server-rs/README.md
index 695e80ca..924b7c98 100644
--- a/server-rs/README.md
+++ b/server-rs/README.md
@@ -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. 已冻结边界
 
diff --git a/server-rs/packages/module-progression/README.md b/server-rs/packages/module-progression/README.md
new file mode 100644
index 00000000..56ec3785
--- /dev/null
+++ b/server-rs/packages/module-progression/README.md
@@ -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` 聚合。