From 03aa82842700648192dc059bce4bba9e47ba70f1 Mon Sep 17 00:00:00 2001 From: kdletters Date: Tue, 21 Apr 2026 00:29:44 +0800 Subject: [PATCH] docs: add server-rs workspace root --- .../01_M0_M2_FOUNDATION_AND_AUTH.md | 3 +- server-rs/README.md | 47 +++++++++++++++++++ 2 files changed, 49 insertions(+), 1 deletion(-) create mode 100644 server-rs/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 1dad617d..f0450f8c 100644 --- a/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md +++ b/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md @@ -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` diff --git a/server-rs/README.md b/server-rs/README.md new file mode 100644 index 00000000..b758ad9f --- /dev/null +++ b/server-rs/README.md @@ -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)