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

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
2026-09-17 01:25:12 +08:00
parent 5b3bad326e
commit 7a2693b239
26 changed files with 2208 additions and 700 deletions
@@ -0,0 +1,58 @@
+-- ============================================================
+-- V039: Phase 13A 婚恋咨询 —— 补 counseling 幂等键 + 扩展 request_source 白名单
+--
+-- 背景（Phase 13A REFACTOR/EXTEND）：
+--   1) 计划项 2 要求「申请接口补幂等」—— 客户端重复提交（网络重试 / 用户连点）
+--      必须收敛为一条记录。此前 counseling_services 无幂等键列，
+--      纯靠 Service 层 SELECT-then-INSERT，并发下会写入重复申请。
+--   2) request_source 白名单需要容纳「内容/活动后续跟进」等既有语义来源。
+--
+-- 幂等语义：同一 user_id + 同一 idempotency_key 只允许一条有效记录。
+--   用 partial unique index 表达（仅约束 idempotency_key 非空的行），
+--   与 V036 的通知幂等索引同一手法。
+--   ⚠️ H2 不支持 partial index，测试库 schema-h2.sql 用普通 UNIQUE 表达
+--      （PG/H2 的标准 UNIQUE 均允许多行 NULL 共存，语义等价）。
+--
+-- 全部语句幂等，可重复执行。
+-- ============================================================
+
+-- ---------- 1) 幂等键列 ----------
+ALTER TABLE counseling_services ADD COLUMN IF NOT EXISTS idempotency_key VARCHAR(128);
+
+-- 同一用户 + 同一幂等键唯一（仅约束非空值）
+CREATE UNIQUE INDEX IF NOT EXISTS uk_counseling_idem
+    ON counseling_services (user_id, idempotency_key)
+    WHERE idempotency_key IS NOT NULL;
+
+-- ---------- 2) request_source 白名单（保持与 V022 一致，显式重述以防漂移） ----------
+-- V022 已建立 chk_request_source，此处按既有惯例 (V018/V020/V025/V038)
+-- 用 DROP + 重加的方式显式固化「最终有效」白名单，使守卫解析结果稳定。
+ALTER TABLE counseling_services DROP CONSTRAINT IF EXISTS chk_request_source;
+ALTER TABLE counseling_services ADD CONSTRAINT chk_request_source
+    CHECK (request_source IN (
+        'user_self', 'matchmaker_referral', 'activity_followup',
+        'service_station', 'operator_assisted'
+    ));
+
+-- ---------- 3) 状态白名单（同上，显式固化合法状态集合） ----------
+ALTER TABLE counseling_services DROP CONSTRAINT IF EXISTS chk_counseling_status;
+ALTER TABLE counseling_services ADD CONSTRAINT chk_counseling_status
+    CHECK (status IN (
+        'pending', 'assigned', 'scheduled', 'in_progress',
+        'completed', 'cancelled', 'closed'
+    ));
+
+-- ---------- 4) service_type 白名单（同上） ----------
+ALTER TABLE counseling_services DROP CONSTRAINT IF EXISTS chk_counseling_service_type;
+ALTER TABLE counseling_services ADD CONSTRAINT chk_counseling_service_type
+    CHECK (service_type IN (
+        'relationship_guidance', 'emotional_support',
+        'premarital_guidance', 'anti_fraud_guidance'
+    ));
+
+-- ---------- 5) 伴侣确认语义（INV-005）----------
+-- user_confirmed_at 由**伴侣本人**写入，非工作人员代填。
+COMMENT ON COLUMN counseling_services.user_confirmed_at
+    IS 'INV-005: 婚前辅导受邀伴侣本人的确认时间，仅本人可写，工作人员不得代确认';
+COMMENT ON COLUMN counseling_services.idempotency_key
+    IS '客户端幂等键；同一 user_id + idempotency_key 唯一';