Genarrative/server-rs/README.md

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 主工程落位。

后续任务会继续在本目录内按顺序补齐：

1. packages/module-auth
2. packages/module-runtime
3. packages/module-story
4. packages/module-combat
5. packages/module-inventory
6. packages/module-npc
7. packages/module-progression
8. packages/module-quest
9. packages/module-runtime-item
10. packages/module-custom-world
11. packages/module-assets
12. packages/module-editor
13. packages/module-ai
14. packages/shared-contracts
15. packages/shared-kernel
16. packages/platform-auth
17. packages/platform-oss
18. packages/platform-llm
19. packages/spacetime-client
20. packages/tests-support
21. 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
2. ../backend-rewrite-tasklist/M0_REPOSITORY_BOUNDARY_DECISIONS_2026-04-20.md
3. ../backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md