统一 AGC 项目与发行版本模型

将用户版本改为可回退、可重复提交的版本标签，使用不可变 versionId 区分具体提交实例。明确 publicationRevision 仅负责并发 CAS，不再限制用户版本号递增。
2026-10-03 15:45:12 +08:00
parent 1621c29cf0
commit 996135379b
3 changed files with 27 additions and 31 deletions
@@ -8,21 +8,21 @@

 ## 修改边界

- `packages/shared/src/contracts/gameCreationApp.ts`：本地 `publication` 绑定，不混入本地编辑迭代 `versions[]`。
- `packages/shared/src/contracts/gameDistribution.ts` 与 Rust shared-contracts：创建版本请求增加可选 `versionNumber`。
- `apps/ai-game-creator-shell`：绑定回读、首次发布/更新 UI、目标版本输入、原 gameId 新版本发布、结果回写。
- `api-server`、`spacetime-client`、`spacetime-module`：把可选目标版本号传入现有创建版本 procedure，事务内比较最大版本号并拒绝冲突。
+- `packages/shared/src/contracts/gameCreationApp.ts`：本地唯一 `projectVersion` 和 `publication` 绑定，不混入内部编辑迭代 `versions[]`。
+- `packages/shared/src/contracts/gameDistribution.ts` 与 Rust shared-contracts：创建版本请求支持正整数 `versionNumber`，允许重复标签提交。
+- `apps/ai-game-creator-shell`：绑定回读、首次发布/更新 UI、项目版本输入、原 gameId 新提交、结果回写。
+- `api-server`、`spacetime-client`、`spacetime-module`：创建版本事务只校验正整数；同 gameId/同 versionNumber 生成新 versionId，publicationRevision 继续 CAS。
 - 现有创建版本 procedure 输入/生成绑定需要同步，但不修改持久表字段。

 ## 实现顺序

-1. 契约先补 `versionNumber?: number` 和本地 `publication`，明确版本号校验与兼容。
-2. 创建版本事务在未传时自动递增；传入时必须大于现有最大版本号，并在同事务内校验。
-3. AGC 发布绑定保存 `gameId`、最新版本、状态和 revision；按账号和 API origin 隔离绑定。
-4. AGC 打开项目回读已有作品；旧项目通过 `localProjectId` 恢复关联。
-5. 发布面板区分首次发布/更新，给出当前版本和可编辑目标版本输入。
-6. Rust 发布 facade 在更新模式跳过创建 game，使用原 gameId 创建新 version；幂等账本把目标版本号纳入发布意图，不能仅以 ZIP 摘要合并不同发布。
-7. 验证重复提交、响应丢失、切换账号、版本冲突、旧作品恢复，以及旧公开版本在新版本审核中继续可玩。
+1. 契约先补唯一 `projectVersion` 和本地 publication，明确 versionId/版本标签/内部 projectRevision 的边界。
+2. 创建版本事务不再要求大于 max；未传时保留旧客户端自动递增，传入时校验正整数，并按同版本最新有效提交处理 pending 替代。
+3. AGC 发布绑定保存 gameId、最新 versionId、状态和 revision；按账号和 API origin 隔离绑定。
+4. AGC 打开项目回读已有作品；旧项目通过 localProjectId 恢复关联。
+5. 发布面板编辑 projectVersion，区分首次发布/更新，允许重复提交和回退，不再存在独立 targetVersion。
+6. Rust 发布 facade 在更新模式跳过 create game，使用原 gameId 创建新 version；幂等账本把目标 projectVersion、资料和提交意图纳入发布意图。
+7. 验证重复提交同版本、回退版本、响应丢失、切换账号、publicationRevision 冲突和旧公开版本继续可玩。

 ## 数据库影响

@@ -9,21 +9,13 @@

 ## 目标

-让 AGC 区分首次发布与已有作品更新：已有作品继续使用原 `gameId`，创建不可覆盖的新版本；发布时用户可以决定目标正整数版本号。
-
-## 范围
-
- 本地项目清单保存平台作品绑定和最近版本状态。
- 打开项目时回读绑定作品；旧清单按 `localProjectId` 做一次性恢复。
- 发布面板显示首次发布/更新模式、当前版本和建议目标版本。
- 用户在发布时填写目标版本号，默认最大版本号加一。
- 服务端可选接收 `versionNumber`；旧客户端不传时继续自动递增。
+让 AGC 区分首次发布与已有作品更新：已有作品继续使用原 `gameId`；用户维护唯一项目发行版本标签，同一标签可以重复提交或回退，具体提交由不可变 `versionId` 标识。
 - 同一 `gameId` 的新版本上传、校验、送审和结果回写。

 ## 不在范围内

- AGC 完整版本历史页、版本回滚、版本删除、版本对比。
- 覆盖已有版本号或原地替换发行包。
+- AGC 完整版本历史页、版本对比和一键回滚 UI；回退版本标签的发布路径属于本里程碑。
+- 原地替换已发布 `versionId`；已发布提交保持不可变。
 - 新增 SpacetimeDB 持久表或修改 `game_distribution_version.version_number` 类型。
 - 改变公开 URL、审核状态机、发行网关或后台审核权限。

@@ -31,8 +23,11 @@

 - [ ] 首次发布完成后项目清单保存 `gameId`、`versionId`、版本号、状态和 `publicationRevision`。
 - [ ] 重新打开同一项目显示“更新游戏”，不再显示“创建平台游戏”。
- [ ] 默认目标版本为最大版本号加一，用户可改为更大的正整数。
- [ ] 目标版本不大于已有最大版本号时服务端拒绝，不能覆盖旧版本。
+- [ ] 项目清单只有一个用户发行版本字段，发布面板编辑它，不存在独立 targetVersion。
+- [ ] 同一 `gameId`、同一 `versionNumber` 可以重复提交，生成新的 `versionId`，不覆盖旧公开实例。
+- [ ] 项目版本可以低于线上最新版本，服务端允许回退标签，但仍校验为正整数。
+- [ ] 同版本旧 pending 提交被取消或被最新提交替代，审核队列不产生重复有效任务。
+- [ ] `publicationRevision` 仍用于并发 CAS，与用户版本号规则独立。
 - [ ] 更新使用同一 `gameId`，只增加一个新 `versionId`，公开地址保持不变。
 - [ ] 旧项目没有发布绑定时能按作者和 `localProjectId` 恢复；恢复失败时明确回到首次发布。
 - [ ] 上传响应丢失、重复提交、版本号冲突和切换账号不会创建重复游戏或错误接管作品。