achievement.fiveCol.test.js 5.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114
  1. /**
  2. * 契约级单测(TDD-RED)——能力键 achievement.grid.fiveCol
  3. *
  4. * 溯源:
  5. * requirement: tests/user-scenarios/应用场景总览.md SC-A-27(成就与成长历史·家长端)
  6. * + docs/需求分析/2026-11-06-成就成长打卡需求变更.md 变更 D(我的成就固定五列)
  7. * design: cfc-frontend/pages/profile-main/profile.vue「我的成就」区块
  8. * 模板 L151-187(.achievement-grid.cols-5 + 5 个 .ach-item)+
  9. * 样式 原 .ach-item{width:25%} 改五列等分 .achievement-grid.cols-5 .ach-item{width:20%}
  10. *
  11. * 缺陷本质(本用例守护的规则):
  12. * 「我的成就」区块固定 5 张成就卡(连续打卡/完成任务/收集勋章/成长记录/参加挑战)。
  13. * 原 .ach-item{width:25%}(4 列等分)→ 第 5 张卡折行错位。
  14. * 变更 D 要求该区块独占 5 列等分(width:20%),单行排布不折行;
  15. * 且必须用独立网格类(.cols-5)隔离,不得全局改 .achievement-grid(其被「我的团队」.team-grid / 「卡券中心」复用)。
  16. *
  17. * 断言口径(静态结构契约,读真实 SFC 源码,不依赖渲染引擎):
  18. * 1) 模板「我的成就」区块根容器使用 .achievement-grid.cols-5
  19. * 2) 样式存在 .achievement-grid.cols-5 .ach-item 规则,且 width 为 20%(五列等分)
  20. * 3) 该区块含 ≥5 个成就入口,且跳转方法为 goToStreak/goToTaskHistory/goToBadges/goToGrowth/goToChallenges
  21. * 4) 隔离性:全局 .achievement-grid 未被改成 20%(保护「我的团队」3 列布局不被波及)
  22. *
  23. * 说明(既有 Jest 体系约束):
  24. * cfc-frontend jest.config.js 仅 transform .js,未装 vue-jest/jsdom 组件环境——
  25. * 沿用既有约定:读取真实 SFC 源码做结构契约断言(参考 __tests__/family-join/join-form.required-info.test.js、
  26. * __tests__/pages/growth-main/growthGrid.layout.test.js)。本文件不修改 pages/ 任何业务代码。
  27. */
  28. import fs from 'fs'
  29. import path from 'path'
  30. const PAGE_PATH = path.join(__dirname, '../../../pages/profile-main/profile.vue')
  31. const SRC = fs.readFileSync(PAGE_PATH, 'utf8')
  32. /** 截取某个 CSS 选择器的声明块({} 内文本),返回 null 表示不存在 */
  33. function cssBlock(src, selector) {
  34. const idx = src.indexOf('\n' + selector + ' {')
  35. const altIdx = src.indexOf(selector + ' {')
  36. const start = idx >= 0 ? idx : altIdx
  37. if (start < 0) return null
  38. const open = src.indexOf('{', start)
  39. const close = src.indexOf('}', open)
  40. if (open < 0 || close < 0) return null
  41. return src.slice(open + 1, close)
  42. }
  43. /** 截取模板中「我的成就」section 块(class="achievement-section" 且其内含「我的成就」) */
  44. function achievementSectionTemplate(src) {
  45. const tmpl = src.match(/<template>([\s\S]*?)<\/template>/)
  46. if (!tmpl) return ''
  47. const t = tmpl[1]
  48. // 成就区块以 class="achievement-section" 起始,逐段切分找到含「我的成就」的那段
  49. const marker = 'achievement-section'
  50. let from = 0
  51. while (true) {
  52. const secStart = t.indexOf(marker, from)
  53. if (secStart < 0) return ''
  54. const secEnd = t.indexOf(marker, secStart + 1)
  55. const chunk = t.slice(secStart, secEnd > 0 ? secEnd : t.length)
  56. if (chunk.indexOf('我的成就') >= 0) return chunk
  57. from = secStart + 1
  58. }
  59. }
  60. // ---------------------------------------------------------------------------
  61. // 变更 D · 我的成就固定五列
  62. // ---------------------------------------------------------------------------
  63. describe('achievement.grid.fiveCol · 我的成就固定五列(变更 D / SC-A-27)', () => {
  64. test('TC-A5-01 模板「我的成就」区块使用 .achievement-grid.cols-5 根容器', () => {
  65. const section = achievementSectionTemplate(SRC)
  66. expect(section).not.toBe('')
  67. expect(section).toMatch(/achievement-grid\s+cols-5/)
  68. })
  69. test('TC-A5-02 .achievement-grid.cols-5 .ach-item 宽度为 20%(五列等分)', () => {
  70. const block = cssBlock(SRC, '.achievement-grid.cols-5 .ach-item')
  71. expect(block).not.toBeNull()
  72. const m = /width:\s*([\d.]+)%/.exec(block)
  73. expect(m).not.toBeNull()
  74. expect(Number(m[1])).toBe(20)
  75. })
  76. test('TC-A5-03 成就区块含 ≥5 个 .ach-item 成就入口,且不折行错位(5 张卡单行)', () => {
  77. const section = achievementSectionTemplate(SRC)
  78. const items = section.match(/class="ach-item"/g) || []
  79. expect(items.length).toBeGreaterThanOrEqual(5)
  80. })
  81. test('TC-A5-04 5 个成就入口跳转方法齐备(goToStreak/TaskHistory/Badges/Growth/Challenges)', () => {
  82. const section = achievementSectionTemplate(SRC)
  83. const required = ['goToStreak', 'goToTaskHistory', 'goToBadges', 'goToGrowth', 'goToChallenges']
  84. required.forEach((fn) => {
  85. // 每个成就卡的 @click 绑定到对应方法
  86. expect(section).toMatch(new RegExp('@click="' + fn + '"'))
  87. })
  88. })
  89. test('TC-A5-05 隔离性:全局 .achievement-grid 未被改成 20%(保护「我的团队」布局)', () => {
  90. // 全局 .achievement-grid 仅声明 flex 布局,不含 width:20%;团队网格用 33.33%
  91. const globalGrid = cssBlock(SRC, '.achievement-grid')
  92. expect(globalGrid).not.toBeNull()
  93. expect(globalGrid).not.toMatch(/width:\s*20%/)
  94. })
  95. })
  96. // ---------------------------------------------------------------------------
  97. // 权限流:本能力为家长端「我的成就」展示布局,无角色分支门禁,
  98. // 属《编排派发》中「权限(适用时)」的不适用项,显式记录。
  99. // ---------------------------------------------------------------------------
  100. describe.skip('权限流:成就五列布局无角色门禁,不适用', () => {
  101. it('占位:该能力面向家长端个人中心展示,无 role 分支(详见汇报)', () => {})
  102. })