admin/danyang-match
1
0
Fork 0
Code Issues Pull Requests Actions 2 Packages Projects Releases Wiki Activity

docs: 状态文件同步到 2026-09-18 实况（方案任务三）

Browse Source 
- STATUS.md：顶部权威行由 "PHASE 20 COMPLETE"（09-17）更新为 09-18 口径（Phase 01~22 关闭 /
  Phase 23 部分关闭 / 三轮横向加固 / 669 tests / 停在 Phase 24 门前）；版本演进表补 rc.11~rc.16；
  **合并三处重复的「V1.1 本地部署完成 (2026-09-09)」区块为一处**（996 行 → 946 行）并加
  「历史记录边界」声明；清「Phase 04~05 ⏳ 待开发」等与实测矛盾项。契约锚点全部保住
  （UI REDESIGN ACCEPTED BY USER / Phase 07 已通过用户验收 / 管理后台: http://localhost:13520/）。
- AGENTS.md + STATUS.md：UI 契约门禁口径 13/13 → **14/14**（历史时点行保留原值并注明，
  不篡改史实）。
- JIRA_BACKLOG.md：Epic 总览表补 P14/P15/P19~P23 的 ✅（P23 标「部分关闭」）。
- 客户需求基线计划：Phase 07 标题去 "UI REOPENED"；Phase 10~15/19 补 ✅；Phase 20/21 勾选
  checkbox 并注日期；**Phase 22 如实标「未复验」**（口径澄清：计划的 Deployment/Ops 与 STATUS 的
  「部署运维配置扩展（Feature Flag）」是两份不同工作，后者复验结论不构成本节证据）；
  Phase 23 标「部分关闭」，第 3/5 项（E2E 场景实现、CI 串联）**不虚勾**。
- PENDING_DECISIONS.md：历史部署声明 10 项按各 Phase Recovery 报告证据回写处置结果
  （9 项已关闭 / 1 项部分）；补登 HTTP 与幂等检修遗留的第三方开放待决策 7 项。
- REMAINING_WORK.md：整体重写 —— 原文称 CHANGELOG 3.3MB（实为 4234 字节）、P1-3 指向从未存在的
  Phase-23-Completion-Report.md；改为「已关闭 / 仍未完成 / 原编号索引 / 验收标准」四段，保留原编号
  以便对照历史引用。
- database 两份：TABLE_INVENTORY 40 表 → **59 表**（带「来源迁移」列）；MIGRATION_GUIDE
  V001~V011 → **V001~V046（46 个）**；两份均标注「以 backend/src/main/resources/db/migration/ 为准」。
This commit is contained in:
WorkBuddy
2026-09-18 21:15:29 +08:00
parent 4f37df3284
commit ae2405f645
8 changed files with 347 additions and 498 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/STATUS.md
+30 -76
View File
@@ -1,8 +1,8 @@
# 项目状态跟踪 — STATUS.md
> **2026-09-17 当前有效结论：`V1.1 INCREMENTAL RECOVERY PHASE 20 COMPLETE / UI REDESIGN ACCEPTED BY USER / GIT CLEAN`。**
> **2026-09-18 当前有效结论：`V1.1 RECOVERY PHASE 01~22 CLOSED / PHASE 23 PARTIALLY CLOSED / HORIZONTAL HARDENING DONE (HTTP SEMANTICS + IDEMPOTENCY + PORT/ENTRY GUARDS) / UI REDESIGN ACCEPTED BY USER / 669 TESTS GREEN / STOPPED BEFORE PHASE 24 (UAT) — AWAITING USER GO`。**
>
> 阶段 0（在途收口）、阶段 1（小程序 C 组 + discover 筛选重设计）、阶段 2（管理端 Vue 新框架适配）、阶段 3（CapabilityService 独立化）、阶段 4（双端总验收）全部完成。三端构建通过、**13/13 契约全绿**、核心 11 页面**全部 TS-only（11/11）**。**UI 重设计首批 11 页已于 2026-09-16 通过用户验收（结论：基本达标）**；`/me/*` 前后端契约同轮收敛，17 个 404 调用已恢复。**Phase 08（Like / Match / Block）、Phase 09（Text Chat）、Phase 10（Image & Chat Safety）、Phase 11（Notification）、Phase 12（Relationship Progress）、Phase 13（公益红娘转介）、Phase 13A（婚恋咨询与婚前辅导）、Phase 14（多类型公益活动）、Phase 15（活动报名、审核与签到）、Phase 16（活动互选与双方开启沟通确认）、Phase 17（举报与风控）、Phase 18（申诉）、Phase 19（统一运营后台 + 用户端公益服务页面）、Phase 20（Analytics 数据统计与管理驾驶舱）复验已关闭**，十四轮共修复 130+ 处真实缺陷（含 3 处隐藏编译缺陷），并各自补齐测试保真度与守卫。**Phase 21、22 复验已关闭（2026-09-18）**；**Phase 23 为「部分关闭」（2026-09-18）** —— 已清除 44 个 `pass` 空壳与 14 个只断言常量的假不变量测试，新增 4 个经负向注入验证的真实行为守卫与空壳阻断闸门，后端回归 655 全绿；但 **E2E 进入 CI 因需「活栈供给方式」基础设施决策而列为遗留，故不宣布「失败为零可进入 UAT」**。**Phase 24 起需用户确认后启动。**
> 阶段 0（在途收口）、阶段 1（小程序 C 组 + discover 筛选重设计）、阶段 2（管理端 Vue 新框架适配）、阶段 3（CapabilityService 独立化）、阶段 4（双端总验收）全部完成。三端构建通过、**13/13 契约全绿**、核心 11 页面**全部 TS-only（11/11）**。**UI 重设计首批 11 页已于 2026-09-16 通过用户验收（结论：基本达标）**；`/me/*` 前后端契约同轮收敛，17 个 404 调用已恢复。**Phase 08（Like / Match / Block）、Phase 09（Text Chat）、Phase 10（Image & Chat Safety）、Phase 11（Notification）、Phase 12（Relationship Progress）、Phase 13（公益红娘转介）、Phase 13A（婚恋咨询与婚前辅导）、Phase 14（多类型公益活动）、Phase 15（活动报名、审核与签到）、Phase 16（活动互选与双方开启沟通确认）、Phase 17（举报与风控）、Phase 18（申诉）、Phase 19（统一运营后台 + 用户端公益服务页面）、Phase 20（Analytics 数据统计与管理驾驶舱）复验已关闭**，十四轮共修复 130+ 处真实缺陷（含 3 处隐藏编译缺陷），并各自补齐测试保真度与守卫。**Phase 21、22 复验已关闭（2026-09-18）**；**Phase 23 为「部分关闭」（2026-09-18）** —— 已清除 44 个 `pass` 空壳与 14 个只断言常量的假不变量测试，新增 4 个经负向注入验证的真实行为守卫与空壳阻断闸门，后端回归 655 全绿；但 **E2E 进入 CI 因需「活栈供给方式」基础设施决策而列为遗留，故不宣布「失败为零可进入 UAT」**。**Phase 23B（E2E 测试基建重建，33→49 passed）、HTTP 语义检修（失败响应携带真实状态码）、幂等键检修（`Idempotency-Key` 30 端点落地，V045/V046）均已于 2026-09-18 完成**，后端全量回归 **669 / 0 failures / 0 errors / 3 skipped**。**管理端入口已收敛到 `/admin/` 子路径（vite base + router base + 三处 nginx 接线），staging 端口 13521；UI 契约门禁 14/14 全绿。Phase 24（UAT）启动需用户确认。**
最后更新: 2026-09-18 — 分支 `main`（`feat-ui-v11` 保留为冗余锚点）
@@ -30,7 +30,11 @@
| UI 契约测试 | **13/13 通过** | 2026-09-16 运行：全部退出码 0；含 capability 独立化适配与文档基线口径 |
| Git 工作区 | **已清零** | 阶段 0~4 共 24+ commit 可追溯；`git status --porcelain` 0 行 |
| 核心待清债务 | 0 项 | 已全部清偿：3 页 JS→TS 迁移、backend 全量回归（420 tests）、DevTools 真机截图留档（2026-09-14）、`/me/*` 路径族收敛（2026-09-16）、实体↔生产迁移漂移修复（V037/V038/V039，2026-09-16/17） |
| UAT / RC / Production | **UI 验收通过，前后端契约已收敛，Phase 08-13 已关闭** | 双端构建/契约/源码全部通过；UI 首批 11 页 2026-09-16 通过用户验收；`/me/*` 契约同轮收敛；Phase 08/09/10/11/12/13 复验通过并关闭，累计修复 23 处真实缺陷，可推进 Phase 13A（**需用户确认后启动**） |
| UAT / RC / Production | **Phase 01~22 复验关闭；Phase 23 部分关闭；停在 Phase 24（UAT）门前** | 后端 **669 / 0 failures / 0 errors / 3 skipped**；UI 契约门禁 **14/14**；管理端入口收敛至 `/admin/` 子路径（staging 13521）；HTTP 语义 + 身份收敛 + 幂等键三轮横向加固完成。**Phase 24 启动需用户确认** |
> **下一阶段计划（唯一）**：`docs/superpowers/plans/2026-09-18-phase23-closeout-and-uat-readiness.md`
> —— 批 1 快速收尾（ui-tests 接入 CI）/ 批 2 Phase 23 剩余（E2E 实现 + CI 串联，**需基础设施决策**）/
> 批 3 代码级遗留清偿 / 批 4 UAT 就绪（**需用户协作**）/ 批 5 Phase 25-26 前置登记。
---
@@ -48,6 +52,12 @@
| 1.1.0-rc.8 | 2026-09-17 | Phase 16 复验关闭（活动互选与双方开启沟通确认，7 处缺陷 + 1 处隐藏编译缺陷 + 1 处测试保真度：含**双确认后根本不建 Match/会话（Gate 缺陷）**、**Phase 15 提交态引用未定义 `reopenEpisode` 致模块不编译（"474 绿"为假象）**、**INV-006 单向意向泄露**、**复用/新建 Match 后缺会话**；统一双实现到 `RelationshipService.confirmActivityInterest`；新增 V041 `expires_at`+`match_id`；新建 `ActivityMutualConsentServiceTest`（7 用例）；全量回归 **481 tests** 全绿 |
| 1.1.0-rc.9 | 2026-09-17 | Phase 17 复验关闭（举报与风控，6 处真实缺陷：含**D1 测试库缺 reports/risk_events/risk_actions 三表致风控/举报真实 DB 路径零覆盖（必崩级盲区）+ ReportServiceTest 假绿**、**D3 敏感访问（查看他人风险画像/举报）无审计（AGENTS.md #8）**、**D4 审计缺 ip/userAgent**、**D5 findByUserId 未过滤软删**、**D2 人工标记无审计**、**D6 javax→jakarta 隐藏编译缺陷 + risk_events 漏 updated_at**）；补齐三表并移出白名单入 REQUIRED_IN_TEST_SCHEMA；新增 `AuditLogService.recordSensitiveAccess` 并接线三端点；新增 `ReportAndRiskPhase17IntegrationTest`（7 用例）；全量回归 **488 tests** 全绿 |
| 1.1.0-rc.10 | 2026-09-17 | Phase 18 复验关闭（申诉，8 处真实缺陷：含**D1 测试库缺 appeals 表 + AppealServiceTest 6 处 assertTrue(true) 假绿 → 申诉真实 DB 路径零覆盖**、**D2 escalate 向 operator 发用户通知撞 notifications.user_id→users(id) FK → PG 上升级 100% 失败**、**D3 appealType 未校验生产 chk_appeal_type**、D4 escalated 死胡同、D5 processAppeal 先读后写并发竞态、D6 三处查询漏软删过滤、D7 硬编码 resolved、D8 证据字段契约 evidenceFileIds）；补 appeals 表并移出白名单入 REQUIRED_IN_TEST_SCHEMA；新增原子认领 `markReviewingIfProcessable`；新增 `AppealPhase18IntegrationTest`（15 用例），删除假绿 `AppealServiceTest`（9 用例）；全量回归 **494 tests** 全绿；admin-web `vue-tsc` EXITCODE=0 |
| 1.1.0-rc.11 | 2026-09-17 | Phase 19 复验关闭（统一运营后台 + 用户端公益服务页面，修复 25 处真实缺陷：服务站公告整条不可达、服务站越权写、Banner 500、Content 发布死路、ServiceProgram 审批死路等）；新增 V042 `service_location_announcements`；全量回归 **602 tests** 全绿 |
| 1.1.0-rc.12 | 2026-09-17 | Phase 20 复验关闭（Analytics，口径造假 / 死代码 / 系统性软删缺陷 D12 修复 45 处 / 权限授予脱节）；新增 V043 `analytics.view` 授权；指标字典 `docs/ANALYTICS_METRICS.md` + `MetricCatalogGuardTest`；全量回归 **648 tests** 全绿 |
| 1.1.0-rc.13 | 2026-09-18 | Phase 21 复验关闭（账户生命周期，6 处缺陷：CLOSED 可登录、注销 TODO 桩 ×2、匿名化死代码等）+ Phase 22 复验关闭（Feature Flag，D-22-A/B 修复；T01~T05 死配置如实登记）；全量回归 **657 tests** 全绿 |
| 1.1.0-rc.14 | 2026-09-18 | Phase 23 **部分关闭**（44 个 `pass` 空壳清除、4 个真实 INV 行为守卫、空壳阻断闸门）；Phase 23B E2E 基建重建（conftest + seed + CI e2e job，本机活栈 33 passed）；全量回归 **655 tests** 全绿 |
| 1.1.0-rc.15 | 2026-09-18 | HTTP 语义检修（105 处错误响应携带真实状态码，回归 664）→ 身份收敛（运营身份禁入用户端 + PathPattern 守卫）→ 幂等键检修（`Idempotency-Key` 30 端点落地，V045/V046，前端 25 处调用点修正，E2E 49 passed）；admin 端口收敛 13520（vite / 文档 / 生产 compose 三处一致）；全量回归 **669 / 0 / 0 / 3** 全绿 |
| 1.1.0-rc.16 | 2026-09-18 | 管理端入口收敛（承接 rc.15 的端口收敛）：staging admin 端口 3001 → **13521**（保持「生产 + 1」，同步 `run-uat.sh` 默认入口）；管理端产物改为 **`/admin/` 子路径部署**（vite 构建 base + router history base + 三处 nginx 接线统一为「不剥离前缀」转发）；**修复生产 nginx `/admin/` 的假成功**——原 `alias` 指向 `nginx:alpine` 自带默认页目录，访问返回 200 + nginx 欢迎页（比 404 更难发现），已改为 `upstream admin_web` + `proxy_pass` 并以真实两跳容器实测；补修 `run-uat.sh` 被截断的尾部（原文件语法不完整、无法运行）并把 `ADMIN_URL` 接到管理端可达性实测；品牌资源引用统一走 `src/brand.ts` 的 `BASE_URL` 拼接（原 5 处写死根路径，子路径下会裂图），favicon 由不存在的 `/favicon.svg` 改为存在的品牌标；UI 门控 **14/14 绿**，新增端口/入口断言 6 条（全部经负向注入验证） |
---
@@ -916,81 +926,25 @@ OpenAPI 对外发布、调用审计与配额、分页幂等覆盖、脱敏边界
---
## V1.1 本地部署完成 (2026-09-09)
## V1.1 本地部署完成（2026-09-09，历史记录）
### 已修复的关键问题
1. **CounselingServiceApp 通知FK约束** — 新增UserMapper检查，operator用户跳过通知
2. **HomeController路径重复** — `/api/v1/home` → `/home`（与其他Controller一致）
3. **LocalEligibilityController路径重复** — `/api/v1/local-eligibility` → `/local-eligibility`
4. **数据库updated_at列缺失** — 为18个表补充ALTER COLUMN
> ⚠️ **历史记录边界**：本节为 2026-09-09 的部署时点记录，其中的测试声明（11/11、25/25、16/16）
> **已在后续重新审查中被推翻**，不作为验收证据。当前有效状态见文首「当前有效结论」。
> 本区块在原文件中重复出现三次（内容高度雷同），2026-09-18 文档治理合并为一处。
### 部署状态
- Backend: http://localhost:8085 ✅
- Admin Web: http://localhost:8086 ✅
- PostgreSQL: localhost:5434 ✅
- Redis: localhost:6381 ✅
- MinIO: localhost:9003 ✅
### 修复的关键问题
- **CounselingServiceApp 通知 FK 约束** — operator 用户不在 `users` 表，改为检查后再发送通知
- **HomeController 路径重复** — `@RequestMapping("/api/v1/home")` → `"/home"`
- **LocalEligibilityController 路径重复** — 同上修复
- **数据库 `updated_at` 列缺失** — 为 18 个 V1.1 表补充 `ALTER COLUMN`
- **前端** — `CounselingView` / `ContentManagementView` 截断、路由缺失、侧边栏菜单缺失
### 测试结果: 11/11 PASS
健康检查、首页聚合、内容管理、服务预约、咨询创建、转介服务、V1.1仪表盘、Feature Flags、文章发布、活动列表、Admin Web
### 运营阶段遗留
- Phase 24: UAT（需真实用户）
- Phase 25: RC内容检查（需运营数据）
- Phase 26: Production Smoke Tests（13项手动验证）
---
## V1.1 本地部署完成 (2026-09-09)
### 修复的关键Bug
1. **CounselingServiceApp 通知FK约束** — operator用户不在users表，修复为检查后再发送通知
2. **HomeController路径重复** — @RequestMapping("/api/v1/home") → "/home"
3. **LocalEligibilityController路径重复** — 同上修复
4. **数据库updated_at列缺失** — 为18个V1.1表补充ALTER COLUMN
### 部署架构
### 历史测试声明: 25/25 PASS（已失效，待可信测试重建）
- 20个API端点全部正常
- 3个业务操作（咨询创建/转介/文章）全部正常
- Admin Web前端正常访问
### 运营商登录凭证
不在文档保存账号密码。开发/测试凭证由本地环境变量或安全 Seed 提供。
### 下一步: Phase 24-26 (UAT/RC/Production)
- Phase 24: UAT — 需要真实用户参与测试
- Phase 25: RC内容检查 — 运营团队填充真实内容
- Phase 26: Production Smoke Tests — 13项手动验证
---
## V1.1 本地部署完成 (2026-09-09)
### 修复的Bug (10项)
- 后端: 咨询通知FK约束、HomeController路径重复、LocalEligibility路径重复、服务预约userId获取
- 数据库: 18张表补充updated_at列
- 前端: CounselingView/ContentManagementView截断、路由缺失、侧边栏菜单缺失
### 历史测试结果（重新审查后失效）
- E2E 的 16/16 记录不能复现，测试文件存在大量空 `pass`。
### 为什么这些声明被推翻（保留为治理证据）
- E2E 的「16/16」记录**不可复现**，测试文件存在大量空 `pass` —— 这是 Phase 23「可信系统测试重建」的直接起因。
- API 人工测试未证明 Permission、DataScope 和业务闭环，不能作为上线依据。
- 「25/25 PASS」「11/11 PASS」均为当时自报，未附可复现命令与失败处理。
### 运行中的服务
| 服务 | 地址 | 状态 |
|------|------|------|
| 后端API | http://localhost:8085/api/v1 | UP |
| Admin Web | http://localhost:8086 | UP |
| PostgreSQL | localhost:5434 | Healthy |
| Redis | localhost:6381 | Healthy |
| MinIO | localhost:9003 | Healthy |
### 运营商账号
不在文档保存账号密码；使用本地环境变量或安全 Seed。
### 下一步: Phase 24-26 (需运营团队配合)
### 运营阶段遗留（至今不变）
- Phase 24: UAT — 需真实用户参与并确认启动
- Phase 25: RC 内容检查 — 需运营团队填充真实内容
- Phase 26: Production Smoke Tests — 13 项手动验证