3.6 KiB
3.6 KiB
server-rs 工作区占位说明
日期：2026-04-20
1. 目录用途
server-rs/ 是本项目新 Rust 后端的固定根目录，用于承载以下重写目标：
AxumHTTP / SSE 边界层SpacetimeDB状态机模块阿里云 OSS资产接入与应用层编排
该目录固定放在仓库根目录，与 server-node/、src/、docs/ 同级。
2. 当前阶段说明
当前目录已经完成以下二十二项初始化：
- 为新后端预留正式目录并把路径固定到仓库结构中。
- 创建虚拟 workspace
Cargo.toml，后续 package 会逐项挂入。 - 明确内部采用“
apps/*主工程 +packages/*独立模块包”的多 package 组织方式。 - 创建
apps/api-server/目录占位，固定 Axum 主工程落位。 - 创建
apps/spacetime-module/目录占位，固定 SpacetimeDB 主工程落位。 - 创建
packages/module-auth/目录占位，固定鉴权模块 package 落位。 - 创建
packages/module-runtime/目录占位，固定运行时状态基座模块 package 落位。 - 创建
packages/module-story/目录占位，固定故事主循环模块 package 落位。 - 创建
packages/module-combat/目录占位，固定战斗规则模块 package 落位。 - 创建
packages/module-inventory/目录占位，固定背包与物品变更模块 package 落位。 - 创建
packages/module-npc/目录占位，固定 NPC 状态与互动模块 package 落位。 - 创建
packages/module-progression/目录占位，固定成长与章节推进模块 package 落位。 - 创建
packages/module-quest/目录占位，固定任务运行时模块 package 落位。 - 创建
packages/module-runtime-item/目录占位，固定运行时物品模块 package 落位。 - 创建
packages/module-custom-world/目录占位，固定自定义世界与 agent 模块 package 落位。 - 创建
packages/module-assets/目录占位，固定资产任务与对象绑定模块 package 落位。 - 创建
packages/module-editor/目录占位，固定编辑器读写模块 package 落位。 - 创建
packages/module-ai/目录占位，固定 AI 编排模块 package 落位。 - 创建
packages/shared-contracts/目录占位，固定前后端兼容 contract 共享 package 落位。 - 创建
packages/shared-kernel/目录占位，固定跨模块共享领域内核 package 落位。 - 创建
packages/platform-auth/目录占位，固定鉴权平台适配 package 落位。 - 创建
packages/platform-oss/目录占位，固定 OSS 平台适配 package 落位。
后续任务会继续在本目录内按顺序补齐：
packages/platform-llmpackages/spacetime-clientpackages/tests-supportscripts/*
3. 已冻结边界
本目录后续落地时必须继续遵守 M0 已冻结的边界：
- 迁移期保留
server-node/，不提前删除。 - 前端在
M0 ~ M6期间只访问 Axum，不直连 SpacetimeDB。 - 外部副作用统一收口在 Axum / package 内应用层 / infra。
apps/api-server只组合与暴露协议，不直接吞并业务模块实现。apps/spacetime-module只负责汇总各模块 package 的表、reducer、view。