docs(release): add phase 7 closure checklist
CI/CD Pipeline / Validate Code Quality And Tests (push) Has been cancelled
Deploy / Deploy Staging (push) Has been cancelled
Deploy / Deploy Production (push) Has been cancelled

This commit is contained in:
Xiaoxia AI
2026-06-21 23:54:38 +08:00
parent 74f57c52bc
commit edf87da8b5
+34 -4
View File
@@ -116,7 +116,37 @@
---
## 五、遗留后续专项
## 五、最终收口清单(2026-06-21)
### 必须做(Phase 7 发布边界内)
- [x] 生产 Web/API/Git 域名按 hostname 分离:`saas.xiaoxiajianji.com`、`saas-api.xiaoxiajianji.com`、`git.xiaoxiajianji.com`
- [x] 生产 staging/production 基础设施分离:DB、Redis、端口、generated 路径、compose project 均独立
- [x] 生产 auth/workspace/project/media 主链路验证:注册、登录、工作空间、项目、素材库、上传、入库、分类、生成、下载均通过
- [x] 生产真实 FFmpeg 成片验证:公网下载返回 `HTTP 200` 和 `Content-Type: video/mp4`
- [x] 前端主链路去 demo/manual internal id:项目上下文通过 workspace detail route state 与 `sessionStorage` 传递
- [x] 结果页可测性增强:加载/错误状态、下载失败详情、文件大小、直链与复制 URL
- [x] 部署脚本漂移修复:staging/production 均显式 rebuild Web image;`.gitattributes` 强制 shell 脚本 LF
- [x] Staging deploy 脚本支持 `HOST_PREFIX`,兼容 CI `/host` 容器环境和宿主机直接验收
- [x] 回归测试覆盖 deploy script 关键约束:`tests/unit/test_release_scripts.py`
### 可延后(Phase 8/专项治理)
- [ ] 前端大 chunk 拆分与加载性能优化(当前 `npm run build` 通过,仅有 Vite warning)
- [ ] 测试覆盖率提升与更完整 E2E 自动化
- [ ] 监控告警体系完善
- [ ] 数据库字段命名进一步清理(当前有兼容映射)
- [ ] SMTP 真实投递启用(MVP 明确 `ENABLE_EMAIL_DELIVERY=false`)
### 不做(Phase 7 冻结项)
- [ ] 不新增运营后台/订阅/成员高级管理等非核心剪辑功能
- [ ] 不把 unsupported UI 做成假成功;没有后端支持的入口保持禁用/暂未开放
- [ ] 不再手工 `docker cp` 前端静态文件作为发布方式;只能作为事故止血,不作为验收路径
- [ ] 不把 Git 服务挂到 API 域名路径下;继续坚持 Web/API/Git hostname 分离
### 当前验证备注
- Clean staging deploy 已按 CI archive 风格执行到 Web 镜像构建阶段,证明脚本入口和 LF 问题已修复;服务器冷构建 FFmpeg/Node 依赖期间 load 一度升至 `26+`,SSH banner 超时,外部 Web 后恢复 `HTTP 200`。
- 最终发布前需在服务器负载恢复后补跑一次短 smoke:`docker ps`、staging Web chunk、`/health`、生产 Web/API health。此项是部署验收确认,不引入新功能。
## 六、遗留后续专项
以下问题不阻塞 Phase 7 完成,已纳入后续专项治理清单:
@@ -130,7 +160,7 @@
---
## 六、执行策略总结
## 七、执行策略总结
Phase 7 执行过程中的关键决策:
@@ -141,7 +171,7 @@ Phase 7 执行过程中的关键决策:
---
## 七、验证清单
## 八、验证清单
如果新会话启动后问:
@@ -159,7 +189,7 @@ Phase 7 执行过程中的关键决策:
---
## 八、完成总结
## 九、完成总结
**Phase 7 已全部完成**,核心视频剪辑业务主链路、P0 部署链路、P1 真实 smoke flow、CI/CD 自动化主链路、真实 FFmpeg 生成与公网成片下载均已打通并验证通过。