Переглянути джерело

test(R215): 刷新单元覆盖台账(控制器 371→372、handler 2019→2021、未覆盖 117→118,本地新增测试源计入)

E2E Test Bot 1 день тому
батько
коміт
0f558de4a

+ 23 - 21
cfc-web/src/__tests__/Families.actionMenu.spec.js

@@ -1,25 +1,20 @@
 import { readFileSync } from 'fs';
 import { resolve } from 'path';
 
-// 契约:admin.family.actionMenu
-// 家庭管理列表「更多」下拉按钮:去掉「查看成员」「删除」两个下拉项,家庭不允许删除。
-// 溯源·需求:docs/superpowers/specs/2026-11-08-family-admin-list-polish.md §需求5
-// 溯源·设计:cfc-web/src/views/Families.vue L92-96 删除 viewMembers/delete 两个 dropdown-item;
-//           L384-390 handleActionCmd 清理对应 case;后端保留 deleteFamily API 不删。
+// 契约:admin.family.actionMenu(修订于 FAMILY-WB-2026-11-13-V1 §S1-1)
+// 溯源·旧需求:docs/superpowers/specs/2026-11-08-family-admin-list-polish.md §需求5
+//   (去掉「查看成员」「删除」下拉项,保留「更多」下拉)
+// 溯源·新需求:docs/需求分析/2026-11-13-家庭运营工作台重构需求变更.md §S1-1
+//   「行操作只保留【进入工作台】【编辑】,删除『更多』下拉;单家庭功能移入 FamilyWorkbench.vue」
+// 溯源·实现:cfc-web/src/views/Families.vue
 //
-// 说明:Families.vue 存在既有 vue-jest 模板编译告警(v-else/v-if 非同级),无法直接 shallowMount。
-// 故本契约单测采用「读源码 + 校验下拉项指令」的组合断言,与同批
-// Families.createdAtDisplay.spec.js(S-cfc-75)风格保持一致。
-//
-// TDD-RED:当前实现仍渲染 command="viewMembers" 与 command="delete" 两个下拉项,
-//          契约要求移除,本测试预期失败(红);GREEN 阶段按设计删除这两个
-//          dropdown-item 并清理 handleActionCmd 对应 case 后转绿。
+// 修订说明:原契约要求「更多」下拉必须渲染(旧 2026-11-08 列表打磨需求),
+//           本次需求变更明示删除「更多」下拉,故本契约反向断言其已移除,并校验保留【编辑】/【进入工作台】。
 
 const VIEWS_DIR = resolve(__dirname, '../views')
 const FAMILIES_VUE_PATH = resolve(VIEWS_DIR, 'Families.vue')
 const source = readFileSync(FAMILIES_VUE_PATH, 'utf8')
 
-// 从模板中抽取「操作」那一列的完整 <el-table-column> 块(含「更多」下拉菜单)
 function extractActionColumnBlock(src) {
   const startTag = '<el-table-column label="操作"'
   const start = src.indexOf(startTag)
@@ -28,26 +23,33 @@ function extractActionColumnBlock(src) {
   if (end === -1) return ''
   return src.slice(start, end + '</el-table-column>'.length)
 }
-
 const actionColumnBlock = extractActionColumnBlock(source)
 
-// 抽取 handleActionCmd 方法体,用于校验 switch case 是否已清理
 function extractHandleActionCmd(src) {
   const startTag = 'handleActionCmd(row, cmd)'
   const start = src.indexOf(startTag)
   if (start === -1) return ''
   return src.slice(start)
 }
-
 const actionCmdBody = extractHandleActionCmd(source)
 
-describe('Families 更多按钮下拉菜单契约 (admin.family.actionMenu)', () => {
-  it('操作列必须存在(设计 L85-98)', () => {
+describe('Families 操作列契约(FAMILY-WB-2026-11-13-V1 S1-1 精简)', () => {
+  it('操作列必须存在', () => {
     expect(actionColumnBlock).not.toBe('')
   })
 
-  it('「更多」下拉菜单必须渲染(保留编辑入口)', () => {
-    expect(actionColumnBlock).toMatch(/<el-dropdown-menu/)
+  it('「更多」下拉菜单已删除(S1-1:行操作仅保留进入工作台/编辑)', () => {
+    expect(actionColumnBlock).not.toMatch(/<el-dropdown-menu/)
+    expect(actionColumnBlock).not.toMatch(/更多/)
+  })
+
+  it('保留【编辑】入口', () => {
+    expect(actionColumnBlock).toMatch(/编辑/)
+  })
+
+  it('保留【进入工作台】入口(push /family-workbench?familyId)', () => {
+    expect(source).toMatch(/family-workbench/)
+    expect(source).toMatch(/familyId\s*:\s*row\.id/)
   })
 
   it('下拉菜单不应再出现「查看成员」项(command="viewMembers")', () => {
@@ -65,4 +67,4 @@ describe('Families 更多按钮下拉菜单契约 (admin.family.actionMenu)', ()
   it('handleActionCmd 不应再分发 delete 指令', () => {
     expect(actionCmdBody).not.toMatch(/case\s+['"]delete['"]/)
   })
-})
+})

+ 24 - 67
cfc-web/src/__tests__/views/FamiliesPlanEntry.spec.js

@@ -1,24 +1,18 @@
 /**
- * admin.family.planEntry 契约级单测(TDD-RED 阶段,预期红)
+ * admin.family.planEntry 契约级单测(修订于 FAMILY-WB-2026-11-13-V1 §S1-1)
  *
  * 能力键:admin.family.planEntry
- * 溯源·需求:docs/superpowers/specs/2026-11-08-family-admin-list-polish.md §需求3
+ * 溯源·旧需求:docs/superpowers/specs/2026-11-08-family-admin-list-polish.md §需求3
  *   (方案数列 0 也渲染可点击链接 + plans 弹窗补「代生成方案」入口)
- * 溯源·设计:cfc-web/src/views/Families.vue
- *   - L68-73  去掉 planCount>0 条件(planCount=0 也渲染可点击 el-link)
- *   - L229-248 plans 明细弹窗补「代生成方案」入口(跳转 HealthPlanManage 或内嵌生成表单)
+ * 溯源·新需求:docs/需求分析/2026-11-13-家庭运营工作台重构需求变更.md §S1-1
+ *   「报告/方案/任务/优惠券数改为纯文本(不可点击)」+「删除 openPlanGen / openDetailDialog / 详情弹窗模板」
+ * 溯源·实现:cfc-web/src/views/Families.vue(统计数纯文本);cfc-web/src/views/FamilyWorkbench.vue(方案 tab 代生成方案能力落点)
  *
- * 【为何以「源码契约」而非「shallowMount 组件挂载」方式书写】
- * 参考风格(ActivityAudit.spec.js)使用 shallowMount 挂载组件。但当前 cfclub 主链的
- * Families.vue 模板存在一处先在的硬编译错误:查看成员弹窗中 `<el-empty v-else>`
- * 嵌套在 `<el-table>`(其 v-if 挂在 table 自身)内部,vue-template-compiler 将其
- * 列为 errors[],导致 vue-jest 无法加载整个组件(suite 直接编译失败)。本任务明确禁止
- * 修改 src/main 实现,故无法绕过该先在障碍。GREEN 阶段落地本能力时会同步修正该嵌套;
- * 届时可将本文件升级为 shallowMount 挂载式测试。
- *
- * 因此本文件采用「源码契约」断言:读取真实的 Families.vue 源码,断言设计契约所需
- * 结构/行为缺失(RED)。GREEN 阶段实现后断言转绿。断言聚焦行为契约,不锁定实现细节
- * (跳转路由 vs 内嵌表单二者任一即可)。
+ * 修订说明:原契约按 2026-11-08 旧需求断言「可点击 el-link + plans 明细弹窗代生成方案入口」。
+ *           本次需求变更(2026-11-13)将上述行为整体迁移到单家庭工作台 FamilyWorkbench.vue,
+ *           Families.vue 列表仅保留纯文本统计数。故本契约改为:
+ *           AC1 校验 Families.vue 方案数为纯文本(无 el-link / 无 planCount>0 门控 / 无 openDetailDialog);
+ *           AC2 校验代生成方案能力已从 Families.vue 移除(迁移到 FamilyWorkbench,由 FamilyWorkbench.contract.spec.js 覆盖)。
  */
 import fs from 'fs'
 import path from 'path'
@@ -34,72 +28,35 @@ function planCountColumn() {
   return source.slice(start, end)
 }
 
-/** 取组件 script 段(`<script>` 至 `</script>`) */
-function scriptBlock() {
-  const start = source.indexOf('<script>')
-  const end = source.indexOf('</script>')
-  return source.slice(start, end)
-}
-
-/** 取 components 段声明(含所有子组件注册) */
-function componentsBlock() {
-  const m = source.match(/components\s*:\s*\{([^]*)\}/m)
-  return m ? m[1] : ''
-}
-
-describe('admin.family.planEntry 契约 (TDD-RED)', () => {
-  describe('AC1 · 列表 planCount=0 也渲染可点击链接', () => {
+describe('admin.family.planEntry 契约(FAMILY-WB-2026-11-13-V1 S1-1 修订)', () => {
+  describe('AC1 · 列表 planCount 为纯文本展示(不可点击)', () => {
     const col = () => planCountColumn()
 
-    it('planCount 列不应再包含 `planCount > 0` 门控(L68-73 契约要求去掉该条件)', () => {
+    it('planCount 列不应包含 `planCount > 0` 门控', () => {
       expect(col()).not.toMatch(/planCount\s*>\s*0/)
     })
 
-    it('planCount 列不应再包含 `.cell-zero` 灰字 fallback(L68-73 契约要求改为 el-link)', () => {
+    it('planCount 列不应包含 `.cell-zero` 灰字 fallback', () => {
       expect(col()).not.toContain('cell-zero')
     })
 
-    it('planCount 列的 el-link 不应被 `v-if="scope.row.planCount > 0"` 门控,且需保留 openDetailDialog 点击行为', () => {
-      expect(col()).toContain('<el-link')
-      expect(col()).toContain("openDetailDialog(scope.row.id, 'plans')")
-      // 契约核心:当前 el-link 被 planCount>0 门控包围(<el-link v-if="scope.row.planCount > 0"...),RED 阶段应断言其未被门控
-      expect(col()).not.toMatch(/<el-link[^>]*v-if\s*=\s*["']scope\.row\.planCount\s*>\s*0["']/)
+    it('planCount 列改为纯文本:不再有 el-link / openDetailDialog(S1-1)', () => {
+      expect(col()).not.toContain('<el-link')
+      expect(source).not.toContain('openDetailDialog')
     })
   })
 
-  describe('AC2 · plans 明细弹窗补「代生成方案」入口', () => {
-    /** 取 plans 明细弹窗区块(detailType === 'plans' 对应模板分支) */
-    function plansDialogBlock() {
-      const start = source.indexOf("detailType === 'plans'")
-      expect(start).toBeGreaterThan(-1) // 明细弹窗 plans 分支存在是既有契约
-      const end = source.indexOf("detailType ===", start + 1)
-      return source.slice(start, end > 0 ? end : start + 5000)
-    }
-
-    const dialog = () => plansDialogBlock()
-    const script = () => scriptBlock()
-
-    it('plans 明细弹窗区块内需出现「代生成方案」文案或语义标记(design anchor L229-248)', () => {
-      const hasEntry =
-        dialog().includes('代生成方案') ||
-        dialog().includes('plan-gen-entry') ||
-        dialog().includes('handleGeneratePlanOnBehalf') ||
-        dialog().includes('openPlanGen') ||
-        dialog().includes('goPlanGen')
-      expect(hasEntry).toBe(true)
+  describe('AC2 · 代生成方案入口已迁移至单家庭工作台(S1-1)', () => {
+    it('Families.vue 不再保留 openPlanGen / goPlanGen / handlePlanGen 处理方法', () => {
+      expect(source).not.toMatch(/openPlanGen|goPlanGen|handlePlanGen/)
     })
 
-    it('组件 script 需提供处理代生成方案流程的方法(跳转 HealthPlanManage 路由或触发内嵌生成表单)', () => {
-      const hasHandler =
-        /(openPlanGen|goPlanGen|handlePlanGen|showPlanGenForm)/.test(script()) ||
-        (/health-plan-manage/.test(script()))
-      expect(hasHandler).toBe(true)
+    it("Families.vue 不再保留 plans 明细弹窗(detailType === 'plans' 已删除)", () => {
+      expect(source).not.toContain("detailType === 'plans'")
     })
 
-    it('代生成方案流程需绑定 familyId(跳转时需携带 query.familyId 或复用 detailFamilyId)', () => {
-      const s = script()
-      expect(s).toMatch(/familyId/)
-      expect(s).toMatch(/health-plan-manage|HealthPlanManage/)
+    it('Families.vue 不再含「代生成方案」文案(能力迁移到 FamilyWorkbench 方案 tab)', () => {
+      expect(source).not.toContain('代生成方案')
     })
   })
 })

+ 24 - 62
cfc-web/src/__tests__/views/FamiliesReportEntry.spec.js

@@ -1,29 +1,22 @@
 /**
- * admin.family.reportEntry 契约级单测(TDD-RED 阶段,预期红)
+ * admin.family.reportEntry 契约级单测(修订于 FAMILY-WB-2026-11-13-V1 §S1-1)
  *
  * 能力键: admin.family.reportEntry
- * 溯源·需求: docs/superpowers/specs/2026-11-08-family-admin-list-polish.md §需求2
+ * 溯源·旧需求: docs/superpowers/specs/2026-11-08-family-admin-list-polish.md §需求2
  *   (列表上传报告数为 0 时也可点击,进入后可代传报告、查看报告)
- * 溯源·设计: cfc-web/src/views/Families.vue
- *   - L62-67  去掉 reportCount>0 条件(reportCount=0 也渲染可点击 el-link)
- *   - L206-226 reports 明细弹窗补「代传报告」入口(跳转 ProxyReportUpload 或内嵌上传)
+ * 溯源·新需求: docs/需求分析/2026-11-13-家庭运营工作台重构需求变更.md §S1-1
+ *   「报告/方案/任务/优惠券数改为纯文本(不可点击)」+「删除 openPlanGen / openDetailDialog / 详情弹窗模板」
+ * 溯源·实现: cfc-web/src/views/Families.vue(统计数纯文本);cfc-web/src/views/FamilyWorkbench.vue(报告 tab 代传报告能力落点)
  *
- * 【为何以「源码契约」而非「shallowMount 组件挂载」方式书写】
- * 参考风格(ActivityAudit.spec.js)使用 shallowMount 挂载组件。但当前 cfclub 主链的
- * Families.vue 模板存在一处先在的硬编译错误:查看成员弹窗中 `<el-empty v-else>`
- * 嵌套在 `<el-table>`(其 v-if 挂在 table 自身)内部,vue-template-compiler 将其
- * 列为 errors[],导致 vue-jest 无法加载整个组件(suite 直接编译失败)。本任务明确禁止
- * 修改 src/main 实现,故无法绕过该先在障碍。GREEN 阶段落地本能力时会同步修正该嵌套;
- * 届时可将本文件升级为 shallowMount 挂载式测试。
- *
- * 因此本文件采用「源码契约」断言:读取真实的 Families.vue 源码,断言设计契约所需
- * 结构/行为缺失(RED)。GREEN 阶段实现后断言转绿。断言聚焦行为契约,不锁定实现细节
- * (跳转路由 vs 内嵌上传二者任一即可)。
+ * 修订说明:原契约按 2026-11-08 旧需求断言「可点击 el-link + reports 明细弹窗代传报告入口」。
+ *           本次需求变更(2026-11-13)将上述行为整体迁移到单家庭工作台 FamilyWorkbench.vue,
+ *           Families.vue 列表仅保留纯文本统计数。故本契约改为:
+ *           AC1 校验 Families.vue 报告数为纯文本(无 el-link / 无 reportCount>0 门控 / 无 openDetailDialog);
+ *           AC2 校验代传报告能力已从 Families.vue 移除(迁移到 FamilyWorkbench,由 FamilyWorkbench.contract.spec.js 覆盖)。
  */
 import fs from 'fs'
 import path from 'path'
 
-// 读取真实组件源码(相对本测试文件:src/__tests__/views -> src/views)
 const srcPath = path.resolve(__dirname, '../../views/Families.vue')
 const source = fs.readFileSync(srcPath, 'utf8')
 
@@ -35,66 +28,35 @@ function reportCountColumn() {
   return source.slice(start, end)
 }
 
-/** 取报告明细弹窗的 reports 分区块(`detailType === 'reports'` 至下一个 detailType 分支开头) */
-function reportsDialogBlock() {
-  const start = source.indexOf("detailType === 'reports'")
-  expect(start).toBeGreaterThan(-1) // 明细弹窗 reports 分支存在是既有契约
-  const end = source.indexOf("detailType ===", start + 1)
-  return source.slice(start, end > 0 ? end : start + 5000)
-}
-
-/** 取组件 script 段(`<script>` 至 `</script>`) */
-function scriptBlock() {
-  const start = source.indexOf('<script>')
-  const end = source.indexOf('</script>')
-  return source.slice(start, end)
-}
-
-describe('admin.family.reportEntry 契约 (TDD-RED)', () => {
-  describe('AC1 · 列表 reportCount=0 也渲染可点击链接', () => {
-    /** 当前源码中 reportCount 列内容(含 v-if 门控与 v-else 灰字两个分支) */
+describe('admin.family.reportEntry 契约(FAMILY-WB-2026-11-13-V1 S1-1 修订)', () => {
+  describe('AC1 · 列表 reportCount 为纯文本展示(不可点击)', () => {
     const col = () => reportCountColumn()
 
-    it('reportCount 列不应再包含 `reportCount > 0` 门控(L62-67 契约要求去掉该条件)', () => {
+    it('reportCount 列不应包含 `reportCount > 0` 门控', () => {
       expect(col()).not.toMatch(/reportCount\s*>\s*0/)
     })
 
-    it('reportCount 列不应再包含 `.cell-zero` 灰字 fallback(L62-67 契约要求改为 el-link)', () => {
+    it('reportCount 列不应包含 `.cell-zero` 灰字 fallback', () => {
       expect(col()).not.toContain('cell-zero')
     })
 
-    it('reportCount 列的 el-link 不应再被 `v-if="scope.row.reportCount > 0"` 门控,且需保留 openDetailDialog 点击行为', () => {
-      expect(col()).toContain('<el-link')
-      expect(col()).toContain("openDetailDialog(scope.row.id, 'reports')")
-      // 契约核心:当前 el-link 被 reportCount>0 门控包围(<el-link v-if="scope.row.reportCount > 0"...),RED 阶段应断言其未被门控
-      expect(col()).not.toMatch(/<el-link[^>]*v-if\s*=\s*["']scope\.row\.reportCount\s*>\s*0["']/)
+    it('reportCount 列改为纯文本:不再有 el-link / openDetailDialog(S1-1)', () => {
+      expect(col()).not.toContain('<el-link')
+      expect(source).not.toContain('openDetailDialog')
     })
   })
 
-  describe('AC2 · 报告明细弹窗补「代传报告」入口', () => {
-    const dialog = () => reportsDialogBlock()
-    const script = () => scriptBlock()
-
-    it('reports 明细弹窗区块内需出现「代传报告」文案或语义标记(design anchor L206-226)', () => {
-      const hasEntry =
-        dialog().includes('代传报告') ||
-        dialog().includes('proxy-report-entry') ||
-        dialog().includes('handleProxyReportUpload') ||
-        dialog().includes('goProxyReportUpload')
-      expect(hasEntry).toBe(true)
+  describe('AC2 · 代传报告入口已迁移至单家庭工作台(S1-1)', () => {
+    it('Families.vue 不再保留 goProxyReportUpload / handleProxyReportUpload / openProxyReportUpload 处理方法', () => {
+      expect(source).not.toMatch(/goProxyReportUpload|handleProxyReportUpload|openProxyReportUpload/)
     })
 
-    it('组件 script 需提供处理代传报告流程的方法(跳转 ProxyReportUpload 路由或触发内嵌上传)', () => {
-      const hasProxyHandler =
-        /(goProxyReportUpload|handleProxyReportUpload|openProxyReportUpload)/.test(script()) ||
-        (/report-proxy-upload/.test(script()))
-      expect(hasProxyHandler).toBe(true)
+    it("Families.vue 不再保留 reports 明细弹窗(detailType === 'reports' 已删除)", () => {
+      expect(source).not.toContain("detailType === 'reports'")
     })
 
-    it('代传报告流程需绑定 familyId(跳转时需携带 query.familyId 或复用当前 detailFamilyId)', () => {
-      const s = script()
-      expect(s).toMatch(/familyId/)
-      expect(s).toMatch(/report-proxy-upload|ProxyReportUpload/)
+    it('Families.vue 不再含「代传报告」文案(能力迁移到 FamilyWorkbench 报告 tab)', () => {
+      expect(source).not.toContain('代传报告')
     })
   })
 })

+ 6 - 6
docs/tdd/test/discovery.md

@@ -7,12 +7,12 @@
 
 | 指标 | 数值 |
 | --- | --- |
-| 控制器总数 | 371 |
-| handler 方法总数 | 2019 |
+| 控制器总数 | 372 |
+| handler 方法总数 | 2021 |
 | handler 方法已覆盖 | 556 (27.5%) |
 | 单元-全覆盖(handler 方法) | 47 |
 | 单元-部分覆盖(handler 方法) | 206 |
-| 单元-未覆盖(handler 方法) | 117 |
+| 单元-未覆盖(handler 方法) | 118 |
 | 单元-无handler 方法 | 1 |
 | 测试文件数 | 513 |
 | @Test 方法总数 | 4376 |
@@ -22,7 +22,7 @@
 
 > 以下控制器在当前测试源中**没有任何handler 方法被命中**。这是真实扫描得到的覆盖缺口。
 
-共 117 个:
+共 118 个:
 
 - `OrchestrationController`(`cfc-backend/src/main/java/com/etotem/cfc/controller/OrchestrationController.java`,15 方法)
 - `KeyPersonController`(`cfc-backend/src/main/java/com/etotem/cfc/controller/KeyPersonController.java`,14 方法)
@@ -84,7 +84,7 @@
 - `AdminGrowthArchiveProductController`(`cfc-backend/src/main/java/com/etotem/cfc/controller/admin/AdminGrowthArchiveProductController.java`,3 方法)
 - `AssessmentController`(`cfc-backend/src/main/java/com/etotem/cfc/controller/guide/AssessmentController.java`,3 方法)
 - `DailyFeedbackController`(`cfc-backend/src/main/java/com/etotem/cfc/controller/DailyFeedbackController.java`,3 方法)
-- …(其余 57 个见完整扫描)
+- …(其余 58 个见完整扫描)
 
 ## 三、部分覆盖控制器(已做一部分测试)
 
@@ -382,7 +382,7 @@
 | `cfc-backend/src/test/java/com/etotem/cfc/unit/TeacherReportProxyContractTest.java` | com | 14 | 3 | 0 | TeacherController | — |
 | `cfc-backend/src/test/java/com/etotem/cfc/unit/TeamStarDigestContractTest.java` | com | 14 | 0 | 0 | TeamStarController | — |
 | `cfc-backend/src/test/java/com/etotem/cfc/unit/AdminKnowledgeBaseManageContractTest.java` | com | 13 | 0 | 0 | AdminController | — |
-| `cfc-backend/src/test/java/com/etotem/cfc/unit/CoachRecommendContractTest.java` | com | 13 | 10 | 0 | — | — |
+| `cfc-backend/src/test/java/com/etotem/cfc/unit/CoachRecommendContractTest.java` | com | 13 | 10 | 0 | CoachRecommendController | — |
 | `cfc-backend/src/test/java/com/etotem/cfc/unit/DietMealPlanGenerateContractTest.java` | com | 13 | 6 | 0 | — | — |
 | `cfc-backend/src/test/java/com/etotem/cfc/integration/controller/DimensionAdminControllerTest.java` | com | 13 | 0 | 7 | DimensionAdminController | — |
 | `cfc-backend/src/test/java/com/etotem/cfc/unit/EnergyLedgerGuardContractTest.java` | com | 13 | 1 | 1 | EnergyController | — |