Files
crawler-plugin/admin-frontend-vue/tests/pure/notification-bell-panel.test.ts
T
huangzd1997 f68d1afecf refactor(通知): 铃铛面板状态机从 SFC 拆成独立一层——是上一笔把两个组件顶到可读棘轮 800 行上限的账,不是新功能
上一笔(5d2a1c69 通知聚合)推 origin 时被四面闸门连拒两次,两次都不是回归:
第一次是负载把 score_ratchet 的 py_case 挤成负数超时(单跑那格 18 秒绿,带 capture_output 复跑 24 秒 rc=0,
管道阻塞这条已排除);第二次读数清楚——后管 10 格红、客户端 48 格红,红的都是我这笔造成的:
① 可读棘轮按对象点名:后管 NotificationBell.vue 700→877 是"新增超长文件",用户端 1318→1439 是"比基线更长";
② 后管还有一把 vitest 挂载尺子(tests/mount/**,npm test 那个 glob 不递归 ⇒ 上一笔我漏跑了),
   它 mock 的还是单层列表接口,两级改造后 2 条判红——这条是我上一轮汇报里说"后管全绿"的假话,先认。

拆法按尺子自己给的那条路("要么拆,要么逐条点名改基线并写清是谁的哪一笔"):放宽基线要人拍板,所以拆。
只搬 script,样式一行没动——搬模板会把 scoped 样式的后代选择器甩在父作用域外,那是会改画面的拆法。
新层是纯 TS + 一个 composable:后管 src/layout/notification-bell-panel.ts、用户端 src/shared/composables/useNotificationBellPanel.ts,
组件只留面板开合、fixed 定位、外部点击关闭、60s 轮询定时器;行数 后管 877→652、用户端 1439→1213(台账点名的基线是 1318)。

这一层是纯函数,于是判据从"源码里有没有那行字"升级成"喂数据看返回值":
新增 tests/pure/notification-bell-panel.test.ts 两支(后管 9 例 / 用户端 8 例,走 vitest——这层要解析 @ 别名与 vue,
进不了零依赖的 node --test,两面 vitest.config 的 include 因此多收一格,注释同步改掉)。
覆盖:红点按组数、组内没读完不许减组数、下钻三维(主体为空改 IS NULL 旗标)、日期倒挂交换、
聚合页缺字段时的回落、换天才挂日期头、级别兜底、水位只在首页有数据时推进。
变异自证 6 条全 KILLED(A1 组数提前掉/A2 下钻丢主体/A3 天天挂头/D1 组数提前掉/D2 丢 IS NULL 旗标/D3 日期不交换),
还原按注入前内存字节写回并比过(admin 13790 / desktop 13115)。

三处台账跟着实况走,没有一处是放宽:
① 用户端 catch 棘轮 perFile:组件 3→0、新记 useNotificationBellPanel.ts=2,silent 总数 84→83(尺子的注释要求降了就一起改小);
   blocks 仍 299(搬动不改分母)。
② 后管 source-pin 台账:notification-bell-failure.test.ts 的钉子从 SFC 复指到新层,
   readSource 读点数不变(中途加过一枚"组件确实在用这层"的钉子,实测会把台账读点数抬上去,
   而这条已由挂载用例在运行时证 ⇒ 撤掉,不往只许减的台账里添)。
③ 后管挂载用例 4→6 例(补"点聚合行只展开不标已读""红点按组数""下钻带主体")。

验证=后管 node --test 1819/1819、vitest 21/21(12 挂载 + 9 纯函数)、真浏览器 e2e 10/10、vue-tsc rc=0;
用户端 node --test 834/834、vitest 16/16(8 挂载 + 8 纯函数)、vue-tsc rc=0;
ops 侧 test_readability_ratchet 9/9 绿(这条是上一笔红的因,现已解)。
⚠ scripts/tests 整量此刻仍 1 格红,红的不是本笔:scripts/tests/test_无声台账放宽闸.py 于 10-13 09:56 被另一路会话
扩写进 RD2 三记反例(3f55f3b),而配套 app_client/scripts/gen_silent_ledger.py 的 --check 还只判总数轴(那份 10-12 23:12 起没动)
⇒ 逐文件那一条轴此刻必然判不到,本笔不动别人的尺子也不替别人抬基线。
2026-10-13 10:38:34 +08:00

126 lines
5.2 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/**
* 面板层纯函数的行为用例(10-13 从 NotificationBell.vue 拆出这一层的唯一目的就在这)。
*
* 组件那一层在本面只能挂载跑(vitest+jsdom),而"红点按组数、组内没读完不许掉、
* 下钻三维、换页清展开态"这几条口径其实都是纯计算——放这一层就能逐条喂数据判它,
* 不必退化成 readSource 钉源码字形(那种钉子在这仓已被记进只许减的台账)。
*
* 跑法:`npx vitest run --config vitest.config.ts`(`npm test` 那把 node --test 零依赖,
* 解析不了 @ 别名与 vue,所以这一支走 vitest 的 tests/pure/**)。
*/
import { describe, expect, it } from 'vitest'
import {
PANEL_DETAIL_LIMIT,
applyGroupsPage,
applyMarkReadToCounts,
detailQueryFor,
itemLevel,
latestIdWorthRecording,
normalizedDayRange,
startsNewDay,
} from '@/layout/notification-bell-panel'
const group = (over: Record<string, unknown> = {}) => ({
latestId: 7,
scene: 'service_down',
category: 'system_error',
day: '2026-09-13',
subjectUserId: 1160,
rowCount: 1,
unreadCount: 1,
level: 'error',
title: '品牌检测服务挂了',
content: '上游 503',
createdAt: '2026-09-13T09:00:00.000Z',
...over,
})
describe('通知面板层纯函数', () => {
it('起止日期倒挂自动交换;单边留空不下发该条件', () => {
expect(normalizedDayRange('2026-09-14', '2026-09-13')).toEqual({
startDate: '2026-09-13',
endDate: '2026-09-14',
})
expect(normalizedDayRange('', '')).toEqual({ startDate: undefined, endDate: undefined })
expect(normalizedDayRange('2026-09-13', '')).toEqual({ startDate: '2026-09-13', endDate: undefined })
})
it('下钻条件带满三维,主体为空改走 IS NULL 旗标', () => {
const labelled = detailQueryFor(group({ subjectUserId: 1196 }) as never)
expect(labelled.scene).toBe('service_down')
expect(labelled.day).toBe('2026-09-13')
expect(labelled.subjectUserId).toBe(1196)
expect(labelled.subjectUnlabelled).toBe(false)
expect(labelled.pageSize).toBe(PANEL_DETAIL_LIMIT)
// 改动上线前的存量行没有主体用户:按 null 下发等于把条件丢掉,必须换成旗标
const unlabelled = detailQueryFor(group({ subjectUserId: null }) as never)
expect(unlabelled.subjectUserId).toBeNull()
expect(unlabelled.subjectUnlabelled).toBe(true)
})
it('组内还有未读时组数不许减,读完最后一条才减', () => {
const groups = [group({ unreadCount: 2 }), group({ subjectUserId: 1196, unreadCount: 1 })]
const key = 'service_down|2026-09-13|1160'
const first = applyMarkReadToCounts(groups, key, 3, 2)
expect(groups[0].unreadCount).toBe(1, '第一条读完,组内还剩一条')
expect(first.unreadCount).toBe(2, '明细条数照实减')
expect(first.unreadGroupCount).toBe(2, '这一组还没读完,未读组数不许动')
const last = applyMarkReadToCounts(groups, key, 2, 2)
expect(groups[0].unreadCount).toBe(0)
expect(last.unreadGroupCount).toBe(1, '组内清零,红点(按组数)才掉这一格')
})
it('没展开任何一组时只减明细数,不减组数', () => {
const groups = [group({ unreadCount: 1 })]
const next = applyMarkReadToCounts(groups, '', 1, 1)
expect(groups[0].unreadCount).toBe(1, '找不到归属组就不该改组内计数')
expect(next.unreadCount).toBe(0)
expect(next.unreadGroupCount).toBe(1)
})
it('两个计数不许越界成负数', () => {
const next = applyMarkReadToCounts([], 'nothing-expanded', 0, 0)
expect(next).toEqual({ unreadCount: 0, unreadGroupCount: 0 })
})
it('聚合页缺字段时回落:组数按实收、明细条数按清单长度', () => {
const applied = applyGroupsPage(
{ groups: [group(), group({ subjectUserId: 1196 })] } as never,
{ unreadCount: 5, unreadGroupCount: 3 },
)
expect(applied.total).toBe(2)
expect(applied.rowCount).toBe(2)
expect(applied.unreadCount).toBe(5, '后端没给这一格就保留上一次读数,别凭空归零')
expect(applied.unreadGroupCount).toBe(3)
const empty = applyGroupsPage({ groups: null } as never, { unreadCount: 1, unreadGroupCount: 1 })
expect(empty.groups).toEqual([])
expect(empty.total).toBe(0)
})
it('日期头只在换天时出现:同一天多组(多用户/多场景)不重复挂头', () => {
const list = [group(), group({ subjectUserId: 1196 }), group({ day: '2026-09-12' })]
expect(startsNewDay(list, 0)).toBe(true)
expect(startsNewDay(list, 1)).toBe(false)
expect(startsNewDay(list, 2)).toBe(true)
})
it('级别兜底:非法/缺失都按 warning,组行与明细行不会配色分家', () => {
expect(itemLevel({ level: 'error' })).toBe('error')
expect(itemLevel({ level: 'info' })).toBe('info')
expect(itemLevel({ level: 'fatal' })).toBe('warning')
expect(itemLevel({ level: '' })).toBe('warning')
})
it('已提醒水位只在首页真有数据时推进,取不到 id 就什么也不写', () => {
expect(latestIdWorthRecording([])).toBe(0)
expect(latestIdWorthRecording([group({ latestId: 0 })])).toBe(0)
expect(latestIdWorthRecording([group({ latestId: 'x' })])).toBe(0)
expect(latestIdWorthRecording([group({ latestId: 88 })])).toBe(88)
})
})