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

fix(counseling): close Phase 13A KEEP-VERIFY/EXTEND — 9 real defects + 4 test-infra defects

Browse Source 
Phase 13A（婚恋咨询与婚前辅导）复验关闭。历史 ✅ 不可信：counseling 模块存在双实现，
线上权威 CounselingService（167 行）零测试，唯一被测的 CounselingServiceApp（280 行）
是孤儿类（无注入点、无 HTTP 端点可达，生产永不执行）→ 已合并并删除。

生产缺陷（D1~D9）：
- D1 Critical 生产故障 · INV-013 泄露：咨询正文 userRequestSummary 原文被写入 WARN 日志
  （同 Phase 10 D2 一族）→ 改为只记 serviceId + riskLevel，绝不记正文。
- D2 High 越权：申请 userId 取自请求体而非认证主体 → Controller 强制 principal.id()。
- D3 High 并发：分配用「先读后写」→ 两管理员并发分配静默覆盖；
  改 assignIfPending 条件更新（WHERE status='pending' AND assigned_operator_id IS NULL），
  affectedRows=0 明确报错。
- D4 High 越权读：counseling_manager 经 getDetail 可读 followups 正文 → INV-013 绕过通道；
  manager 只加回 userRequestSummary，不装配 followups。
- D5 Medium：无状态机 → 「已完成」可被再取消；新增 ALLOWED_TRANSITIONS + assertTransition。
- D6 Medium 生产故障：GET /counseling/services/intro 后端不存在（且被 /services/{id} 吞掉）
  → 小程序 intro 页 100% 无数据；补端点并声明在变量路径之前。
- D7 Medium 契约：Admin 调用 5 条不存在的 /services/operator/*（404）+ 缺四态
  → 后端补 8 个运营端端点（@PreAuthorize），前端整体重写 + 注册 /counseling 路由。
- D8 Medium 契约：小程序字段名错（userRequestSummary/preferredServiceMode）+ 无幂等
  + my-counseling 未检查 success（403 静默空列表）+ 跳转不存在的页 + WXML 内调用方法。
- D9 Medium 测试保真度：测试库 counseling 两表零 CHECK 约束，
  counseling_services 未列入 EntityMigrationParityTest 任何集合（= 零覆盖）。

测试基建缺陷（T1~T4，不修即恒真假绿）：
- T1 守卫找不到 DDL：surefire workingDirectory = ${project.basedir}/.. 使 CWD 为仓库根，
  且 backend/ 是子目录非祖先 → 改为候选后缀 + 逐级向上定位，失败大声抛异常。
- T2 全限定 @com.baomidou...TableField(exist=false) 漏解析（假漂移警报）→ 正则放宽 + 回归守卫。
- T3 OperatorEndpointPermissionCoverageTest 扫到私有辅助方法（假阳性）→ 只扫描真实端点 + 自检。
- T4 两处测试自身逻辑缺陷：陈旧内存快照比较、Instant 纳秒 vs DB 微秒精度。

迁移：新增 V039（counseling 幂等键 + 三个 CHECK 白名单显式固化），基线 38 → 39。

负向验证两轮（均已还原，grep -c NEG-VAL = 0）：
- ① DDL 常量守卫：从 V039 移除 'scheduled' → 常量守卫精准变红
  （证明解析的是真实 DDL 而非副本）。
- ② 行为守卫：注入「并发回退先读后写 / manager 读 followups / 状态机守卫失效」
  → 三个用例各自精准变红。

测试：新增 CounselingPhase13ATest（25）+ CounselingConstraintGuardTest（5，解析真实 DDL）；
删除孤儿类及其 3 个 DTO、删除测死代码的 CounselingDataScopeTest。
全量回归：Tests run: 420, Failures: 0, Errors: 0, Skipped: 3 / BUILD SUCCESS（4:49）。
基线 391 → 420（净 +29）。admin-web vue-tsc EXIT=0；miniapp tsc EXIT=0。

Tag: phase13a-recovery-2026-09-17
Report: docs/Phase-13A-V11-Recovery-Completion-Report-2026-09-17.md
This commit is contained in:
WorkBuddy
2026-09-17 01:25:12 +08:00
parent 5b3bad326e
commit 7a2693b239
26 changed files with 2208 additions and 700 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/STATUS.md
+68 -15
View File
@@ -1,10 +1,10 @@
# 项目状态跟踪 — STATUS.md
> **2026-09-16 当前有效结论：`V1.1 INCREMENTAL RECOVERY PHASE 4 COMPLETE / UI REDESIGN ACCEPTED BY USER / PHASE 08-13 RECOVERY CLOSED / GIT CLEAN`。**
> **2026-09-17 当前有效结论：`V1.1 INCREMENTAL RECOVERY PHASE 13A COMPLETE / GIT CLEAN`。**
>
> 阶段 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（公益红娘转介）复验已关闭**，六轮共修复 23 处真实缺陷，并各自补齐测试保真度与守卫。**Phase 13A 需用户确认后启动。**
> 阶段 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（婚恋咨询与婚前辅导）复验已关闭**，七轮共修复 32 处真实缺陷，并各自补齐测试保真度与守卫。**Phase 14 需用户确认后启动。**
最后更新: 2026-09-16 — 分支 `main`（`feat-ui-v11` 保留为冗余锚点）
最后更新: 2026-09-17 — 分支 `main`（`feat-ui-v11` 保留为冗余锚点）
## 当前唯一有效状态
@@ -21,15 +21,15 @@
| 阶段 2 管理端 Vue 适配 | 已完成 | 18 modules + 22 routes + vue-tsc 全绿 + vite build 11.68s |
| 阶段 3 CapabilityService 独立化 | 已完成 | New `capability` 模块：CapabilityService（getCapabilities + 公共判断方法）+ CapabilityController（GET /api/v1/capabilities）；HomeApplicationService 完全委托 |
| 阶段 4 双端总验收 | **已完成**（2026-09-14） | 三端构建全绿 + 13/13 契约全绿 + 源码健康检查通过；验收报告见 docs/superpowers/plans/2026-09-14-phase4-acceptance-report.md |
| Flyway 迁移 | V001~V038 | V028~V038 已纳入 STATUS；V037 为 Phase 12 新增（实体列与生产迁移对齐，23 表 50 列）；V038 为 Phase 13 新增（`matchmaker_recommendations.status` + `matchmaker_services.service_type` 的 CHECK 白名单扩展） |
| Backend 全量回归 | **已清偿**（2026-09-16） | 离线容器（`danyang-match-backend-test`）`mvn -o test` 实测：**391 tests / 0 failures / 0 errors / 3 skipped / BUILD SUCCESS**（4 分 59 秒）；含 `CanonicalRouteContractTest`、`ChatContractJsonTest`、`MeRouteContractTest`、`DiscoverBlockInvisibilityIntegrationTest`、`ChatPhase09IntegrationTest`、`ChatWebSocketHandlerTest`、`PhotoUploadValidationTest`、`NotificationPhase11IntegrationTest`、`NotificationTemplateTypeGuardTest`、`NotificationPrivacyCopyTest`、`EntityMigrationParityTest`、`RelationshipProgressPhase12Test`、`HomePremaritalGuidancePhase12Test`、`MatchmakerReferralPhase13Test`、`MatchmakerServiceTest` |
| Flyway 迁移 | V001~V039 | V028~V038 已纳入 STATUS；V037 为 Phase 12 新增（实体列与生产迁移对齐，23 表 50 列）；V038 为 Phase 13 新增（`matchmaker_recommendations.status` + `matchmaker_services.service_type` 的 CHECK 白名单扩展）；V039 为 Phase 13A 新增（counseling 幂等键 + 三个 CHECK 白名单显式固化） |
| Backend 全量回归 | **已清偿**（2026-09-16） | 离线容器（`danyang-match-backend-test`）`mvn -o test` 实测：**420 tests / 0 failures / 0 errors / 3 skipped / BUILD SUCCESS**（4 分 49 秒）；含 `CanonicalRouteContractTest`、`ChatContractJsonTest`、`MeRouteContractTest`、`DiscoverBlockInvisibilityIntegrationTest`、`ChatPhase09IntegrationTest`、`ChatWebSocketHandlerTest`、`PhotoUploadValidationTest`、`NotificationPhase11IntegrationTest`、`NotificationTemplateTypeGuardTest`、`NotificationPrivacyCopyTest`、`EntityMigrationParityTest`、`RelationshipProgressPhase12Test`、`HomePremaritalGuidancePhase12Test`、`MatchmakerReferralPhase13Test`、`MatchmakerServiceTest` |
| 路由/字段契约收敛 | **已完成**（2026-09-15） | 字段：会话 `target*` + `sentAt` + `relationStatus`（commit `687a156`）；路径：采用 2026-09-14 canonical（`/likes` `/passes` `/blocks` `/matches`，缘分保留 `/relations/fate/*`），旧路径与 `success` 桩实现已移除；裁决由 `CanonicalRouteContractTest` 锁定 |
| `/me/*` 路径族 | **已完成**（2026-09-16） | 小程序按 REST 规范（§16 / §22-§40 / §80 / §83-§84）调用 `/me/*`，后端此前**无 `/me` 基路径**致 17 个调用 404。新增 `MeController` 委托既有 service 暴露规范路径，旧路径全部保留，小程序三条历史写法（`/me/privacy-settings`、`/me/photos/{id}/main`、`/me/appeals`）一并兼容；由 `MeRouteContractTest` 锁定 |
| Admin Web | **验证通过** | 2026-09-14 阶段 4：vue-tsc ✅、vite build ✅ 11.68s；18 modules 齐全；壳层+工作台通过参考图 QA |
| Miniapp | **验证通过** | 2026-09-16：tsc ✅；**11 核心页全部 TS-only（11/11）**；首批 11 页于 2026-09-16 通过用户验收；discover 筛选重设计已通过 DevTools 验证 |
| UI 契约测试 | **13/13 通过** | 2026-09-16 运行：全部退出码 0；含 capability 独立化适配与文档基线口径 |
| Git 工作区 | **已清零** | 阶段 0~4 共 24+ commit 可追溯；`git status --porcelain` 0 行 |
| 核心待清债务 | 0 项 | 已全部清偿：3 页 JS→TS 迁移、backend 全量回归（391 tests）、DevTools 真机截图留档（2026-09-14）、`/me/*` 路径族收敛（2026-09-16）、实体↔生产迁移漂移修复（V037/V038，2026-09-16） |
| 核心待清债务 | 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（**需用户确认后启动**） |
---
@@ -186,17 +186,23 @@
| ReviewService 集成本地资格审核通知 | ✅ |
| 隐私安全文案（中性化，不暴露敏感信息） | ✅ |
### Phase 13A — 公益婚恋咨询与婚前辅导（核心链路）✅ 已完成
### Phase 13A — 公益婚恋咨询与婚前辅导（核心链路）✅ 已完成（2026-09-17 KEEP-VERIFY/EXTEND 复验通过）
| 任务 | 状态 |
|------|------|
| V022 counseling_services + counseling_followups 迁移 | ✅ |
| CounselingServiceApp（Service/Controller/DTO） | ✅ |
| 用户端 API：intro / create / list / detail / cancel | ✅ |
| 后台 API：queue / assign / schedule / start / followup / complete / close | ✅ |
| INV-012 Counselor assigned scope 实现 | ✅ |
| Miniapp U55-U59 页面（咨询介绍/申请/我的/婚前辅导） | ✅ |
| app.json 路由注册 | ✅ |
| companionUserId 伴侣支持 | ✅ |
| **V039 Phase 13A 迁移**（counseling 幂等键 + 三个 CHECK 白名单显式固化） | ✅ 新增 |
| `CounselingService`（权威实现，合并孤儿类 `CounselingServiceApp` 后删除） | ✅ 重写 |
| 用户端 API：intro / create / list / detail / cancel / companion-confirm | ✅ |
| 后台 API：queue / assigned / detail / assign / schedule / start / followup / complete | ✅ 8 端点 |
| INV-012 Counselor assigned scope 实现（`assignIfPending` 条件更新防并发覆盖） | ✅ |
| INV-013 正文保护（脱敏分层：user/assigned=全文；matchmaker/operator=脱敏；manager=摘要无 followups） | ✅ |
| INV-005 伴侣须本人确认 | ✅ |
| 合法状态机 `ALLOWED_TRANSITIONS` + `assertTransition` | ✅ 新增 |
| 幂等（`idempotencyKey` + `uk_counseling_idem` 唯一索引） | ✅ 新增 |
| Miniapp U55-U59 页面（咨询介绍/申请/我的/婚前辅导），字段名对齐后端 + 检查 `success` | ✅ |
| Admin `CounselingView.vue` 重写（四态 + 二次确认）+ `/counseling` 路由注册 | ✅ |
| 测试：`CounselingPhase13ATest`（25）+ `CounselingConstraintGuardTest`（5） | ✅ 新增 |
| 全量回归 **420 tests 全绿** | ✅ |
### Phase 13 — 公益红娘服务转介 ✅ 已完成
| 任务 | 状态 |
@@ -299,6 +305,53 @@
> `assertTrue(true)` → 已删除占位、如实改名并注明行为验证位置。
> - 报告：`docs/Phase-13-V11-Recovery-Completion-Report-2026-09-16.md`
### Phase 13A — 婚恋咨询与婚前辅导 ✅ 已完成（2026-09-17 KEEP-VERIFY/EXTEND 复验通过）
| 计划项 | 状态 |
|------|------|
| 计划项 1 Admin Vue 修复 + `/counseling` 路由注册 | ✅ `vue-tsc` EXIT=0 |
| 计划项 2 认证主体 userId + 幂等 + 取消 + owner 校验 + 状态迁移 | ✅ 8 用例 |
| 计划项 3 条件更新解决并发 + Assigned Service 边界 | ✅ `assignIfPending` + 4 用例 |
| 计划项 4 Manager 可摘要不可读正文 | ✅ 7 用例 |
| 计划项 5 婚前辅导复用 service type + 伴侣自主确认 | ✅ 4 用例 |
| 计划项 6 U55~U59 类型/契约/四态/非医疗化文案 | ✅ 双端 type-check EXIT=0 |
> **2026-09-17 复验结论（KEEP-VERIFY/EXTEND）**：历史 ✅ 不可信。counseling 模块存在
> **双实现**——线上权威 `CounselingService`（167 行）**零测试**，唯一被测的
> `CounselingServiceApp`（280 行）是**孤儿类**（无注入点、无端点可达，生产永不执行）。
> 已将其流程合并入 `CounselingService` 并删除孤儿类及仅其使用的 3 个 DTO 与测死代码的测试。
> 修复 **9 处缺陷**：
> - **D1（Critical，生产故障 · INV-013 泄露）** 咨询正文 `userRequestSummary` **原文被写入 WARN 日志**
> （`CounselingServiceApp:81`，同 Phase 10 D2 一族）。修复：合并后只记 `serviceId` + `riskLevel`。
> - **D2（High，越权）** 申请 `userId` 取自**请求体**而非认证主体 → 可替他人提交申请。
> 修复：Controller 强制 `principal.id()`。
> - **D3（High，并发）** `assignCounselor` 用「先读后写」→ 两管理员并发分配**静默覆盖**。
> 修复：`assignIfPending` 条件更新（`WHERE status='pending' AND assigned_operator_id IS NULL`），
> `affectedRows=0` 明确报错。
> - **D4（High，越权读）** `counseling_manager` 经 `getDetail` 可读 `followups` 正文 →
> **INV-013 绕过通道**。修复：manager 只加回 `userRequestSummary`，不装配 followups。
> - **D5（Medium）** 无状态机 → 「已完成」可被再取消。修复：`ALLOWED_TRANSITIONS` + `assertTransition`。
> - **D6（Medium，生产故障）** `GET /counseling/services/intro` **后端不存在**，小程序 intro 页
> 100% 无数据（且被 `/services/{id}` 吞掉）。修复：补端点并**声明在变量路径之前**。
> - **D7（Medium，契约）** Admin 调用 5 条不存在的 `/services/operator/*`（404）+ 缺四态。
> 修复：后端补 8 个运营端端点（`@PreAuthorize`），前端整体重写。
> - **D8（Medium，契约）** 小程序字段名错（`userRequestSummary`/`preferredServiceMode`）+ 无幂等
> + `my-counseling` **未检查 `success`**（403 静默空列表）+ 跳转不存在的页 + WXML 内调用方法（非法）。
> - **D9（Medium，测试保真度）** 测试库 counseling 两表**零 CHECK 约束**，`counseling_services`
> 未列入 `EntityMigrationParityTest` 任何集合（= 零覆盖）。修复：补 3 个 CHECK + 建
> `counseling_followups` + 两表移入 `REQUIRED_IN_TEST_SCHEMA`。
> - **另修 4 处测试基建缺陷（T1~T4）**：① 守卫因 surefire `<workingDirectory>${project.basedir}/..`
> 指向**仓库根**而**找不到 DDL**（且 `backend/` 是子目录非祖先，回溯也找不到）→ 恒真假绿；
> ② 全限定 `@com.baomidou...TableField(exist=false)` **漏解析** → 假漂移警报；
> ③ `OperatorEndpointPermissionCoverageTest` 扫到**私有辅助方法**（假阳性）；
> ④ 两处测试自身逻辑缺陷（陈旧内存快照比较、Instant 纳秒 vs DB 微秒精度）。
> - **负向验证两轮**：① 从 `V039` 移除 `scheduled` → 常量守卫**精准变红**
> （证明其解析的是**真实 DDL** 而非副本）；② 注入「并发回退先读后写 / manager 读 followups /
> 状态机守卫失效」→ **三个用例各自精准变红**。均已还原（`grep -c "NEG-VAL"` = 0）。
> - **全量回归**：`Tests run: 420, Failures: 0, Errors: 0, Skipped: 3 / BUILD SUCCESS`（4:49）。
> 基线 391 → 420（净 +29）。
> - 报告：`docs/Phase-13A-V11-Recovery-Completion-Report-2026-09-17.md`
### V1.1 待实现模块（按 Phase 顺序）
| 模块 | 对应 Phase | 状态 |
@@ -307,7 +360,7 @@
| Banner 管理（后端+前端） | Phase 19 | ⏳ 待开发 |
| 本地资格声明与审核 | Phase 04~05 | ⏳ 待开发 |
| 公益红娘服务转介 | Phase 13 | ✅ 已完成 |
| 婚恋咨询 + 婚前辅导（Phase 13A） | Phase 13A | ⏳ 待开发（**需用户确认后启动**） |
| 婚恋咨询 + 婚前辅导（Phase 13A） | Phase 13A | ✅ 已完成（2026-09-17 复验关闭） |
| 内容管理（婚恋课堂/反诈） | Phase 19 | ⏳ 待开发 |
| 专项公益服务项目 | Phase 19 | ⏳ 待开发 |
| V1.1新增不变量测试（INV-011~020） | Phase 23 | ⏳ 待开发 |