diff --git a/.codex-tasks/template-audit-execution/raw/completion-evidence.json b/.codex-tasks/template-audit-execution/raw/completion-evidence.json index 8be1aa0..4c21d8a 100644 --- a/.codex-tasks/template-audit-execution/raw/completion-evidence.json +++ b/.codex-tasks/template-audit-execution/raw/completion-evidence.json @@ -256,5 +256,5 @@ } } }, - "sourceTreeHash": "88af963f5c1186b8e3b9a8ba4c6132f1601d0f4ee21d334bf9b7aacfccd3e04c" + "sourceTreeHash": "7db7647772c54d29bcff2211b59bc3a1c261988b543046ba3b078d5945d3a599" } diff --git a/docs/deployment.md b/docs/deployment.md index d1003d9..8d67a5c 100644 --- a/docs/deployment.md +++ b/docs/deployment.md @@ -159,7 +159,40 @@ pnpm deploy:verify 脚本要求账号已完成初始密码修改,品牌发布检查全部通过,公开工作区已发布且至少有一项业务。凭据只从环境变量读取,不能写入仓库。 -### 5. 小程序代码上传 +### 5. 模板契约迁移后的发布快照刷新 + +`BrandRelease` 是公开工作区的唯一数据源,发布后内容不可变。模板包升级或兼容性声明修正不会自动改写历史发布,必须显式刷新快照,否则公开工作区会继续返回旧契约(例如旧的 `supportedIndustryTemplates`)。 + +先在生产 release 目录执行 dry-run: + +```bash +node deploy/republish-stale-template-contracts.mjs +``` + +脚本逐品牌比较当前发布快照与数据库重建快照: + +- `current`:无需处理; +- `contract-stale`:仅模板契约字段变化,可重发; +- `content-diverged`:品牌内容(`brand`、`offerings`、`forms`、`trustContents`、`capabilities` 等)与已发布快照不同,**禁止自动重发**,必须在 Admin 审查草稿后手动发布; +- `not-ready`:发布检查未通过,先修复阻断项。 + +确认输出后加 `--apply` 执行。历史遗留字段删除必须显式放行,不能默认忽略: + +```bash +node deploy/republish-stale-template-contracts.mjs --apply \ + --allow-removed-key=brand.config.visualTemplateKey +``` + +`--allow-removed-key` 只允许“旧值存在、新值缺失”的删除;该字段被改成其他值或与其他内容差异同时出现时仍会拦截。`--apply` 退出码为 1 表示至少一个品牌被拦截,应按上面的分类处理,不要重复盲目执行。 + +重发后验证公开契约: + +```bash +curl -fsS "$API_BASE_URL/public/workspace?brandSlug=$BRAND_SLUG" | + jq '{publication, visualTemplate}' +``` + +### 6. 小程序代码上传 后台“配置与发布 → 小程序发布”会调用对应模板的小程序构建,并把产物上传到微信。构建产物根目录由 `MINIAPP_ARTIFACT_ROOT` 控制,相对路径按仓库根目录解析(不是 API 进程的工作目录),默认 `apps/taro/dist`;单个模板的产物固定为 `//weapp`,缺少 `app.json` 即判定构建失败并保留构建日志。生产环境仍按 ADR 0023,优先在 CI 或专用发布 Worker 中构建,API 只负责上传。