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

fix(feature-flags): close Phase 22 KEEP-VERIFY — 2 real defects + doc overclaims

Browse Source 
KEEP-VERIFY re-audit of the Feature Flag configuration extension (STATUS's
"Phase 22 部署运维配置扩展"): marked ✅ but contained real code defects and
overstated completion.

Real defects fixed:
- D-22-A (High): FeatureFlagController.updateFlag used reflection
  `getMethod("set"+cap, boolean.class)` and only supported boolean flags.
  7 non-boolean flags (livenessProvider, localEvidenceAllowedTypes,
  counselingAttachmentsBucket, localEvidenceMaxFiles, localEvidenceMaxFileSizeMB,
  localEvidenceRetentionDays) failed to update via the API. Now dispatches by
  field type (boolean/int/String).
- D-22-B (Medium): `body.getOrDefault("value", false)` silently set false when
  value was missing and crashed on non-boolean casts. Now returns 400 on missing
  value / type mismatch and leaves the original value unchanged.

Doc overclaims corrected (no silent scope creep):
- T01-T05 module-toggle flags (isCounselingEnabled etc.) have zero business
  call sites -> dead config (exposed but not gating). Left for each module's
  own phase to wire; documented as residual.
- T07 private-storage bucket flags have zero references; storage already uses
  object-storage.bucket-private. Documented as residual.
- STATUS claimed "application.yml defaults (15 flags)"; yml has no `features:`
  block, defaults are Java field defaults. Functionally fine, docs corrected.

T06 upload policy verified actually enforced in LocalEligibilityService +
PhotoService (kept ✅).

Guard tests: new FeatureFlagControllerTest (7 cases: 21 keys exposed, boolean/
string/int update reflected, unknown flag / missing value / wrong type -> 400).
Negative validation: reverting to boolean-only dispatch made exactly 2 update
cases fail red, then green after restore — proves guards are real.

Full regression: 657 tests / 0 failures / 0 errors / 3 skipped (baseline 650, +7).
This commit is contained in:
WorkBuddy
2026-09-18 11:00:08 +08:00
parent 0580da0c62
commit 2fbdbc32d0
5 changed files with 289 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/STATUS.md
+17 -2
View File
@@ -2,9 +2,9 @@
> **2026-09-17 当前有效结论：`V1.1 INCREMENTAL RECOVERY PHASE 20 COMPLETE / UI REDESIGN ACCEPTED BY USER / 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（公益红娘转介）、Phase 13A（婚恋咨询与婚前辅导）、Phase 14（多类型公益活动）、Phase 15（活动报名、审核与签到）、Phase 16（活动互选与双方开启沟通确认）、Phase 17（举报与风控）、Phase 18（申诉）、Phase 19（统一运营后台 + 用户端公益服务页面）、Phase 20（Analytics 数据统计与管理驾驶舱）复验已关闭**，十四轮共修复 130+ 处真实缺陷（含 3 处隐藏编译缺陷），并各自补齐测试保真度与守卫。**Phase 21 起需用户确认后启动。**
> 阶段 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-17 — 分支 `main`（`feat-ui-v11` 保留为冗余锚点）
最后更新: 2026-09-18 — 分支 `main`（`feat-ui-v11` 保留为冗余锚点）
## 当前唯一有效状态
@@ -569,6 +569,21 @@ MinIO: localhost:9003 (凭证由本地环境变量提供)
| 报告 | `docs/Phase-21-V11-Recovery-Completion-Report-2026-09-18.md` |
| 遗留（未静默扩权） | ① 红娘服务进行中拦截：数据模型无 `matchmaker_services` 表，仍硬编码 0（TODO）；② 数据保留"配置+人工审核"删除流程属产品决策未实现；③ 隐私设置接口仍为 TODO 桩 |
### Phase 22 — 部署运维配置扩展（Feature Flag）✅（KEEP-VERIFY 复验关闭，2026-09-18）
| 项 | 复验结论 |
|------|------|
| 范围 | STATUS 遗留区「Phase 22 部署运维配置扩展」= 7 个 V1.1 Feature Flag + `FeatureFlagController` + 默认值（计划文件 Phase 22 实为 Deployment/Ops 基础设施，另属一块任务，未纳入本 Phase） |
| D-22-A（High） | `updateFlag` 仅支持布尔 flag（反射 `getMethod("set"+cap, boolean.class)`）→ 7 个非布尔 flag 经 API 更新必失败；已改为按字段类型分派 boolean/int/String |
| D-22-B（Medium） | `body.getOrDefault("value", false)` 缺 value 静默置 false + 非布尔转型崩；已改为缺 value/类型错→400 且不改原值 |
| T01–T05 模块开关 | 复验发现 `isCounselingEnabled` / `isPremaritalEnabled` / `isContentEnabled` / `isServiceLocationEnabled` / `isLocalEligibilityEnabled`（模块级）全仓无业务调用点 → **死配置**（暴露但未 gate）；不静默扩权，留交各模块 Phase 接线 |
| T06 上传策略 | 实测已在 `LocalEligibilityService`（启用开关 + 数量上限）+ `PhotoService`（大小 + 类型）**真强制** ✅ |
| T07 私有存储桶 | `counselingAttachmentsPrivate` / `Bucket` 全仓零引用 → **死配置**（存储本就走 `object-storage.bucket-private`）；可选增强，遗留 |
| yml 声明夸大 | STATUS 称「application.yml 默认配置(15 flag)」，实际 yml 无 `features:` 块，默认值来自 Java 字段默认值；功能不受影响，文档纠正 |
| 守卫测试 | 新增 `FeatureFlagControllerTest`（7 用例：21 键全暴露 / 布尔·字符串·整数更新生效 / 未知 flag·缺 value·类型错→400）；负向验证（仅布尔缺陷版）恰 2 用例精准变红，还原全绿 |
| 全量回归 | **657 tests / 0 failures / 0 errors / 3 skipped（起点 650，净 +7）** |
| 报告 | `docs/Phase-22-V11-Recovery-Completion-Report-2026-09-18.md` |
| 遗留（未静默扩权） | ① T01–T05 模块开关死配置；② T07 私有桶死配置；③ PUT 仅内存生效（不持久化，计划未要求）；④ 计划 Phase 22 Deployment/Ops 基础设施尚未复验 |
**Phase 20（Analytics数据统计扩展）— 已完成** ✅
### Phase 22 — 部署运维配置扩展 ✅ 已完成