danyang-match/docs/superpowers/specs/2026-09-11-codex-baseline-cleanup-design.md

Codex 基线归并与旧环境清理设计

目标

以 codex/ui-v11-fidelity 的 ac2327b 为唯一代码基线，清除 ZCode 遗留、旧 Phase 分支、临时依赖与本项目历史 Docker 环境，并从空环境验证启动。

保留

• Codex 分支、冻结标签和完整 Git 历史；
• artifacts/backups/*.dump 数据库备份；
• Flyway 全部迁移文件；
• 当前 V1.1 客户需求文档与 Codex 已完成代码。

清理

• .zcode/；
• 旧 phase/02-rbac-datascope 分支；
• 已跟踪的临时 Maven 包、临时 POM、小程序 .bak；
• node_modules、target、dist、pytest 缓存等可重建产物；
• 仅属于本项目的旧容器、镜像、网络和数据卷。

其他项目的 Docker 资源不在本次范围内。

归并与重建

1. 将 main 快进到 Codex 基线，保留 codex/ui-v11-fidelity 作为审计分支。
2. 数据卷删除前创建 PostgreSQL 备份。
3. 清理后按锁文件重新安装依赖，从空 PostgreSQL 执行 Flyway。
4. 修复妨碍纯净启动的配置冲突，但不重构业务架构。

验收

• Git 工作区仅保留预期变更和备份；
• 后端测试及构建通过；
• 管理端类型检查、构建及页面访问通过；
• 小程序 TypeScript 检查通过，并能由微信开发者工具打开；
• PostgreSQL、Redis、MinIO、Backend 健康，管理端可访问；
• 不删除或停止其他项目的容器、网络、卷和镜像。