suzmii
909f3d5fa2
Project CI / Native shell tests (pull_request) Has been cancelled
Project CI / Frontend tests (pull_request) Has been cancelled
Project CI / AI game creator shell Rust lane 1/2 (pull_request) Has been cancelled
Project CI / AI game creator shell Rust crates (pull_request) Has been cancelled
Project CI / Backend tests (pull_request) Has been cancelled
Project CI / Repository checks (pull_request) Has been cancelled
Project CI / AI game creator shell web tests (pull_request) Has been cancelled
Project CI / AI game creator shell Rust lane 2/2 (pull_request) Has been cancelled
- 客户端：新增 listThemes（游标分页，读 nextCursor）与 getTheme（404 由页面渲染成降级态）；getGame 的返回类型增量 themes（匿名也返回；无主题时是空数组而不是缺键） - 共创 Tab：广场页新增「游戏 / 共创」页签，复用既有 game-category-tabs 结构与类名，切到 /games/themes - 主题列表页 GameThemesPage：卡片展示 name / summary / badge / memberCount；只有 nextCursor 非空才渲染「加载更多」并在点击时追加；空态与失败重试照既有写法 - 主题页 GameThemePage：标题 / 简介 / 角标 + 成员根清单；**逐根内嵌渲染作品树**——直接复用族谱页（GameLineagePage 新增 embedded 变体，只隐藏页面外壳：返回按钮 / 页头 / 脚注），树查询、可见性过滤、稳定排序与截断全部走 M3 那一份实现，不新建第二套树查询或树渲染（每根一次 /lineage 的 N+1 是技术方案 §3.10.4 已接受的取舍）；已发布但可见成员为空 → 明确空态而不是错误；主题不存在 / 未发布 → 错误态 - 详情页：共创信息卡渲染所属主题角标（点击进主题页），第 N 代作品同样可见（服务端按根反查）；无主题时不渲染空容器 - 路由登记：新增 /games/themes 与 /games/theme（详情用 ?id=），四处同批登记（STAGE_ROUTE_ENTRIES + SelectionStage 类型 + 壳层 lazy/回调/渲染分支 + 页面标题），并同步三份 nginx SPA allowlist 与 Pingora MAIN_SPA_PATHS：check:nginx-spa-routes（20 SPA routes / 3 模板）与 check:pingora-route-parity 均绿 - 测试：主题列表三例（渲染与卡片跳转 / 有游标时的加载更多与追加 / 空态与失败重试）、主题页三例（逐根两棵树且复用 lineage 查询 + 全屏入口参数 / 空成员空态 / 404 错误态）、详情页主题入口两例（渲染并可跳转 / 无主题不渲染容器）、路由与标题登记断言、壳层三例（页签切换 / 列表进主题页 / 主题页按 ?id= 渲染并复用族谱查询）
server-rs 工作区说明
更新时间：2026-05-15
server-rs/ 是当前唯一后端工作区，承载 Rust api-server、SpacetimeDB module、领域模块、平台副作用适配和共享契约。旧 server-node、Express、PostgreSQL、Go 服务端和 maincloud 口径均为历史残留，不再作为当前实现目标。
当前职责
crates/api-server：Axum HTTP / SSE / BFF 门面、鉴权、中间件、外部服务编排和 DTO 映射。crates/spacetime-module：SpacetimeDB 表、reducer、procedure、事务 adapter、row mapper 和迁移。crates/spacetime-client：后端访问 SpacetimeDB 的 typed facade。crates/module-*：领域模型、命令、应用规则、领域事件和领域错误。crates/platform-*：OSS、LLM、语音、认证等外部平台能力。crates/shared-contracts：前后端共享 DTO 与公开契约。crates/shared-kernel、crates/shared-logging、crates/tests-support：跨模块基础能力、日志和测试支撑。
开发规则
server-rs/Cargo.toml是 workspace 成员和依赖版本事实源；第三方依赖和 workspace 内 crate path 优先放在[workspace.dependencies]。module-*不直接依赖 Axum、SpacetimeDB table/reducer/procedure、reqwest、OSS、LLM、spacetime-client、tokio或文件系统。api-server不承接领域真相；发现领域规则时优先沉到对应module-*。- SpacetimeDB schema 变化必须同步
spacetime-module/src/migration.rs、生成绑定和当前后端架构文档的表目录。 - 人工命令、本地联调和文档示例不要使用
spacetime --root-dir。
常用命令
cargo check -p api-server --manifest-path server-rs/Cargo.toml
cargo test -p api-server --manifest-path server-rs/Cargo.toml
npm run check:server-rs-ddd
npm run check:spacetime-schema
npm run spacetime:generate
npm run dev:api-server
涉及 API smoke 时用 npm run dev:api-server 启动后端并检查 /healthz，不要使用旧 api-server:maincloud。
当前文档
- ../docs/【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.md：DDD 边界、API 分组、schema 变更规则和表目录。
- ../docs/【开发运维】本地开发验证与生产运维-2026-05-15.md：本地启动、检查、SpacetimeDB 操作和生产运维。