2.2 KiB
2.2 KiB
当前后端实现基线（2026-04-25）
1. 当前唯一落地口径
后续正式后端实现统一以 server-rs 为准：
- HTTP 门面：Rust
api-server/ Axum。 - 实时状态与业务真相：
crates/spacetime-module/ SpacetimeDB。 - 共享领域与契约：
server-rs多 crate 分层维护。 - 前端职责：只做表现、输入采集、临时 UI 状态与服务端结果渲染。
涉及 SpacetimeDB 的表、reducer、绑定生成、发布、本地联调，必须按仓库内 SpacetimeDB skills 执行。
2. 已替代的旧方向
以下旧方向不再作为新功能设计和编码依据：
server-node/ Express / PostgreSQL 正式后端路线。- Go 服务端试验路线。
- 浏览器侧承担正式运行时逻辑、正式生成编排或正式数据真相的路线。
旧实现只允许作为迁移参考：可以阅读其 contract、提示词、测试用例和边界经验，但不得为了兼容旧服务端继续扩展新代码。
3. 新文档落点
后续补充后端方案时优先落到这些文档族：
- Rust / SpacetimeDB 架构与切流：
SPACETIMEDB_AXUM_OSS_BACKEND_REWRITE_DESIGN_2026-04-20.md、BACKEND_REWRITE_CROSS_CUTTING_GOVERNANCE_2026-04-22.md、M7_TEST_DEPLOY_CUTOVER_EXECUTION_PLAN_2026-04-22.md。 - SpacetimeDB 模块拆分：
SPACETIME_MODULE_LIB_RS_SPLIT_EXECUTION_2026-04-23.md。 - Rust API 路由索引：
RUST_API_SERVER_ROUTE_INDEX_2026-04-22.md。 - 本地与远端部署：
RUST_LOCAL_AND_REMOTE_DEPLOYMENT_SCRIPTS_2026-04-22.md、JENKINS_RUST_BUILD_DEPLOY_PIPELINES_2026-04-23.md。
如果旧文档与本基线冲突，以本基线和更新日期更近的 Rust / SpacetimeDB 文档为准。
4. DDD 重构总纲补充
2026-04-28 起，server-rs 后续后端改动还必须同时遵循 SERVER_RS_DDD_FULL_REFACTOR_2026-04-28.md：
module-*只承载领域模型、命令、应用编排结果、领域事件和领域错误。spacetime-module只承载 SpacetimeDB 表、reducer、procedure、事务 adapter 与 mapper。api-server只承载 HTTP / SSE / BFF adapter 和外部平台服务编排。- 任何表结构变化仍必须同步
migration.rs与 SPACETIMEDB_TABLE_CATALOG.md。