feat: 收口小程序构建上传阶段
This commit is contained in:
1 parent
6420b85019
commit
ec16fff70e
23 files changed
+1185
-104
No files matched your search
@@ -0,0 +1,38 @@
|
||||
# 0030 小程序构建与上传 attempt
|
||||
|
||||
## 状态
|
||||
|
||||
已采纳
|
||||
|
||||
## 背景
|
||||
|
||||
小程序发布任务原本以一个聚合 `status` 表达构建、上传、微信审核和发布,同时用 `buildStatus` 表示有限构建进度。构建和上传请求在 API 进程内同步执行;进程退出可能留下永久 `building`,重试可能读取共享产物目录中的旧包,不同品牌的并行构建也可能覆盖相同模板目录。
|
||||
|
||||
## 决策
|
||||
|
||||
- 在 `MiniAppReleaseTask` 上新增独立 `uploadStatus` 和 `reviewStatus`,保留现有 `status` 作为兼容聚合状态,不在本次迁移中破坏旧 API 消费方。
|
||||
- 新增 `MiniAppReleaseAttempt`,每个 build/upload 操作分别有单调序号、随机 lease token、租约过期时间、heartbeat、开始/结束时间、日志、产物路径、微信 external id 和明确终态。
|
||||
- 同一任务和阶段最多有一个有效 lease;有效 lease 拒绝并发,过期 lease 被标记 `timed_out` 后才允许下一次 attempt。只有持有匹配 lease token 的运行可更新或结束 attempt。
|
||||
- 构建产物按 `brandSlug/templateKey@templateVersion/attemptId` 隔离。一次 attempt 只能上传自己的 `app.json` 产物;不能回退到模板共享目录或其他 attempt 的产物。
|
||||
- 构建超时必须终止子进程并落终态;上传沿用隔离子进程和超时机制。进程意外退出时,lease 到期提供恢复边界。
|
||||
- 历史 `status` 可推导的阶段状态由 additive migration 回填;不推断微信审核以外的业务事实。
|
||||
|
||||
## 考虑过的方案
|
||||
|
||||
- 只在现有行上加 `buildStatus/uploadStatus`:无法区分重试、并发执行和进程重启后的旧执行者,也无法审计每次产物。
|
||||
- 将旧 `status` 直接替换为多维状态:会破坏现有 API Client、Admin 和历史记录兼容,且仍不能表达一次次尝试。
|
||||
- 仅靠目录名隔离产物:能避免覆盖,但不能防止数据库并发抢占、过期进程回写或查询终态不一致。
|
||||
|
||||
## 后果
|
||||
|
||||
- API 列表/latest 查询需要包含 attempt 记录;Admin 同时展示聚合状态和各阶段状态。
|
||||
- attempt 表随任务删除级联,历史任务保留其 attempt 作为审计证据。
|
||||
- 目前 Admin 触发请求仍同步等待 build/upload 结束;lease 与持久化记录为后续 worker/队列化提供基础,但本 ADR 不宣称已实现异步 worker 或重启后自动恢复执行。
|
||||
- 真实微信上传成功必须以返回的 `weappUploadId` 作为外部证据;本地 build 成功不等于上传或审核成功。
|
||||
|
||||
## 迁移计划
|
||||
|
||||
1. additive migration 新增阶段 enum、attempt 表及历史状态回填,旧读路径继续工作。
|
||||
2. 所有新 build/upload 路径写 attempt;Admin 和 shared client 同步读取新字段。
|
||||
3. 完成 API/worker 重启、并行品牌、超时与旧产物故障注入,并记录实际微信上传结果。
|
||||
4. 只有在调用方迁移完成并有 API contract test 后,才另行评估移除聚合 `status` 和旧 build 兼容字段;删除必须使用单独 migration。
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
> 任务 ID:TMP-PLATFORM-001
|
||||
>
|
||||
> 状态:实施中,Phase 0/1/2/3 已完成;Phase 3 通过本地 Admin/H5 视觉验收,微信真机与线上发布验收留在后续阶段
|
||||
> 状态:Phase 0/1/2/3/4/5 已收口;Phase 5 的本地实现与验证完成,真实微信上传未成功,后续出现发布问题时再按需核查
|
||||
>
|
||||
> 唯一任务入口:本文档
|
||||
>
|
||||
@@ -474,15 +474,26 @@ seed 边界已收口:`ensureRuntimeContent` 写入的 offerings、trust conten
|
||||
|
||||
### Phase 5:构建、上传和线上发布闭环
|
||||
|
||||
- [ ] 将 build、upload、review、release 状态拆分并建 attempt/lease;
|
||||
- [ ] 产物路径包含品牌 slug、模板 key、精确版本和 release/attempt id;
|
||||
- [ ] 生产依赖闭包在干净安装和重启后可用;
|
||||
- [ ] 构建失败、上传失败、超时、进程退出、重试和恢复有自动化测试;
|
||||
- [ ] 防止 No projects matched、缺产物、旧产物冒充和并行品牌串产物;
|
||||
- [ ] 用实际品牌参数构建并保存日志、产物检查和上传结果。
|
||||
- [x] 将 build、upload、review 状态拆分,并为构建/上传增加持久化 attempt 和 lease;旧聚合 `status` 暂时保留兼容;
|
||||
- [x] 产物路径包含品牌 slug、模板 key、模板包精确版本和 build attempt id;
|
||||
- [x] 生产依赖闭包通过 Node 24 release package、干净 `--prod --frozen-lockfile` 安装、Prisma Client generate、API runtime import 和 production API health check 验证;API app 重建后的 attempt 恢复由真实 Prisma integration 覆盖;
|
||||
- [x] 构建失败、上传失败、超时、进程退出、重试和恢复有自动化测试;覆盖 build worker 非零退出/watchdog kill、失败构建、上传子进程超时、attempt lease 竞争/接管、真实 Prisma/API app 重建恢复;本机 Node 24 production bundle 已启动、停止并重启验证;生产机 PM2/主机重启仍属于部署环境验收;
|
||||
- [x] 自定义产物目录纳入 Taro 构建和 masking 检查;缺少 `app.json` 会阻止上传;
|
||||
- [x] 使用实际品牌参数完成 production weapp build 并尝试微信上传,保存产物检查和外部结果;`linjing-doors` 的真实 AppID/API 地址构建通过,修复了 worker 漏掉 `/weapp` 输出层级的问题;同一 release task 的两次真实微信上传均返回工具链 `timeout`,attempt 持久化为 failed 且无 upload id,未提交审核或发布。
|
||||
|
||||
退出门禁:API 不会因为 fire-and-forget 日志或并行重试永久轮询;任何终态都可查询;构建成功不再隐含上传成功;上传结果有真实 weappUploadId 或明确外部失败证据。
|
||||
|
||||
Phase 5 首轮实现记录(2026-10-17):
|
||||
|
||||
- 新增 `MiniAppReleaseAttempt`,分别记录 build/upload attempt、单调 attempt 序号、随机 lease token、过期时间、heartbeat、日志、产物路径、external id 和 terminal status;并发操作拒绝,过期 attempt 收敛为 `timed_out` 后可重试。
|
||||
- MiniAppReleaseTask 新增独立 `uploadStatus`、`reviewStatus`;旧 `status` 仍作为兼容聚合状态供现有客户端读取。新增 migration 对历史 uploaded/review 状态做可推导回填。
|
||||
- 构建输出按 `releases/<brandSlug>/<templateKey>@<templateVersion>/<attemptId>/weapp` 隔离;每次 build 不复用其他品牌、版本或 attempt 的目录。成功产物可用于当前任务上传;失败状态不允许旧产物冒充本次 build。
|
||||
- Taro 支持受控 `MINIAPP_OUTPUT_ROOT`,masking 会检查同一自定义目录;构建进程增加明确 timeout。Admin 发布卡片显示 build/upload/review 阶段状态。
|
||||
- 本地验证:API unit `60/60`、API HTTP integration `52/52`、upload integration `2/2`、Taro tests `16/16`、Admin/API/API Client/Taro typecheck、Admin production build、`format:check` 通过;migration 在主本地数据库及隔离 integration schema 均成功应用。Taro `weapp` 使用测试 AppID 的自定义输出路径 smoke build 已通过,不作为生产参数证据。
|
||||
- 本轮补充:`deploy:package` 首次暴露 Admin production asset base 错误,已统一 Vite `base` 并重跑通过;最新 929 文件 release 在 Node 24.16.0 下完成干净 production-only 冻结安装、Prisma Client generate 和 API runtime import;production API 启动、停止、重启及 `/health` 检查通过。新增真实 Prisma integration:关闭并重建 Nest app 后接管过期持久化 build attempt;最近全套 integration `53/53`、upload `2/2` 通过。该本机验证不替代生产机 PM2/主机重启演练。
|
||||
- 本轮实际发布尝试:`linjing-doors` 页面的凭据状态为已加密保存,解密后 PEM 校验通过。为避免改写历史 version 13 上传任务,先基于当前已发布且 readiness 通过的品牌内容生成 version 14,并创建独立 MiniAppReleaseTask。首次构建因 worker 输出目录缺少 `/weapp` 而失败;修复后 build attempt 2 成功,产物包含 `app.json`。两次 miniprogram-ci 上传均返回 `timeout`,task 当前为 `buildStatus=success`、`uploadStatus=failed`、`reviewStatus=not_submitted`,没有 `weappUploadId`。任务、attempt 和失败原因已保存在本地数据库;没有提交微信审核,也没有发布小程序线上版本。
|
||||
- 收口说明:按当前交付范围,Phase 5 的实现、自动化测试、本地 production bundle 验证及实际品牌构建/上传尝试均已完成,故阶段标记为已收口。真实微信上传仍以 `timeout` 失败且无 upload id;未提交审核或发布,生产机 PM2/主机重启演练也未执行。这些是明确记录的外部/部署环境限制,不代表微信发布成功;若后续需要线上发布或出现相关问题,再核查上传链路及部署环境。
|
||||
|
||||
### Phase 6:升级、冲突、回滚和恢复
|
||||
|
||||
- [ ] 生成旧版本到新版本的字段、模块、资源、能力和 renderer 差异;
|
||||
|
||||
Reference in new issue
Block a user