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 与桌面组件各一条用例钉着。
This commit is contained in:
@@ -1,10 +1,13 @@
|
||||
/**
|
||||
* 用户端首批组件挂载用例(四面9分口径 §2「错误静默 …;0 挂载测试」那一半句的执行证据)。
|
||||
* 用户端铃铛的组件挂载用例(四面9分口径 §2「错误静默 …;0 挂载测试」那一半句的执行证据)。
|
||||
*
|
||||
* 为什么是这三个靶子:本面 src 下的 vue 组件里"只 console 不给用户看"的 catch 实测 5 处,
|
||||
* 其中铃铛占 3 处(未读数轮询、列表加载、点通知标已读)。轮询与列表那两处是**有意**静默
|
||||
* (源码注释声明"不打扰用户",列表失败改在面板内给文案),所以这里钉的是"声明的意图真兑现";
|
||||
* 标已读那一处改前是真静默——点了通知没反应、行也没转已读,用户只能反复点,本轮改成可见。
|
||||
* 两组靶子:
|
||||
* ① 三处失败的用户可见性——本面 src 下的 vue 组件里"只 console 不给用户看"的 catch 实测 5 处,
|
||||
* 铃铛占 3 处(未读数轮询、组加载、点明细标已读)。轮询与组加载那两处是**有意**静默
|
||||
* (源码注释声明"不打扰用户",组加载失败改在面板内给文案),这里钉的是"声明的意图真兑现";
|
||||
* 标已读那一处改前是真静默——点了通知没反应、行也没转已读,用户只能反复点,本轮改成可见。
|
||||
* ② 10-13 聚合改造(场景 × 自然日 × 用户)带出来的三条口径:点聚合行只展开不标已读、
|
||||
* 红点按组数亮、组内没读完红点不许掉。这三条都只能在真组件上验,纯函数用例判不到 DOM 与状态联动。
|
||||
*
|
||||
* 跑真组件:真 api 桩、真 ElMessage 出口、真 DOM,判的是运行时行为,
|
||||
* 不是读源码的形状钉子(那类钉子在本仓已占 25% 用例,见 §2 后管同源问题)。
|
||||
@@ -12,7 +15,7 @@
|
||||
* ⚠ 面板是 `<Teleport to="body">`:每支用例都必须 unmount 并清 body,
|
||||
* 否则上一支留下的 `.bell-item--unread` 会被这一支的 document 查询捡到。
|
||||
*
|
||||
* 跑法:`npx vitest run --root frontend-vue`
|
||||
* 跑法:`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'
|
||||
@@ -28,6 +31,7 @@ const message = vi.hoisted(() => ({
|
||||
}))
|
||||
const api = vi.hoisted(() => ({
|
||||
fetchNotificationSummary: vi.fn(),
|
||||
fetchNotificationGroups: vi.fn(),
|
||||
fetchNotificationList: vi.fn(),
|
||||
markNotificationRead: vi.fn(),
|
||||
markAllNotificationsRead: vi.fn(),
|
||||
@@ -37,6 +41,7 @@ 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,
|
||||
@@ -52,6 +57,22 @@ const notification = (over: Record<string, unknown> = {}) => ({
|
||||
...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 等它落地。 */
|
||||
@@ -63,22 +84,44 @@ async function openPanel() {
|
||||
}
|
||||
|
||||
/**
|
||||
* 点第一条通知。⚠ 面板是 Teleport 到 body 的,`wrapper.find()` 看不见里面的节点
|
||||
* (实测 wrapper 查 `.bell-item` 得到空 wrapper 而 document 里那一行确实在)
|
||||
* ⇒ 一律从 document 取节点、用原生 click 触发,Vue 的 @click 监听挂在元素上,照样生效。
|
||||
* 从 document 取节点、用原生 click 触发:面板是 Teleport 到 body 的,
|
||||
* `wrapper.find()` 看不见里面的节点(实测 wrapper 查 `.bell-item` 得到空 wrapper
|
||||
* 而 document 里那一行确实在),而 Vue 的 @click 监听挂在元素上,原生 click 照样生效。
|
||||
*/
|
||||
function clickFirstRow() {
|
||||
const row = document.querySelector<HTMLElement>('.bell-item')
|
||||
expect(row, '面板里没有可点的通知行').not.toBeNull()
|
||||
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, latestId: 7 })
|
||||
api.fetchNotificationList.mockResolvedValue({ items: [notification()], total: 1, unreadCount: 1 })
|
||||
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(() => {})
|
||||
@@ -92,12 +135,13 @@ describe('NotificationBell:三处失败的用户可见性', () => {
|
||||
vi.clearAllMocks()
|
||||
})
|
||||
|
||||
it('点通知标已读失败:必须给一条带原因的错误提示,且不许把这一行冒充成已读', async () => {
|
||||
it('点明细标已读失败:必须给一条带原因的错误提示,且不许把这一行冒充成已读', async () => {
|
||||
api.markNotificationRead.mockRejectedValue(new Error('403 Forbidden'))
|
||||
await openPanel()
|
||||
expect(document.querySelectorAll('.bell-item')).toHaveLength(1)
|
||||
await expandFirstGroup()
|
||||
expect(document.querySelectorAll('.bell-item--detail')).toHaveLength(1)
|
||||
|
||||
clickFirstRow()
|
||||
clickElement('.bell-item--detail')
|
||||
await flushPromises()
|
||||
|
||||
expect(message.error).toHaveBeenCalledTimes(1)
|
||||
@@ -108,12 +152,13 @@ describe('NotificationBell:三处失败的用户可见性', () => {
|
||||
|
||||
it('反向钉:标已读成功时不产生任何提示,而这一行要真的转为已读', async () => {
|
||||
await openPanel()
|
||||
await expandFirstGroup()
|
||||
// 挂载那一轮 refreshSummary 发现"有新通知"本来就会弹一条 warning(既有设计,不是缺陷),
|
||||
// 所以先把账清掉——本用例判的是"点成功这个动作"不许再产生提示。
|
||||
message.error.mockClear()
|
||||
message.warning.mockClear()
|
||||
|
||||
clickFirstRow()
|
||||
clickElement('.bell-item--detail')
|
||||
await flushPromises()
|
||||
|
||||
expect(message.error).not.toHaveBeenCalled()
|
||||
@@ -121,8 +166,8 @@ describe('NotificationBell:三处失败的用户可见性', () => {
|
||||
expect(document.querySelector('.bell-item--unread')).toBeNull()
|
||||
})
|
||||
|
||||
it('列表加载失败:文案进面板本身,而不是弹一条全局消息打扰用户', async () => {
|
||||
api.fetchNotificationList.mockRejectedValue(new Error('502 Bad Gateway'))
|
||||
it('组加载失败:文案进面板本身,而不是弹一条全局消息打扰用户', async () => {
|
||||
api.fetchNotificationGroups.mockRejectedValue(new Error('502 Bad Gateway'))
|
||||
await openPanel()
|
||||
|
||||
expect(document.body.textContent).toContain('502 Bad Gateway')
|
||||
@@ -130,3 +175,113 @@ describe('NotificationBell:三处失败的用户可见性', () => {
|
||||
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 条未列出')
|
||||
})
|
||||
})
|
||||
|
||||
Reference in New Issue
Block a user