assignments.test.ts

apps/dashboard/test/assignments.test.ts

1. /**
2. * Assignment arrives on the Plinth API as `production_owner` and
3. * `account_owner` on orders.fetch. `normalizeAssignments` has two jobs:
4. *
5. * The roster join. Plinth speaks in account labels ("Marco-Acct7-Desk"), the
6. * board compares against roster names ("Marco Ibáñez"). Without this step
7. * every `l.productionOwner === p.name` compares false and the whole team
8. * renders as holding nothing.
9. *
10. * The coverage guard. Assignment data that quietly stops arriving looks like
11. * "nobody has much work" rather than like a break. Zero coverage must reach
12. * the page as missing, never as zero.
13. */
15. import { describe, expect, it } from 'vitest'
16. import { normalizeAssignments, type Snapshot } from '../src/collect.js'
17. import { sourceStatuses } from '../src/view-model.js'
18. import { FIXTURE_SNAPSHOT } from '../src/fixtures.js'
19. import type { AssignmentFieldCoverage, OrderLine } from '@meridian/plinth-client'
21. const line = (productionOwner: string | null, accountOwner: string | null = null): OrderLine =>
22. ({
23. orderId: 24_001,
24. ordersProductsId: 30_001,
25. productId: 907,
26. orderStatus: 'File Check',
27. orderStatusId: 121,
28. productStatus: 'File Check',
29. productStatusId: 176,
30. productTitle: 'Feather Banner',
31. quantity: 1,
32. price: 100,
33. customer: 'Sample Customer',
34. company: 'Sample Co',
35. placedAt: '2026-08-20 09:00:00',
36. amount: 100,
37. vendor: null,
38. userGroup: 'Retail',
39. productionOwner,
40. accountOwner,
41. ageDays: 5,
42. }) satisfies OrderLine
44. const full = (n: number): AssignmentFieldCoverage => ({
45. production: n,
46. accountOwner: n,
47. total: n,
48. })
50. describe('Plinth account labels become roster names', () => {
51. it('maps the labels seen on the live response', () => {
52. // All four are real account labels. If Plinth adds an account,
53. // the unmapped warning below is what surfaces it.
54. const lines = [
55. line('Marco-Acct7-Desk', 'Sam-Accounts-Desk'),
56. line('Rafael-Prod-Desk', 'Hazel (Desk 2)'),
57. ]
58. normalizeAssignments(lines, full(2))
59. expect(lines.map((l) => l.productionOwner)).toEqual(['Marco Ibáñez', 'Rafael Montero'])
60. // "Hazel (Desk 2)" is still the string Plinth sends, and it now resolves
61. // to Rosa. The field name and value did not change when she took over the
62. // role, so the orders assigned to it are now hers. This line is where that
63. // decision actually takes effect: an order assigned months ago resolves to
64. // whoever holds the account today, by design.
65. expect(lines.map((l) => l.accountOwner)).toEqual(['Sam Whitaker', 'Rosa Galván'])
66. })
68. it('matches a label regardless of case', () => {
69. const lines = [line('MARCO-ACCT7-DESK')]
70. normalizeAssignments(lines, full(1))
71. expect(lines[0]!.productionOwner).toBe('Marco Ibáñez')
72. })
74. it('leaves null alone rather than inventing an owner', () => {
75. // A line Plinth sent as `--` arrives here already null. It must stay null: an
76. // unassigned line is work nobody has picked up, and attributing it to
77. // somebody would hide it from whoever should.
78. const lines = [line(null, null)]
79. const warnings = normalizeAssignments(lines, full(1))
80. expect(lines[0]!.productionOwner).toBeNull()
81. expect(lines[0]!.accountOwner).toBeNull()
82. expect(warnings).toEqual([])
83. })
85. it('ROLE COMES FROM THE FIELD, never from the label text', () => {
86. // "Marco-Acct7-Desk" is a designer and "Sam-Accounts-Desk" is Client
87. // Success; the Accounts/Prod tokens in these strings mean nothing. Reading role
88. // out of the label would swap the two of them.
89. const lines = [line('Sam-Accounts-Desk', 'Marco-Acct7-Desk')]
90. normalizeAssignments(lines, full(1))
91. expect(lines[0]!.productionOwner).toBe('Sam Whitaker')
92. expect(lines[0]!.accountOwner).toBe('Marco Ibáñez')
93. })
94. })
96. describe('an unmapped account is surfaced, never rendered raw and never dropped', () => {
97. it('warns once per label and still shows a readable name', () => {
98. const lines = [line('Bob-New-Desk')]
99. const warnings = normalizeAssignments(lines, full(1))
100. expect(warnings).toHaveLength(1)
101. expect(warnings[0]).toContain('Bob-New-Desk')
102. expect(warnings[0]).toContain('plinth-people')
103. // The default is surfaced, but the row still reads as a person rather than
104. // going blank: a blank row loses the work.
105. expect(lines[0]!.productionOwner).toBe('Bob')
106. })
108. it('says nothing about accounts that are mapped', () => {
109. const lines = [line('Marco-Acct7-Desk', 'Sam-Accounts-Desk')]
110. expect(normalizeAssignments(lines, full(1))).toEqual([])
111. })
112. })
114. describe('field coverage decides whether the counts can be trusted', () => {
115. it('reports absent fields as MISSING, not as zero work', () => {
116. // The regression this exists for. If Plinth stops sending the fields, every line
117. // reads unassigned, which looks exactly like a team with free capacity.
118. const warnings = normalizeAssignments([], { production: 0, accountOwner: 0, total: 25 })
119. const joined = warnings.join(' ')
120. expect(joined).toMatch(/missing/i)
121. expect(joined).toContain('production_owner')
122. expect(joined).toContain('account_owner')
123. })
125. it('calls partial coverage a floor', () => {
126. const warnings = normalizeAssignments([], { production: 10, accountOwner: 25, total: 25 })
127. expect(warnings).toHaveLength(1)
128. expect(warnings[0]).toContain('production_owner')
129. expect(warnings[0]).toContain('10')
130. expect(warnings[0]).toContain('25')
131. expect(warnings[0]).toMatch(/floor/)
132. })
134. it('is silent at full coverage', () => {
135. expect(normalizeAssignments([], full(25))).toEqual([])
136. })
138. it('is silent when no lines were fetched at all', () => {
139. // Nothing to judge. A failed or empty sweep is reported by the source that
140. // failed; saying "0 of 0 lines" here would describe one problem twice.
141. expect(normalizeAssignments([], { production: 0, accountOwner: 0, total: 0 })).toEqual([])
142. })
143. })
145. const liveSnap = (fields: AssignmentFieldCoverage, over: Partial<Snapshot> = {}): Snapshot => ({
146. ...FIXTURE_SNAPSHOT,
147. mode: 'live',
148. fixtureCapturedAt: null,
149. orderWindow: { ...FIXTURE_SNAPSHOT.orderWindow, assignmentFields: fields },
150. ...over,
151. })
153. const assignmentPill = (snap: Snapshot) =>
154. sourceStatuses(snap).find((s) => s.name === 'Plinth assignments')
156. describe('the assignments pill tells the truth about coverage', () => {
157. it('reads live when every line carried both fields', () => {
158. const pill = assignmentPill(liveSnap(full(25)))
159. expect(pill?.tone).toBe('live')
160. expect(pill?.status).toBe('live')
161. })
163. it('reads FAILED, not empty, when the fields stop arriving', () => {
164. const pill = assignmentPill(liveSnap({ production: 0, accountOwner: 0, total: 25 }))
165. expect(pill?.tone).toBe('failed')
166. expect(pill?.note).toMatch(/missing, not zero/)
167. })
169. it('degrades on partial coverage and says the counts are a floor', () => {
170. const pill = assignmentPill(liveSnap({ production: 20, accountOwner: 25, total: 25 }))
171. expect(pill?.tone).toBe('degraded')
172. expect(pill?.note).toMatch(/floor/)
173. })
175. it('fails when the Plinth fetch itself failed, since assignments ride that request', () => {
176. const pill = assignmentPill(
177. liveSnap(full(0), {
178. orderLines: { ok: false, data: [], error: 'HTTP 500' },
179. }),
180. )
181. expect(pill?.tone).toBe('failed')
182. expect(pill?.note).toContain('HTTP 500')
183. })
185. it('withholds a verdict when the window returned no lines', () => {
186. // Zero lines is not evidence either way, and claiming "live" off an empty
187. // window would assert something this run never observed.
188. const pill = assignmentPill(liveSnap({ production: 0, accountOwner: 0, total: 0 }))
189. expect(pill?.tone).toBe('degraded')
190. expect(pill?.status).toBe('no lines')
191. })
193. it('never reads live on a fixture run', () => {
194. // Same rule as every other pill: a frozen export must not borrow the
195. // vocabulary of a live query.
196. const pill = assignmentPill(FIXTURE_SNAPSHOT)
197. expect(pill?.status).toBe('sample data')
198. expect(pill?.tone).not.toBe('live')
199. })
200. })