docs: add runtime module package placeholder

This commit is contained in:
2026-04-21 00:44:05 +08:00
parent 60f25f3aa5
commit d13c70f7fc
3 changed files with 53 additions and 22 deletions

View File

@@ -51,7 +51,8 @@
交付物:[../server-rs/apps/spacetime-module/README.md](../server-rs/apps/spacetime-module/README.md)
- [x] 创建 `packages/module-auth`
交付物:[../server-rs/packages/module-auth/README.md](../server-rs/packages/module-auth/README.md)
- [ ] 创建 `packages/module-runtime`
- [x] 创建 `packages/module-runtime`
交付物:[../server-rs/packages/module-runtime/README.md](../server-rs/packages/module-runtime/README.md)
- [ ] 创建 `packages/module-story`
- [ ] 创建 `packages/module-combat`
- [ ] 创建 `packages/module-inventory`

View File

@@ -14,7 +14,7 @@
## 2. 当前阶段说明
当前目录已经完成以下项初始化:
当前目录已经完成以下项初始化:
1. 为新后端预留正式目录并把路径固定到仓库结构中。
2. 创建虚拟 workspace `Cargo.toml`,后续 package 会逐项挂入。
@@ -22,29 +22,29 @@
4. 创建 `apps/api-server/` 目录占位,固定 Axum 主工程落位。
5. 创建 `apps/spacetime-module/` 目录占位,固定 SpacetimeDB 主工程落位。
6. 创建 `packages/module-auth/` 目录占位,固定鉴权模块 package 落位。
7. 创建 `packages/module-runtime/` 目录占位,固定运行时状态基座模块 package 落位。
后续任务会继续在本目录内按顺序补齐:
1. `packages/module-runtime`
2. `packages/module-story`
3. `packages/module-combat`
4. `packages/module-inventory`
5. `packages/module-npc`
6. `packages/module-progression`
7. `packages/module-quest`
8. `packages/module-runtime-item`
9. `packages/module-custom-world`
10. `packages/module-assets`
11. `packages/module-editor`
12. `packages/module-ai`
13. `packages/shared-contracts`
14. `packages/shared-kernel`
15. `packages/platform-auth`
16. `packages/platform-oss`
17. `packages/platform-llm`
18. `packages/spacetime-client`
19. `packages/tests-support`
20. `scripts/*`
1. `packages/module-story`
2. `packages/module-combat`
3. `packages/module-inventory`
4. `packages/module-npc`
5. `packages/module-progression`
6. `packages/module-quest`
7. `packages/module-runtime-item`
8. `packages/module-custom-world`
9. `packages/module-assets`
10. `packages/module-editor`
11. `packages/module-ai`
12. `packages/shared-contracts`
13. `packages/shared-kernel`
14. `packages/platform-auth`
15. `packages/platform-oss`
16. `packages/platform-llm`
17. `packages/spacetime-client`
18. `packages/tests-support`
19. `scripts/*`
## 3. 已冻结边界

View File

@@ -0,0 +1,30 @@
# module-runtime 独立模块 package 占位说明
日期:`2026-04-20`
## 1. package 职责
`module-runtime` 是运行时状态基座模块 package后续负责
1. `runtime_snapshot``runtime_setting` 等主状态模型
2. profile dashboard、browse history、save archive 相关读写模型
3. 运行时状态归一化与兼容聚合快照策略
4.`apps/api-server` 的 runtime facade 对接
5.`apps/spacetime-module` 的运行时表与 view 聚合对接
## 2. 当前阶段说明
当前提交仅完成目录占位不提前进入表结构、projection 与接口实现。
后续与本 package 直接相关的任务包括:
1. 设计 `runtime_snapshot``runtime_setting`
2. 设计 `profile_dashboard_state``profile_wallet_ledger`
3. 设计 `profile_played_world``profile_save_archive``user_browse_history`
4. 落地存档、设置、资料页兼容接口
## 3. 边界约束
1. `module-runtime` 负责运行时状态真相与模块级 facade 编排,不把主状态继续留在旧式大 JSON repository 中。
2. 兼容快照可以作为聚合产物保留,但不能再次成为唯一真相。
3. 前端兼容接口由 `apps/api-server` 暴露,状态表与 view 最终由 `apps/spacetime-module` 聚合。