docs: add phase 04-06 recovery reports, gate outputs and execution plan

2026-09-14 10:01:41 +08:00
parent 1aea6f7791
commit 0518cda95c
20 changed files with 669 additions and 0 deletions
@@ -0,0 +1,37 @@
+# Phase 06 V1.1 恢复验收报告
+
+日期：2026-09-12  
+范围：Match Eligibility 增量（KEEP / EXTEND）
+
+## 完成项
+
+- 保留正式 `RecommendationEngineService` 的双向 Required 算法，未重写既有匹配架构。
+- 推荐入口与缓存命中均重新执行实时 Eligibility，防止 Redis 中的旧结果绕过状态变化。
+- 双向过滤 Block；仅账号正常、关系状态 `searching`、推荐开关开启、资料审核通过且隐私允许的双方可进入推荐。
+- `paused`、`matched_successfully`、关闭推荐及不可见用户均不能进入候选或继续使用缓存结果。
+- 本地资格门禁由 `MATCH_LOCAL_ELIGIBILITY_REQUIRED` 配置；关闭时不强制，开启时仅 `verified` 通过。
+- 修复旧 Eligibility 将 `pending_review` 错判为已核验的问题。
+- 首页聚合改为调用正式推荐引擎，不再返回硬编码空列表。
+- 用户端继续只显示推荐等级和推荐理由，不暴露数字匹配率。
+
+## 验证结果
+
+- 推荐专项测试：21/21 通过。
+- Phase 06 前后端契约检查：通过。
+- Admin Web TypeScript 检查：通过。
+- Docker 后端镜像构建：通过。
+- PostgreSQL、Redis、MinIO、Backend：全部 Healthy。
+- Flyway：35 个迁移校验通过，数据库保持 V035。
+- `/api/v1/health/live`：UP。
+
+## Gate 结论
+
+- 双方任一 Required 不满足时永不入选：通过。
+- Block、Paused、Successful、隐私和推荐开关不能被缓存绕过：通过。
+- 前端不显示数字匹配率：通过。
+
+## 已知后续项
+
+- 推荐评分仍沿用 V1 简化实现，真实画像填充、推荐理由丰富及首页完整状态矩阵在 Phase 07 继续完成。
+
+Phase 06 完成。按阶段门禁停止，Phase 07 尚未开始。