diff --git a/docs/superpowers/specs/2026-09-11-codex-baseline-cleanup-design.md b/docs/superpowers/specs/2026-09-11-codex-baseline-cleanup-design.md new file mode 100644 index 0000000..b9fcf00 --- /dev/null +++ b/docs/superpowers/specs/2026-09-11-codex-baseline-cleanup-design.md @@ -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 健康,管理端可访问; +- 不删除或停止其他项目的容器、网络、卷和镜像。