fix: 收紧拼图发布资产门槛

docs/technical/【后端架构】PuzzlePublishAssetGate收紧计划-2026-06-04.md

@@ -0,0 +1,38 @@
+# 【后端架构】Puzzle Publish Asset Gate 收紧计划
+
+## 背景
+
+拼图前端恢复链路已由 `platformPuzzleDraftRecoveryModel.ts` 收紧：只有首图、关卡画面、UI spritesheet 与关卡背景资产包完整时，才把恢复草稿抬为完成态。但后端仍有两处待发布门槛偏弱：
+
+- `module-puzzle::validate_publish_requirements(...)` 只校验作品名、描述、标签、关卡名与 cover。
+- `api-server::puzzle::tags::is_puzzle_session_snapshot_publish_ready(...)` 也只校验同一组轻字段，并据此把 session stage 置为 `ready_to_publish`。
+
+这会让只有首图但缺关卡正式画面、UI spritesheet 或关卡背景的半成品显示为可发布或进入待发布 stage。
+
+## 决策
+
+后端拼图待发布门槛统一收紧到完整首关资产包：
+
+- `module-puzzle` 在 `validate_publish_requirements` 中新增资产 blocker，业务规则继续留在领域模块。
+- `api-server` 的 session snapshot ready 判定复用同一资产语言，避免标签生成后把半成品 session stage 改成 `ready_to_publish`。
+- 本切片不改 SpacetimeDB schema、不改 DTO 字段、不改路由、不改计费和发布动作副作用。
+
+## 接口约束
+
+- 仍保留既有作品名、描述、标签数量、关卡名、cover 校验。
+- 每个关卡必须具备：
+  - `cover_image_src`；
+  - `level_scene_image_src` 或 `level_scene_image_object_key`；
+  - `ui_spritesheet_image_src` 或 `ui_spritesheet_image_object_key`；
+  - `level_background_image_src` 或 `level_background_image_object_key`。
+- 缺正式关卡画面、UI spritesheet、关卡背景时，各自输出明确 blocker。
+- `build_result_preview(...).publish_ready` 与 `is_puzzle_session_snapshot_publish_ready(...)` 必须在同一类缺资产草稿上返回 false。
+- `api-server` 从 action payload 构造 fallback session 时，缺资产 levels snapshot 应停留 `image_refining`，不得进入 `ready_to_publish`。
+
+## 验收
+
+- `cargo test -p module-puzzle --manifest-path server-rs/Cargo.toml validate_publish_requirements`
+- `cargo test -p api-server --manifest-path server-rs/Cargo.toml puzzle_image_generation`
+- `npm run check:encoding`
+- `git diff --check`
+- 修改后按仓规尝试 `npm run api-server` 拉起后端并确认 `/healthz`。