docs: define Codex baseline cleanup

2026-09-11 10:13:02 +08:00
parent ac2327b499
commit 8432587b83
1 changed files with 38 additions and 0 deletions
@@ -0,0 +1,38 @@
 # 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 健康，管理端可访问；
 - 不删除或停止其他项目的容器、网络、卷和镜像。