64 lines
2.5 KiB
Markdown
64 lines
2.5 KiB
Markdown
# server-rs 工作区占位说明
|
||
|
||
日期：`2026-04-20`
|
||
|
||
## 1. 目录用途
|
||
|
||
`server-rs/` 是本项目新 Rust 后端的固定根目录，用于承载以下重写目标：
|
||
|
||
1. `Axum` HTTP / SSE 边界层
|
||
2. `SpacetimeDB` 状态机模块
|
||
3. `阿里云 OSS` 资产接入与应用层编排
|
||
|
||
该目录固定放在仓库根目录，与 `server-node/`、`src/`、`docs/` 同级。
|
||
|
||
## 2. 当前阶段说明
|
||
|
||
当前目录已经完成以下六项初始化：
|
||
|
||
1. 为新后端预留正式目录并把路径固定到仓库结构中。
|
||
2. 创建虚拟 workspace `Cargo.toml`，后续 package 会逐项挂入。
|
||
3. 明确内部采用“`apps/*` 主工程 + `packages/*` 独立模块包”的多 package 组织方式。
|
||
4. 创建 `apps/api-server/` 目录占位，固定 Axum 主工程落位。
|
||
5. 创建 `apps/spacetime-module/` 目录占位，固定 SpacetimeDB 主工程落位。
|
||
6. 创建 `packages/module-auth/` 目录占位，固定鉴权模块 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/*`
|
||
|
||
## 3. 已冻结边界
|
||
|
||
本目录后续落地时必须继续遵守 `M0` 已冻结的边界：
|
||
|
||
1. 迁移期保留 `server-node/`，不提前删除。
|
||
2. 前端在 `M0 ~ M6` 期间只访问 Axum，不直连 SpacetimeDB。
|
||
3. 外部副作用统一收口在 Axum / package 内应用层 / infra。
|
||
4. `apps/api-server` 只组合与暴露协议，不直接吞并业务模块实现。
|
||
5. `apps/spacetime-module` 只负责汇总各模块 package 的表、reducer、view。
|
||
|
||
## 4. 关联文档
|
||
|
||
1. [../docs/technical/SPACETIMEDB_AXUM_OSS_BACKEND_REWRITE_DESIGN_2026-04-20.md](../docs/technical/SPACETIMEDB_AXUM_OSS_BACKEND_REWRITE_DESIGN_2026-04-20.md)
|
||
2. [../backend-rewrite-tasklist/M0_REPOSITORY_BOUNDARY_DECISIONS_2026-04-20.md](../backend-rewrite-tasklist/M0_REPOSITORY_BOUNDARY_DECISIONS_2026-04-20.md)
|
||
3. [../backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md](../backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md)
|