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 健康，管理端可访问；
+- 不删除或停止其他项目的容器、网络、卷和镜像。