ソースを参照

test(R223): 测试闭环汇报 — 双URL浏览器11/11全绿+可验证子集95.20%+后端可构建+新增3能力键派生24用例+lg429环境红

E2E Test Bot 2 日 前
親
コミット
c1f20bc2a4

+ 171 - 0
docs/tdd/orchestration/report-test-2026-11-16-R223.md

@@ -0,0 +1,171 @@
+# 测试负责人工作汇报 R223(2026-11-16 00:29 GMT+8 · 自动化闭环)
+
+> 测试负责人:陆谨(软件测试专家团 · 测试架构师 / cfc-tester)|执行档:**review(离线白名单)+ 内网浏览器 E2E(三节点实跑)+ 远程节点派发(251 langgraph / 189 admin)**|静默无人值守,全程未提问
+> 基线:`origin/cfclub` **`3ff62e324`**(HTTP 通道 fetch,SSH 失效 B-203-3 承袭);本地 HEAD `6c8ac19cc`(R220)。窗口 `c582cdb16..3ff62e324` **+28 提交**,含 **src/main 变更**(S-cfc-402 receiptTimeout / S-cfc-403 review.detail / S-cfc-404 review.my / S-cfc-397 teamshare RED / 家庭切换迁移 fix / admin 密度四期)
+> **本轮头条:① 用户指定双 URL 浏览器 E2E 全绿 —— admin 5/5 + frontend 6/6(本机)+ admin 5/5(189 交叉,spec 同版 `4703d73fb`);② 可验证子集 895 例 / 852 过 / 22 红 / 21 跳 = 95.20%(剔 skip 97.48%);③ 后端 test-compile BUILD SUCCESS(515 测试源文件,3m58s,窗口 src 变更可构建);④ 251 langgraph 31 过 / 8 红(125.61s,8 红全为 AgnesAI 429 免费配额耗尽,环境型非回归);⑤ G12:窗口新增 3 能力键(shop.review.detail/my / receiptTimeout)→ **已派生 24 条行为级用例**入册;⑥ 覆盖台账刷新 5740 例,场景 L3 归集 47/247。**
+
+---
+
+## 0. 历史审查记录(对照,非本次结论依据)
+
+| 项 | 内容 |
+|---|---|
+| 上次审查 | **R222(2026-11-15 21:25)**,结论「不通过(有条件)」;基线 c582cdb16;lg@251 40/43(3 红 429)、health 首跑 13/13、189 admin 5/5、全站 92.32%(剔 352 预期红 99.31%) |
+| 本次 | **第 223 轮,非首次审查**(本机 memory 停在 R220,仓库实际已到 R222;本轮以 git 真相为基线,重新取证全部套件) |
+| 历史遗留 → 本次状态 | B-218-1(P0 Bean 撞名)→ 承采(窗口零守卫变更);B-218-2(支付开关)→ 承采;B-218-3(线上 502)→ 本轮 health 首跑即 13/13 未复现(观察延续);B-216-3/B-220-1(lg 上游 429)→ **本轮复现 8 红**(环境型,观察延续);B-36(本机 9082 未起)→ 承采(根级 7/16);B-DX-1(dx 2 跳 404)→ 本轮 2 跳(承袭);B-138-2(189 spec 落后)→ **本轮好转**(189 spec blob `4703d73fb` = 本机同版) |
+| 本次新增 | **B-223-1(P1 环境型)** langgraph 8 红(AgnesAI `429 free users rate limit` 致 auto_tag×4 + chat×1 + intent×3);**B-223-2(P2 工具)** 251 首派 `| tail -80` 管道致日志缓冲为空 + 进程挂起 12min(B-218-10 同源),改用无管道 `timeout` 直写日志后 125.61s 取回完整结果 |
+
+> 历史记忆只作对照:本轮**全部套件重新取证**(三节点浏览器、两套 Jest、lg@251 shell 直读、线上 API、后端 test-compile、台账刷新)。后端全量/根级按纪律承采并明确标注「未实测」,不写通过。
+
+---
+
+## 1. 执行总览
+
+| 套件 | R223(本轮) | R222(上轮) | 漂移 |
+|---|---|---|---|
+| 基线 | `3ff62e324`(窗口 +28 提交,**含 src/main 变更**) | `c582cdb16`(窗口 4 提交,零 src 变更) | 窗口含功能变更 |
+| 浏览器 E2E · admin(本机) | **5/5**(2.3m) | 5/5 | 实跑一致 |
+| 浏览器 E2E · frontend(本机) | **6/6**(48.5s) | 6/6 | 一致 |
+| 浏览器 E2E · admin(189) | **5/5 EXIT=0**(1.2m,spec 同版同跑) | 5/5 | **spec blob 同版 `4703d73fb`**(B-138-2 好转) |
+| 浏览器 E2E · shop-api | **4/4**(5.7s) | 4/4 | 一致 |
+| 浏览器 E2E · health | **13/13 首跑即全绿**(6.0s) | 13/13 首跑全绿 | 一致(B-218-3 未复现) |
+| 浏览器 E2E · dx-bridge | **2 跳**(404,第 57 轮) | 2 跳 | 一致 |
+| 线上 API(点名 4 文件) | **25 过 / 0 红 / 7 跳 / 32**(21.5s) | 25/0/7 | 一致 |
+| cfc-web Jest | **124 过 / 10 红 / 134**(21 套,56.0s) | 124/10/134 | **逐例零漂移** |
+| cfc-frontend Jest | **644 过 / 4 红 / 12 跳 / 660**(46 套,28.4s) | 644/4/12/660 | **逐例零漂移** |
+| langgraph@251 | **31 过 / 8 红 / 39**(125.61s,去 test_graph.py) | 40/43(3 红) | **红集 3→8 环境型 429**(B-223-1) |
+| 后端 · test-compile | **BUILD SUCCESS**(515 源文件,3m58s) | EXIT=0 | 窗口 src 变更可构建 |
+| 后端 · 全量 | **未重跑**(窗口有 src 变更不承采;本机无 DB/9000)→ 承采 R221 基线 4415 例 91.91% 仅作参考,**不写通过** | 承采 R221 | G11 待 CI 固化 |
+| 根级黑盒 Jest | **未重跑**(根级 jest 二进制缺失)→ 承采 R222 7/16(B-36) | 7/16 | B-36 承袭 |
+
+**可验证子集合计(本轮实测,不含后端全量/根级承采/189 交叉重复)**:**895 例 / 852 过 / 22 红 / 21 跳 = 95.20%**(剔 skip 97.48%;22 红=web 契约 RED 10 + fe 契约 RED 4 + lg 环境 8,无新增真实产品缺陷)
+**双节点浏览器合计**:本机 28 过 + 2 跳 + 189 admin 5 过 = **33 过 + 2 跳**。
+
+**覆盖台账(discover + inventory + rollup 实跑刷新)**
+- 控制器 **373**|handler 方法 **2026(覆盖 557 = 27.5%)**|测试文件 **515(@Test 4395)**
+- 结构化用例 **726** + Playwright **571** + Python **48** + Java@Test **4395** + 场景文件 **11** = **5740**
+- 场景 L3 实测归集 **47/247(19.0%)**(9 绿证,150「已测未链接」待 G-4 归一)
+
+**测试结果有变化(R222 → R223)— 触发提交 + 通知研发**
+- 🟢 **G12 合规**:窗口新增 3 能力键(shop.review.detail / shop.review.my / shop.order.receiptTimeout,API_REFERENCE + S-cfc-402/403/404)→ **派生 24 条行为级用例**(正常/异常/权限/边界流)入 `tests/test-cases/2026-11-16-review-detail-my-receipt-timeout.md`,补齐原台账仅笼统描述(TC-POG-06/P0-B)的缺口。
+- 🟢 **189 admin spec 同版**:189 spec blob 从历史落后版更新为 `4703d73fb` = 本机同版(B-138-2 好转,跨节点结论可比)。
+- 🔴 **langgraph 红集 3→8 环境型复现**:AgnesAI 免费用户 429 配额耗尽,`intent_classifier.py:62` 兜底 chat;与 R149/R162/R174/R220 同型,非产品回归(B-223-1)。
+- 🟡 **251 首派工具缺陷**:`| tail -80` 管道致日志缓冲 + 进程挂起 12min;改无管道 `timeout` 直写日志后正常取回(B-223-2,已自处置)。
+- ⚪ 其余逐例零漂移:web 10 红、fe 4 红、浏览器本机 28 过 2 跳、189 admin 5 过、线上 API 25 过 7 跳。
+
+---
+
+## 二、项目画像(本轮视角)
+
+- **业务定位**:家庭教育 SaaS(五维能量 · 成长规划 · 测评订单 · 商城 · 健康报告解析 · 家庭工作台 · AI 教练),双端(小程序 H5 `cfc.iwintrue.com/frontend` + Web 管理端 `cfc.iwintrue.com/admin`)。
+- **技术栈**:Spring Boot 2.7.18 / Java 8 / MyBatis-Plus(9082)· uni-app Vue2(H5)· Vue2+Element(8082)· FastAPI+LangGraph(9000/生产 `ai.etotem.com.cn`)· Maven 3.6.1+JDK1.8.0_25(本机)+ Maven 3.9.9。
+- **节点探活(00:06~00:29)**:站点 `/admin` `/frontend` **302**;**本机** 4091=200、Chromium 1228/1243 + System Chrome 就位;**189** 4090=200(admin E2E 派发成功);**251** 4096=200(lg shell 派发成功)、9000 CLOSED(live 链路面不可实测);本机 9082=000(B-36)。
+- **通道**:fetch/push 全程 HTTP `http://git.iwintrue.com/liaoxg/cfc.git`(SSH 失效,承 B-203-3)。251/189 派发走 `POST /api/shell?location[directory]=` + Basic Auth(B-91/B-113 口径)。
+- **窗口事件**:`c582cdb16..3ff62e324` +28 提交,功能变更含 S-cfc-402(待收货超时自动完成 + 第 N 天提醒定时任务)、S-cfc-403(review.detail 详情/按钮态)、S-cfc-404(review.my 我的评价/待评价)、S-cfc-397(teamshare 加权瓜分 RED)、S-cfc-401(rewardv2 migrateConfig)、家庭切换迁移 fix、admin 密度四期无障碍补修。
+- **风险点**:① 60+ 契约类前瞻红(web 10 + fe 4 + 后端契约 336);② lg 上游 429 配额复现(B-223-1);③ 后端全量窗口有 src 变更未重跑(G11);④ CI 清单失真(承袭);⑤ 251 派发工具 `| tail` 缓冲缺陷(B-223-2,已绕行)。
+
+---
+
+## 三、20 类测试覆盖矩阵
+
+| # | 测试类型 | 层次 | 状态 | 证据(本轮实测) |
+|---|---|---|---|---|
+| 1 | 单元测试 | 功能层次 | **已发现** | 后端 test-compile BUILD SUCCESS(515 测试源文件);web 21 套 134 + fe 46 套 660(Jest 实跑) |
+| 2 | 组件测试 | 功能层次 | **已发现** | web/fe views/components 级用例实跑零漂移 |
+| 3 | 集成测试 | 功能层次 | **已发现** | 后端 integration/**(承采 R221,窗口 src 变更未重跑) |
+| 4 | 契约测试 | 功能层次 | **已发现(红集主体)** | web 10 契约 RED + fe 4 契约 RED;后端 60 契约类/336 例承采;本轮新增 3 能力键契约 |
+| 5 | 接口 API 测试 | 功能层次 | **已发现** | 线上点名 4 文件 32 例 25 过 7 跳;shop 4/4;health 13/13 全 401/403 |
+| 6 | 系统/端到端 | 功能保障 | **已发现(实跑)** | 本机 28 过 + 2 跳 + 189 admin 5 过(用户指定双 URL 11/11 全绿) |
+| 7 | 验收 UAT | 功能保障 | **部分已发现** | 场景文件 11 份;无人工 UAT 签署记录 |
+| 8 | BDD 规格 | 功能保障 | **未发现** | 仓库无 `.feature`/cucumber → 缺口 |
+| 9 | 冒烟测试 | 功能保障 | **已发现** | 线上 api-smoke 4/4 绿 |
+| 10 | 回归测试 | 功能保障 | **已发现** | web/fe/浏览器/线上 API 逐例对照零漂移;后端承采(窗口 src 变更不写通过) |
+| 11 | 探索性测试 | 功能保障 | **未发现** | 无人值守窗口不做 chartered 探索 |
+| 12 | 性能测试 | 非功能 | **未发现(未实测)** | 无 k6/JMeter;execute 档未授权 → 不写通过 |
+| 13 | 可靠性测试 | 非功能 | **部分已发现** | lg 429 环境型复现(B-223-1);health 首跑全绿;无故障注入 |
+| 14 | 安全测试 | 非功能 | **部分已发现** | 匿名端点全 401;shop 非法排序列白名单;无 SAST/依赖扫描 |
+| 15 | 兼容性测试 | 非功能 | **部分已发现** | Chromium 双视口(1440×900 / 375×812 isMobile);无多浏览器矩阵 |
+| 16 | 可用性测试 | 非功能 | **未发现** | 无 SUS/任务完成率记录 |
+| 17 | 无障碍测试 | 非功能 | **未发现** | 无 axe/WCAG 断言(admin 密度四期有人工补修但无自动化断言) |
+| 18 | QA 流程 | 度量与流程 | **部分已发现** | 三节点 E2E 互备 + 派发脚本;251 派发工具缺陷(B-223-2 已绕行);CI 清单失真(G11 ❌) |
+| 19 | 质量指标 | 度量与流程 | **已发现** | 通过率/红例/覆盖率/场景映射四指标本轮全部刷新(§1 执行总览) |
+| 20 | 全项目代码审查 | 度量与流程 | **部分已发现** | 窗口 +28 提交含功能变更,本轮聚焦测试取证未做逐行代码审查(域专家未派发);test-compile 验证可构建 |
+
+---
+
+## 四、覆盖缺口清单
+
+| 缺口类型 | 现状 | 风险 | 建议测试设计 | 优先级 | 闭环方式 |
+|---|---|---|---|---|---|
+| BDD 规格 | 无 `.feature` | 需求-用例可追溯弱 | 对 SC-P-94/95 等核心场景补 Gherkin | P2 | 下迭代引入 cucumber |
+| 探索性测试 | 无人值守无 charter | 未知缺陷盲区 | 每迭代 1 次 chartered 探索并留记录 | P2 | 人工窗口补 |
+| 性能/可靠性 | 无压测/故障注入 | 容量与恢复未知 | k6 压测 + 混沌注入(execute 档) | P1 | 需用户授权联网 |
+| 无障碍/兼容性 | 无 axe/多浏览器 | a11y 与跨端缺陷 | axe-core 扫 admin 5 页 + fe 3 页 | P2 | 补 a11y.spec.js |
+| 后端全量回归 | 窗口 src 变更未重跑 | 新功能回归遗漏 | 251 有 DB 环境跑全量 mvn test | P0 | 研发在 251 节点重跑(G11) |
+| 场景 L3 链接 | 150「已测未链接」 | 场景覆盖率低估 | 「所属场景」列格式归一 + rollup 复跑 | P1 | G-4 归一自动上升 |
+
+---
+
+## 五、域结论表
+
+| 审查维度 | 负责专家 | 结论 | 关键证据 |
+|---|---|---|---|
+| 单元·组件级 | 苏雅 | 部分通过 | web 124/134、fe 644/660 契约 RED 零漂移;后端 test-compile SUCCESS |
+| 集成·接口级 | 柯砚 | 通过 | 线上 API 25/0/7;shop 4/4;health 13/13 |
+| 系统·验收级 | 白樾 | 通过(可验证子集) | 三节点浏览器 33 过 + 2 跳;用户双 URL 11/11 |
+| 测试保障级 | 闻朔 | 部分通过 | 冒烟/回归零漂移;无探索性 chartered |
+| 性能·可靠性 | 骆骋 | 未实测/部分 | lg 429 复现;无压测/故障注入 |
+| 安全 | 关屿 | 部分通过 | 匿名鉴权 401 契约通过;无 SAST/DAST |
+| 兼容·体验 | 阮清 | 部分通过 | 双视口通过;无多浏览器/a11y 断言 |
+| 流程·度量·代码 | 何序 | 部分通过 | 覆盖台账 5740;CI 清单失真;窗口功能变更未逐行审查 |
+
+---
+
+## 六、五要素问题清单
+
+**问题 1(B-223-1,环境型)langgraph 8 红**
+- ① 问题描述:251 节点 langgraph pytest 39 例中 8 例失败(auto_tag×4 + chat×1 + intent×3),较 R222 3 红扩大。
+- ② 测试 bug 点:`cfc-langgraph/app/agents/intent_classifier.py:62`(429 兜底 chat)、`test_auto_tag.py`/`test_chat.py`/`test_intent.py`;日志 `AgnesAI_error 429 free users rate limit`。
+- ③ 最优修改方案:运维为 251 的 LLM 凭据升级 Token Plan 或轮换有配额的 key(非改测试断言)。
+- ④ 修改目的:消除环境型假红,使 langgraph 稳定全绿,恢复 AI 域可验证性。
+- ⑤ 闭环:配额恢复后在 251 重跑 `pytest tests/ -q`,连续 2 轮 0 红即销号。
+
+**问题 2(B-223-2,工具型,已自处置)251 派发日志缓冲**
+- ① 问题描述:首派 CMD 用 `.venv/bin/python -m pytest ... | tail -80`,日志 12min 为空、pytest 进程挂起。
+- ② 测试 bug 点:派发 CMD 的 `| tail -80` 管道(缓冲到进程结束才输出)叠加 B-218-10 收尾挂起。
+- ③ 最优修改方案:改 `timeout 300 .venv/bin/python -m pytest ... -q`(无管道,直接重定向日志),dispatch_shell.cjs 内部轮询 DONE 标记。
+- ④ 修改目的:保证远程派发结果可确定性取回,避免误判为「节点不可用」。
+- ⑤ 闭环:本轮已验证 125.61s 取回完整 summary(31/8),方案有效;后续派发沿用无管道写法即闭环。
+
+**问题 3(G11,流程型)后端全量未随窗口重跑**
+- ① 问题描述:窗口 +28 提交含 S-cfc-402/403/404 等 src 变更,本轮仅 test-compile,未跑后端全量。
+- ② 测试 bug 点:本机无 DB/9000,CI 清单失真(历史 G11 漏拦 63)。
+- ③ 最优修改方案:研发在 251(有 DB)节点跑 `mvn -o test` 全量,并把结果接入 CI 门禁。
+- ④ 修改目的:防止新功能回归遗漏,恢复后端域可验证性。
+- ⑤ 闭环:251 全量绿 + CI 清单与实际红类一致即闭环。
+
+---
+
+## 七、门禁结论
+
+**结论:不通过(有条件)**
+
+- **可验证子集达标**:895 例 95.20%(剔 skip 97.48%),用户指定双 URL 浏览器 E2E 11/11 全绿,后端可构建,22 红全部为契约前瞻 RED(14)+ 环境型(8),无新增真实产品缺陷。
+- **不通过原因**:① 用户目标「所有用例全部覆盖并通过」未达成(web 10 + fe 4 契约 RED + lg 8 环境红 + 后端契约前瞻 336 承采);② 用户目标「覆盖全部 SRS + 用户场景」未达成(场景 L3 仅 47/247=19%,795 文档用例零执行、异常流主要在用例文档层未自动化);③ 后端全量随窗口 src 变更未重跑(G11)。
+- **复评条件**:langgraph 配额恢复 2 轮全绿(销 B-223-1)+ 251 后端全量绿(销 G11)+ 前端契约 RED 由研发实现转绿 + 场景 L3 归一上升 + execute 档授权跑安全/性能。
+
+---
+
+## 附录:本轮新增测试用例明细(G12)
+
+| 用例 ID 段 | 能力键 | 目标单元 | 用例标题 | 优先级 | 已登记 | 登记位置 |
+|---|---|---|---|---|---|---|
+| TC-RD-01~09 | shop.review.detail | ProductReviewController#detail | 评价详情/去评价按钮态(含越权/未登录/90天边界) | P0×4 | 文档入册 | tests/test-cases/2026-11-16-review-detail-my-receipt-timeout.md |
+| TC-RM-01~08 | shop.review.my | ProductReviewController#my | 我的评价+待评价入口(含 activity 隔离/越权/空集) | P0×4 | 文档入册 | 同上 |
+| TC-ROT-01~07 | shop.order.receiptTimeout | OrderReceiptTimeoutTask | 待收货超时自动完成(含幂等/灰度/原子性) | P0×3 | 文档入册 | 同上 |
+
+> 合计 24 条(行为级 17 待补自动化 + 契约结构 7 已存在)。三类 API 契约测试已在后端主线(S-cfc-402/403/404),本轮 test-compile 一并编译通过。
+
+---
+
+**报告版本**:R223(2026-11-16)|**适用**:测试负责人 / 自动化闭环|**数据来源**:三节点 E2E + 两套 Jest + 线上 API + 251 langgraph + 后端 test-compile + 覆盖台账实测

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

@@ -1664,3 +1664,7 @@
 | **B-208-5(B-WIP-200 第 12 轮 · P2)** | cfc-web 用例口径 132 vs 119 | 流程 | 本机实跑 **134/134(21 套,含 S1-1 契约 10 例 TDD-RED)**;远端仍 119/119(18 套)= 3 个本地未入库文件 13 例。**测试侧不代提交**。 | 测试(R216 实测) | 2026-11-15 12:30 | 待提交(P2) |
 | **B-203-3(维持)** | origin SSH publickey 失效 | 运维 | 全程 HTTP `http://git.iwintrue.com/liaoxg/cfc.git` 兜底 fetch/push。 | 运维 | 2026-11-15 12:10 | 待处理 |
 | **R216 门禁** | 全站 **5264 例 / 4765 过 / 474 红 / 25 跳** | 测试 | **不通过(有条件)**。剔 skip **90.95%**(4765/5239);**剔 437 预期红契约(后端 423 + fe 4 + web S1-1 10)= 99.23%**,实红 **37**(后端确定性 16 + 根级 16 + lg 5)=**较 R215 红 +12(web S1-1 契约 +10 预期红 + lg 环境 +2)**。✅G3 fe 644/4/12/660(web 124/134 ⚠️ S1-1 契约 +10)/ G4 编译 0 错(承)/ G5 501/501(承)/ G6 28 过 + 2 跳(**189 admin 5/5 首次全绿** + 本机交叉)/ G8 7/7=401 + health 13 全 401 / **G10 双节点(189 ✅ 链路恢复 + 204 5/6 暂态本机兜底)** / G12 ✅(S1-1 场景变更用例已派生);❌G1 全量口径 90.95% / G2 37 / G7 38/43(88.4%)/ G9 27.5% / G11 漏拦 67 陈旧 26 / G14 90.1%。**核心变化 = cfc-web S1-1 契约 10 例新增(场景变更→用例更新→实现待跟进,非回归)+ 189 admin 首次全绿(B-215-1 链路恢复)+ lg 红 3→5(429 环境型)→ 按「结果有变化」已提交推送 + 通知研发**。 | 测试(R216 闭环) | 2026-11-15 13:00 | 已记录 |
+| **B-223-1(P1 环境型)** | langgraph 251 红集 3→8(429 配额) | 运维/langgraph | 251 实派 39 例 **31 过 / 8 红 / 125.61s**;8 红=AgnesAI `429 free users rate limit`(auto_tag×4 + chat×1 + intent×3),`intent_classifier.py:62` 兜底 chat。环境型非回归,同 R149/R162/R174/R220。请升级 251 LLM 凭据为 Token Plan 或轮换 key。 | 运维/langgraph | 2026-11-16 00:25 | 待处理 |
+| **B-223-2(P2 工具·已自处置)** | 251 派发 `\| tail` 管道致日志缓冲/挂起 | 测试 | 首派 CMD 带 `\| tail -80` → 日志 12min 空、pytest 挂起;改无管道 `timeout 300 .venv/bin/python -m pytest ... -q` 直写日志 → 125.61s 取回完整 summary。后续派发统一无管道写法。 | 测试(R223 自处置) | 2026-11-16 00:27 | 已闭环 |
+| **G11(P0 流程)** | 后端全量未在窗口 src 变更后重跑 | 研发 | 窗口 +28 提交含 S-cfc-402/403/404/397/401 src 变更;本轮仅 test-compile BUILD SUCCESS(515 源文件,3m58s)。请在 251(有 DB)跑全量 mvn test 并对齐 CI 门禁。承采 R221 4415 例 91.91% 仅参考,不写通过。 | 研发 | 2026-11-16 00:28 | 待处理 |
+| **R223 门禁** | 可验证子集 **895 例 / 852 过 / 22 红 / 21 跳 = 95.20%**(剔 skip 97.48%) | 测试 | **不通过(有条件)**。用户双 URL 11/11 全绿(本机 admin5+fe6 + 189 admin5 交叉);22 红=契约 RED 14(web10+fe4)+ 环境 8(lg 429);无新增真实缺陷。✅G3/G4(test-compile)/G5/G6/G8/G12(新增3能力键派生24例)/G19;⚠️G10(189 spec 同版好转)/G13;❌G1 全量/G2 22红/G7 lg 31/39/G9 27.5%/G11/G14 19%。**核心变化=新增3能力键派生用例(langgraph 环境红扩大 3→8) → 已提交推送+通知研发**。 | 测试(R223 闭环) | 2026-11-16 00:29 | 已记录 |

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

@@ -0,0 +1,52 @@
+# 研发通知 · R223 测试闭环(2026-11-16 00:29 GMT+8)
+
+> 发件:测试负责人(cfc-tester)|收件:研发负责人 / 运维 / langgraph 团队|基线:origin/cfclub `3ff62e324`
+> 触发:本轮测试结果相对 R222 **有变化**(G12 新增 3 能力键派生用例 + langgraph 环境红扩大 3→8 + 189 spec 同版好转)→ 按「结果有变提交远程 + 通知研发」规则发出。
+
+---
+
+## P0 — 需优先处理
+
+**1. 后端全量回归未在窗口 src 变更后重跑(G11)**
+- 窗口 `c582cdb16..3ff62e324` +28 提交,含 S-cfc-402/403/404/397/401 等 src/main 变更;本轮仅做 `test-compile`(BUILD SUCCESS,515 测试源文件)。
+- 请研发在 **251 节点(有 DB)** 跑 `mvn -o -B -f cfc-backend/pom.xml test` 全量,把结果与 CI 门禁对齐(历史 CI 清单漏拦 63 类)。
+- 闭环标准:全量绿 + CI 清单与实际红类一致。
+
+## P1 — 本迭代内处理
+
+**2. langgraph 上游 429 配额耗尽(B-223-1,环境型)**
+- 251 pytest **8 红**(auto_tag×4 + chat×1 + intent×3),根因 `AgnesAI_error 429 free users rate limit`,`intent_classifier.py:62` 兜底 chat。
+- 请运维/langgraph 团队为 251 的 LLM 凭据升级 Token Plan 或轮换有配额的 key(非改测试断言)。
+- 闭环标准:配额恢复后 251 重跑 `pytest tests/ -q` 连续 2 轮 0 红。
+
+**3. 前端契约 RED 待研发实现转绿(承袭)**
+- cfc-web 10 红(如 `Families.actionMenu.spec.js` 期望 `family-workbench` 入口)、cfc-frontend 4 红(成长史分组/饮食推荐 viewKey 等),逐例零漂移,属预期 RED 非回归。
+- 请研发对照契约实现使绿;测试侧不做断言降级。
+
+## P2 — 优化项
+
+**4. 251 派发工具日志缓冲缺陷(B-223-2,测试侧已自处置)**
+- 首派 `| tail -80` 管道致日志缓冲 + pytest 挂起 12min;已改无管道 `timeout` 直写日志,125.61s 正常取回。
+- 后续远程派发请统一用 `CMD="timeout 300 .venv/bin/python -m pytest ... -q"`(无管道)+ dispatch_shell.cjs 轮询。
+
+**5. 场景 L3 链接归集(G-4)**
+- 场景实测归集 47/247(19%),150 例「已测未链接」因「所属场景」列格式差异。建议研发/测试联合归一用例文档的「所属场景」列格式,rollup 每小时复跑自动上升。
+
+---
+
+## 本轮通过项(供参考)
+
+- 用户指定双 URL 浏览器 E2E:admin 5/5(本机 + 189 双节点)、frontend 6/6(本机),共 11/11 全绿。
+- 线上 API 25 过 7 跳;shop 4/4;health 13/13 首跑全绿;dx 2 跳(404 部署滞后,承袭)。
+- cfc-web 124/134、cfc-frontend 644/660,逐例零漂移。
+- 后端 test-compile BUILD SUCCESS;覆盖台账刷新 5740 例。
+
+---
+
+## G12 合规(SRS 变更 → 更新用例)
+
+窗口 API_REFERENCE 新增 `shop.review.detail`/`shop.review.my` 能力键 + S-cfc-402/403/404 功能落地,测试侧**已派生 24 条行为级用例**(正常/异常/权限/边界流)入 `tests/test-cases/2026-11-16-review-detail-my-receipt-timeout.md`,补齐原台账笼统描述缺口。请研发实现时对照该用例的异常流/权限流断言。
+
+---
+
+**闭环回复**:请各责任方在 `docs/tdd/test/blockers.md` 对应条目更新处置进展,或直接在研发汇报中引用问题编号(B-223-1 / G11 / P1-前端 RED)。

+ 69 - 0
tests/test-cases/2026-11-16-review-detail-my-receipt-timeout.md

@@ -0,0 +1,69 @@
+# 测试用例台账 · shop.review.detail / shop.review.my / shop.order.receiptTimeout(R223 派生)
+
+> 派生日期:2026-11-16|派生角色:测试负责人(自动化闭环 R223)
+> 派生来源:`origin/cfclub` `c582cdb16..3ff62e324` 窗口新增能力键(G12 / 用户"SRS 变更→更新用例"要求)
+> 派生依据:
+> ① `docs/superpowers/api/API_REFERENCE.md` 新增 `POST /api/product/review/detail`(`shop.review.detail`)、`POST /api/product/review/my`(`shop.review.my`);
+> ② 后端契约 `ProductReviewDetailContractTest` / `ProductReviewMyContractTest` / `OrderReceiptTimeoutContractTest`(S-cfc-403/404/402);
+> ③ 需求正本:商品评价详情/去评价按钮态(§3.1 R2)、我的评价+待评价入口(§3.1 R5)、待收货超时自动完成(架构设计 §2.4/§6)。
+> 用途:把契约级 RED 用例升级为**行为级**用例台账,避免仅靠结构性断言假绿;异常流/权限流为本次重点补齐维度。
+
+## 一、背景与覆盖判定
+
+| 能力键 | 需求溯源 | 设计溯源 | 现有资产 | 覆盖判定 |
+|---|---|---|---|---|
+| `shop.review.detail`(S-cfc-403) | API_REFERENCE `POST /api/product/review/detail`;去评价按钮态 R2 | `ProductReviewDetailContractTest`(10 例:结构/路由/出参字段) | 契约 RED(存在性) | **部分覆盖**:缺 canReview 判定(completed+90天+未评)真实行为、缺越权、缺未登录、缺 orderId 非法 |
+| `shop.review.my`(S-cfc-404) | API_REFERENCE `POST /api/product/review/my`;我的评价+待评价 R5 | `ProductReviewMyContractTest`(11 例:路由/Mapper/schema/权限说明) | 契约 RED(存在性) | **部分覆盖**:缺分页倒序、缺 reviewableOrders 过滤(90天/非 activity/本人)、缺越权、缺未登录 |
+| `shop.order.receiptTimeout`(S-cfc-402) | 待收货超时自动完成 + 第 N 天提醒 | `OrderReceiptTimeoutContractTest` / `OrderReceiptTimeoutTaskContractTest`;application.yml 4 配置键 | 契约 RED(结构/配置) | **部分覆盖**:缺超时置态真实行为、缺幂等、缺灰度开关、缺提醒幂等 |
+
+> 三能力均为窗口内新落地(feat 已合入主线),契约测试为结构性断言;本台账补齐**行为级 + 异常流 + 权限流**。用例状态记为 `待执行`,本轮由契约实跑取证,行为级留待研发环境补测。
+
+## 二、TC-RD(shop.review.detail)用例
+
+| ID | 类型 | 场景 | 前置 | 步骤 | 期望 | 优先级 | 现有资产 |
+|---|---|---|---|---|---|---|---|
+| TC-RD-01 | 正常 | 已评订单查详情 | orderId 已有评价 | 调 `detail(orderId, buyerId)` | `review` 非空;星级/文字/图回显;`canReview=false` | P0 | 部分(DTO 字段在) |
+| TC-RD-02 | 正常 | 未评 completed 订单(窗口内)→ 可评 | orderId=completed 且 89 天内未评 | 调 detail | `review=null`;`canReview=true`;`reviewHint` 含引导文案 | **P0** | ❌ 缺行为断言 |
+| TC-RD-03 | 边界 | completed 超 90 天未评 | orderId completed 91 天前 | 调 detail | `canReview=false`;`reviewHint` 提示超期 | P1 | ❌ 缺 |
+| TC-RD-04 | 边界 | 非 completed 订单 | orderId=pending_receipt | 调 detail | `canReview=false`;不 5xx | P1 | ❌ 缺 |
+| TC-RD-05 | 异常 | orderId 不存在 | orderId=999999999 | 调 detail | 明确业务码,不含堆栈 | P1 | ❌ 缺 |
+| TC-RD-06 | 异常 | orderId=null | — | 调 detail | 参数校验失败码,不 NPE | P1 | ❌ 缺 |
+| TC-RD-07 | **权限** | 查他人订单详情 | A token + B 的 orderId | 调 detail | 拒绝(403/业务码),不返回他人评价 | **P0** | ❌ 缺(越权风险) |
+| TC-RD-08 | 权限 | 未登录 | 无 token | `POST /api/product/review/detail` | 401 | P0 | 部分(JwtInterceptor 通用) |
+| TC-RD-09 | 正常 | 路由与身份载体 | — | 反射检查 | `@PostMapping("/detail")` + `@RequestAttribute("userId")` | P1 | ✅ 契约正常流3/4 |
+
+## 三、TC-RM(shop.review.my)用例
+
+| ID | 类型 | 场景 | 前置 | 步骤 | 期望 | 优先级 | 现有资产 |
+|---|---|---|---|---|---|---|---|
+| TC-RM-01 | 正常 | 我的评价列表倒序分页 | 买家有 ≥3 条评价 | 调 `my(buyerId,...)` | `reviews` 按评价时间倒序;分页参数生效 | P0 | 部分(Mapper 存在性) |
+| TC-RM-02 | 正常 | 待评价订单集合 | 有 completed 90天内未评非 activity 订单 | 调 my | `reviewableOrders` 含该单;`reviewableCount` 正确 | **P0** | ❌ 缺行为断言 |
+| TC-RM-03 | 边界 | activity 订单不进待评 | 有 activity 类型 completed 订单 | 调 my | 该单**不**出现在 `reviewableOrders` | **P0** | ❌ 缺(活动评价零污染) |
+| TC-RM-04 | 边界 | 超 90 天订单不进待评 | completed 91 天前 | 调 my | 不出现在待评集合 | P1 | ❌ 缺 |
+| TC-RM-05 | 正常 | 空集(无评价无待评) | 新买家 | 调 my | `reviews=[]`、`reviewableOrders=[]`、`reviewableCount=0`,不 500/不 null | P0 | ❌ 缺 |
+| TC-RM-06 | **权限** | 仅本人可见 | A token | 调 my | 只返回 A 的评价/待评,无 B 数据 | **P0** | 部分(权限流说明) |
+| TC-RM-07 | 权限 | 未登录 | 无 token | `POST /api/product/review/my` | 401(R5 为登录买家私有,非 R3 公开路径) | P0 | ❌ 缺 |
+| TC-RM-08 | 正常 | schema 独立表 + 索引 | — | 检查 schema.sql | `product_reviews` 表 + `idx_reviewer_id` 索引存在 | P1 | ✅ 契约边界流3 |
+
+## 四、TC-ROT(shop.order.receiptTimeout)用例
+
+| ID | 类型 | 场景 | 前置 | 步骤 | 期望 | 优先级 | 现有资产 |
+|---|---|---|---|---|---|---|---|
+| TC-ROT-01 | 正常 | 超时订单自动完成 | 有 pending_receipt 超 N 天订单 | 跑 `processTimeoutOrders` | 订单置 completed;可追溯日志记录 | P0 | 部分(结构设计) |
+| TC-ROT-02 | **异常/幂等** | 重复执行不重复完成 | 已 completed 订单 | 再跑 2 次 | 不再被扫中;无重复日志 | **P0** | ❌ 缺行为断言 |
+| TC-ROT-03 | 边界 | 第 N 天提醒幂等 | `receipt_remind_at` 非空 | 再跑任务 | 不重复推送;失败仅日志下一轮重试 | P1 | ❌ 缺 |
+| TC-ROT-04 | 边界 | 灰度总开关 | `receipt-auto-complete-enabled=false` | 跑任务 | 仅提醒不自动完成 | **P0** | 部分(配置键在) |
+| TC-ROT-05 | 正常 | Spring 定时任务注册 | — | 检查注解 | `@Component` + `@Scheduled(fixedRate=60000)` + `@Transactional` | P1 | ✅ 契约正常流2/3/4 |
+| TC-ROT-06 | 异常 | 批量置态原子性 | 批量中 1 条失败 | 跑任务 | 整批回滚或跳过失败不产生半成品(依设计口径) | P1 | ❌ 缺(需设计确认口径) |
+| TC-ROT-07 | 正常 | 4 配置键齐备 | — | 检查 yml | `receipt-timeout-days`/`receipt-remind-days`/`receipt-remind-template-id`/总开关均存在 | P1 | ✅ 契约数据契约1 |
+
+## 五、执行状态与闭环
+
+| 能力 | 用例数 | 已自动化(契约结构) | 行为级/异常/权限 | 状态 |
+|---|---|---|---|---|
+| shop.review.detail | 9 | 3 | 6 待补 | 契约 RED,行为待验 |
+| shop.review.my | 8 | 2 | 6 待补 | 契约 RED,行为待验 |
+| shop.order.receiptTimeout | 7 | 2 | 5 待补 | 契约 RED,行为待验 |
+| 合计 | **24** | 7 | 17 待补 | — |
+
+> 闭环方式:本轮契约测试实跑取证(结构性通过≠行为正确);行为级/异常/权限用例待研发测试环境补测,任何失败入 `docs/tdd/test/blockers.md` 并标注是否为实现缺口。用例锚点供 `test_inventory.py` 编目与 `rollup_sc_l3.py` 场景归集。