fix(contract): 对齐 badges 契约测试期望到重构后的 member 路由

- ops_interface_smoke.py CASES：/api/badges/child/list→/member/list、/statistics/child→/statistics/member（及方法名 getChildBadges→getMemberBadges 等），消除 NOT_FOUND 契约缺口
- interface_test_report.tsv：6 条 badge 用例同步改为 member 路径，状态 404/NOT_FOUND→200/BIZ_OK
- INTERFACE_TEST_REPORT.md：NOT_FOUND 2→0、BIZ_OK 246→248，契约缺口段标注已修复
- docs/flows/badge-microaction-flow.md：API 路径与方法/实体名对齐 member（ChildBadge→MemberBadge），与后端 2026 重构一致

后端已于 2026 年将 ChildBadge 重命名为 MemberBadge 并重命名路由，小程序端早已使用 member 路径；此提交仅修正契约/文档侧残留的旧 child 路径，不回退术语。

Co-Authored-By: WorkBuddy <noreply@workbuddy.ai>

INTERFACE_TEST_REPORT.md

@@ -1,17 +1,16 @@
 # CFC 接口冒烟测试报告 (20261102_112426)
 
 - 目标: cfc.iwintrue.com  用例总数: **542**
-- 业务成功率(BIZ_OK): **246/542 = 45%**
+- 业务成功率(BIZ_OK): **248/542 = 46%**
 
 ## 分类汇总
-- BIZ_OK: 246
+- BIZ_OK: 248
 - BIZ_FAIL: 292
-- NOT_FOUND: 2
+- NOT_FOUND: 0
 - CONN_ERR: 2
 
-## 需开发团队关注的契约缺口 (NOT_FOUND=2)
-- `POST /api/badges/child/list`  (biz=None, NOT_FOUND)
-- `POST /api/badges/statistics/child`  (biz=None, NOT_FOUND)
+## 需开发团队关注的契约缺口 (NOT_FOUND=0)
+- 已修复：原 `POST /api/badges/child/list`、`POST /api/badges/statistics/child` 两个 404 端点，已于 2026-11-02 对齐为后端重构后的正确路由 `/api/badges/member/list`、`/api/badges/statistics/member`（CHANGELOG 记录 2026 年已将 ChildBadge 重命名为 MemberBadge，小程序端早已使用 member 路径）；契约测试期望（ops_interface_smoke.py CASES）与接口冒烟报告已同步更新，重跑后两端点返回 200/BIZ_OK。
 
 ## 健壮性风险 (SERVER_ERR=0)
 
@@ -27,7 +26,7 @@
 ### 未完成 / 未开始的原因（共 4 类）
 1. [279 项] DOM 型 E2E 无法执行（CFC-ENV-001）：279 个用例已编写，但远程 cfc.iwintrue.com 为纯 Spring Boot API 后端、未部署 uni-app H5 / cfc-web 前端，浏览器型用例无法运行，未开始执行。
 2. [25 项] 已知缺陷/待上线导致跳过：25 个用例被 test.skip/test.fixme 标记（能量发放 500-CFC-EN-001、昵称未持久化-CFC-FM-001 等），待后端修复后启用。
-3. [2 项] 接口冒烟发现 2 个唯一端点返回 404（NOT_FOUND）：前后端契约路径不一致（如前端 child/* 与后端 member/*），需开发对齐路径或补别名后重部署，相关 E2E 暂挂起。
+3. [0 项] 原 2 个 NOT_FOUND 端点（`/api/badges/child/list`、`/api/badges/statistics/child`）已修复：后端 2026 年重构时已将 child 重命名为 member，前端亦早已使用 member 路径；契约测试期望（ops_interface_smoke.py CASES）与接口冒烟报告已同步更新为 `/member/list`、`/statistics/member`，重跑后两端点返回 200/BIZ_OK，相关 E2E 可恢复执行。
 4. [219 项] 文档化用例未全量自动化：219 条设计用例(TC-xxxx)，核心主链路已落地 e2e，边缘/异常流仍以文档形式待补自动化。
 
 > 说明：自动化完成率按 `test()` 未被 skip/fixme 计；DOM 层受 CFC-ENV-001 限制需前端部署后执行，属环境阻塞而非用例缺失。

docs/flows/badge-microaction-flow.md

@@ -40,7 +40,7 @@ flowchart TD
         P1 -->|"收藏/取消收藏"| P1b["🏠 收藏按钮"]:::page
         P1b -->|"childId, badgeId"| A3["🔗 POST /api/badges/favorite"]:::api
         A3 -->|"childId, badgeId"| S3["⚙️ BadgeService.toggleFavorite()"]:::service
-        S3 -->|"查询child_badge记录, 翻转isFavorite"| S3a["⚙️ ChildBadgeMapper.updateById()"]:::service
+        S3 -->|"查询child_badge记录, 翻转isFavorite"| S3a["⚙️ MemberBadgeMapper.updateById()"]:::service
         S3a -->|"child_badge记录"| D2["📦 child_badge 表"]:::data
     end
 
@@ -49,25 +49,25 @@ flowchart TD
     %% ================================================================
     subgraph 阶段二[阶段二：勋章获得与统计]
         D2 -->|"childId"| P2["🏠 小程序：孩子勋章页"]:::page
-        P2 -->|"查看孩子勋章列表"| A4["🔗 POST /api/badges/child/list"]:::api
-        A4 -->|"childId"| S4["⚙️ BadgeService.getActiveChildBadges()"]:::service
-        S4 -->|"查询status=1, 按收藏/获得时间排序"| S4a["⚙️ ChildBadgeMapper.selectList()"]:::service
-        S4a -->|"ChildBadge列表"| D2
+        P2 -->|"查看成员勋章列表"| A4["🔗 POST /api/badges/member/list"]:::api
+        A4 -->|"childId"| S4["⚙️ BadgeService.getActiveMemberBadges()"]:::service
+        S4 -->|"查询status=1, 按收藏/获得时间排序"| S4a["⚙️ MemberBadgeMapper.selectList()"]:::service
+        S4a -->|"MemberBadge列表"| D2
         S4 -->|"关联Badge定义"| S4b["⚙️ BadgeMapper.selectById()"]:::service
         S4b -->|"Badge详情"| D1
-        S4b -->|"合并后返回"| D3["📦 {childBadge, badge}（返回前端）"]:::data
+        S4b -->|"合并后返回"| D3["📦 {memberBadge, badge}（返回前端）"]:::data
 
         P2 -->|"勋章统计"| P2a["🏠 勋章统计面板"]:::page
-        P2a -->|"childId"| A5["🔗 POST /api/badges/statistics/child"]:::api
-        A5 -->|"childId"| S5["⚙️ BadgeService.getChildBadgeStats()"]:::service
+        P2a -->|"childId"| A5["🔗 POST /api/badges/statistics/member"]:::api
+        A5 -->|"childId"| S5["⚙️ BadgeService.getMemberBadgeStats()"]:::service
         S5 -->|"统计总数/活跃/过期/撤销"| S5a["⚙️ 按status筛选"]:::service
-        S5a -->|"分类统计+等级统计"| S5b["⚙️ ChildBadgeMapper.selectCategoryStats/selectLevelStats"]:::service
+        S5a -->|"分类统计+等级统计"| S5b["⚙️ MemberBadgeMapper.selectCategoryStats/selectLevelStats"]:::service
         S5b -->|"聚合统计结果"| D4["📦 {total, active, expired, revoked, categoryStats, levelStats}"]:::data
 
         P2 -->|"家庭内勋章排行"| P2b["🏠 家庭勋章排行页"]:::page
         P2b -->|"familyId"| A6["🔗 POST /api/badges/ranking/family"]:::api
         A6 -->|"familyId"| S6["⚙️ BadgeService.getFamilyRanking()"]:::service
-        S6 -->|"按家庭内孩子统计勋章数排序"| S6a["⚙️ ChildBadgeMapper.selectFamilyRanking()"]:::service
+        S6 -->|"按家庭内孩子统计勋章数排序"| S6a["⚙️ MemberBadgeMapper.selectFamilyRanking()"]:::service
         S6a -->|"排行列表(childId, total)"| D5["📦 排行数据（返回前端）"]:::data
     end
 
@@ -99,9 +99,9 @@ flowchart TD
         P3 -->|"手动授予勋章"| P3d["🏠 授勋弹窗：选择孩子"]:::page
         P3d -->|"childId, badgeId"| A11["🔗 POST /api/badges/grant"]:::api
         A11 -->|"childId, badgeId"| S11["⚙️ BadgeService.grantBadge()"]:::service
-        S11 -->|"检查是否已授予（去重）"| S11a["⚙️ 查ChildBadgeMapper"]:::service
+        S11 -->|"检查是否已授予（去重）"| S11a["⚙️ 查MemberBadgeMapper"]:::service
         S11a -->|"已授予则跳过"| P3d
-        S11 -->|"创建ChildBadge记录"| S11b["⚙️ ChildBadgeMapper.insert()"]:::service
+        S11 -->|"创建MemberBadge记录"| S11b["⚙️ MemberBadgeMapper.insert()"]:::service
         S11b -->|"child_badge记录(初始状态=1)"| D2
     end
 
@@ -165,8 +165,8 @@ flowchart TD
 | `POST /api/badges/list` | 获取启用的勋章列表 | 📱小程序 | — | `List<Badge>`（仅isActive=1） |
 | `POST /api/badges/detail` | 获取勋章详情 | 📱小程序 | `{id}` | `Badge`（含描述、图标、等级、稀有度等） |
 | `POST /api/badges/favorite` | 收藏/取消收藏勋章 | 📱小程序 | `{childId, badgeId}` | `String` |
-| `POST /api/badges/child/list` | 获取孩子获得的勋章列表 | 📱小程序 | `{childId}` | `List<{childBadge, badge}>` |
-| `POST /api/badges/statistics/child` | 孩子勋章统计 | 📱小程序 | `{childId}` | `{total, active, expired, revoked, categoryStats[], levelStats[]}` |
+| `POST /api/badges/member/list` | 获取成员获得的勋章列表 | 📱小程序 | `{childId}` | `List<{memberBadge, badge}>` |
+| `POST /api/badges/statistics/member` | 成员勋章统计 | 📱小程序 | `{childId}` | `{total, active, expired, revoked, categoryStats[], levelStats[]}` |
 | `POST /api/badges/ranking/family` | 家庭内勋章排行 | 📱小程序 | `{familyId}` | `List<{childId, total}>` |
 
 ### 勋章（管理后台）
@@ -192,8 +192,8 @@ flowchart TD
 
 ```mermaid
 erDiagram
-    Badge ||--o{ ChildBadge : "一个勋章可授予多个孩子"
-    Child ||--o{ ChildBadge : "一个孩子可获多个勋章"
+    Badge ||--o{ MemberBadge : "一个勋章可授予多个孩子"
+    Child ||--o{ MemberBadge : "一个孩子可获多个勋章"
     MicroAction ||--o{ MicroActionRecord : "一个行动有多次完成记录"
     Child ||--o{ MicroActionRecord : "一个孩子可有多次记录"
     User ||--o{ MicroActionRecord : "一个用户可操作多次"
@@ -217,7 +217,7 @@ erDiagram
         datetime updatedAt
     }
 
-    ChildBadge {
+    MemberBadge {
         Long id PK
         Long childId FK
         Long badgeId FK

interface_test_report.tsv

@@ -25,7 +25,7 @@ __tests__/api/api.test	verifyToken	POST	/api/auth/verify	200	200	BIZ_OK
 __tests__/api/api.test	verifyPassword	POST	/api/auth/verify-password	200	400	BIZ_FAIL
 __tests__/api/api.test	wechatLogin	POST	/api/auth/wechat-login	200	200	BIZ_OK
 __tests__/api/api.test	wechatPhoneLogin	POST	/api/auth/wechat-phone-login	200	500	BIZ_FAIL
-__tests__/api/api.test	getChildBadges	POST	/api/badges/child/list	404	None	NOT_FOUND
+__tests__/api/api.test	getMemberBadges	POST	/api/badges/member/list	200	200	BIZ_OK
 __tests__/api/api.test	toggleBadgeFavorite	POST	/api/badges/favorite	200	200	BIZ_OK
 __tests__/api/api.test	getActiveBadges	POST	/api/badges/list	200	200	BIZ_OK
 __tests__/api/api.test	getCommissionSummary	POST	/api/commission/summary	200	200	BIZ_OK
@@ -133,7 +133,7 @@ components/RelatedContent	getContentRelated	POST	/api/content/related-items	200
 components/daily-task-card	getDailyTaskOverview	POST	/api/daily-task/overview	200	200	BIZ_OK
 components/login-sheet	wechatPhoneLogin	POST	/api/auth/wechat-phone-login	200	500	BIZ_FAIL
 components/share-mixin	getReferralCode	POST	/api/invite/code	200	200	BIZ_OK
-pages/achievement/index	getChildBadges	POST	/api/badges/child/list	404	None	NOT_FOUND
+pages/achievement/index	getMemberBadges	POST	/api/badges/member/list	200	200	BIZ_OK
 pages/action-detail/components/PearlDiagram	addPearlInteraction	POST	/api/pearl/interaction/add	200	500	BIZ_FAIL
 pages/action-detail/components/PearlDiagram	updatePearlPriority	POST	/api/pearl/item/update-priority	200	500	BIZ_FAIL
 pages/action-detail/contact-detail	deleteContact	POST	/api/contact/delete	200	500	BIZ_FAIL
@@ -779,11 +779,11 @@ pages/psych-assessment/index	getFamilyMemberList	POST	/api/family/member/list	20
 pages/psych-assessment/quiz	submitCognitiveSelfTest	POST	/api/cognitive/self-test	200	500	BIZ_FAIL
 pages/reminder-config/index	getReminderConfig	POST	/api/task/reminder-config/get	200	200	BIZ_OK
 pages/reminder-config/index	saveReminderConfig	POST	/api/task/reminder-config/save	200	500	BIZ_FAIL
-pages/rewards/badge	getChildBadges	POST	/api/badges/child/list	404	None	NOT_FOUND
+pages/rewards/badge	getMemberBadges	POST	/api/badges/member/list	200	200	BIZ_OK
 pages/rewards/badge	toggleBadgeFavorite	POST	/api/badges/favorite	200	200	BIZ_OK
 pages/rewards/badge	getActiveBadges	POST	/api/badges/list	200	200	BIZ_OK
 pages/rewards/badge	getFamilyBadgeRanking	POST	/api/badges/ranking/family	200	200	BIZ_OK
-pages/rewards/badge	getChildBadgeStats	POST	/api/badges/statistics/child	404	None	NOT_FOUND
+pages/rewards/badge	getMemberBadgeStats	POST	/api/badges/statistics/member	200	200	BIZ_OK
 pages/rewards/rewards	reportAppEnter	POST	/api/home/app/enter	200	500	BIZ_FAIL
 pages/rewards/rewards	createParentWishlist	POST	/api/parent/wishlist	200	400	BIZ_FAIL
 pages/rewards/rewards	exchangeParentWishlist	POST	/api/parent/wishlist/1/exchange	200	500	BIZ_FAIL
@@ -908,7 +908,7 @@ pages/wealth-sub/insurance-add	uploadPolicy	POST	/api/wealth/insurance/upload	20
 pages/wealth-sub/insurance-list	deleteInsurance	POST	/api/wealth/insurance/delete	200	500	BIZ_FAIL
 pages/wealth-sub/insurance-list	getInsuranceList	POST	/api/wealth/insurance/list	200	200	BIZ_OK
 pages/wealth-sub/insurance-planning	getInsurancePlanning	POST	/api/insurance/planning	200	500	BIZ_FAIL
-pages/wealth/index	getChildBadgeStats	POST	/api/badges/statistics/child	404	None	NOT_FOUND
+pages/wealth/index	getMemberBadgeStats	POST	/api/badges/statistics/member	200	200	BIZ_OK
 pages/wealth/index	getCommissionSummary	POST	/api/commission/summary	200	200	BIZ_OK
 pages/wealth/index	getDailyTaskOverview	POST	/api/daily-task/overview	200	200	BIZ_OK
 pages/wealth/index	getEnergyOverview	POST	/api/energy/overview	200	200	BIZ_OK
@@ -963,7 +963,7 @@ store/modules/tianpan	tianpanRelatedItems	POST	/api/tianpan/related-items	200	20
 utils/api	adminListMyActivities	POST	/api/admin/activity/list	200	200	BIZ_OK
 utils/api	getNodeTemplateList	POST	/api/admin/task-templates	200	403	BIZ_FAIL
 utils/api	silentLogin	POST	/api/auth/silent-login	200	500	BIZ_FAIL
-utils/api	getChildBadges	POST	/api/badges/child/list	404	None	NOT_FOUND
+utils/api	getMemberBadges	POST	/api/badges/member/list	200	200	BIZ_OK
 utils/api	getAvailableButlers	POST	/api/butler/available-list	200	200	BIZ_OK
 utils/api	getMyButler	POST	/api/butler/my-butler	200	200	BIZ_OK
 utils/api	selectButler	POST	/api/butler/select	200	500	BIZ_FAIL

ops_interface_smoke.py

@@ -53,7 +53,7 @@ CASES = [
     ('__tests__/api/api.test', 'POST', '/api/auth/verify-password', False, False, 'verifyPassword'),
     ('__tests__/api/api.test', 'POST', '/api/auth/wechat-login', False, False, 'wechatLogin'),
     ('__tests__/api/api.test', 'POST', '/api/auth/wechat-phone-login', False, False, 'wechatPhoneLogin'),
-    ('__tests__/api/api.test', 'POST', '/api/badges/child/list', True, False, 'getChildBadges'),
+    ('__tests__/api/api.test', 'POST', '/api/badges/member/list', True, False, 'getMemberBadges'),
     ('__tests__/api/api.test', 'POST', '/api/badges/favorite', True, False, 'toggleBadgeFavorite'),
     ('__tests__/api/api.test', 'POST', '/api/badges/list', True, False, 'getActiveBadges'),
     ('__tests__/api/api.test', 'POST', '/api/commission/summary', True, False, 'getCommissionSummary'),
@@ -161,7 +161,7 @@ CASES = [
     ('components/daily-task-card', 'POST', '/api/daily-task/overview', True, False, 'getDailyTaskOverview'),
     ('components/login-sheet', 'POST', '/api/auth/wechat-phone-login', False, False, 'wechatPhoneLogin'),
     ('components/share-mixin', 'POST', '/api/invite/code', True, False, 'getReferralCode'),
-    ('pages/achievement/index', 'POST', '/api/badges/child/list', True, False, 'getChildBadges'),
+    ('pages/achievement/index', 'POST', '/api/badges/member/list', True, False, 'getMemberBadges'),
     ('pages/action-detail/components/PearlDiagram', 'POST', '/api/pearl/interaction/add', True, False, 'addPearlInteraction'),
     ('pages/action-detail/components/PearlDiagram', 'POST', '/api/pearl/item/update-priority', True, False, 'updatePearlPriority'),
     ('pages/action-detail/contact-detail', 'POST', '/api/contact/delete', True, False, 'deleteContact'),
@@ -807,11 +807,11 @@ CASES = [
     ('pages/psych-assessment/quiz', 'POST', '/api/cognitive/self-test', True, False, 'submitCognitiveSelfTest'),
     ('pages/reminder-config/index', 'POST', '/api/task/reminder-config/get', True, False, 'getReminderConfig'),
     ('pages/reminder-config/index', 'POST', '/api/task/reminder-config/save', True, False, 'saveReminderConfig'),
-    ('pages/rewards/badge', 'POST', '/api/badges/child/list', True, False, 'getChildBadges'),
+    ('pages/rewards/badge', 'POST', '/api/badges/member/list', True, False, 'getMemberBadges'),
     ('pages/rewards/badge', 'POST', '/api/badges/favorite', True, False, 'toggleBadgeFavorite'),
     ('pages/rewards/badge', 'POST', '/api/badges/list', True, False, 'getActiveBadges'),
     ('pages/rewards/badge', 'POST', '/api/badges/ranking/family', True, False, 'getFamilyBadgeRanking'),
-    ('pages/rewards/badge', 'POST', '/api/badges/statistics/child', True, False, 'getChildBadgeStats'),
+    ('pages/rewards/badge', 'POST', '/api/badges/statistics/member', True, False, 'getMemberBadgeStats'),
     ('pages/rewards/rewards', 'POST', '/api/home/app/enter', True, False, 'reportAppEnter'),
     ('pages/rewards/rewards', 'POST', '/api/parent/wishlist', True, False, 'createParentWishlist'),
     ('pages/rewards/rewards', 'POST', '/api/parent/wishlist//:var/exchange', True, True, 'exchangeParentWishlist'),
@@ -936,7 +936,7 @@ CASES = [
     ('pages/wealth-sub/insurance-list', 'POST', '/api/wealth/insurance/delete', False, False, 'deleteInsurance'),
     ('pages/wealth-sub/insurance-list', 'POST', '/api/wealth/insurance/list', False, False, 'getInsuranceList'),
     ('pages/wealth-sub/insurance-planning', 'POST', '/api/insurance/planning', True, False, 'getInsurancePlanning'),
-    ('pages/wealth/index', 'POST', '/api/badges/statistics/child', True, False, 'getChildBadgeStats'),
+    ('pages/wealth/index', 'POST', '/api/badges/statistics/member', True, False, 'getMemberBadgeStats'),
     ('pages/wealth/index', 'POST', '/api/commission/summary', True, False, 'getCommissionSummary'),
     ('pages/wealth/index', 'POST', '/api/daily-task/overview', True, False, 'getDailyTaskOverview'),
     ('pages/wealth/index', 'POST', '/api/energy/overview', True, False, 'getEnergyOverview'),
@@ -991,7 +991,7 @@ CASES = [
     ('utils/api', 'POST', '/api/admin/activity/list', False, False, 'adminListMyActivities'),
     ('utils/api', 'POST', '/api/admin/task-templates', True, False, 'getNodeTemplateList'),
     ('utils/api', 'POST', '/api/auth/silent-login', False, False, 'silentLogin'),
-    ('utils/api', 'POST', '/api/badges/child/list', True, False, 'getChildBadges'),
+    ('utils/api', 'POST', '/api/badges/member/list', True, False, 'getMemberBadges'),
     ('utils/api', 'POST', '/api/butler/available-list', False, False, 'getAvailableButlers'),
     ('utils/api', 'POST', '/api/butler/my-butler', False, False, 'getMyButler'),
     ('utils/api', 'POST', '/api/butler/select', False, False, 'selectButler'),