Files
crawler-plugin/frontend-vue/tests/mount/notification-bell-failure.mount.test.ts
T
huangzd1997 5d2a1c6974 feat(通知): 列表按 场景×自然日×主体用户 聚合成两级,红点按组数亮而明细条数同屏;后管日期面板不再被弹窗压住
V158 给 biz_user_notification 加 subject_user_id(事件主体用户,与收件人 user_id 分家):
一行通知是给某个收件人看的,被通知的那个 uid 原先只活在文案字符串里,没有列就没法按用户成组,
也不肯用正则去解历史文案凑分组键。存量不回填(定案)⇒ 老行 subject_user_id 为 NULL,自成「未标注主体」一组。
写入侧 pushOrRefresh 第 8 参带主体,AUDIENCE_USER 时主体=收件人(故新增 7 参便捷档,68 处调用一行没改);
pushToAdminsAnyOf 传 null 并注明理由:一把密钥被 N 个账号共用,不挑一个 uid 冒充。

新增 GET /api/notifications/groups 与 /api/admin/notifications/groups:Java 侧分组(复用 baseWrapper 一份筛选实现),
分页按组切,同屏返回 total=组数 与 rowCount=明细条数;unreadGroupCount 走
COUNT(DISTINCT scene, DATE(created_at), IFNULL(subject_user_id,-1)) —— IFNULL 不能省,
MySQL 的 COUNT(DISTINCT a,b,c) 会跳过任一表达式为 NULL 的行,不兜就把存量那一组整个数没。
红点是新增 unreadGroupCount 而不动 unreadCount 语义:已装机老客户端读 unreadCount 画徽标,
换语义会让老客户端出现「红点 3、列表 217 条」对不上。

铃铛两级(后管+桌面各一份):聚合行点击只展开、不替用户标已读,已读必须进明细逐条点;
明细一次最多 50 条,超出显示「另有 N 条未列出」;下钻带 scene+day+subjectUserId(主体为空改下发
subjectUnlabelled 旗标走 IS NULL),少一维就会把同场景同天别主体的行混进这一组的明细——桌面端最初就漏了这一维。
死码随两级视图退场:groupNotificationsByDay/NotificationDayGroup 删掉,用例换成 formatDayLabel/notificationGroupKey/formatGroupCounts。

后管日期选择面板 z-index 抬到 3300(面板 3200)之上:Element 弹层只自 2000 起递增,不抬就被面板压住,表现为「日期点不动」。
playwright 加 E2E_PORT+strictPort:实测 5174/5176 被别的项目的 vite 占着,reuseExistingServer 让 e2e 连上别人的应用,
当时 5 条全红是端口归属问题而不是回归。

验证=后端通知面 66/66(-Dtest='Notification*' 63 + AdminNotificationControllerTest 3)BUILD SUCCESS;
后管 node --test 1819/1819、真浏览器 e2e 10/10(含遮挡与「展开只取本组」);
桌面 node --test 834/834、组件挂载 vitest 8/8;两前端 vue-tsc --noEmit rc=0;ops 值班侧 18/18。
记账三处=后管 source-pin 逐文件基线 notification-bell.test.ts 用例 6→7(该文件钉子仍 0,占比不动);
桌面 catch 棘轮 blocks 298→299(新增那支是 toggleGroup 明细失败写进面板 loadError,非静默,silent 84 一格没涨);
桌面 endpoints 台账补 /api/notifications/groups。
变异自证 7 条全 KILLED:红点按条数/组内没读完就减组数/聚合行直接标已读/明细截断不报数/下钻丢主体/
丢 IS NULL 旗标/null 主体当值下发。其中「组内没读完就减组数」第一轮 SURVIVED——用例只钉了徽标,
而徽标在 unreadGroupCount 归零时会退回条数兜底,把这条回归盖住了;改成同时钉「N 组未读」chip 才杀掉。

已知盲区(下次补,别当已验):①桌面两级只在 happy-dom 跑过真组件,布局与层级没在真浏览器点过
(桌面日期弹层的层级修复本就在 HEAD 里,不是这批引入);②后管 e2e 夹具没有 subjectUserId=null 的行,
「存量自成一组」在后管 UI 层没被点过,只有后端 WHERE 与桌面组件各一条用例钉着。
2026-10-13 08:34:18 +08:00

288 lines
12 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.
/**
* 用户端铃铛的组件挂载用例(四面9分口径 §2「错误静默 …;0 挂载测试」那一半句的执行证据)。
*
* 两组靶子:
* ① 三处失败的用户可见性——本面 src 下的 vue 组件里"只 console 不给用户看"的 catch 实测 5 处,
* 铃铛占 3 处(未读数轮询、组加载、点明细标已读)。轮询与组加载那两处是**有意**静默
* (源码注释声明"不打扰用户",组加载失败改在面板内给文案),这里钉的是"声明的意图真兑现";
* 标已读那一处改前是真静默——点了通知没反应、行也没转已读,用户只能反复点,本轮改成可见。
* ② 10-13 聚合改造(场景 × 自然日 × 用户)带出来的三条口径:点聚合行只展开不标已读、
* 红点按组数亮、组内没读完红点不许掉。这三条都只能在真组件上验,纯函数用例判不到 DOM 与状态联动。
*
* 跑真组件:真 api 桩、真 ElMessage 出口、真 DOM,判的是运行时行为,
* 不是读源码的形状钉子(那类钉子在本仓已占 25% 用例,见 §2 后管同源问题)。
*
* ⚠ 面板是 `<Teleport to="body">`:每支用例都必须 unmount 并清 body,
* 否则上一支留下的 `.bell-item--unread` 会被这一支的 document 查询捡到。
*
* 跑法:`npx vitest run --config vitest.config.ts`(在 frontend-vue 目录下)
*/
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
import { flushPromises, mount, type VueWrapper } from '@vue/test-utils'
import NotificationBell from '@/shared/components/NotificationBell.vue'
const message = vi.hoisted(() => ({
error: vi.fn(),
warning: vi.fn(),
success: vi.fn(),
info: vi.fn(),
closeAll: vi.fn(),
}))
const api = vi.hoisted(() => ({
fetchNotificationSummary: vi.fn(),
fetchNotificationGroups: vi.fn(),
fetchNotificationList: vi.fn(),
markNotificationRead: vi.fn(),
markAllNotificationsRead: vi.fn(),
}))
vi.mock('element-plus', () => ({ ElMessage: message }))
vi.mock('@/shared/api/types/modules/notification.ts', () => ({
NOTIFICATION_CATEGORY_OPTIONS: [],
fetchNotificationSummary: api.fetchNotificationSummary,
fetchNotificationGroups: api.fetchNotificationGroups,
fetchNotificationList: api.fetchNotificationList,
markAllNotificationsRead: api.markAllNotificationsRead,
markNotificationRead: api.markNotificationRead,
}))
const notification = (over: Record<string, unknown> = {}) => ({
id: 7,
title: '品牌检测服务挂了',
content: '上游 503',
level: 'error',
read: false,
createdAt: new Date().toISOString(),
...over,
})
/** 聚合行:一条组 = 场景 × 自然日 × 主体用户,rowCount 是折叠前的明细条数。 */
const group = (over: Record<string, unknown> = {}) => ({
latestId: 7,
scene: 'brand_check_failed',
category: 'task_error',
day: '2026-09-13',
subjectUserId: 1160,
rowCount: 1,
unreadCount: 1,
level: 'error',
title: '品牌检测服务挂了',
content: '上游 503',
createdAt: new Date().toISOString(),
...over,
})
let wrapper: VueWrapper | null = null
/** 打开面板:触发 togglePanel ⇒ 内部 void loadPage(1),靠 flushPromises 等它落地。 */
async function openPanel() {
wrapper = mount(NotificationBell)
await flushPromises()
await wrapper.find('.bell-trigger').trigger('click')
await flushPromises()
}
/**
* 从 document 取节点、用原生 click 触发:面板是 Teleport 到 body 的,
* `wrapper.find()` 看不见里面的节点(实测 wrapper 查 `.bell-item` 得到空 wrapper
* 而 document 里那一行确实在),而 Vue 的 @click 监听挂在元素上,原生 click 照样生效。
*/
function clickElement(selector: string) {
const row = document.querySelector<HTMLElement>(selector)
expect(row, `面板里没有可点的 ${selector}`).not.toBeNull()
row!.click()
}
/** 展开第一个聚合行:聚合行上的点击只做展开,明细行才是要点的那些。 */
async function expandFirstGroup() {
clickElement('.bell-group')
await flushPromises()
}
/**
* 红点取自 wrapper 而不是 document:`mount()` 不挂 attachTo,组件自身(含 .bell-trigger 与
* 它里面的 .bell-badge)渲染在游离节点上,只有 Teleport 到 body 的面板才能在 document 里查到。
*/
function badgeText(): string | null {
const badge = wrapper?.find('.bell-badge')
return badge && badge.exists() ? badge.text() : null
}
describe('NotificationBell:三处失败的用户可见性', () => {
beforeEach(() => {
document.body.innerHTML = ''
localStorage.clear()
api.fetchNotificationSummary.mockResolvedValue({ unreadCount: 1, unreadGroupCount: 1, latestId: 7 })
api.fetchNotificationGroups.mockResolvedValue({
groups: [group()],
total: 1,
rowCount: 1,
unreadGroupCount: 1,
unreadCount: 1,
})
api.fetchNotificationList.mockResolvedValue({ items: [notification()], total: 1 })
api.markNotificationRead.mockResolvedValue(undefined)
vi.spyOn(console, 'warn').mockImplementation(() => {})
vi.spyOn(console, 'log').mockImplementation(() => {})
})
afterEach(() => {
wrapper?.unmount()
wrapper = null
document.body.innerHTML = ''
vi.restoreAllMocks()
vi.clearAllMocks()
})
it('点明细标已读失败:必须给一条带原因的错误提示,且不许把这一行冒充成已读', async () => {
api.markNotificationRead.mockRejectedValue(new Error('403 Forbidden'))
await openPanel()
await expandFirstGroup()
expect(document.querySelectorAll('.bell-item--detail')).toHaveLength(1)
clickElement('.bell-item--detail')
await flushPromises()
expect(message.error).toHaveBeenCalledTimes(1)
expect(String(message.error.mock.calls[0][0])).toContain('403 Forbidden')
// 失败就是失败:这一行还得看着是未读(否则用户以为点到了,实际服务端没落)
expect(document.querySelector('.bell-item--unread')).not.toBeNull()
})
it('反向钉:标已读成功时不产生任何提示,而这一行要真的转为已读', async () => {
await openPanel()
await expandFirstGroup()
// 挂载那一轮 refreshSummary 发现"有新通知"本来就会弹一条 warning(既有设计,不是缺陷),
// 所以先把账清掉——本用例判的是"点成功这个动作"不许再产生提示。
message.error.mockClear()
message.warning.mockClear()
clickElement('.bell-item--detail')
await flushPromises()
expect(message.error).not.toHaveBeenCalled()
expect(message.warning).not.toHaveBeenCalled()
expect(document.querySelector('.bell-item--unread')).toBeNull()
})
it('组加载失败:文案进面板本身,而不是弹一条全局消息打扰用户', async () => {
api.fetchNotificationGroups.mockRejectedValue(new Error('502 Bad Gateway'))
await openPanel()
expect(document.body.textContent).toContain('502 Bad Gateway')
expect(message.error).not.toHaveBeenCalled()
expect(document.querySelectorAll('.bell-item')).toHaveLength(0)
})
})
describe('NotificationBell:聚合两级与红点口径', () => {
beforeEach(() => {
document.body.innerHTML = ''
localStorage.clear()
api.fetchNotificationSummary.mockResolvedValue({ unreadCount: 2, unreadGroupCount: 1, latestId: 7 })
api.fetchNotificationGroups.mockResolvedValue({
groups: [group({ latestId: 13, rowCount: 3, unreadCount: 2 })],
total: 1,
rowCount: 3,
unreadGroupCount: 1,
unreadCount: 2,
})
api.fetchNotificationList.mockResolvedValue({
items: [notification({ id: 11 }), notification({ id: 12 }), notification({ id: 13, read: true })],
total: 3,
})
api.markNotificationRead.mockResolvedValue(undefined)
vi.spyOn(console, 'warn').mockImplementation(() => {})
vi.spyOn(console, 'log').mockImplementation(() => {})
})
afterEach(() => {
wrapper?.unmount()
wrapper = null
document.body.innerHTML = ''
vi.restoreAllMocks()
vi.clearAllMocks()
})
it('点聚合行只展开:一次都不许替用户把通知标成已读', async () => {
await openPanel()
// 折叠态:面板里只有组行,一条明细都不该出现(明细要用户主动展开才拉)
expect(document.querySelectorAll('.bell-group')).toHaveLength(1)
expect(document.querySelectorAll('.bell-item--detail')).toHaveLength(0)
await expandFirstGroup()
expect(api.markNotificationRead).not.toHaveBeenCalled()
expect(api.fetchNotificationList).toHaveBeenCalledTimes(1)
// 下钻必须带上第三维(主体用户):同场景同一天里小魏11 与小魏17 是两组,
// 只按 scene+day 查会把两家的行都捞进同一份明细。
expect(api.fetchNotificationList.mock.calls[0][0]).toMatchObject({
scene: 'brand_check_failed',
day: '2026-09-13',
subjectUserId: 1160,
})
expect(api.fetchNotificationList.mock.calls[0][0].subjectUnlabelled).toBe(false)
expect(document.querySelectorAll('.bell-item--detail')).toHaveLength(3)
})
it('展开「未标注主体」那一组:按 IS NULL 查,不许把有主体的行混进来', async () => {
api.fetchNotificationGroups.mockResolvedValue({
groups: [group({ subjectUserId: null, rowCount: 2, unreadCount: 2 })],
total: 1,
rowCount: 2,
unreadGroupCount: 1,
unreadCount: 2,
})
await openPanel()
await expandFirstGroup()
const sent = api.fetchNotificationList.mock.calls[0][0]
expect(sent.subjectUnlabelled).toBe(true)
expect(sent.subjectUserId).toBeNull()
})
it('红点按组数亮、明细条数同屏:一组两条未读也不会亮成"2"', async () => {
await openPanel()
expect(badgeText()).toBe('1')
expect(document.querySelector('.bell-unread-chip')?.textContent).toContain('1 组未读')
// 组数与条数必须同时在屏上,只给一个数就会被读成"一共就这些通知"
expect(document.querySelector('.bell-foot-total')?.textContent).toContain('共 1 组')
expect(document.querySelector('.bell-foot-total')?.textContent).toContain('明细 3 条')
expect(document.querySelector('.bell-group-count')?.textContent).toBe('3 条 · 2 未读')
})
it('组内还有未读时红点不许掉,读完最后一条才掉', async () => {
await openPanel()
await expandFirstGroup()
clickElement('.bell-item--detail.bell-item--unread')
await flushPromises()
expect(api.markNotificationRead).toHaveBeenCalledTimes(1)
expect(badgeText()).toBe('1')
// 判组数必须看 chip:徽标在 unreadGroupCount 为 0 时会退回条数(兼容没给新字段的旧后端),
// 只钉徽标的话"组内没读完就把组数减掉"这条回归会被那层兜底盖住(变异自证 M2 实测存活过一次)。
expect(document.querySelector('.bell-unread-chip')?.textContent).toContain('1 组未读')
clickElement('.bell-item--detail.bell-item--unread')
await flushPromises()
expect(api.markNotificationRead).toHaveBeenCalledTimes(2)
// 这一组的两条未读都读完了:组数从 1 掉到 0,红点与"组未读"字样一起消失
expect(document.querySelector('.bell-badge')).toBeNull()
expect(document.querySelector('.bell-unread-chip')).toBeNull()
})
it('明细超出上限时说明还剩多少,不许让用户以为这就是全部', async () => {
api.fetchNotificationList.mockResolvedValue({
items: Array.from({ length: 50 }, (_, i) => notification({ id: 100 + i })),
total: 60,
})
await openPanel()
await expandFirstGroup()
expect(document.querySelectorAll('.bell-item--detail')).toHaveLength(50)
expect(document.querySelector('.bell-detail-state')?.textContent).toContain('另有 10 条未列出')
})
})