Explorar o código

test(R225): 自动化闭环测试汇报 — 基线9528c60db窗口+3提交(coupon-share T03前端+merge+bump) + 前端6/6·线上API33/0/3·fe44套零漂移 + lg 6红(429环境观察3/3) + 新增B-225-1(coupon-share T02后端未入库线上已部署) + G12补16条coupon-share用例

E2E Test Bot hai 1 día
pai
achega
96ccd11e8a

+ 193 - 0
docs/tdd/orchestration/report-test-2026-11-16-R225.md

@@ -0,0 +1,193 @@
+# 测试负责人工作汇报 R225(2026-11-16 02:50 GMT+8 · 自动化闭环)
+
+> 测试负责人:陆谨(软件测试专家团 · 测试架构师)|执行档:**review(离线白名单)** + 内网三节点浏览器 E2E 实跑 + 远程节点派发(251 langgraph / 189 admin)
+> 静默无人值守,全程未提问(按用户指令:不提问、静默完成);方案假设已在 §2 声明
+> 基线:`origin/cfclub` **`9528c60db`**(HTTP 通道 fetch);R224 基线 `8010b1f34`,本轮窗口 **+3 提交**(含 coupon-share 前端功能与版本 bump)→ **有 src 变更,触发 G12 工序**
+
+## 0. 历史审查记录(对照,非本次结论依据)
+
+| 项 | 内容 |
+|---|---|
+| 上次审查 | **R224(2026-11-16 01:30)**,结论「不通过(有条件)」;基线 `8010b1f34`;lg@251 43/35/8(429×8);后端全量首跑 510 类/4469 例/92.12%;可验证子集 92.73%;复评条件 4 项 |
+| 本次 | **第 225 轮,非首次审查**;基线 `9528c60db`;窗口 **+3 提交**(`9dc097eab` coupon-share T03 前端 / `d26a795a5` merge / `9528c60db` bump) |
+| 遗留 → 本次状态 | **B-223-1(lg 429 红集)→ R225 复现 6 红(同型 429 子集,观察 3/3)**;**B-218-1(P0 Bean 撞名)→ 承袭未修**(本轮后端零变更,守卫红沿用 R224 实测);B-36(根级 16 红)→ 承袭;B-DX-1(dx 2 跳)→ 第 59 轮;G11(CI 清单失真)→ 承袭(第 27 轮) |
+| 本次新增 | **B-225-1(P1 流程/资产)→ 已闭环**:R225 期间发现 coupon-share T02 后端未入库但线上已可响应(detail 匿名 200+业务404、create 401、不存在端点 404 对照组成立);**研发已于 02:21 合入 `2ceab5553`(T02 接口+契约单测 592 行)**,本报告复核时 T02 已随最新基线入库,并在 `3e024736d+` 上单独跑 `CouponShareClaimContractTest` **全绿**(创建/幂等/领取链路通过) |
+| 窗口后置(复核时远端再推进) | `3e024736d` 起远端追加 **S-cfc-382(plan.draft.save 方案草稿保存 SC-P-81)**、**S-cfc-405(cf.rewardv2.platformTake 平台抽成 T03)** 等提交至 `33e314cba`——为 R225 报告定稿后的功能增补,**R226 起纳入全量复验** |
+
+> 历史记忆只作对照;本轮**全部本机/189/251 套件重新取证**;后端全量因窗口 src 零变更**承采 R224**(§2 声明)。
+
+---
+
+## 1. 执行总览
+
+| 套件 | R225(本轮) | R224(上轮) | 漂移 |
+|---|---|---|---|
+| 基线 | `9528c60db`(窗口 **+3 提交**:coupon-share T03 前端 / merge / bump) | `8010b1f34`(窗口 0 提交) | **有 src 变更**(仅 cfc-frontend / cfc-web,后端与 tests/ 零变更) |
+| 浏览器 E2E · admin(本机) | **5/5** | 5/5 | 一致 |
+| 浏览器 E2E · frontend(本机,耦合新基线重跑) | **6/6**(47.0s,coupon-share 上线后重取) | 6/6 | 一致(新功能无回归) |
+| 浏览器 E2E · admin(189) | **5/5 EXIT=0**(1.1m,spec blob 同本机) | 5/5 | 一致 |
+| 浏览器 E2E · shop-api | **4/4** | 4/4 | 一致 |
+| 浏览器 E2E · health | **13/13** | 13/13 | 一致(B-218-3 未复发,观察 3/3) |
+| 浏览器 E2E · dx-bridge | **2 跳**(404,第 59 轮) | 2 跳 | 一致 |
+| 线上 API(点名 4 文件) | **33 过 / 0 红 / 3 跳**(31.6s,origin 版 spec) | 33 过 / 0 红 / 3 跳 | **逐例零漂移** |
+| cfc-web Jest | **124 过 / 10 红 / 134**(21 套,承 R224 实测;cfc-web 零变更) | 124/10/134 | **逐例零漂移** |
+| cfc-frontend Jest | **636 过 / 4 红 / 12 跳 / 652**(44 套;worktree 新基线含 coupon-share 重跑,红集 3 套与 R221 同型) | 644/4/12/660(46 套,主区口径含本地未入库资产) | **红集同型**(3 套 4 红:dayGroupView / viewKeyAndDelete / consignee) |
+| 根级黑盒 Jest | **7 过 / 16 红 / 23**(B-36 ECONNREFUSED 9082 承袭) | 7/16/23 | 一致 |
+| langgraph@251 | **43 例 / 37 过 / 6 红**(108.52s,EXIT=0;红=auto_tag×2 + intent×4) | 43 例 / 35 过 / 8 红 | **红集 8→6**(429 命中波动,6 红为 R224 红集子集且日志实证 429→默认 chat) |
+| 后端 · 全量 | **承采 R224**(510 类 / 4469 例 / 4113 过 / 352 红 / 4 跳 = 92.12%);本轮后端 src 零变更 | 同上(51:50) | 承采(声明于 §2) |
+| 后端 · coupon-share T02 契约单测 | **`CouponShareClaimContractTest` 全绿**(5m16s,最新基线复核:创建 share/幂等 PENDING/claim 领取链路通过) | 无(T02 后置合入) | ▸R225 复核新增 |
+| 后端 · test-compile | **BUILD SUCCESS**(R224 结果;本轮后端零变更) | SUCCESS | 承采 |
+
+**全站合计(本轮实测 + 承采 R224)**:与 R224 完全一致的 5400 例口径;**真实产品缺陷红 = 17**(后端 16 存量 + B-218-1 P0 守卫 1)——**无新增真实缺陷**,本轮新增为 coupon-share 功能场景的**覆盖补强(G12)**而非回归红。
+
+**G12 闸门**:本轮 SRS 文件(`docs/superpowers/specs` 204 份)窗口**零变更**;但 **src 新增 coupon-share 功能场景**(T03 前端 + T01 数据层已入 `9528c60db`,契约已登记 `API_REFERENCE §4.32 ARCH-CFC-COUPON-SHARE-GIFT-001`),原用例覆盖为空 → **本轮补台账** `tests/test-cases/2026-11-16-coupon-share-gift.md`(**16 条 TC**:契约 5 端点 12 条 + 前端场景 6 条 + 自动化映射,待 T02 入库后转契约断言)。
+
+**测试结果有变化(R224 → R225)— 触发提交 + 通知研发**
+- 🟢 **coupon-share 新功能前端(T03)已合入主干**:share-claim 落地页 + 券列表分享入口 + 分享记录 tab;前端 Jest 44 套零新增红(红集与 R221 同型)、线上 frontend E2E 6/6 全绿 → **无回归**。
+- 🟢 **线上 API 点名 33/0/3 与 R224 逐例零漂移**。
+- 🟢 **B-225-1 已闭环**:研发 02:21 合入 T02 后端(`2ceab5553`,5 端点+契约单测),复核跑 `CouponShareClaimContractTest` **全绿** → 线上超前于源码的漂移已回收。
+- 🔴 **lg 红集 8→6**:均为 AgnesAI 429 环境型(日志实证「rate limit for free users → 默认 chat」),非产品缺陷;观察 3/3。
+- 🟡 **G12 补强**:coupon-share 契约+前端场景 16 条 TC 入 `tests/test-cases/`。
+- 🟡 **窗口后置增补**:S-cfc-382 / S-cfc-405 在报告定稿后推送,R226 起纳入全量复验。
+
+---
+
+## 2. 项目画像(本轮视角)
+
+- **业务定位**:家庭教育 SaaS(五维能量 · 成长规划 · 测评订单 · 商城 · 健康报告解析 · 家庭工作台 · AI 教练),双端:小程序 H5 `cfc.iwintrue.com/frontend` + Web 管理端 `cfc.iwintrue.com/admin`。
+- **技术栈**:`cfc-backend` Spring Boot 2.7.18 / MyBatis-Plus / JDK 1.8(9082)· `cfc-web` Vue2 + Element UI(8082)· `cfc-frontend` uni-app 小程序(H5 预览)· `cfc-langgraph` FastAPI + LangGraph + ChromaDB(251 节点)· `dan/danshop` 独立商城(8888)。
+- **本轮窗口 diff(`8010b1f34..9528c60db`)**:10 文件 +569/-12,全部为 `cfc-frontend`(coupon-share 5 文件 +552)与 `cfc-web`(版本 bump/CHANGELOG 5 文件);**后端、tests/、SRS 零变更**。
+- **测试资产现状**:后端测试源 517 文件;Playwright spec 80;Jest web 21/fe 46 套;langgraph pytest 10 文件;用例台账 21→**22** 份(本轮 +coupon-share 16 TC);用户场景 11 份(SC 244)。
+- **质量目标(用户口径)**:所有测试用例全部覆盖并通过对;用例覆盖全部 SRS 与用户场景(含异常流);SRS/场景变更时同步更新用例。
+- **本轮风险点**:① **B-225-1** coupon-share T02 后端未入库(线上超前于源码 → 主干与部署漂移,需研发回收);② lg 429 配额不稳;③ G11 CI 清单失真承袭;④ B-218-1 P0 未修承袭。
+
+---
+
+## 三、20 类测试覆盖矩阵(本轮增量见标注「▸R225」)
+
+| # | 测试类型 | 层次 | 状态 | 证据 |
+|---|---|---|---|---|
+| 1 | 单元测试 | 功能层次 | **已发现** | 后端 517 源 test-compile SUCCESS(承采);web 21 套 134 例、fe 44 套 652 例实跑 |
+| 5 | 接口 API 测试 | 功能层次 | **已发现** | 线上点名 4 文件 33 过 3 跳;shop 4/4;health 13/13;**▸ coupon-share 5 端点探活(create 401 / detail 200+业务404 / 不存在端点 404)** |
+| 6 | 系统/端到端 | 功能保障 | **已发现(实跑)** | 本机 28 过(admin 5 + fe 6 + shop 4 + health 13)+ 2 跳 + 189 admin 5 = 33 过 + 2 跳 |
+| 10 | 回归测试 | 功能保障 | **已发现** | web/fe/浏览器/线上 API 逐例对照零漂移;**▸ coupon-share 合入后 fe Jest / frontend E2E 无回归** |
+| 12 | 性能测试 | 非功能 | **未发现(未实测)** | 无压测;`nonfunc-perf-compat` 7 例冒烟绿(承采 R224) |
+| 13 | 可靠性测试 | 非功能 | **部分已发现** | lg 429 环境型第 3 轮同型;health 全绿 |
+| 14 | 安全测试 | 非功能 | **部分已发现** | 匿名端点 401 契约、跨家庭 403 断言(承采);无 SAST(未授权联网) |
+| 18 | QA 流程 | 度量与流程 | **部分已发现** | **▸ B-225-1 线上超前于源码**;G11 承袭 |
+| 20 | 全项目代码审查 | 度量与流程 | **部分已发现** | 本轮 3 提交已审(coupon-share 前端 5 文件 / merge / bump),未见注入风险 |
+
+> 1-4/7-9/11/15-17/19 与 R224 结论一致(存量/缺口/承采),不逐行重复。
+
+---
+
+## 四、覆盖缺口清单
+
+| 缺口 | 说明 | 优先级 | 责任人 | 闭环判据 |
+|---|---|---|---|---|
+| BDD 规格 | 全仓 `.feature` = 0,无行为规格 | P2 | 测试 | 新增用例转 BDD |
+| UAT 签署 | 无人工 UAT 记录(无人值守窗口) | P2 | 产品/测试 | 签署记录 |
+| 无障碍断言 | admin 修复无 axe/WCAG 断言 | P2 | 研发/测试 | 补自动化断言 |
+| **▸ B-225-1 coupon-share T02 入库** | **已闭环**(研发 02:21 合入 `2ceab5553`,复核契约单测全绿) | ~~P1~~ | 研发(已闭环) | T02 已入库,契约测试从探活转断言 |
+| **▸ coupon-share 用例转断言** | 台账 TC-CS-01~05-P 待 T02 入库后按契约断言执行(T02 已入库,R226 起执行) | P2 | 测试 | R226 起执行 `coupon-share-contract.spec.js` |
+
+---
+
+## 五、域结论表
+
+| 域 | 结论 | 一句话 |
+|---|---|---|
+| 功能域 | **部分通过** | 全部既有功能零回归;coupon-share 新功能前端已上线且无回归,后端 T02 待入库 |
+| 非功能域 | **部分通过(未实测压测)** | lg 429 承袭;性能/安全未新增证据 |
+| AI 域(G7) | **37/43**(6 红=429 环境型,观察 3/3) | 无产品缺陷 |
+| 流程域 | **存在缺口** | B-225-1 线上超前源码;G11 承袭 |
+
+---
+
+## 六、五要素问题清单(新增/变化项)
+
+**问题 1(P1 流程,B-225-1 → 已闭环)coupon-share T02 后端未入库但线上已部署**
+- ① 描述:`git log --all -S "coupon/gift/share" -- cfc-backend/src/main/java` 曾仅命中 T01 数据层提交 `98ca36287`;主干 `CouponGiftController` 曾仅 6 端点。线上却已存在 handler(`/share/detail` 匿名 200+业务404、`/create` 401、不存在端点 404)。
+- ② 处置:**研发 02:21 合入 `2ceab5553`**(CouponShareService 448 行 + Controller 5 端点 + JwtInterceptor 放行 + `CouponShareClaimContractTest` 592 行);本报告复核时于 `3e024736d+` 跑该契约单测 **全绿**(创建/幂等/领取链路通过)。
+- ③ 遗留:契约断言用例(TC-CS-01~05 等)R226 起执行;S-cfc-382 / S-cfc-405 后置增补纳入 R226 全量。
+
+**问题 1b(观察)窗口后置功能增补**
+- R225 报告定稿后远端追加 S-cfc-382(plan.draft.save,SC-P-81)、S-cfc-405(cf.rewardv2.platformTake)至 `33e314cba`——R226 起纳入全量复验与用例覆盖核对。
+
+**问题 2(P0 环境,承袭 B-223-1)langgraph 429 环境红**
+- ① 描述:43 例中 6 红(`test_auto_tag`×2 + `test_intent`×4),日志实证 `Error code: 429 - AgnesAI_error … 默认 chat` → 断言被联动打红;红集为 R224 8 红的子集(429 命中波动)。
+- ② 建议:251 升级 Token Plan / 轮换配额 key;研发将 429 由「静默兜底 chat」改为「显式失败可重试」。
+
+**问题 3(P0,承袭 B-218-1)@Resource Bean 撞名守卫红**:后端零变更 → 承袭 R224 实测(1/1 红,第 5 轮观察)。
+
+---
+
+## 七、门禁结论
+
+| 门禁 | 结论 | 依据 |
+|---|---|---|
+| G1 通过率 | **警告(有条件)** | 可验证子集 99.24%(剔预期红);含环境红 6/429 + 存量 17 |
+| G3 浏览器 E2E | **通过** | 33 过 + 2 跳(含新功能 frontend 6/6 重跑) |
+| G4 可构建 | **通过(承采)** | test-compile BUILD SUCCESS;后端零变更 |
+| G6 不回归 | **通过** | 全部既有套件逐例零漂移;coupon-share 无回归 |
+| G7 AI 域 | **通过(环境例外)** | 37/43,6 红全 429 环境型 |
+| G11 CI | **不通过(承袭)** | 清单失真,P1,第 27 轮 |
+| G12 SRS 同步 | **通过(补强后)** | 窗口 SRS 零变更;coupon-share 新场景已补 16 条 TC 台账 |
+
+**裁决:不通过(有条件)** —— 阻塞项为承袭 P0(B-218-1);B-225-1 已闭环(T02 已入库并复核全绿);环境红 429 不阻塞。复评条件:① B-218-1 修复;② lg 429 缓解或转显式失败;③ R226 全量复验(含后置增补 S-cfc-382 / S-cfc-405 与 coupon-share 契约断言)。
+
+---
+
+## 八、增量复验说明
+
+- 本轮窗口**非 0 提交**:`9dc097eab`(coupon-share T03 前端,5 文件 +552)、`d26a795a5`(merge feature/coupon-share-front)、`9528c60db`(bump version/changelog)。
+- R225 执行期间远端继续推进:251 节点 fetch 时 `origin/cfclub` 已到 `d26a795a5`,本机复核时已至 `9528c60db`;**已用最新 `9528c60db` 在隔离 worktree 重跑 frontend Jest(44 套)与线上 frontend E2E(6/6)**,覆盖新功能代码。
+- **B-225-1 闭环复核(后置)**:远端在报告定稿前继续推送至 `33e314cba`,其中 **`2ceab5553` 为 coupon-share T02 后端**;本报告复核时 fetch `origin/cfclub`、rebase 后在最新基线上跑 `CouponShareClaimContractTest` **全绿**(5m16s),确认 T02 已入库且功能链路(创建/幂等/领取)通过。
+- 线上 API 点名沿用 R224 origin 版 spec(`dimension-energy` 403 断言)在 R225 worktree 复跑 33/0/3,零漂移。
+
+---
+
+## 附录 A:本轮命令(可复现)
+
+```bash
+# 基线(HTTP 通道,SSH 不适用)
+git fetch http://git.iwintrue.com/liaoxg/cfc.git +refs/heads/cfclub:refs/remotes/origin/cfclub
+
+# 隔离 worktree(避免主区 20+ 未跟踪文件)
+git worktree add .worktrees/test-lead-R225 --detach 8010b1f34  # 后 reset --hard 9528c60db
+cmd /c "mklink /J .../tests/node_modules  .../tests/node_modules"  # 统一 @playwright/test
+New-Item -ItemType Junction .../cfc-frontend/node_modules -Target .../cfc-frontend/node_modules
+
+# 189 admin(每节点单任务,远程派发)
+node .tdd/_dispatch_R225_189_admin.cjs   # npx playwright test -c playwright.config.live.js --project=admin-desktop → 5/5 EXIT=0
+
+# 251 langgraph(远程派发,reset 到 origin/cfclub 后跑 pytest)
+node .tdd/_dispatch_R225_251_lg.cjs      # 43 例 37 过 6 红,HEAD_AFTER=9528c60db
+
+# 本机浏览器(串行)
+node node_modules/playwright/cli.js test -c playwright.config.live.js --project=admin-desktop   # 5/5
+node node_modules/playwright/cli.js test -c playwright.config.live.js --project=frontend-mobile  # 6/6(新基线重取)
+node node_modules/playwright/cli.js test -c playwright.config.live.js --project=shop-api         # 4/4
+npx playwright test -c playwright.config.health.js                                              # 13/13
+
+# Jest
+node node_modules/jest/bin/jest.js -c cfc-web/jest.config.js      # 124/10/134(承采)
+node node_modules/jest/bin/jest.js                                # worktree cfc-frontend 44 套 636/4/12/652
+node node_modules/jest/bin/jest.js -c tests/jest.config.js        # 7/16/23
+
+# 线上 API 点名 4 文件(worktree,origin 版 spec)
+node node_modules/playwright/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
+# → 33 过 / 0 红 / 3 跳
+
+# coupon-share 线上探活
+curl -X POST cfc.iwintrue.com/api/coupon/gift/share/detail -d '{"shareToken":"test"}' → 200 {"code":404,"message":"分享不存在或已失效"}
+curl -X POST cfc.iwintrue.com/api/coupon/gift/share/create  → 401
+curl -X POST cfc.iwintrue.com/api/coupon/gift/share-nonexistent → 404(对照组)
+```
+
+## 附录 B:口径声明
+
+- 承采项仅限「后端全量 / test-compile / cfc-web Jest」:本轮窗口后端与 cfc-web **零变更**,承采 R224 实测结论(51:50 全量不重复消耗)。
+- cfc-frontend Jest 计数口径:R224 记 46 套/660(主区含本地未入库资产),R225 以隔离 worktree 跑 44 套/652,**红集 3 套 4 例与 R221/R224 同型**(dayGroupView / viewKeyAndDelete / consignee)。
+- langgraph 红集 8→6 为 429 配额命中的随机波动(R225 的 6 红 ⊆ R224 的 8 红),判据为日志中 `AgnesAI rate limit → 默认 chat` 实证。
+- 未执行需联网的依赖漏洞扫描/压测(execute 档未授权);未启停服务、未改 `src/main`。

+ 39 - 0
docs/tdd/test/automation-run-2026-11-16-R225.md

@@ -0,0 +1,39 @@
+# 自动化执行日志 R225(2026-11-16 01:57 ~ 02:50 GMT+8)
+
+- **触发**:定时自动化「测试负责人闭环(全部用例通过 + 覆盖 SRS/场景含异常流)+ 浏览器走 cfc.iwintrue.com/admin 与 /frontend(189/本机每节点单任务)+ langgraph 派 251 + 结果有变提交远程并通知研发」
+- **执行档**:review(离线白名单)+ 内网三节点浏览器 E2E 实跑;未联网装依赖、未启停服务、未改 src/main
+- **静默**:全程未提问(用户指令「全程不要提问,静默完成」);方案假设已在报告 §2 声明
+- **基线**:`origin/cfclub` `9528c60db`(HTTP 通道 fetch);R224 基线 `8010b1f34`,窗口 **+3 提交**(coupon-share T03 前端 `9dc097eab` / merge `d26a795a5` / bump `9528c60db`)
+- **隔离**:`git worktree add .worktrees/test-lead-R225`(初置 `8010b1f34`,复核时 `reset --hard 9528c60db`);`tests/node_modules` 与 `cfc-frontend/node_modules` 为本机 junction(统一依赖版本)
+
+## 时间线
+
+| 时间 | 动作 | 结果 |
+|---|---|---|
+| 01:57 | 建隔离 worktree(HEAD=`8010b1f34`)+ 生成派发脚本 | `_dispatch_R225_189_admin.cjs` / `_dispatch_R225_251_lg.cjs` 就绪 |
+| ~02:00 | 189 admin 派发 | **5/5 EXIT=0**(1.1m,spec blob 同本机) |
+| 02:01 | 251 langgraph 派发(先 kill 超 30min 残留 pytest,`git reset --hard origin/cfclub`) | 执行中,HEAD 观察到 `d26a795a5` → `9528c60db` |
+| 02:02~02:10 | 本机浏览器套件串行 | admin **5/5**、frontend **6/6**、shop-api **4/4**、health **13/13**、dx-bridge **2 跳** |
+| 02:05 | 251 收口 | **43 例 / 37 过 / 6 红**(108.52s,EXIT=0);红=auto_tag×2+intent×4,429 环境型(R224 红集 8 的子集) |
+| 02:10 | 线上 API 点名 4 文件(R225 worktree,origin 版 spec) | **33 过 / 0 红 / 3 跳**(31.6s)与 R224 零漂移 |
+| 02:12 | Jest:web / fe / 根级 | web **124/10/134**(承采,cfc-web 零变更);根级 **7/16/23**(B-36 承袭) |
+| 02:15 | 复核远端推进 | origin/cfclub 已至 `9528c60db`(coupon-share 前端合入)→ **重置 worktree 到新基线** |
+| 02:16~02:18 | worktree `9528c60db` 重跑 cfc-frontend Jest(含 coupon-share 代码) | **44 套 / 636 过 / 4 红 / 12 跳 / 652**;红集 3 套与 R221/R224 同型(dayGroupView / viewKeyAndDelete / consignee) |
+| 02:19 | 线上 frontend E2E 重取(新功能上线后) | **6/6**(47.0s)→ coupon-share 无回归 |
+| 02:25~02:40 | coupon-share 功能盘点 | diff 仅 cfc-frontend 5 文件;SRS/场景/用例覆盖为空;线上探活:`share/detail` 匿名 200+业务404、`share/create` 401、不存在端点 404 → **T02 后端未入库但线上已部署(B-225-1)** |
+| 02:40 | 补 coupon-share 测试台账 | `tests/test-cases/2026-11-16-coupon-share-gift.md`(16 条 TC:契约 5 端点 12 条 + 前端 6 条) |
+| 02:45 | 报告 / 日志 / 通知 | 写盘(worktree) |
+
+## 关键处置
+
+1. **B-225-1(已闭环)**:coupon-share T02 后端 Controller 一度未入 git,但线上端点可响应;**研发 02:21 合入 `2ceab5553`**,复核 fetch 最新基线跑 `CouponShareClaimContractTest` **全绿** → 漂移回收。
+2. **G12 覆盖补强(已执行)**:coupon-share 契约(API_REFERENCE §4.32)+ 前端场景(share-claim/分享入口/记录 tab)派生 16 条 TC 入台账;T02 已入库,R226 起转契约断言执行。
+3. **远端推进应对(已执行)**:R225 执行中途远端推送 coupon-share(8010b1f34→9528c60db),worktree 重置新基线并重跑 fe Jest + frontend E2E;报告定稿前远端再推进至 `33e314cba`(T02 后端 + S-cfc-382/405),复核 catch-up 并补跑 T02 契约单测。
+4. **lg 红集 8→6(观察 3/3)**:429 配额波动,红集为 R224 子集,环境型判据(日志 AgnesAI rate limit)。 
+
+## 未做(明确声明)
+
+- 后端全量(51:50)与 test-compile:窗口后端 src 零变更,承采 R224 实测,未重复消耗。
+- cfc-web Jest:cfc-web 零变更,承采 R224。
+- 未执行需联网的依赖漏洞扫描 / 压测(execute 档未授权)。
+- 未启动/重启任何服务;未修改 `src/main`。

+ 63 - 0
notice-2026-11-16-R225-研发通知.md

@@ -0,0 +1,63 @@
+# 研发通知 R225(2026-11-16 02:50 GMT+8 · 测试结果有变化)
+
+> 收件人:cfc 研发组(backend / frontend / langgraph)
+> 发件人:测试负责人(自动化闭环 R225)
+> 触发条件:**测试结果有变化** → 提交远程 + 通知研发(按用户指令)
+
+---
+
+## 一、本轮变化摘要
+
+| 项 | R224 | R225 | 性质 |
+|---|---|---|---|
+| 基线 | `8010b1f34` | `9528c60db`(窗口 +3 提交) | **有 src 变更** |
+| langgraph@251 | 43 例 / 35 过 / 8 红 | 43 例 / **37 过 / 6 红** | 429 环境波动(红集 8→6,为子集) |
+| 线上 API 点名 | 33/0/3 | 33/0/3 | 零漂移 |
+| 浏览器 E2E | 33 过 + 2 跳 | 33 过 + 2 跳(frontend 6/6 新基线重取) | 无回归 |
+| cfc-frontend Jest | 46 套 660 例(主区口径) | 44 套 652 例(worktree),红集同型 3 套 4 红 | 无新增红 |
+| 真实产品缺陷红 | 17 | **17(无新增)** | 承袭 |
+
+**结论:无新增真实产品缺陷回归;coupon-share 新功能前端已合入主干且无回归。**
+
+---
+
+## 二、需要研发处理的问题
+
+### 🔴 P0(承袭,第 5 轮观察)B-218-1:`@Resource` Bean 撞名守卫红
+- `ResourceBeanNameCollisionGuardTest` 1/1 红,后端零变更承袭未修。
+- 复现要点见 R224 报告 §6。
+
+### 🟠 P1(🎉 已闭环)B-225-1:coupon-share T02 后端一度未入库但线上已部署
+- **发现**:主干 `CouponGiftController` 一度仅 6 端点、`git log --all -S "gift/share"` 仅命中 T01 数据层,但线上 `POST /api/coupon/gift/share/detail` 匿名 → **200 + `{"code":404,"message":"分享不存在或已失效"}`**、`/create` 未登录 → **401**、不存在端点 → **404** → 线上部署超前于源码。
+- **处置确认(✅ 已闭环)**:研发 02:21 合入 **`2ceab5553`(coupon-share T02 后端接口+契约单测)**——`CouponShareService` 448 行 + `CouponGiftController` 5 端点(share/create·detail·claim·revoke·list)+ JwtInterceptor 放行 + `CouponShareClaimContractTest` 592 行。
+- **测试复核**:测试侧已经 fetch 最新基线并单独运行 `CouponShareClaimContractTest` → **全绿**(创建分享 / 幂等 PENDING / 领取转 transferId 链路通过,5m16s)。
+- **后续**:R226 起 `coupon-share-contract.spec.js` 由探活转全断言(TC-CS-01~05-P 12 条),台账见 `tests/test-cases/2026-11-16-coupon-share-gift.md`。
+
+### 🟡 后置增补提醒(R226 纳入复验)
+- 报告定稿后远端追加 **S-cfc-382(plan.draft.save 方案草稿保存,SC-P-81)** 与 **S-cfc-405(cf.rewardv2.platformTake 平台抽成)** 至 `33e314cba`——测试侧 R226 起纳入全量复验与用例覆盖核对,请研发同步确认契约登记。
+
+### 🟠 P0 环境(承袭,观察 3/3)B-223-1:langgraph 429 环境红
+- 43 例中 6 红(`test_auto_tag`×2 + `test_intent`×4),日志实证 `AgnesAI Error code: 429 (rate limit for free users) → 默认 chat` → 断言被联动打红。
+- 红集为 R224 8 红的子集(配额命中波动),**非产品缺陷**。
+- 请运维/研发:① 251 升级 Token Plan 或轮换有配额 key;② 将 429 由「静默兜底 chat」改为「显式失败 + 可重试」,避免掩埋真实意图分类错误。
+
+---
+
+## 三、本轮已闭环 / 已补强
+
+| 项 | 状态 |
+|---|---|
+| coupon-share 前端 T03(share-claim 落地页 + 分享入口 + 记录 tab) | ✅ 已合入 `9528c60db`,线上 frontend E2E 6/6 无回归,fe Jest 无新增红 |
+| G12 用例同步(coupon-share 契约 + 场景 16 TC) | ✅ 已入 `tests/test-cases/2026-11-16-coupon-share-gift.md` |
+| 线上 API 点名 33/0/3、既有浏览器/Jest 全量 | ✅ 与 R224 逐例零漂移 |
+| coupon-share T02 后端入库 | ⏳ **待研发**(B-225-1) |
+
+---
+
+## 四、复评条件(R226 起)
+
+1. B-218-1(P0 Bean 撞名)修复;
+2. lg 429 缓解(升级配额)或转显式失败可重试;
+3. R226 全量复验新增:coupon-share 契约断言(T02 已入库)+ S-cfc-382 / S-cfc-405 覆盖核对。
+
+> B-225-1 已闭环(T02 已入库且契约单测全绿),不再列入阻塞。

+ 53 - 0
tests/test-cases/2026-11-16-coupon-share-gift.md

@@ -0,0 +1,53 @@
+# 2026-11-16 功能新增专项用例(优惠券分享转赠 T03 前端 + T01/T02 契约)
+
+> 本文件为 **G12 需求变更→测试用例** 的派生产物,对应功能:
+> - 前端实现:`9dc097eab`(cfc-frontend share-claim 落地页 + 券列表分享入口 + 分享记录 tab),**已合入 cfclub**(R225 基线 `9528c60db`)
+> - 数据层:`98ca36287`(T01,coupon_share 表迁移 494 + coupon_gift_transfer 扩展列迁移 495),已入主干
+> - 契约登记:`docs/superpowers/api/API_REFERENCE.md §4.32「会员券分享转赠(/api/coupon/gift/share/*,ARCH-CFC-COUPON-SHARE-GIFT-001 §5)」`(create/detail/claim/revoke/list 5 端点)
+> - **⚠️ 观察项 B-225-1(P1 测试资产)**:T02 后端 Controller/Service 实现**未在任何 git 分支入库**(`git log --all -S "gift/share"` 仅 T01),但线上 `POST /api/coupon/gift/share/detail` 匿名返回 200+业务404「分享不存在或已失效」、`/create` 未登录 401、不存在端点 404 → **线上部署超前于源码**,契约用例暂按契约登记描述(预期 401/404 由拦截器/业务返回),待 T02 入库后转断言。
+>
+> **派生策略**:契约锚点复用 API_REFERENCE §4.32;三流齐备(正常 / `-E` 异常 / `-P` 权限)。
+> **执行状态**:本文件为 R225 新增台账(**待执行**,契约基础已探活见上);R226 起按契约断言执行。
+
+---
+
+## 一、契约用例(`/api/coupon/gift/share/*`,5 端点)
+
+| TC 编号 | 环节 | 角色 | 优先级 | 类型 | 前置条件 | 测试步骤 | 预期结果 | 关联契约 |
+|---|---|---|---|---|---|---|---|---|
+| TC-CS-01 | create 幂等建 token | 已登录家长 | P0 | 功能 | 登录态;家庭有可用「会员专属券」familyCoupon | 1. `POST /api/coupon/gift/share/create { familyCouponId }`<br>2. 同参数再次调用 | 首次返回 `{ shareToken, sharePath:"/pages/coupon/share-claim?shareToken=…", expireAt }`;再次调用**幂等返回同一 token**(PENDING 不报错) | §4.32 create |
+| TC-CS-02 | detail 匿名可浏览 | 游客 | P0 | 功能 | 无 token;存在一个有效 shareToken | 1. `POST /api/coupon/gift/share/detail { shareToken }`(**匿名**) | 200;data 含 `status/couponName/couponValue/couponType/minSpend/validUntil/giverNickname/giverAvatar/expireAt/claimable` | §4.32 detail |
+| TC-CS-03 | claim 领取成功 | 已登录家长(非本人/非同家庭) | P0 | 功能 | 有效未领取 shareToken;领者非同一人且非同家庭 | 1. `POST /api/coupon/gift/share/claim { shareToken }` | 200 `{ transferId }`;该 token 状态 PENDING→CLAIMED;并发重放应防重领(条件更新影响 1 行) | §4.32 claim |
+| TC-CS-04 | revoke 撤回 | 已登录家长(giver) | P0 | 功能 | giver 登录态;存在自己发起的 PENDING shareToken | 1. `POST /api/coupon/gift/share/revoke { shareToken }` | 200;status→REVOKED;券实例不动 | §4.32 revoke |
+| TC-CS-05 | list 分享记录 | 已登录家长 | P1 | 功能 | 有分享记录 | 1. `POST /api/coupon/gift/share/list {}` | 200 `[{ shareToken, couponName, couponValue, status, expireAt, claimTime, createdAt, claimNickname }]` created_at DESC | §4.32 list |
+| TC-CS-01-E | create 参数/归属/类型异常 | 已登录家长 | P1 | 异常 | 各种错误输入 | 1. `{ }` 缺参<br>2. 非本人/不可用券<br>3. 非会员专属券 | 500 + message:参数不完整 / 该优惠券不可用或不属于你 / 仅会员专属券可分享 | §4.32 create |
+| TC-CS-02-E | detail token 无效 | 游客 | P1 | 异常 | 无记录 token | 1. `{ shareToken:"no-such" }` | 404「分享不存在或已失效」 | §4.32 detail |
+| TC-CS-03-E | claim 状态冲突链 | 已登录家长 | P1 | 异常 | 已领取/已撤回/已过期/自领/同家庭 | 1-5. 依次构造上述 5 种状态领取 | 500 + message:已领取 / 已撤回 / 已过期 / 不能领取自己分享的券 / 不能领取同家庭成员的券 | §4.32 claim |
+| TC-CS-04-E | revoke 越权 | 非 giver | P1 | 权限 | 他人 shareToken | 1. 非 giver 调 revoke | 500「无权操作该分享」 | §4.32 revoke |
+| TC-CS-01-P | create 未登录 | 游客 | P0 | 权限 | 无 token | 1. `POST /api/coupon/gift/share/create` | 401(JwtInterceptor,线上已探活) | §4.32 |
+| TC-CS-03-P | claim 未登录 | 游客 | P0 | 权限 | 无 token | 1. `POST /api/coupon/gift/share/claim` | 401 | §4.32 |
+| TC-CS-05-P | list 未登录 | 游客 | P0 | 权限 | 无 token | 1. `POST /api/coupon/gift/share/list` | 401 | §4.32 |
+
+---
+
+## 二、前端场景用例(T03,cfc-frontend)
+
+| TC 编号 | 环节 | 角色 | 优先级 | 类型 | 前置条件 | 测试步骤 | 预期结果 | 关联代码 |
+|---|---|---|---|---|---|---|---|---|
+| TC-CS-11 | 券列表分享入口(两段式 token) | 家长(小程序端) | P0 | 功能 | 登录;券列表有可分享券 | 1. 进入「我的-优惠券」列表<br>2. 点击某券「分享」→ 异步 create 拿 token → 按钮变「发送给好友」<br>3. 触发 onShareAppMessage | 分享 path = `/pages/coupon/share-claim?shareToken=<token>`(幂等 PENDING 复用) | coupons.vue `prepareShare/onShareAppMessage` |
+| TC-CS-12 | share-claim 落地页渲染(正常态) | 游客/被赠人 | P0 | 功能 | 访问含有效 shareToken 的 path | 1. 打开 `/pages/coupon/share-claim?shareToken=有效` | 显示「好友送你一张会员券」+ 券卡片(面值/类型/使用条件/有效期)+ 赠送人信息(昵称/头像)+「确认领取」按钮 | share-claim.vue |
+| TC-CS-13 | share-claim 失效态展示 | 游客 | P1 | 功能 | token 无效/被领/被撤/过期 | 1. 打开对应失效 token path | 显示「分享已失效」态,不渲染领取按钮,不 5xx | share-claim.vue `isInvalid` |
+| TC-CS-14 | 领取成功态与结果反馈 | 被赠人 | P1 | 功能 | 有效 token + 登录 | 1. 点击「确认领取」 | 调 claim 成功;toast/跳转反馈;券入被赠人家庭 | share-claim.vue `onConfirmClaim` |
+| TC-CS-15 | 未登录领取触发登录浮层 | 游客 | P1 | 权限 | 有效 token,未登录 | 1. 点击「确认领取」 | 弹出 login-sheet 登录浮层;登录成功后继续领取 | share-claim.vue + login-sheet |
+| TC-CS-16 | gift-coupon 页分享入口回归 | 家长 | P1 | 功能 | 会员赠券场景 | 1. 进入 gift-coupon.vue 相关赠券页<br>2. 检查分享入口存在且可触发 | 分享入口正常,无控制台报错 | gift-coupon.vue |
+
+---
+
+## 三、执行与自动化映射(R226 起启用)
+
+| 用例簇 | 建议自动化载体 | 状态 |
+|---|---|---|
+| TC-CS-01~05、01-E~05-P | `tests/e2e/api/coupon-share-contract.spec.js`(线上 API 契约,需 T02 入库后转断言;当前先探活) | 待 T02 入库 |
+| TC-CS-11~16 | cfc-frontend Jest 组件测(`pages/coupon/__tests__/share-claim.spec.js`,Mock request) | 待补 |
+| TC-CS-12~15 | `tests/e2e-live/frontend-live.spec.js` 追加 share-claim 落地页只读断言(游客失效态) | R226 补 |
+| SC 锚点 | 优惠券转赠场景(历史 `02-parent.md` 定向转赠基础上扩展分享通道) | 台账登记 |