docs: 补充模板契约发布快照刷新流程
CI / Taro builds (linjing-editorial) (push) Has been cancelled
CI / Browser regression (push) Has been cancelled
CI / Static checks (push) Has been cancelled
CI / Production build (push) Has been cancelled
CI / API integration (push) Has been cancelled
CI / Taro builds (acheng-campus-food) (push) Has been cancelled
CI / Taro builds (atelier-solopreneur) (push) Has been cancelled
CI / Taro builds (linjing-editorial) (push) Has been cancelled
CI / Browser regression (push) Has been cancelled
CI / Static checks (push) Has been cancelled
CI / Production build (push) Has been cancelled
CI / API integration (push) Has been cancelled
CI / Taro builds (acheng-campus-food) (push) Has been cancelled
CI / Taro builds (atelier-solopreneur) (push) Has been cancelled
This commit is contained in:
1 parent
cb046a4c27
commit
6df4e1d72b
2 files changed
+35
-2
No files matched your search
@@ -256,5 +256,5 @@
|
||||
}
|
||||
}
|
||||
},
|
||||
"sourceTreeHash": "88af963f5c1186b8e3b9a8ba4c6132f1601d0f4ee21d334bf9b7aacfccd3e04c"
|
||||
"sourceTreeHash": "7db7647772c54d29bcff2211b59bc3a1c261988b543046ba3b078d5945d3a599"
|
||||
}
|
||||
+34
-1
@@ -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`;单个模板的产物固定为 `<root>/<template-package-key>/weapp`,缺少 `app.json` 即判定构建失败并保留构建日志。生产环境仍按 ADR 0023,优先在 CI 或专用发布 Worker 中构建,API 只负责上传。
|
||||
|
||||
|
||||
Reference in new issue
Block a user