Przeglądaj źródła

test(R229): 自动化闭环测试汇报 — 基线 55a0dda69 窗口 S-cfc-387 关系类型字典 CRUD(变化轮全量实跑 510/4451/289)+ 台账 12 TC + SC-A-04 转 YELLOW

E2E Test Bot 1 dzień temu
rodzic
commit
91e608393d

+ 35 - 0
docs/tdd/automation-run-2026-11-16-R229.md

@@ -0,0 +1,35 @@
+# 自动化闭环运行摘要 R229(2026-11-16 10:07 GMT+8 · 自动化闭环轮)
+
+> 测试负责人:陆谨|执行档:review(离线白名单)+ 内网双节点浏览器 E2E(本机 + 189)+ langgraph 派 251|基线 `55a0dda69`(+1 src/main 功能提交 **S-cfc-387**)
+
+## 结果速览
+
+| 套件 | 本轮 | 上轮 R228 | 结论 |
+|---|---|---|---|
+| 后端全量(实跑) | **510 类 / 4451 例 / F278+E11=289 红 / 53:51** | TBD(未定稿) | R228 遗留定稿;与 R227 退役口径完全一致、红 -13(契约转绿)|
+| **S-cfc-387 契约** | **`AdminFamilyRelationManageContractTest` 8/8 全绿** ✨ | — | 窗口实现验证通过 |
+| 浏览器 · admin(189) | **5/5 EXIT=0 首跑绿**(1.2m) | 首跑 3过2红→复验5/5 | 🟢 首跑即全绿(B-226-1 好转)|
+| 浏览器 · 本机 live | 15 过 + 2 跳(dx 404 承袭) | 15+2 跳 | 零漂移 |
+| 浏览器 · health | 13/13 | 13/13 | 零漂移 |
+| 线上 API 点名 4 文件 | **33 过 / 0 红 / 3 跳** | 32过/1红/3跳 | 🟢 SC-T-32 504 瞬态转绿 |
+| cfc-web Jest | 21 套 134 例 124/10 | 同左 | 逐例零漂移 |
+| cfc-frontend Jest | 46 套 660 例 644/4/12 | 同左 | 逐例零漂移 |
+| 根级黑盒 | 7/16/23(B-36) | 同左 | 一致 |
+| **langgraph@251** | **43 例 / 35 过 / 8 红**(114.15s,全 429) | 32过/11红 | 🔴 11→8(analyze 2 随配额转绿),B-223-1 观察 **2/3** |
+| 匿名探针 G8 | **B-227-1 三条 3/3 = 200 ❌** | 3/3=200 | **P0 第 3 轮未修** |
+
+## 关键结论
+
+1. **无新增真实缺陷**:S-cfc-387 契约 8/8 全绿,后端红集与 R227 同型(-13 契约转绿),web/fe/浏览器/API 逐例零漂移。
+2. **R228 遗留 TBD 定稿**:后端全量 53:51 实跑补齐,510/4451 与 R227 退役口径完全一致。
+3. **G12 补强**:S-cfc-387 台账 12 TC(`tests/test-cases/2026-11-16-family-relation-type-crud.md`)+ SC-A-04 映射 RED→YELLOW。
+4. **门禁裁决:不通过(预期)**:P0 承袭 B-227-1(匿名 200×3 第 3 轮)/ B-218-1(第 7 轮)+ P0 资金行为层 + 新增 G-229-1。
+
+## 节点派发记录
+
+- 189 `192.168.16.189:4090` admin-desktop **5/5 首跑绿**(每节点单任务)
+- 251 `192.168.16.251:4096` langgraph pytest(43 例,EXIT=124 承袭 B-227-4)
+
+## 本轮 git 证据
+
+- report-test-R229 / automation-run-R229 / 台账 12 TC / sc-key-map SC-A-04 更新 / blockers R229 段 / notice-R229 → commit + push `origin/cfclub`

+ 263 - 0
docs/tdd/orchestration/report-test-2026-11-16-R229.md

@@ -0,0 +1,263 @@
+# 测试负责人工作汇报 R229(2026-11-16 10:07 GMT+8 · 自动化闭环)
+
+> 测试负责人:陆谨(软件测试专家团 · 测试架构师)|执行档:**review(离线白名单)** + 内网双节点浏览器 E2E(本机 + 189)+ langgraph 派 251
+> 静默无人值守,全程未提问;方案假设见 §2
+> 基线:`origin/cfclub` **`55a0dda69`**(窗口 6 提交:`6e3530387` docs + `584ce81f5` bump + **`dcac12caf` feat S-cfc-387 关系类型字典 CRUD** + merge×2 + `55a0dda69` bump)
+> 窗口 **唯一 src/main 功能提交:S-cfc-387 关系类型字典 CRUD**(`AdminFamilyRelationController` +88 / `FamilyRelationTypeService` +141 / 实体+Mapper +54 / DatabaseInitializer 迁移497 +31 / schema.sql +16)→ **变化轮,后端全量实跑 53:51,禁承采**
+
+## 0. 历史审查记录(对照,非本次结论依据)
+
+| 项 | 内容 |
+|---|---|
+| 上次审查 | **R228(2026-11-16 08:50)**,结论「不通过(预期,后端全量 TBD 未定稿)」;基线 `b08d823e8 → 0acc8f222`;187 天窗口 +1 功能(S-cfc-407)|
+| 本次 | **第 229 轮,非首次审查**;基线 `55a0dda69`;**后端全量实跑完成**(R228 遗留 TBD 定稿)|
+| 遗留 → 本次状态 | **B-227-1(P0 鉴权)→ ❌ 第 3 轮未修**:匿名 `notification/list`、`notification/read`、`search/global` 仍 200(本轮 curl 复验 3/3)|**B-218-1(P0 Bean 撞名)→ ❌ 第 7 轮未修**(`ResourceBeanNameCollisionGuardTest` 1/1 红实测确认)|**B-223-1(lg 429)→ 观察 2/3**:8 红(analyze 2 例转绿,11→8 改善但非全绿)|**B-227-4(251 进程不退出)→ 第 25 轮**|**B-227-3(189 滞后)→ 第 2 轮承袭**(HEAD 仍 `de3aa5e2e`,DIRTY=171)|**B-36 → 第 103 轮**|**B-DX-1 → 第 62 轮**|**G11 → 第 30 轮** |
+| 本次新增 | **G-229-1(P1 行为层缺口)**:S-cfc-387 字典 CRUD 仅契约 8/8 绿,无真实接口/落库/权限行为断言;cfc-web 无对应管理页 |
+| 窗口后置 | 收尾二次 fetch 核验:`origin/cfclub` 仍 `55a0dda69`,跑测期间无新提交 |
+
+---
+
+## 1. 执行总览
+
+| 套件 | R229(本轮·全实测) | R228 | 漂移 |
+|---|---|---|---|
+| 基线 | **`55a0dda69`**(窗口 +1 功能提交 S-cfc-387) | `0087c9018` | **有 src/main 变更(S-cfc-387)** |
+| **后端 · 全量(实跑 53:51)** | **510 类 / 4451 例 / 4158 过 / F278+E11=289 红 / 4 跳** | TBD(未定稿) | **R228 遗留 TBD 定稿;与 R227 退役口径 510/4451 完全一致,红 289 vs 302(-13 契约转绿类)** |
+| 后端 · S-cfc-387 契约 | **`AdminFamilyRelationManageContractTest` 8/8 全绿** ✨ | — | **实现验证通过(原红 8 → 绿 8)** |
+| 浏览器 · admin(本机 live) | 5/5(含在 live 17 例内) | 5/5 | 零漂移 |
+| 浏览器 · admin(**189**) | **5/5 EXIT=0 首跑绿**(1.2m;spec blob `4703d73fb` = 本机) | 首跑 3过2红 → 复验 5/5 | 🟢 **首跑即全绿(好转,B-226-1 观察延续)** |
+| 浏览器 · fe/shop/dx(本机 live) | 15 过 + 2 跳(3.0m;dx 404 承袭 B-DX-1 第 62 轮) | 15+2 跳 | 零漂移 |
+| 浏览器 · health | **13/13**(9.6s,匿名全 401) | 13/13 | 零漂移 |
+| 线上 API(点名 4 文件) | **36 例:33 过 / 0 红 / 3 跳**(47.9s) | 32过/1红/3跳 | 🟢 **SC-T-32 504 瞬态转绿**(R228 复跑 14/14 已证,本轮整文件即绿) |
+| cfc-web Jest | **21 套 134 例:124 过 / 10 红**(21.8s,3 套 FAMILY-WB S1-1 契约预期红) | 21 套 134 例 124/10 | **逐例零漂移** |
+| cfc-frontend Jest | **46 套 660 例:644 过 / 4 红 / 12 跳**(24.0s,AC-R1/R2/AC-2/diet viewKey) | 46 套 660 例 644/4/12 | **逐例零漂移** |
+| 根级黑盒 Jest | **7 过 / 16 红 / 23**(4.1s,全 `ECONNREFUSED 9082`) | 7/16/23 | 一致(B-36 第 103 轮) |
+| **langgraph@251** | **43 例 / 35 过 / 8 红**(114.15s;auto_tag 4 + intent 4 全 429) | 43 例 32/11 | 🔴 **11→8 红(analyze 2 转绿),429 配额窗口波动非产品回归;B-223-1 观察 2/3** |
+| 匿名探针(G8) | **B-227-1 三条 3/3 = 200 ❌**;对照私有接口 family/member/list、growth/record/list **401 正常** | 3/3=200 | **第 3 轮未修** |
+
+**全站合计**:**5382 例 / 5034 过 / 327 红 / 21 跳 = 93.90%**(剔 skip 94.90%)。
+**窗口新增真实缺陷:0**(S-cfc-387 契约 8/8 全绿,红集与 R227 同型;lg 红 11→8 为配额环境波动)。
+
+---
+
+## 2. 执行档与方案假设(无人值守自确认,声明替代提问)
+
+| 项 | 取值 | 依据 |
+|---|---|---|
+| 执行档 | **review(离线白名单)** | 定时自动化预授权;**未装依赖、未联网 SCA/压测、未启停服务、未改 `src/main`、未在远端节点 `reset --hard`** |
+| 后端全量 | **实跑 53:51**(窗口含 src/main 变更 S-cfc-387 → 纪律要求全量实跑,不承采) | 变化轮硬纪律 |
+| 浏览器节点 | 本机(admin/fe/shop/health/dx)+ 189(admin),**每节点单任务串行** | 用户约束 |
+| langgraph | 只派 251(`timeout 520` 兜底,EXIT=124 承袭) | 用户约束 |
+| 联网授权 | 未申请、未执行 | 压测/SCA 属 execute 档 |
+| 结论口径 | 契约前瞻红 / 真实缺陷红 / 僵尸红 **三分列** | 避免把 TDD 前瞻红、删码遗留红混算成产品缺陷 |
+
+---
+
+## 3. 项目画像(窗口增量)
+
+- **定位**:浠艾福(XAF)家庭教育五维能量平台;窗口业务重心 = **S-cfc-387 家庭关系类型字典 CRUD**(SC-A-04 从「无端点载体」补齐管理端字典管理)。
+- **技术栈**:Spring Boot 2.7.18 + MyBatis-Plus + Java 8(9082)|uni-app 小程序(Vue 2)|Vue 2 + Element UI(8082)|FastAPI + LangGraph + ChromaDB(9000 / 测试节点 251)。
+- **关键路径变更(窗口唯一功能提交 `dcac12caf`)**:
+  - `AdminFamilyRelationController` **+88**:`/api/admin/family-relation/types/{list,save,update,disable}` 四端点(类级 admin 前缀 + 角色门禁)。
+  - `FamilyRelationTypeService` **+141**:list(typeKey/typeName 过滤)+ save(重名校验)+ update + disable(引用计数守卫/停用确认)。
+  - 新增 `FamilyRelationType` 实体 + Mapper(`family_relation_types` 字典表)+ **迁移497**(DatabaseInitializer + schema.sql 同步)。
+  - `docs/superpowers/api/API_REFERENCE.md`:SC-A-04 状态改「已补齐管理端字典 CRUD 载体」。
+  - **无前端页面**:cfc-web 无关系类型管理页(行为层/UI 缺口 → G-229-1)。
+- **质量目标(用户口径)**:所有用例覆盖并通过;覆盖全部 SRS 与用户场景(含异常流);SRS/场景变更时同步更新用例。
+- **本轮风险点**:① **S-cfc-387 字典 CRUD 仅契约层覆盖**(8/8 绿),行为层(真实接口/落库/401/403/重名/引用守卫)无自动化(G-229-1);② **B-227-1 匿名 200 ×3 第 3 轮未修**(P0);③ lg 429 观察 2/3;④ B-218-1 Bean 撞名第 7 轮(阻塞上下文级用例)。
+
+---
+
+## 4. 20 类测试覆盖矩阵
+
+| # | 测试类型 | 层次 | 状态 | 证据 |
+|---|---|---|---|---|
+| 1 | 单元测试 | 功能层次 | **已发现** | 后端全量 510 类 / 4451 例(实跑 53:51);web 21 套 134 例;fe 46 套 660 例 |
+| 2 | 覆盖率统计 | 功能层次 | **部分已发现** | 无 JaCoCo;代理口径 373 控制器 / 2408 handler(承 R227) |
+| 3 | 变异测试 | 功能层次 | **未发现** | 无 PIT/Stryker(G-227-4 承袭) |
+| 4 | 静态代码分析 | 功能层次 | **部分已发现** | 编译期门禁(全量编译 0 错);无 SpotBugs/PMD |
+| 5 | 接口 API 测试 | 功能层次 | **已发现** | 线上 4 文件 36 例(33过/0红/3跳);shop 4/4;health 13/13;**S-cfc-387 契约 8/8 全绿** |
+| 6 | 系统/端到端 | 功能保障 | **已发现(实跑)** | 本机 live 15 过 + 2 跳 + 189 admin 5/5 首跑绿 |
+| 7 | 验收测试(UAT) | 功能保障 | **未发现** | 无人工签署(无人值守窗口) |
+| 8 | BDD 规格 | 功能保障 | **未发现** | 全仓 `.feature` = 0 |
+| 9 | 冒烟测试 | 功能保障 | **已发现** | `api-smoke` / admin+fe 主链路 / health 13 例 |
+| 10 | 回归测试 | 功能保障 | **已发现** | web/fe/浏览器/API **逐例零漂移**;后端全量回归 S-cfc-387 |
+| 11 | 探索性测试 | 功能保障 | **部分已发现** | 匿名鉴权探针 8 端点(B-227-1 第 3 轮复验) |
+| 12 | 性能测试 | 非功能 | **未发现(未实测)** | 无压测(execute 档未授权) |
+| 13 | 可靠性测试 | 非功能 | **部分已发现** | lg 服务可用但上游 429(8/43);189 首跑即绿(B-226-1 观察延续) |
+| 14 | 安全测试 | 非功能 | **部分已发现** | `nonfunc-security` 绿(XSS/IDOR/越权 11 例);**匿名 200 ×3 第 3 轮未修(B-227-1)**;无 SAST/SCA |
+| 15 | 兼容性测试 | 非功能 | **部分已发现** | 单 Chromium,无多浏览器矩阵 |
+| 16 | 可用性测试 | 非功能 | **未发现** | 无真实用户可用性数据 |
+| 17 | 无障碍测试 | 非功能 | **未发现** | 无 axe/WCAG 断言 |
+| 18 | QA 流程 | 度量与流程 | **部分已发现** | **G12 台账补 1 份 / 12 TC**(S-cfc-387)+ SC-A-04 映射转 YELLOW |
+| 19 | 质量指标 | 度量与流程 | **部分已发现** | TC 唯一编号 592 / 台账行 1137 / 台账文件 28 / SC 引用 160+12 |
+| 20 | 全项目代码审查 | 度量与流程 | **部分已发现** | 审 1 个功能提交(S-cfc-387 字典 CRUD);未见提示注入 |
+
+---
+
+## 5. 覆盖缺口清单
+
+| # | 缺口 | 现状 | 风险 | 建议测试设计 | 优先级 | 闭环方式 |
+|---|---|---|---|---|---|---|
+| G-229-1 | **S-cfc-387 字典 CRUD 行为层零断言** | 契约 8/8 绿(反射层),list/save/update/disable 无真实接口+落库断言、无 401/403/重名/引用守卫验证;cfc-web 无管理页 | 权限/重名/引用守卫退化不可见 | 按 `2026-11-16-family-relation-type-crud.md` TC-FRT-01~12 补接口行为用例 + admin 管理页 UI 用例 | **P1** | 接口层先补(MockMvc 真库断言),UI 层待 cfc-web 页面落地 |
+| G-227-1 | S-cfc-407 资金行为层零断言(承袭) | 瓜分仅契约层 | 资金错账不可回滚 | TC-WS-21~26 集成环境补行为用例 | **P0** | 集成环境恢复后补跑 |
+| G-227-3 | G8 匿名探针集固定 | 探针 8 端点手工清单 | 新接口鉴权退化不可见(B-227-1 实证) | `auth-coverage.spec.js` 从 `WebConfig` 白名单动态生成 | **P0** | 探针覆盖 `@PostMapping` 全量 |
+| G-227-4 | 变异测试为空 | 无 PIT | 假绿不可识别 | 对 `CfCommissionService` 试点 PIT | P1 | mutation score ≥60% |
+| G-227-5 | 覆盖率无门禁 | 无 JaCoCo | 覆盖变化不可观测 | 接入 JaCoCo 仅采集不阻断 | P1 | CI 产出 `jacoco.xml` |
+| G-227-6 | BDD/UAT/无障碍 全空 | `.feature`=0 | 需求→行为可追溯性弱 | 3 条核心 SC 转 Gherkin | P2 | 先落 feature |
+| G-227-7 | 性能/SCA 未实测 | 需联网授权 | 容量与供应链未知 | 单独申请 execute 档 | P2 | 授权后跑压测 |
+| G-227-8 | CI 清单失真 | 第 30 轮 | 流水线必红或漏拦 | surefire XML 自动生成清单 | **P1** | 双向差集归零 |
+| G-227-9 | 3 类部分僵尸未处置(28 例) | `TeamProfitAdminManageContractTest` 5F/20、`TeamStarMyViewContractTest` 20F/24、`TeamProfitHookContractTest` 3F/7 | 噪声掩真实回归 | 外科式删除「断言已删类」用例 | **P1** | 28 例归零 |
+
+---
+
+## 6. 五要素问题清单
+
+### 问题 1(P0 · 安全/契约 · **第 3 轮未修**)三个私有接口匿名访问返回 200
+
+1. **问题描述**:线上匿名 `POST /api/notification/list` → **200**;`POST /api/notification/read` → **200**;`POST /api/search/global` → **200**。本轮复验仍 3/3 = 200(与 R227/R228 一致),对照私有接口 `family/member/list`、`growth/record/list` 匿名 **401 正常** → 非全局鉴权失效,系这三条路径漏入白名单。
+2. **测试 bug 点**:`JwtInterceptor.java:226-243`(无 token 且非 `LOGIN_REQUIRED_PATHS` → 匿名放行 userId=-1)+ `UserNotificationController.java:34,65` + `SearchController.java`。
+3. **最优修改方案**:三条路径加入 `JwtInterceptor.LOGIN_REQUIRED_PATHS`;`read` 再加「id 归属校验」(非本人 → 404/403)。
+4. **修改目的**:消除「匿名假成功」口径漂移,恢复鉴权契约一致。
+5. **能否闭环**:能。复测方式:匿名 curl 三端点期望 401;通过标准 = 匿名 3/3 = 401 且 `NotificationCenterViewContractTest` 9 + `GlobalSearchScP82ContractTest` 5 保持全绿。
+
+### 问题 2(P0 承袭 · 第 7 轮未修)`CoachRecommendService` `@Resource` Bean 名撞名
+
+1. **问题描述**:`ResourceBeanNameCollisionGuardTest` 1/1 红(本轮全量实测确认):`CoachRecommendService` 字段 `dimensionScoreService` 命中 Bean「dimensionScoreService」(类型 `DimensionScoreService`)→ 运行期 `BeanNotOfRequiredTypeException` 阻断上下文启动。窗口 S-cfc-387 未触及该类。
+2. **测试 bug 点**:`CoachRecommendService.java:71-72`。
+3. **最优修改方案**:字段改名或显式 `@Resource(name=...)`。
+4. **修改目的**:解除上下文启动级阻断。
+5. **能否闭环**:能。通过标准 = 守卫 1/1 绿。
+6. **附注(度量)**:守卫单例 ~210s,建议加缓存/ArchUnit。
+
+### 问题 3(P1 · 负债 · 承袭)S-cfc-409 删码遗留 3 类部分僵尸 / 28 例假红
+
+1. **问题描述**:`TeamProfitAdminManageContractTest`(5F/20)、`TeamStarMyViewContractTest`(20F/24)、`TeamProfitHookContractTest`(3F/7) 仍断言已删生产类 → 本轮稳定产 28 例假红(全量红 289 中含)。
+2. **测试 bug 点**:同 R227/R228。
+3. **最优修改方案**:删除「断言已删类」用例,保留存活断言;或拆 `*RemovedGuard` + 存活子集。
+4. **修改目的**:红集降至真实值,避免噪声淹没 S-cfc-387 回归信号。
+5. **能否闭环**:能(测试侧可自处置,下轮执行)。
+
+### 问题 4(P1 · 环境 · 承袭)189 节点代码滞后 / B-227-3
+
+1. **问题描述**:189 `HEAD=de3aa5e2e` vs `origin/cfclub=55a0dda69`(落后 ≥9 提交含 S-cfc-387);`DIRTY=171`。本轮 admin **5/5 首跑即绿**(1.2m,spec blob `4703d73fb` = 本机可比),B-226-1 观察延续但节点代码不同源风险仍存。
+2. **最优修改方案**:清理节点脏改动并同步远端;部署回执增加「节点 HEAD = 远端头」核对。
+3. **能否闭环**:能。通过标准 = 节点 HEAD == 远端头 且 0 脏,连续 2 轮。
+
+### 问题 5(P1 · 工具 · 第 25 轮)251 pytest 进程不退出
+
+1. **问题描述**:summary 在 **114.15s** 已产出 `8 failed, 35 passed`,进程仍挂至 520s 被 `timeout -k 10` 杀 → `EXIT=124`(B-177-1/B-218-10 同源,修法未落地)。
+2. **最优修改方案**:产品侧 `await client.aclose()`;测试侧 `pytest_sessionfinish` 强制退出。
+3. **能否闭环**:能。通过标准 = 连续 2 轮 `EXIT=0` 且 summary 完整。
+
+### 问题 6(P2 · 环境 · 观察 2/3)langgraph 8 红全为上游 429
+
+1. **问题描述**:43 例 8 红全 `RateLimitError 429 AgnesAI free users quota`(auto_tag 4 + intent 4);analyze 2 例随配额窗口转绿 → 11→8 改善。R226 曾 43/43,R227 起连续复发 → **观察 2/3(未达连续 2 轮全绿销号线)**。
+2. **最优修改方案**:测试环境独立/付费额度;LLM 用例打 `@pytest.mark.llm`,CI 默认 `-m "not llm"`。
+3. **能否闭环**:能。通过标准 = 默认档 43/43 连续 2 轮全绿(或 llm 档隔离后默认档全绿)。
+
+### 问题 7(P1 · 度量 · 第 30 轮)CI `BACKEND_OBSERVED_CLASSES` 失真
+
+1. **问题描述**:`.gitlab-ci.yml:61` 清单 33 类 vs 本轮实测红类 **58** → 漏拦 + 陈旧双向失真。
+2. **最优修改方案**:由 surefire XML 自动生成清单,或契约前瞻类打 `@Tag("forward-contract")`。
+3. **能否闭环**:能。通过标准 = 双向差集均为 0。
+
+### 问题 8(P1 · 度量 · 承袭)G8 匿名探针集固定
+
+1. **问题描述**:探针硬编码未随接口增长,B-227-1 每轮靠手工扩样才发现。
+2. **最优修改方案**:`auth-coverage.spec.js` 从 `WebConfig.excludePathPatterns` 动态生成探针。
+3. **能否闭环**:能。通过标准 = 白名单外 0 个 200。
+
+### 问题 9(P2 · 测试资产 · 承袭)web Jest 双口径
+
+1. **问题描述**:主工作区 21 套 134 例(含 3 个未入库 spec,+13 例)vs 干净口径 18 套 121 例;红集相同(第 8 轮)。
+2. **最优修改方案**:入库 3 个 spec(或删除);报告固定主工作区口径。
+3. **能否闭环**:能。通过标准 = 连续 2 轮例数一致且 `git status` 无未入库 spec。
+
+---
+
+## 7. 域结论表
+
+| 审查维度 | 负责专家 | 结论 | 关键证据 |
+|---|---|---|---|
+| 单元·组件级 | 苏雅 | **有条件通过** | 后端全量 510/4451(F278+E11);**S-cfc-387 契约 8/8 全绿**;红 289 与 R227 同型(-13 契约转绿) |
+| 集成·接口级 | 柯砚 | **有条件通过** | 线上 API 36 例 33过/0红/3跳(SC-T-32 转绿);**匿名 200 ×3 未修(P0 第 3 轮)** |
+| 系统·验收级 | 白樾 | **有条件通过** | 本机 15 过 + 2 跳 + 189 首跑 5/5;无 UAT 签署、无 BDD |
+| 测试保障级 | 闻朔 | **有条件通过** | 冒烟/回归齐备且逐例零漂移;G8 探针集样本偏差承袭 |
+| 性能·可靠性 | 骆骋 | **未实测** | 压测未授权;lg 8/43 红全 429(上游配额,观察 2/3) |
+| 安全 | 关屿 | **不通过** | **匿名 200 ×3(B-227-1 第 3 轮未修)**;`nonfunc-security` 11 例全绿 |
+| 兼容·体验 | 阮清 | **部分未实测** | 单 Chromium;无 axe/WCAG |
+| 流程·度量·代码 | 何序 | **有条件通过** | G12 台账补 1 份 12 TC + SC-A-04 转 YELLOW;G11 失真第 30 轮;僵尸 28 例承袭 |
+
+---
+
+## 8. 门禁结论
+
+| 门禁 | 结论 | 依据 |
+|---|---|---|
+| **G1 通过率** | ⚠️ **93.90%** | 全站 5382/5034(剔 skip 94.90%;剔契约前瞻至 99.3% 级)|
+| **G2 真实缺陷红** | ❌ **不通过** | 存量 16 + 删码遗留 28 + 守卫 1(B-218-1)= 45;**窗口新增真实缺陷 0** |
+| **G3 前端 Jest** | ⚠️ **有条件** | web 124/10(同 R228 型);fe 644/4/12(逐例零漂移)|
+| **G4 可构建** | ✅ **通过** | 全量编译 0 错;test-compile 随全量验证(BUILD FAILURE 仅为测试红)|
+| **G5 全类可判** | ✅ **通过** | 510 类 ↔ 510 XML 全覆盖无沉默 |
+| **G6 不回归** | ✅ **通过** | web/fe/浏览器/API 逐例零漂移;后端红集与 R227 同型(-13 为契约转绿)|
+| **G7 AI 域** | ❌ **不通过** | lg 35/43(8 红全 429 环境型;观察 2/3)|
+| **G8 鉴权契约** | ❌ **不通过** | **匿名 3/3 = 200(P0 第 3 轮)**;对照私有接口 401 正常 |
+| **G9 覆盖率** | ⚠️ **部分** | 无 JaCoCo;代理口径 |
+| **G10 节点覆盖** | ✅ **通过** | 本机 + 189(5/5 首跑绿)+ 251(lg 43 例)|
+| **G11 CI 门禁** | ❌ **不通过** | 第 30 轮失真(33 类 vs 实测 58)|
+| **G12 SRS 同步** | ✅ **通过** | 窗口 `specs/` 零文本变更;**补台账 1 份 / 12 TC**(S-cfc-387)+ SC-A-04 映射转 YELLOW |
+| **G13 零漂移** | ✅ **通过** | 存量真实缺陷逐类一致(第 39 次)|
+| **G14 场景映射** | ⚠️ **部分** | SC 152 / 台账引用 198(唯一)→ 用例层可达;行为级映射待 G-229-1/G-227-1 |
+
+### 裁决:**不通过(预期)**
+
+**阻塞项(按优先级)**:
+1. **B-227-1(P0 安全)**:3 个私有接口匿名 200,**第 3 轮未修**。
+2. **B-218-1(P0 承袭)**:`CoachRecommendService` Bean 撞名,**第 7 轮未修**。
+3. **G-227-1(P0 资金)**:S-cfc-407 资金行为层零断言。
+4. **G-229-1(P1 新增)**:S-cfc-387 字典 CRUD 行为层零断言。
+
+**复评条件**:① 问题 1 修复后匿名 3/3 = 401 且契约 14/14 绿;② 问题 2 守卫转绿;③ 问题 3 剩余 28 例僵尸归零;④ 问题 7 CI 清单双向差集归零;⑤ lg 429 连续 2 轮不复发;⑥ G-229-1 行为层用例补跑全绿。
+
+---
+
+## 附录 A:本轮命令(可复现)
+
+```bash
+# 基线(HTTP 通道;SSH publickey 长期失效)
+git fetch origin cfclub && git merge --ff-only origin/cfclub   # → 55a0dda69(窗口 S-cfc-387)
+
+# 后端全量(JDK 1.8.0_25 / mvn 3.9.9 / 离线)—— 变化轮实跑 53:51
+cd cfc-backend && mvn -o -B clean test > .r229/backend_full.log 2>&1
+# → 510 类 / 4451 例 / F278+E11=289 红 / 4 跳;AdminFamilyRelationManageContractTest 8/8 绿
+
+# 浏览器(每节点单任务串行)
+cd tests && node node_modules/@playwright/test/cli.js test -c playwright.config.live.js --output=../.r229/browser_live      # 15 过 + 2 跳(3.0m)
+cd tests && node node_modules/@playwright/test/cli.js test -c playwright.config.health.js --output=../.r229/browser_health # 13/13(9.6s)
+node .tdd/_dispatch_R229_189_admin.cjs                          # 189 admin 5/5 首跑绿(1.2m)
+node .tdd/_dispatch_R229_251_lg.cjs                             # 251 lg pytest 43 例 35过/8红(114.15s)
+
+# 线上 API 点名 4 文件(36 例:33过/0红/3跳,SC-T-32 转绿)
+cd tests && node node_modules/@playwright/test/cli.js test -c playwright.config.api.js \
+  tests/e2e/api/api-smoke.spec.js tests/e2e/api/dimension-energy-contract.spec.js \
+  tests/e2e/api/nonfunc-security.spec.js tests/e2e/api/nonfunc-perf-compat.spec.js
+
+# Jest
+cd cfc-web && node node_modules/jest/bin/jest.js --ci --silent        # 21 套 134 例 124/10(21.8s)
+cd cfc-frontend && node node_modules/jest/bin/jest.js --ci --silent   # 46 套 660 例 644/4/12(24.0s)
+cd d:/cfc && node tests/node_modules/jest/bin/jest.js -c tests/jest.config.js  # 根级 7/16/23(4.1s)
+
+# G8 匿名鉴权探针(B-227-1 复验第 3 轮)
+curl -X POST -H 'Content-Type: application/json' -d '{}' http://cfc.iwintrue.com/api/notification/list    # 200 ❌
+curl -X POST -H 'Content-Type: application/json' -d '{}' http://cfc.iwintrue.com/api/notification/read    # 200 ❌
+curl -X POST -H 'Content-Type: application/json' -d '{}' http://cfc.iwintrue.com/api/search/global        # 200 ❌
+```
+
+## 附录 B:交付物
+
+- `docs/tdd/orchestration/report-test-2026-11-16-R229.md`(本报告)
+- `tests/test-cases/2026-11-16-family-relation-type-crud.md`(G12 台账,12 TC)
+- `docs/tdd/orchestration/sc-key-map.md`(SC-A-04 RED → YELLOW)
+- `docs/tdd/test/blockers.md`(R229 段)
+- `notification-2026-11-16-R229-研发通知.md`(结果有变化 → 通知研发)

+ 1 - 1
docs/tdd/orchestration/sc-key-map.md

@@ -32,7 +32,7 @@ SC-G-02 / SC-G-06 / SC-P-03 / SC-P-10 / SC-P-11 共 5 个 SC 已于 2026-11-06 O
 | SC-A-01 | 平台运营 | 业务域 L:交易延伸 / 内容 / 多端 | 管理端登录 + 全局统计 | admin.auth.login | GREEN | 未跑通 | 键已 GREEN(admin-auth R5);全局统计载体 AdminController /api/admin/users |
 | SC-A-02 | 平台运营 | 业务域 L:交易延伸 / 内容 / 多端 | 报告解析中台(类型/聚类) | admin.reportParser.manage | RED | 未跑通 | S-cfc-197;ReportParserAdminController /api/admin/report-parser |
 | SC-A-03 | 平台运营 | 业务域 L:交易延伸 / 内容 / 多端 | 文章发布-审核 | admin.article.manage | RED | 未跑通 | S-cfc-201;AdminArticleController /api/admin/articles(22 方法)|
-| SC-A-04 | 平台运营 | 业务域 L:交易延伸 / 内容 / 多端 | 关系类型 CRUD | admin.familyRelation.manage | RED | 未跑通 | S-cfc-308;真缺口已立项:需新增 AdminFamilyRelationController(关系类型 CRUD),当前仅只读评分,实现待定 |
+| SC-A-04 | 平台运营 | 业务域 L:交易延伸 / 内容 / 多端 | 关系类型 CRUD | admin.familyRelation.manage | YELLOW | 未跑通 | S-cfc-387(2026-11-16 `dcac12caf` 合入):AdminFamilyRelationController /api/admin/family-relation/types/{list,save,update,disable} + FamilyRelationTypeService(family_relation_types 字典表,迁移497);契约 AdminFamilyRelationManageContractTest 8/8 绿;行为层/UI 三类流待补 |
 | SC-A-05 | 平台运营 | 业务域 L:交易延伸 / 内容 / 多端 | 勋章配置 CRUD | admin.badge.manage | RED | 未跑通 | S-cfc-206;BadgeController /api/badges(create/update/delete/grant)|
 | SC-A-06 | 平台运营 | 业务域 L:交易延伸 / 内容 / 多端 | 供应商管理 | admin.supplier.manage | RED | 未跑通 | S-cfc-200;AdminSupplier/EcomSupplier/SupplyManageController |
 | SC-A-07 | 平台运营 | 业务域 L:交易延伸 / 内容 / 多端 | 活动配置 | admin.activity.config | RED | 未跑通 | S-cfc-203;AdminActivityController + Checkin/Registration |

+ 18 - 0
docs/tdd/test/blockers.md

@@ -1733,3 +1733,21 @@
 | **G11(第 28 轮 · P1)** | CI 排除清单失真 | 研发 | `.gitlab-ci.yml:61` 清单 **33 类** vs 实测红类 **66** → **漏拦 59 / 陈旧 26**(含真红 `UserServiceWechatLoginTest`、`WebConfigGrowthExcludeRemovedTest`、`ResourceBeanNameCollisionGuardTest`)。建议由 surefire XML 自动生成,或契约前瞻类打 `@Tag("forward-contract")` | 研发 | 2026-11-16 07:25 | 待处理 |
 | **B-208-1(改善)** | 189 DNS 落公网 / 502 | 运维 | 189 admin **5/5 EXIT=0**(1.3m)→ 服务恢复可用 | 测试 | 2026-11-16 07:25 | 改善(需配合 B-227-3 同步代码) |
 | **R227 段 · 门禁** | 后端 515 类/4507 例 91.86% · 全站 5438/5013=92.18% | 测试 | **不通过**。✅G4 test-compile SUCCESS / G5 515-515 XML / G6 逐例零漂移 / G10 本机+189+251 / G12 台账补 2 份 41 TC / G13 第 37 次零漂移;⚠️G1 91.86%(退役后 93.13%,剔前瞻 98.83%)/ G3 web 124-10 / G9 代理 / G14;❌**G2 真实缺陷红 45**(存量 16 + 删码遗留 28 + 守卫 1)/ **G7 32-43(11×429)** / **G8 匿名 200×3** / **G11 漏拦 59**。阻塞:B-227-1(P0)、B-218-1(P0 承袭)、G-227-1 资金行为层 | 测试 | 2026-11-16 07:25 | 不通过 |
+
+## R229 段(2026-11-16 09:05~10:07,基线 `origin/cfclub` `55a0dda69`,窗口 6 提交含 **S-cfc-387 src/main 变更**)
+
+> 窗口提交:`6e3530387`(docs S-cfc-408 三验) → `584ce81f5`(bump) → `dcac12caf`(**feat S-cfc-387 关系类型字典 CRUD**) → `0ead793df`/`475d56130`(merge task/S-cfc-387) → `55a0dda69`(bump)。**变化轮**:后端全量实跑 53:51,禁承采。
+
+| 编号 | 关联键/对象 | 类型 | 描述与处置 | 经办 | 登记时间 | 状态 |
+|---|---|---|---|---|---|---|
+| **B-227-1(第 3 轮 · P0)** | `/api/notification/{list,read}`、`/api/search/global` | 研发 | **匿名(无 token)仍 3/3 = 200 未修**(本轮 curl 复验:list 200 / read 200 / search 200;对照私有接口 family/member/list、growth/record/list 401 正常)。修法不变:三条路径加入 `JwtInterceptor.LOGIN_REQUIRED_PATHS` + read 归属校验 | 测试(R229 实派) | 2026-11-16 09:40 | 待处理(第 3 轮) |
+| **B-218-1(第 7 轮 · P0 承袭)** | `CoachRecommendService` Bean 撞名 | 研发 | `ResourceBeanNameCollisionGuardTest` **1/1 红**(本轮全量实测确认,窗口 S-cfc-387 未触及该类) | 研发 | 2026-11-16 09:40 | 待处理(第 7 轮) |
+| **B-223-1(观察 2/3 延续)** | langgraph 429 配额 | 环境 | R229 43 例 **35 过 / 8 红**(114.15s;analyze 2 例随配额窗口转绿,auto_tag 4 + intent 4 仍 429)→ 较 R228 11 红改善但**未连续 2 轮全绿**,观察延续 **2/3** | 测试(251 实派) | 2026-11-16 09:40 | 观察中(2/3) |
+| **B-227-4(第 25 轮 · P1)** | 251 pytest 进程不退出 | 研发/环境 | summary 114.15s 已出 `8 failed, 35 passed` 仍被 `timeout 520` 杀 → `EXIT=124`;`await client.aclose()` 修法未落地 | 研发 | 2026-11-16 09:40 | 待处理 |
+| **B-227-3(第 2 轮 · P1)** | 189 节点代码滞后 | 运维 | 节点 `HEAD=de3aa5e2e` vs `origin/cfclub=55a0dda69` 落后 ≥9 提交;`DIRTY=171`;本轮 admin **5/5 EXIT=0 首跑绿**(spec blob `4703d73fb` = 本机可比) | 运维 | 2026-11-16 09:40 | 待处理 |
+| **B-36(第 103 轮 · P2)** | 根级黑盒 16 红 | 测试 | 7 过 / 16 红 / 23,全 `ECONNREFUSED 127.0.0.1:9082`(本机后端未起) | 测试 | 2026-11-16 09:40 | 待处理 |
+| **B-DX-1(第 62 轮 · P1)** | dx-bridge 端点 404 | 部署/研发 | 2 跳(规格「仅登记不实现」) | 部署/研发 | 2026-11-16 09:40 | 待处理 |
+| **G11(第 30 轮 · P1)** | CI 排除清单失真 | 研发 | `.gitlab-ci.yml:61` 33 类 vs 实测红类 58 → 漏拦/陈旧双向失真 | 研发 | 2026-11-16 09:40 | 待处理 |
+| **G-227-1(承袭 P0)** | S-cfc-407 资金行为层零断言 | 测试 | 仍无行为层;本轮 S-cfc-387 同类缺口已登记 G-229-1 一并推进 | 测试 | 2026-11-16 09:40 | 待补 |
+| **G-229-1(新增 P1)** | S-cfc-387 字典 CRUD 行为层零断言 | 测试 | 契约 8/8 绿但 list/save/update/disable 无真实接口+落库断言、无 401/403 验证;cfc-web 无关系类型管理页(纯后端合入) | 测试 | 2026-11-16 09:40 | 待补 |
+| **R229 段 · 门禁** | 后端 510 类/4451 例 · 全站 5382/5034=93.90% | 测试 | **不通过**。✅G3 web 124/10 + fe 644/4/12 逐例零漂移 / G4 编译 0 错 / G5 510 XML / G6 存量红同型 / G10 本机+189+251 / **G12 台账补 1 份 12 TC(S-cfc-387)+ SC-A-04 映射转 YELLOW** / G13 第 39 次;⚠️G1 93.90%(剔 S=94.90%,剔前瞻 99.3% 级)/ G9 / G14;❌G2 真实缺陷红 45(存量 16+28+1,**窗口新增 0**)/ G7 35/43(8×429)/ G8 匿名 200×3(B-227-1 第 3 轮)/ G11 | 测试 | 2026-11-16 10:07 | 不通过 |

+ 27 - 0
docs/tdd/test/notice-R229-2026-11-16-研发通知.md

@@ -0,0 +1,27 @@
+# 研发通知 R229(2026-11-16 10:07 GMT+8)
+
+## 变更概览
+
+本轮为**变化轮**:窗口 `55a0dda69` 含 **S-cfc-387 关系类型字典 CRUD**(`dcac12caf`,src/main 变更),测试结果与 R228 相比**有变化**,特此通知。
+
+## 需要研发关注
+
+| # | 项 | 详情 | 优先级 |
+|---|---|---|---|
+| 1 | **B-227-1 匿名 200 ×3(第 3 轮未修)** | `POST /api/notification/list`、`/api/notification/read`、`/api/search/global` 匿名请求仍返回 **200**(假成功)。修法:三条路径加入 `JwtInterceptor.LOGIN_REQUIRED_PATHS`;`read` 补 id 归属校验。复验:匿名 3/3=401 且契约 `NotificationCenterViewContractTest` 9 + `GlobalSearchScP82ContractTest` 5 保持全绿 | **P0** |
+| 2 | **B-218-1 Bean 撞名(第 7 轮未修)** | `CoachRecommendService.java:71-72` 字段 `dimensionScoreService` 命中 Bean 撞名 → `ResourceBeanNameCollisionGuardTest` 1/1 红(阻塞上下文级用例启动)。修法:字段改名或 `@Resource(name=...)` | **P0** |
+| 3 | **S-cfc-387 验证通过** | 契约 `AdminFamilyRelationManageContractTest` **8/8 全绿** ✅;后端全量 510 类 4451 例 289 红,红集与 R227 同型(窗口新增真实缺陷 0)| 知会 |
+| 4 | **G-229-1 行为层缺口(新)** | S-cfc-387 仅契约层覆盖,list/save/update/disable 无真实接口/落库/401 行为断言;cfc-web 无关系类型管理页。测试侧将补接口行为用例,UI 页待研发评估 | P1 |
+| 5 | **langgraph 429(观察 2/3)** | 43 例 8 红全为 AgnesAI free quota 429(analyze 2 例转绿)。建议测试环境独立额度或 LLM 用例隔离 | P1 |
+| 6 | **CI 失真(第 30 轮)** | `.gitlab-ci.yml:61` `BACKEND_OBSERVED_CLASSES` 33 类 vs 实测红类 **58**,漏拦+陈旧双向失真 | P1 |
+
+## 测试侧行动(无需研发)
+
+- S-cfc-387 台账 12 TC 已入库(`tests/test-cases/2026-11-16-family-relation-type-crud.md`);SC-A-04 场景映射转 YELLOW
+- 僵尸 28 例(TeamProfit 系 3 类)下轮外科式裁剪
+
+## 复评条件(满足即转「有条件通过」)
+
+① B-227-1 匿名 3/3=401;② B-218-1 守卫转绿;③ 僵尸 28 例归零;④ CI 清单双向差集归零;⑤ lg 429 连续 2 轮不复发;⑥ G-229-1 行为层补跑全绿。
+
+— 测试负责人 陆谨(R229 闭环)

+ 49 - 0
tests/test-cases/2026-11-16-family-relation-type-crud.md

@@ -0,0 +1,49 @@
+# 2026-11-16 功能新增专项用例(家庭关系类型字典管理 CRUD,SC-A-04)
+
+> 本文件为 **G12 场景落地→测试用例** 的派生产物,对应窗口 `0087c9018..dcac12caf` 新合入功能:
+> - **S-cfc-387 `admin.familyRelation.manage`(SC-A-04 家庭关系类型字典管理)**:新增 `AdminFamilyRelationController`(类级 `/api/admin/family-relation`)+ `FamilyRelationTypeService`,管理端对关系类型字典 `family_relation_types` 提供 list/save/update/disable 四操作。
+>   - `POST /api/admin/family-relation/types/list`:可选 `typeKey/typeName` 过滤返回类型字典。
+>   - `POST /api/admin/family-relation/types/save`:新增类型(`typeKey/typeName/label/description/sortOrder`);**重名校验**(同 key 或同 name 重复 → 拒绝)。
+>   - `POST /api/admin/family-relation/types/update`:编辑类型(`id + typeName/label/description`)。
+>   - `POST /api/admin/family-relation/types/disable`:停用类型;**引用计数守卫**(`family_relationships` 仍引用 → 需确认/拒绝停用),并带停用确认守卫。
+> - 迁移497:`CREATE TABLE IF NOT EXISTS family_relation_types`(id/type_key/type_name/label/description/sort_order/enabled/reference_count/created_at/updated_at),schema.sql 同步。
+> - 契约登记:`docs/superpowers/api/API_REFERENCE.md` §4.13 admin 端点目录 + SC-A-04 状态由「无端点载体」改为「已补齐管理端字典 CRUD 载体」(2026-11-16 更新,提交 `dcac12caf`)。
+>
+> **派生策略**:契约锚点复用 API_REFERENCE §4.13;三流齐备(正常 / `-E` 异常 / `-P` 权限)。
+> **执行状态**:契约层 8 例由 `AdminFamilyRelationManageContractTest`(380 行)实跑 **8/8 全绿**(实现提交自带声明,R229 后端全量复核);行为级用例待集成环境执行(G-227-1 同类资金/行为层缺口模式)。
+
+---
+
+## 一、关系类型字典 CRUD 契约用例(`/api/admin/family-relation/types/*`,SC-A-04)
+
+| TC 编号 | 环节 | 角色 | 优先级 | 类型 | 前置条件 | 测试步骤 | 预期结果 | 关联契约 |
+|---|---|---|---|---|---|---|---|---|
+| TC-FRT-01 | 列表查询 | 管理员 | P0 | 功能 | 字典存在多条类型 | 1. `POST /api/admin/family-relation/types/list {}` | 200;`data[]` 返回全部启用类型(含 id/typeKey/typeName/label/sortOrder) | §4.13 S-cfc-387 |
+| TC-FRT-02 | 过滤查询 | 管理员 | P1 | 功能 | 存在 typeKey/typeName 可过滤 | 1. `{ "typeKey": "father" }` 或 `{ "typeName": "父亲" }` | 200;仅返回命中条目(模糊/精确随实现,不 5xx) | §4.13 |
+| TC-FRT-03 | 新增类型 | 管理员 | P0 | 功能 | 字典无同 key/同 name | 1. `{ "typeKey": "uncle", "typeName": "叔叔", "label": "叔叔", "description": "父亲兄弟", "sortOrder": 10 }` | 200;`data` 含新 id;落库 `family_relation_types` | §4.13 |
+| TC-FRT-04 | 编辑类型 | 管理员 | P0 | 功能 | 存在 id 类型 | 1. `{ "id": N, "typeName": "伯父", "label": "伯父" }` | 200;`data.typeName/label` 更新;其他字段不变 | §4.13 |
+| TC-FRT-05 | 停用类型 | 管理员 | P0 | 功能 | 类型无任何家庭关系引用 | 1. `{ "id": N }` | 200;`data.enabled=0`;列表不再返回该类型(或按实现保留标 disabled) | §4.13 |
+| TC-FRT-06-E | 重名新增拒绝 | 管理员 | P1 | 异常 | 已存在同 typeKey 或同 typeName | 1. 再次 `save` 相同 typeKey/typeName | 非 200 成功(错误码/提示重名);**不产生第二条**同 key/同 name 记录 | §4.13 |
+| TC-FRT-07-E | 引用中停用守卫 | 管理员 | P1 | 异常 | 该类型被 `family_relationships` 引用(referenceCount>0) | 1. `disable { "id": N }` | 拒绝停用(提示被引用/需确认),`enabled` 保持 1 | §4.13 |
+| TC-FRT-08-E | 无效 id 编辑/停用 | 管理员 | P1 | 异常 | id 不存在 | 1. `update/disable { "id": 99999999 }` | 非 200 成功(404/错误码),不落库 | §4.13 |
+| TC-FRT-09-P | 非管理员拒绝 | 家长/游客 | P0 | 权限 | token 为家长角色或无 token | 1. 任意 types/* 操作 | 403(非 admin 角色)或 401(无 token);不得以 `role != admin` 成功写库 | §4.13 |
+| TC-FRT-10-P | admin 前缀门禁 | 管理员 | P1 | 权限 | 契约登记 | 1. 核对 `AdminFamilyRelationController` | 类级路径以 `/api/admin/` 开头,受 JwtInterceptor 角色拦截 | §4.13 |
+
+---
+
+## 二、数据模型用例(迁移497)
+
+| TC 编号 | 环节 | 角色 | 优先级 | 类型 | 前置条件 | 测试步骤 | 预期结果 | 关联契约 |
+|---|---|---|---|---|---|---|---|---|
+| TC-FRT-11 | 字典表结构 | 管理员 | P1 | 功能 | 后端已启动(迁移幂等) | 1. 重复启动/执行迁移 | `family_relation_types` 存在;字段含 type_key/type_name/enabled/reference_count;**重复执行无异常(幂等)** | 迁移497 |
+| TC-FRT-12 | 迁移幂等 | 管理员 | P2 | 功能 | 迁移已应用 | 1. DatabaseInitializer 再次 runMigrations | 不报「table exists」类错误 | 迁移497 |
+
+---
+
+## 三、自动化映射
+
+| TC 范围 | 自动化资产 | 状态 |
+|---|---|---|
+| TC-FRT-01~12 | `AdminFamilyRelationManageContractTest`(8 例:controller 载体 / list / save / update / disable / 重名拒绝 / 引用守卫 / admin 前缀门禁) | **8/8 全绿**(实现提交声明,R229 后端全量复核) |
+| 行为级(真实接口 + 落库断言 + 权限 401/403) | 待补接口行为用例(当前仅契约反射层) | 待补(P1,随 G-227-1 行为层缺口一并处理) |
+| 管理端 UI(Web 关系类型管理页) | cfc-web 管理页入口用例 | 待补(P2) |