feat(collections): 自动同步作品交付集验收状态

2026-07-21 19:23:58 +08:00
parent e4d1d3bcea
commit 721e971dd8
22 changed files with 309 additions and 35 deletions
--- a/docs/integration-guide.md
+++ b/docs/integration-guide.md
@@ -72,6 +72,8 @@ curl -X POST http://localhost:3010/api/projects/1/collections \
  -d '{"name":"2026 年 7 月交付","client_description":"本月交付内容"}'
 ```

+新建作品交付集的 `status` 为 `draft`。上传首件作品后自动变为 `reviewing`；全部非草稿作品通过后自动变为 `completed`。响应中的 `work_count`、`approved_count` 和 `completed_at` 分别表示已提交作品数、已通过作品数和本次完成时间。调用方不应直接维护作品交付集状态；创建作品、新版本、修改验收状态和删除作品都会触发服务端重算。
+
 ## 上传作品

 外部客户端使用 JSON 创建作品，`images` 直接传入 1–30 个公开可读的 HTTP/HTTPS 图片 URL。服务只保存 URL，不会下载图片或再次上传到 COS。数组顺序就是展示顺序，第一张为封面。