3.3 KiB
Codex Baseline Cleanup Implementation Plan
For agentic workers: REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (
- [ ]) syntax for tracking.
Goal: 以昨天 Codex 构建为唯一基线，删除 ZCode 旧版和本项目旧运行环境，并从空环境完成可验证启动。
Architecture: Git 以 codex/ui-v11-fidelity 为源快进 main，不混合旧 Phase 代码。运行环境通过明确的项目资源白名单清理，数据库先备份，再由 Flyway 从空卷重建。
Tech Stack: Git、Docker Compose、PostgreSQL 16、Java 21/Maven、Vue 3/Vite、微信原生小程序/TypeScript
Spec: docs/superpowers/specs/2026-09-11-codex-baseline-cleanup-design.md
Global Constraints
- 只清理
E:\develop\公益婚恋服务平台及 Docker 项目infrastructure/旧danyang的资源。 - 保留
artifacts/backups/*.dump、Flyway 迁移、冻结标签和 Codex 分支。 - 不停止或删除其他项目 Docker 资源。
- 删除数据卷前必须生成新的 PostgreSQL custom-format 备份并验证文件非空。
Task 1: 归并 Git 基线并删除旧文件
Files:
-
Delete:
.zcode/ -
Delete:
backend/build-temp/ -
Delete:
backend/maven.zip -
Delete:
miniapp/project.config.json.bak -
Modify:
.gitignore -
Step 1: 确认 HEAD 位于
codex/ui-v11-fidelity，工作区除数据库备份外无未知变更。 -
Step 2: 删除上述 ZCode/临时文件，并让
.gitignore保持生成物不回流。 -
Step 3: 将
main快进到当前 Codex 提交，删除phase/02-rbac-datascope。 -
Step 4: 用
git status --short --branch和git branch -vv验证基线。
Task 2: 备份并清理本项目运行环境
Files:
-
Preserve:
artifacts/backups/*.dump -
Step 1: 在当前 PostgreSQL 容器内执行
pg_dump -Fc，复制到artifacts/backups/并验证非空。 -
Step 2: 停止本项目管理端开发进程和 Compose 项目
infrastructure。 -
Step 3: 删除白名单资源：
infrastructure_*、danyang_*、danyang-m2-cache、danyang-net和本项目构建镜像。 -
Step 4: 列出剩余 Docker 资源，确认其他 Compose 项目仍存在。
Task 3: 清理并重建依赖
Files:
-
Delete and recreate:
admin-web/node_modules/,miniapp/node_modules/,backend/target/ -
Preserve: package manifests and lock files
-
Step 1: 删除可重建的依赖、构建和测试缓存。
-
Step 2: 使用现有锁文件执行
npm ci。 -
Step 3: 执行后端测试、管理端类型检查/构建、小程序类型检查。
Task 4: 从空卷启动并验收
Files:
-
Modify only if startup evidence proves necessary:
infrastructure/docker-compose.yml,infrastructure/nginx.conf -
Step 1: 执行
docker compose up -d --build postgres redis minio backend。 -
Step 2: 等待所有服务健康，验证 Flyway 和
/api/v1/health/live。 -
Step 3: 启动管理端，验证 HTTP 200 和 API 代理。
-
Step 4: 验证微信小程序 TypeScript；开发者工具若关闭服务端口，仅报告人工打开方式，不修改安全设置。
-
Step 5: 输出 Git、测试、端口、容器和保留备份的最终清单。