# 飞书前门替换后回归检查模板 v1

## 1. 文档目的
本文件用于定义飞书前门在完成真实地址替换后的回归检查模板。
目标不是再讨论要不要上线，而是把“替换后必须验证什么、满足什么条件才 go/no-go”整理成一个标准检查模板。

一句话判断：
这份模板的意义，是把“替换动作完成”进一步转化成“可验证、可放行、可回退”的 go-live 判断依据。

## 2. 使用时机
本模板应在以下动作全部完成后使用：

1. 已确认真实 base domain
2. 已确认真实 download domain
3. 已替换 runtime_portal_url
4. 已替换 feishu_frontdoor_homepage_url
5. 已替换 callback / redirect URL
6. 已替换 trusted domain
7. 已更新相关配置文件
8. 已重新生成 readiness / Portal / Feishu Frontdoor Homepage

## 3. 替换后目标状态
替换完成后，目标状态应明确为：

### 3.1 system_ready
- 仍应保持 `system_ready = true`

### 3.2 go_live_ready
- 应从 `false` 变为 `true`

### 3.3 replacement_blocker_count
- 应从大于 0 变为 `0`

一句话判断：
替换后最关键的变化，不是页面内容变了，而是 readiness 应正式从“系统 ready”升级到“真实上线 ready”。

## 4. 第一层：配置回归检查

### 4.1 域名检查
必须确认：
- `base_domain` 已替换
- `download_domain` 已替换
- 不再存在 `example.com`

### 4.2 URL 检查
必须确认：
- `runtime_portal_url` 已替换为真实地址
- `feishu_frontdoor_homepage_url` 已替换为真实地址
- `latest_release_bundle_url` 或 fallback_url 至少一个真实可用
- `callback_url` 已替换
- `sso_callback_url` 已替换

### 4.3 trusted domain / redirect URL 检查
必须确认：
- trusted domain 全部已替换为真实地址
- redirect URL 全部已替换为真实地址
- 与飞书后台配置一致

## 5. 第二层：系统回归检查

### 5.1 readiness 检查
必须确认：
- `system_ready = true`
- `go_live_ready = true`
- `replacement_blocker_count = 0`

### 5.2 版本治理检查
必须确认：
- `current_release` 正确
- `release_manifest_latest` 正确
- `release_history_latest` 正确
- Portal 当前版本与历史版本一致

### 5.3 发布产物检查
必须确认：
- `latest_release_bundle` 可用
- 推荐下载可用
- `Runtime Portal` 可用
- `Feishu Frontdoor Homepage` 可用

## 6. 第三层：页面回归检查

### 6.1 Runtime Portal
必须检查：
- 首页可打开
- `current_release` 展示正确
- 历史发布版本可展示
- 推荐下载可点击
- latest_release_bundle 可下载
- 飞书前门状态摘要可展示
- readiness 摘要可展示

### 6.2 Feishu Frontdoor Homepage
必须检查：
- 页面可打开
- 飞书前门状态可展示
- 当前正式版本可展示
- 版本摘要可展示
- 趋势快照可展示
- “进入完整 Portal”入口可点击
- latest_release_bundle 可点击

## 7. 第四层：飞书端回归检查

### 7.1 桌面端
必须检查：
- 应用在工作台可见
- 桌面端首页可打开
- 首页加载无白屏
- 首页链接可点击
- current_release 感知清楚

### 7.2 移动端
必须检查：
- 移动端首页可打开
- H5 页面兼容正常
- 首页布局不明显错乱
- 关键入口可点击

### 7.3 白名单
必须检查：
- 白名单用户可见应用
- 白名单用户可打开首页
- 非白名单用户不可见（若策略如此）

## 8. 推荐的回归执行顺序
建议按以下顺序执行：

1. 替换配置文件
2. 重跑 readiness checker
3. 重刷 Runtime Portal
4. 重刷 Feishu Frontdoor Homepage
5. 检查 go_live_ready
6. 检查 current_release
7. 检查 latest_release_bundle
8. 检查 Runtime Portal 页面
9. 检查 Feishu Frontdoor Homepage 页面
10. 在飞书桌面端验证
11. 在飞书移动端验证
12. 最后做 go/no-go 判断

## 9. go/no-go 模板
建议在回归后直接按下面模板判断：

### go 条件
- `system_ready = true`
- `go_live_ready = true`
- `replacement_blocker_count = 0`
- Runtime Portal 正常
- Feishu Frontdoor Homepage 正常
- current_release 正常
- latest_release_bundle 正常
- 飞书桌面端验证通过
- 飞书移动端验证通过
- 白名单验证通过

### no-go 条件
任一项成立即 no-go：
- 仍存在 `example.com`
- `go_live_ready = false`
- `replacement_blocker_count > 0`
- Runtime Portal 打不开
- Feishu Frontdoor Homepage 打不开
- latest_release_bundle 下载异常
- current_release 错误
- 飞书端页面异常
- 白名单策略异常

## 10. 回退模板
若回归失败，建议按以下方式回退：

1. 保留原 Web 直链作为备用入口
2. 飞书前门先不扩白名单
3. 回退到上一版真实稳定配置
4. 重新跑 readiness
5. 修复 blocker 后再重新回归

## 11. 输出记录建议
每次执行替换后回归，建议至少留以下记录：
- 替换时间
- 执行人
- 替换了哪些域名与 URL
- readiness 结果
- 当前 `system_ready`
- 当前 `go_live_ready`
- 当前 `replacement_blocker_count`
- 最终 go/no-go 结论

## 12. 一句话总结
飞书前门替换后回归检查模板的意义，不是多一次机械检查，而是确保 Talent Review OS 在真实地址替换后，能够从“理论可上线”真正进入“可放行试点”的状态。
