recommendation.participantSelect.test.js 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328
  1. /**
  2. * 契约级单测(TDD-RED)——能力键 diet.recommendation.participantSelect
  3. *
  4. * 溯源:
  5. * requirement: docs/superpowers/specs/2026-11-08-diet-recommendation-polish.md
  6. * §2 需求 7(共餐人选择:家庭总览先弹共餐人多选、个人/成员直传 currentMemberId)
  7. * design: 同文档 §2 需求 7
  8. * - 前端:cfc-frontend/pages/diet/recommendation.vue generateRecipe(L407-425),
  9. * 家庭总览(currentView==='family')点「生成食谱」→ 弹共餐人多选
  10. * (候选=memberList,含 familyMemberId+nickname+isSelf,默认勾选全部),
  11. * 确认后调 generate 并传 participant_member_ids([familyMemberId,...] JSON 字符串);
  12. * 个人/成员(currentView==='personal')→ 不弹选择,传 participant_member_ids:[currentMemberId]
  13. * - api 透传:cfc-frontend/utils/api.js generateDietRecommendation(L3125)通用透传,无需改动
  14. * - 后端:DietRecommendationService.generateRecommendation(L67-140)应读
  15. * request.get("participant_member_ids") 覆盖 queryParticipantIds 兜底;
  16. * 解析复用 parseMemberIds(L257-267)——本文件(前端契约)锚定「前端发送该字段」,
  17. * 后端覆盖行为由 GREEN 阶段后端侧验证
  18. *
  19. * 说明:
  20. * 沿用 __tests__/pages/diet/recommendation.uiRework.test.js 约定:直接加载真实
  21. * recommendation.vue SFC 的 <script>(import 替换为注入桩后求值)拿到 data()/methods,
  22. * 做行为级断言。当前实现未落地(generateRecipe 仅传 {date, meal_type},无 participant_member_ids),
  23. * 预期全部 RED;GREEN 阶段在实现不修改本文件的前提下翻绿。
  24. * 注:家庭总览「确认共餐人」的确认入口设计未限定方法名,本文件以 confirmParticipants 作为
  25. * GREEN 预期表面,并在断言中聚焦「载荷契约(participant_member_ids 内容)」,若 GREEN 采用
  26. * 其他命名需与编排侧确认同步。
  27. * 本文件不修改 pages/ / components/ / utils/ 任何业务代码。
  28. */
  29. import fs from 'fs'
  30. import path from 'path'
  31. import { generateDietRecommendation as apiGenerateDietRecommendation, clearApiDedup } from '@/utils/api'
  32. const RECOMMENDATION_PATH = path.join(__dirname, '../../../pages/diet/recommendation.vue')
  33. // ---------------------------------------------------------------------------
  34. // 工具:把 ES import 替换成从 globalThis.__recommendationStubs 取桩的 var 声明
  35. // ---------------------------------------------------------------------------
  36. function stubImports(script, stubMap) {
  37. return script.replace(/import\s+([^;]+?)\s+from\s+['"]([^'"]+)['"];?/g, function (m, clause, id) {
  38. var names = []
  39. var c = clause.trim()
  40. var braceIdx = c.indexOf('{')
  41. if (braceIdx >= 0) {
  42. var def = c.slice(0, braceIdx).replace(/,\s*$/, '').trim()
  43. if (def) names.push(def)
  44. var named = c.slice(braceIdx + 1, c.lastIndexOf('}'))
  45. named.split(',').forEach(function (part) {
  46. var p = part.trim()
  47. if (!p) return
  48. var parts = p.split(/\s+as\s+/)
  49. var local = parts.length > 1 ? parts[1].trim() : parts[0].trim()
  50. if (local) names.push(local)
  51. })
  52. } else if (c.indexOf('*') === 0) {
  53. var nsMatch = c.match(/\*\s+as\s+(\w+)/)
  54. if (nsMatch) names.push(nsMatch[1])
  55. } else {
  56. names.push(c)
  57. }
  58. return names.map(function (n) {
  59. return 'var ' + n + ' = (globalThis.__recommendationStubs[' + JSON.stringify(id) + '] || {})[' + JSON.stringify(n) + '];'
  60. }).join('\n')
  61. })
  62. }
  63. /** 加载真实 SFC:返回 { component, template } */
  64. function loadRecommendation() {
  65. var src = fs.readFileSync(RECOMMENDATION_PATH, 'utf8')
  66. var tmplMatch = src.match(/<template>([\s\S]*?)<\/template>/)
  67. var scriptMatch = src.match(/<script>([\s\S]*?)<\/script>/)
  68. if (!scriptMatch) throw new Error('无法在 recommendation.vue 中定位 <script> 块')
  69. var script = stubImports(scriptMatch[1], globalThis.__recommendationStubs || {})
  70. script = script.replace(/export default\s*\{/, 'module.exports = {')
  71. var mod = { exports: {} }
  72. // eslint-disable-next-line no-new-func
  73. var fn = new Function('module', 'exports', script)
  74. fn(mod, mod.exports)
  75. return { component: mod.exports, template: tmplMatch ? tmplMatch[1] : '' }
  76. }
  77. /** 把 component 的 data()/computed()/methods 合并到 vm 实例(computed 定义为 getter) */
  78. function instantiate(component) {
  79. var vm = {}
  80. var data = typeof component.data === 'function' ? component.data.call(vm) : (component.data || {})
  81. Object.keys(data).forEach(function (k) { vm[k] = data[k] })
  82. if (component.computed) {
  83. Object.keys(component.computed).forEach(function (k) {
  84. Object.defineProperty(vm, k, { get: component.computed[k].bind(vm), enumerable: true, configurable: true })
  85. })
  86. }
  87. var methods = component.methods || {}
  88. Object.keys(methods).forEach(function (k) { vm[k] = methods[k] })
  89. return vm
  90. }
  91. /**
  92. * 从 generate 载荷中提取共餐人 id 数组。
  93. * 契约要点:participant_member_ids 存在即返回其内容(兼容 JSON 字符串 / 原生数组两种实现形态,
  94. * 值统一规整为 number 数组),不存在/为空则返回与之对应的哨兵值,令断言干净失败(RED)。
  95. */
  96. function participantIdsOf(payload) {
  97. if (!payload || !Object.prototype.hasOwnProperty.call(payload, 'participant_member_ids')) return undefined
  98. var v = payload.participant_member_ids
  99. if (v === undefined || v === null || v === '') return []
  100. var out
  101. if (Array.isArray(v)) {
  102. out = v
  103. } else if (typeof v === 'string') {
  104. try { out = JSON.parse(v) } catch (e) { return v }
  105. } else if (typeof v === 'number') {
  106. out = [v]
  107. } else {
  108. return v
  109. }
  110. return out.map(function (n) { return Number(n) })
  111. }
  112. // ---------------------------------------------------------------------------
  113. // 测试夹具
  114. // ---------------------------------------------------------------------------
  115. var stubs
  116. beforeEach(function () {
  117. global.uni._storage = {}
  118. global.uni.showToast.mockReset()
  119. global.uni.showLoading.mockReset()
  120. global.uni.hideLoading.mockReset()
  121. global.uni.request.mockReset()
  122. stubs = {
  123. generateDietRecommendation: jest.fn(function () { return Promise.resolve({}) }),
  124. getDietRecommendation: jest.fn(function () { return Promise.resolve({}) }),
  125. completeDietRecommendation: jest.fn(function () { return Promise.resolve({}) }),
  126. regenerateDietRecommendation: jest.fn(function () { return Promise.resolve({}) }),
  127. updateDietRecommendation: jest.fn(function () { return Promise.resolve({}) }),
  128. memberIdOf: jest.fn(function (m) { return m && (m.familyMemberId != null ? m.familyMemberId : (m.id != null ? m.id : null)) }),
  129. config: { default: { API_BASE_URL: '/api' } },
  130. MemberSelector: { default: {} },
  131. fontScaleMixin: { default: { data: function () { return { fontScale: 1 } }, onShow: function () {} } }
  132. }
  133. globalThis.__recommendationStubs = {
  134. '@/utils/api.js': {
  135. getDietRecommendation: stubs.getDietRecommendation,
  136. generateDietRecommendation: stubs.generateDietRecommendation,
  137. completeDietRecommendation: stubs.completeDietRecommendation,
  138. regenerateDietRecommendation: stubs.regenerateDietRecommendation,
  139. updateDietRecommendation: stubs.updateDietRecommendation
  140. },
  141. '@/config.js': stubs.config,
  142. '@/components/MemberSelector.vue': stubs.MemberSelector,
  143. '@/utils/memberNormalize.js': { memberIdOf: stubs.memberIdOf },
  144. '@/mixins/font-scale.js': stubs.fontScaleMixin
  145. }
  146. })
  147. afterEach(function () {
  148. delete globalThis.__recommendationStubs
  149. })
  150. /** 家庭总览场景的成员列表(/api/food/recommendation/members 返回含 familyMemberId+nickname+isSelf) */
  151. function familyOf(memberIds) {
  152. return memberIds.map(function (id) {
  153. return { familyMemberId: id, nickname: '成员' + id, isSelf: id === 1 }
  154. })
  155. }
  156. // ---------------------------------------------------------------------------
  157. // REQ7-前端 个人/成员视角:generateRecipe 不弹选择,直传 participant_member_ids:[currentMemberId]
  158. // ---------------------------------------------------------------------------
  159. describe('REQ7 personal 视角:generateRecipe 载荷直传当前成员为共餐人', function () {
  160. var vm
  161. beforeEach(function () {
  162. var component = loadRecommendation().component
  163. vm = instantiate(component)
  164. vm.currentView = 'personal'
  165. vm.currentMemberId = 42
  166. stubs.generateDietRecommendation.mockClear()
  167. })
  168. it('generate 载荷存在 participant_member_ids 键', async function () {
  169. vm.generateRecipe()
  170. await Promise.resolve()
  171. await Promise.resolve()
  172. expect(stubs.generateDietRecommendation).toHaveBeenCalled()
  173. var payload = stubs.generateDietRecommendation.mock.calls[0][0]
  174. expect(payload).toHaveProperty('participant_member_ids')
  175. })
  176. it('participant_member_ids 解析为 [currentMemberId](只当前选中人,不做多选)', async function () {
  177. vm.generateRecipe()
  178. await Promise.resolve()
  179. await Promise.resolve()
  180. expect(stubs.generateDietRecommendation).toHaveBeenCalled()
  181. var payload = stubs.generateDietRecommendation.mock.calls[0][0]
  182. expect(participantIdsOf(payload)).toEqual([42])
  183. })
  184. it('成员视角(选中其他成员)同样直传该成员 id', async function () {
  185. vm.currentMemberId = 88
  186. vm.generateRecipe()
  187. await Promise.resolve()
  188. await Promise.resolve()
  189. expect(stubs.generateDietRecommendation).toHaveBeenCalled()
  190. var payload = stubs.generateDietRecommendation.mock.calls[0][0]
  191. expect(participantIdsOf(payload)).toEqual([88])
  192. })
  193. })
  194. // ---------------------------------------------------------------------------
  195. // REQ7-前端 家庭总览视角:点「生成食谱」先弹共餐人选择,不立即生成
  196. // ---------------------------------------------------------------------------
  197. describe('REQ7 family 视角:generateRecipe 先弹共餐人选择,不直接调 generate', function () {
  198. var vm
  199. beforeEach(function () {
  200. var component = loadRecommendation().component
  201. vm = instantiate(component)
  202. vm.currentView = 'family'
  203. vm.memberList = familyOf([1, 2, 3])
  204. stubs.generateDietRecommendation.mockClear()
  205. })
  206. it('family 视角 generateRecipe 不立即调用 generateDietRecommendation(等待共餐人确认)', async function () {
  207. vm.generateRecipe()
  208. await Promise.resolve()
  209. await Promise.resolve()
  210. await Promise.resolve()
  211. expect(stubs.generateDietRecommendation).not.toHaveBeenCalled()
  212. })
  213. it('family 视角即使成员列表为单人也先弹选择(不跳过共餐人确认)', async function () {
  214. vm.memberList = familyOf([1])
  215. vm.generateRecipe()
  216. await Promise.resolve()
  217. await Promise.resolve()
  218. await Promise.resolve()
  219. expect(stubs.generateDietRecommendation).not.toHaveBeenCalled()
  220. })
  221. })
  222. // ---------------------------------------------------------------------------
  223. // REQ7-前端 家庭总览视角:确认共餐人后生成,participant_member_ids 默认覆盖全部成员
  224. // ---------------------------------------------------------------------------
  225. describe('REQ7 family 视角:确认共餐人后生成的载荷契约', function () {
  226. var vm
  227. beforeEach(function () {
  228. var component = loadRecommendation().component
  229. vm = instantiate(component)
  230. vm.currentView = 'family'
  231. vm.memberList = familyOf([1, 2, 3])
  232. stubs.generateDietRecommendation.mockClear()
  233. })
  234. it('家庭总览存在「确认共餐人」入口(confirmParticipants 方法)', async function () {
  235. vm.generateRecipe()
  236. await Promise.resolve()
  237. await Promise.resolve()
  238. expect(typeof vm.confirmParticipants).toBe('function')
  239. })
  240. it('未显式勾选时确认 → participant_member_ids 默认覆盖全部成员(默认勾选全部)', async function () {
  241. vm.generateRecipe()
  242. await Promise.resolve()
  243. await Promise.resolve()
  244. expect(typeof vm.confirmParticipants).toBe('function')
  245. if (typeof vm.confirmParticipants === 'function') {
  246. await vm.confirmParticipants()
  247. await Promise.resolve()
  248. await Promise.resolve()
  249. expect(stubs.generateDietRecommendation).toHaveBeenCalled()
  250. var payload = stubs.generateDietRecommendation.mock.calls[0][0]
  251. expect(participantIdsOf(payload)).toEqual([1, 2, 3])
  252. }
  253. })
  254. it('confirmParticipants 生成的载荷仍含 participant_member_ids 键', async function () {
  255. vm.generateRecipe()
  256. await Promise.resolve()
  257. await Promise.resolve()
  258. expect(typeof vm.confirmParticipants).toBe('function')
  259. if (typeof vm.confirmParticipants === 'function') {
  260. await vm.confirmParticipants()
  261. await Promise.resolve()
  262. await Promise.resolve()
  263. expect(stubs.generateDietRecommendation).toHaveBeenCalled()
  264. var payload = stubs.generateDietRecommendation.mock.calls[0][0]
  265. expect(payload).toHaveProperty('participant_member_ids')
  266. }
  267. })
  268. })
  269. // ---------------------------------------------------------------------------
  270. // 设计锚点:utils/api.js generateDietRecommendation 为通用透传,无需改动
  271. // (规格 §2 需求 7:generateDietRecommendation 通用透传 request,GREEN 不动 api.js)
  272. // ---------------------------------------------------------------------------
  273. describe('设计锚点:api.js generateDietRecommendation 透传 participant_member_ids', function () {
  274. it('POST /api/diet/recommendation/generate 载荷含 participant_member_ids 原样透传', async function () {
  275. var captured = null
  276. global.uni.request.mockImplementation(function (opts) {
  277. captured = opts
  278. process.nextTick(function () { opts.success({ data: { code: 200, message: 'ok', data: { id: 1 } } }) })
  279. })
  280. clearApiDedup()
  281. await apiGenerateDietRecommendation({ date: '2026-11-08', meal_type: 'all', participant_member_ids: '[1,2,3]' })
  282. expect(captured.url).toContain('/api/diet/recommendation/generate')
  283. expect(captured.method).toBe('POST')
  284. expect(captured.data).toEqual(expect.objectContaining({ participant_member_ids: '[1,2,3]' }))
  285. })
  286. })
  287. // ---------------------------------------------------------------------------
  288. // 权限流:本能力为「生成食谱时的共餐人选择」,家长/孩子进入均可能触发
  289. // (家庭总览为家长视角典型入口;成员视角任何角色均可),无额外角色门禁,
  290. // 属《编排派发》中「权限(适用时)」的不适用项,显式记录。
  291. // ---------------------------------------------------------------------------
  292. describe.skip('权限流:共餐人选择无角色门禁,不适用', function () {
  293. it('占位:生成食谱在家长端/成员端共用 generateRecipe,无 role 分支(详见汇报)', function () {})
  294. })