docs: add server-rs workspace root

This commit is contained in:
2026-04-21 00:29:44 +08:00
parent 194e26bf84
commit 03aa828427
2 changed files with 49 additions and 1 deletions

View File

@@ -41,7 +41,8 @@
### 工作区搭建
- [ ] 在根目录新增 `server-rs/`
- [x] 在根目录新增 `server-rs/`
交付物:[../server-rs/README.md](../server-rs/README.md)
- [ ] 创建 workspace `Cargo.toml`
- [ ] 创建 `crates/api-server`
- [ ] 创建 `crates/spacetime-module`

47
server-rs/README.md Normal file
View File

@@ -0,0 +1,47 @@
# server-rs 工作区占位说明
日期:`2026-04-20`
## 1. 目录用途
`server-rs/` 是本项目新 Rust 后端的固定根目录,用于承载以下重写目标:
1. `Axum` HTTP / SSE 边界层
2. `SpacetimeDB` 状态机模块
3. `阿里云 OSS` 资产接入与应用层编排
该目录固定放在仓库根目录,与 `server-node/``src/``docs/` 同级。
## 2. 当前阶段说明
当前提交只完成 `M1` 的第一条任务:为新后端预留正式目录并把路径固定到仓库结构中。
后续任务会继续在本目录内按顺序补齐:
1. workspace `Cargo.toml`
2. `crates/api-server`
3. `crates/spacetime-module`
4. `crates/application`
5. `crates/domain`
6. `crates/contracts`
7. `crates/auth-service`
8. `crates/oss-service`
9. `crates/llm-service`
10. `crates/spacetime-client`
11. `crates/tests`
12. `scripts/*`
## 3. 已冻结边界
本目录后续落地时必须继续遵守 `M0` 已冻结的边界:
1. 迁移期保留 `server-node/`,不提前删除。
2. 前端在 `M0 ~ M6` 期间只访问 Axum不直连 SpacetimeDB。
3. 外部副作用统一收口在 Axum / application / infra。
4. `spacetime-module` 只负责状态、规则、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)