lhk229
e5fb51d1a7
合法 assetId 且不带 sourceResourceId 时，取得端点准入许可后到 OSS 下载之间会
顺序执行 8 次 SpacetimeDB 调用，全是裸 await，第一次真正应用 30 秒预算的是下载。
其中 list_editor_projects + get_editor_asset_library 这对全账号扫描重复了三轮：
resolve_editor_reference_object_key_for_owner 内部两个子函数各扫一轮，
resolve_editor_pixel_art_source_for_owner 再扫第三轮，拉的是同一份数据。
预算从 handler 入口「起算」不等于「覆盖」。deadline 是绝对时刻，早起算只让后续
余额更少；中间不检查就不会在该阶段返回 504，请求会一路走到下载才失败并返回下载
相关文案，误导排障，同时准入许可全程被这些无界调用占用，把并发闸自身变成瓶颈。
去重参照抠图入口 resolve_editor_background_removal_source 的既有范式：扫一次，
注册 ID 解析、归属校验和跨记录 assetKind 收集全部交给 _from_records 纯函数在内存
里完成。归属校验命中已登记记录即短路，只有两份记录都查不到才回落点查。老包装
resolve_editor_reference_object_key_for_owner 保持不动，它服务的是没有任何上下文
的调用方。全账号 RPC 由 6 次降为 2 次，整段由 8 次降为 3 次。
预算侧把 get_editor_project 到来源解析结束整体包进 timeout_at，超时返回 504 且
文案指向归属校验。不重复写 Instant::now() 预检——紧邻的 permit 获取已做过，且本块
首个 await 是网络 IO 不会立即就绪，不构成 timeout_at 先 poll 再判超时的陷阱。
参照 937378ab9 用 assert_function_occurrence_count 把两处全账号扫描各钉为 1 次，
并禁止该函数重新调用取数包装。后者断言调用形式而非裸函数名，否则会命中生产代码里
说明「老包装保持不动」的注释——该陷阱在编写时即由测试抓出。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
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 操作和生产运维。