66 lines
3.3 KiB
Markdown
66 lines
3.3 KiB
Markdown
# 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、测试、端口、容器和保留备份的最终清单。
|