diff --git a/admin-frontend-vue/e2e/notification-panel.spec.ts b/admin-frontend-vue/e2e/notification-panel.spec.ts index d3c61123d..17ad23a35 100644 --- a/admin-frontend-vue/e2e/notification-panel.spec.ts +++ b/admin-frontend-vue/e2e/notification-panel.spec.ts @@ -1,38 +1,78 @@ import { expect, test, type Page } from '@playwright/test' -// 站内通知铃铛面板验收:关键字/年月日区间搜索、按天分组、分页。 -// 依赖 scripts/mock-admin-server.mjs 的通知夹具(14 条:09-13 六条、09-12 四条、09-10 四条)。 +// 站内通知铃铛面板验收:聚合视图(场景 × 自然日 × 事件主体用户)、展开明细、 +// 关键字/年月日区间搜索、按组分页、红点按组数。 +// 依赖 scripts/mock-admin-server.mjs 的通知夹具:14 行折成 10 组、2 组未读、3 行未读。 +// 夹具的 id 与 createdAt 同为插入时单调(与真库一致),场景显式写在夹具里而不是从 id 推。 + +// 夹具会被"标记已读"改写,而 mock 服务在 reuseExistingServer 下跨轮存活 ⇒ 每条用例前重置, +// 否则第二遍跑会带着上一遍的已读态,绝对计数断言全漂。 +test.beforeEach(async ({ request }) => { + await request.post('/api/admin/notifications/__reset') +}) + +async function clearDateFilter(page: Page) { + const picker = page.locator('.bell-panel .bell-date-picker') + await picker.hover() + await picker.locator('.el-range__close-icon').click() + await expect(page.locator('.bell-page-total')).toHaveText('共 10 组 · 明细 14 条') +} async function openBell(page: Page) { await page.goto('/admin-vue/') await expect(page.locator('.admin-topbar h1')).toHaveText('用户管理') await page.locator('.admin-notification-bell .bell-trigger').click() await expect(page.locator('.bell-panel')).toBeVisible() - await expect(page.locator('.bell-item').first()).toBeVisible() + // 面板默认按「当天」过滤,夹具是 09-10~09-13:先清空日期才能拿到全量 + await clearDateFilter(page) + await expect(page.locator('.bell-group').first()).toBeVisible() } -test('test_notification_panel_day_group_and_pagination', async ({ page }) => { +/** + * 打开日历并等入场动画落定。 + * + * 两件事必须先做对,否则读数全是假的: + * ① 弹层节点是常驻的(Element 用 v-show),未打开时它也在 DOM 里、rect 全 0, + * 所以 `toBeAttached()` 不能当「已打开」的判据; + * ② 打开瞬间 el-zoom-in-top 把弹层 scaleY 压到 0,格子坐标整体贴到面板顶部, + * 此时做命中测试会把「动画中」读成「被面板遮挡」。 + */ +async function openCalendar(page: Page) { + await page.locator('.bell-panel .bell-date-picker').click() + const popper = page.locator('.bell-date-popper') + await expect(popper).toBeVisible() + await page.waitForFunction(() => { + const pop = document.querySelector('.bell-date-popper') + if (!pop) return false + const style = getComputedStyle(pop) + return style.transform === 'none' && style.opacity === '1' && pop.getBoundingClientRect().height > 0 + }) + return popper +} + +test('test_notification_panel_groups_and_pagination', async ({ page }) => { await openBell(page) const panel = page.locator('.bell-panel') const nextPage = panel.getByRole('button', { name: '下一页' }) - // 每页 10 条,跨两个日期分组,页脚显示页码与总数 - await expect(page.locator('.bell-item')).toHaveCount(10) + // 一页 6 组:09-13 的 4 组 + 09-12 的 2 组 ⇒ 日期头 2 个(同一天可以多组) + await expect(page.locator('.bell-group')).toHaveCount(6) await expect(page.locator('.bell-day-head')).toHaveCount(2) - await expect(page.locator('.bell-page-info')).toHaveText('1 / 2') - await expect(page.locator('.bell-page-total')).toHaveText('共 14 条') await expect(page.locator('.bell-day-head').first()).toHaveText(/^(今天|昨天|\d{4}年\d{1,2}月\d{1,2}日)$/) + await expect(page.locator('.bell-page-info')).toHaveText('1 / 2') + await expect(page.locator('.bell-page-total')).toHaveText('共 10 组 · 明细 14 条') + // 聚合行必须把"折叠前几条、其中几条没读"写在行上 + await expect(page.locator('.bell-group-count').first()).toHaveText('1 条 · 1 未读') const page2Request = page.waitForRequest( - (request) => request.url().includes('/api/admin/notifications?') && request.url().includes('page=2'), + (request) => request.url().includes('/api/admin/notifications/groups?') && request.url().includes('page=2'), ) await nextPage.click() await page2Request - await expect(page.locator('.bell-item')).toHaveCount(4) + await expect(page.locator('.bell-group')).toHaveCount(4) await expect(page.locator('.bell-page-info')).toHaveText('2 / 2') - await expect(page.locator('.bell-day-head')).toHaveCount(1) await expect(nextPage).toBeDisabled() }) @@ -45,37 +85,129 @@ test('test_notification_panel_search_by_keyword', async ({ page }) => { await page.locator('.bell-search-input').fill('余额不足') await keywordRequest - // 关键字命中标题/内容:夹具里 5 条含「余额不足」 - await expect(page.locator('.bell-item')).toHaveCount(5) - await expect(page.locator('.bell-page-total')).toHaveText('共 5 条') + // 关键字命中标题/内容:夹具里 5 条含「余额不足」,且分属 5 个不同的组 + await expect(page.locator('.bell-group')).toHaveCount(5) + await expect(page.locator('.bell-page-total')).toHaveText('共 5 组 · 明细 5 条') await expect(page.locator('.bell-search-reset')).toBeVisible() await page.locator('.bell-search-reset').click() - await expect(page.locator('.bell-item')).toHaveCount(10) + // 重置回到面板的默认视图:清空关键字、日期恢复「当天」(当天不是清空日期) + await expect(page.locator('.bell-search-input')).toHaveValue('') await expect(page.locator('.bell-search-reset')).toBeHidden() + await expect(page.locator('.bell-empty')).toHaveText('暂无通知') }) +/** 红点按**组数**亮:3 条未读落在 2 个组里,徽标就是 2 而不是 3。 */ +test('test_notification_panel_badge_counts_groups_not_rows', async ({ page }) => { + await page.goto('/admin-vue/') + await expect(page.locator('.admin-notification-bell .bell-badge')).toHaveText('2') +}) + +test('test_notification_panel_expand_group_loads_that_group_only', async ({ page }) => { + await openBell(page) + + const groups = page.locator('.bell-group') + await expect(groups).toHaveCount(6) + + const firstDetailRequest = page.waitForRequest((request) => { + const url = new URL(request.url()) + return ( + url.pathname.endsWith('/api/admin/notifications') && + url.searchParams.get('scene') === 'secret_balance' && + url.searchParams.get('day') === '2026-09-13' && + url.searchParams.get('subjectUserId') === '1196' + ) + }) + await groups.first().click() + await firstDetailRequest + await expect(page.locator('.bell-item--detail')).toHaveCount(1) + await expect(page.locator('.bell-group--open')).toHaveCount(1) + + // 换一组展开:上一组的明细必须收掉,不能两组明细叠在一起 + const secondDetailRequest = page.waitForRequest((request) => { + const url = new URL(request.url()) + return ( + url.pathname.endsWith('/api/admin/notifications') && + url.searchParams.get('scene') === 'task_failed' && + url.searchParams.get('subjectUserId') === '1196' + ) + }) + await groups.nth(1).click() + await secondDetailRequest + await expect(page.locator('.bell-item--detail')).toHaveCount(2) + await expect(page.locator('.bell-group--open')).toHaveCount(1) + + // 再点一次收起 + await groups.nth(1).click() + await expect(page.locator('.bell-item--detail')).toHaveCount(0) +}) + +test('test_notification_panel_date_popper_not_covered_by_panel', async ({ page }) => { + await openBell(page) + await openCalendar(page) + + // 日历与通知面板同为挂在 body 上的浮层:逐格做命中测试,最上层必须还是日历自己。 + // 通知面板 z-index 3200 高于 Element 默认弹层段(自 2000 递增)时,日历整块被压在 + // 面板底下,用户看到的就是「日期点不动」——这里必须判红而不是靠肉眼发现。 + const covered = await page.evaluate(() => { + const pop = document.querySelector('.bell-date-popper') as HTMLElement + const panel = document.querySelector('.bell-panel') as HTMLElement + const blocked: string[] = [] + for (const cell of Array.from(pop.querySelectorAll('td.available'))) { + const rect = cell.getBoundingClientRect() + if (rect.bottom > window.innerHeight || rect.right > window.innerWidth) continue + const hit = document.elementFromPoint(rect.left + rect.width / 2, rect.top + rect.height / 2) + if (!hit || !pop.contains(hit)) blocked.push(String(hit?.className ?? hit?.tagName ?? 'null')) + } + return { blocked, popperZ: getComputedStyle(pop).zIndex, panelZ: getComputedStyle(panel).zIndex } + }) + expect(covered.blocked, `日历被通知面板遮挡(popper=${covered.popperZ},panel=${covered.panelZ})`).toEqual([]) +}) + +/** 把左栏翻到 2026 年 9 月,返回按日取格的点击器(夹具:09-10 四条、09-12 四条、09-13 六条)。 */ +async function openRangeOnSeptember(page: Page) { + const popper = await openCalendar(page) + await popper.locator('.el-picker-panel__icon-btn.arrow-left').click() + const leftPanel = popper.locator('.el-date-range-picker__content').first() + const day = (text: string) => + leftPanel.locator('td.available .el-date-table-cell__text', { hasText: new RegExp(`^${text}$`) }) + await expect(day('10')).toBeVisible() + return day +} + test('test_notification_panel_search_by_day_range', async ({ page }) => { await openBell(page) + const day = await openRangeOnSeptember(page) + // 09-10 四条折成 3 组(两个用户 × 两个场景组合) const rangeRequest = page.waitForRequest( (request) => - request.url().includes('startDate=2026-09-12') && request.url().includes('endDate=2026-09-12'), + request.url().includes('startDate=2026-09-10') && request.url().includes('endDate=2026-09-12'), ) - await page.locator('.bell-date-input').first().fill('2026-09-12') - await page.locator('.bell-date-input').nth(1).fill('2026-09-12') + await day('10').click() + await day('12').click() await rangeRequest - await expect(page.locator('.bell-item')).toHaveCount(4) - await expect(page.locator('.bell-day-head')).toHaveCount(1) - await expect(page.locator('.bell-page-total')).toHaveText('共 4 条') + await expect(page.locator('.bell-page-total')).toHaveText('共 6 组 · 明细 8 条') + await expect(page.locator('.bell-day-head')).toHaveCount(2) await expect(page.locator('.bell-empty')).toHaveCount(0) + // 选完区间后面板必须还开着:日历挂在 body 上,不能被「点击外部关闭」当成面板外 + await expect(page.locator('.bell-panel')).toBeVisible() +}) - // 起止倒挂自动交换:09-13 起 / 09-10 止 → 实际按 09-10 ~ 09-13 查询(全量 14 条) - await page.locator('.bell-date-input').first().fill('2026-09-13') - await page.locator('.bell-date-input').nth(1).fill('2026-09-10') - await expect(page.locator('.bell-page-total')).toHaveText('共 14 条') - await expect(page.locator('.bell-item')).toHaveCount(10) +test('test_notification_panel_day_range_picked_backwards', async ({ page }) => { + await openBell(page) + const day = await openRangeOnSeptember(page) + + // 先点 13 再点 10:控件自己保证起 ≤ 止,落到 09-10 ~ 09-13(全量 14 条 / 10 组) + const swappedRequest = page.waitForRequest( + (request) => + request.url().includes('startDate=2026-09-10') && request.url().includes('endDate=2026-09-13'), + ) + await day('13').click() + await day('10').click() + await swappedRequest + await expect(page.locator('.bell-page-total')).toHaveText('共 10 组 · 明细 14 条') }) test('test_notification_panel_not_covered_by_page_content', async ({ page }) => { @@ -102,21 +234,47 @@ test('test_notification_panel_not_covered_by_page_content', async ({ page }) => test('test_notification_panel_reference_screenshot', async ({ page }) => { await openBell(page) - // 同日多条不得重叠:逐条校验纵向排布严格递增(截图伪影与真实布局问题的分界) const tops = await page - .locator('.bell-item') + .locator('.bell-group') .evaluateAll((els) => els.map((el) => el.getBoundingClientRect().top)) for (let i = 1; i < tops.length; i += 1) { - expect(tops[i], `第 ${i + 1} 条应排在第 ${i} 条下方`).toBeGreaterThan(tops[i - 1]) + expect(tops[i], `第 ${i + 1} 组应排在第 ${i} 组下方`).toBeGreaterThan(tops[i - 1]) } - await page.screenshot({ path: 'test-results/notification-panel-admin-page.jpg', animations: 'disabled' }) - await page.locator('.bell-panel').screenshot({ path: 'test-results/notification-panel-admin.jpg', animations: 'disabled' }) - - await page.locator('.bell-search-input').fill('余额不足') - await expect(page.locator('.bell-item')).toHaveCount(5) await page.locator('.bell-panel').screenshot({ - path: 'test-results/notification-panel-admin-search.jpg', + path: 'test-results/notification-panel-admin-groups.jpg', + animations: 'disabled', + }) + await page.locator('.bell-group').first().click() + await expect(page.locator('.bell-item--detail')).toHaveCount(1) + await page.locator('.bell-panel').screenshot({ + path: 'test-results/notification-panel-admin-expanded.jpg', animations: 'disabled', }) }) + +/** + * 已读只能进明细逐条点(口径见设计):组内未读清零,红点才掉一格。 + */ +test('test_notification_panel_mark_read_from_detail_drops_group_last', async ({ page }) => { + await openBell(page) + + const group = page.locator('.bell-group').nth(1) + await expect(group.locator('.bell-group-count')).toHaveText('2 条 · 2 未读') + await group.click() + await expect(page.locator('.bell-item--detail')).toHaveCount(2) + // 每次点的都必须是「还红着」的那条:已读行点了不做事(onItemClick 直接 return), + // 拿 .first() 连点两次会第二次点到刚读过的那条,看着像"没扣数"。 + const unread = page.locator('.bell-item--detail.bell-item--unread') + + await unread.first().click() + await expect(unread).toHaveCount(1) + await expect(group.locator('.bell-group-count')).toHaveText('2 条 · 1 未读') + // 还剩一条未读 ⇒ 这一组仍计为一个未读组,红点不动 + await expect(page.locator('.admin-notification-bell .bell-badge')).toHaveText('2') + + await unread.first().click() + await expect(unread).toHaveCount(0) + await expect(group.locator('.bell-group-count')).toHaveText('2 条') + await expect(page.locator('.admin-notification-bell .bell-badge')).toHaveText('1') +}) diff --git a/admin-frontend-vue/playwright.config.ts b/admin-frontend-vue/playwright.config.ts index be6b4cac9..549db3b3a 100644 --- a/admin-frontend-vue/playwright.config.ts +++ b/admin-frontend-vue/playwright.config.ts @@ -1,9 +1,14 @@ import { defineConfig } from '@playwright/test' /** - * 浏览器验收:起 mock admin API(18100) + vite dev(5174, /api 代理到 mock)。 + * 浏览器验收:起 mock admin API(18100) + vite dev(E2E_PORT,默认 5174, /api 代理到 mock)。 * 本地用已安装的 MS Edge(channel: msedge)运行,无需下载 Chromium。 + * + * 端口必须可改:5174 被别的项目占用时 vite 会顺延到别的端口,而 reuseExistingServer + * 会让 playwright 直接连上那个「不是本站」的服务,整份验收测的是别人的页面。 */ +const PORT = Number(process.env.E2E_PORT || 5174) + export default defineConfig({ testDir: './e2e', timeout: 45_000, @@ -13,7 +18,7 @@ export default defineConfig({ retries: 0, reporter: [['list']], use: { - baseURL: 'http://127.0.0.1:5174', + baseURL: `http://127.0.0.1:${PORT}`, channel: 'msedge', headless: true, viewport: { width: 1440, height: 900 }, @@ -26,8 +31,8 @@ export default defineConfig({ reuseExistingServer: true, }, { - command: 'set VITE_API_TARGET=http://127.0.0.1:18100&& npm run dev', - port: 5174, + command: `set VITE_API_TARGET=http://127.0.0.1:18100&& npm run dev -- --port ${PORT} --strictPort`, + port: PORT, reuseExistingServer: true, timeout: 120_000, }, diff --git a/admin-frontend-vue/scripts/mock-admin-server.mjs b/admin-frontend-vue/scripts/mock-admin-server.mjs index 45fb6e572..61dd20f95 100644 --- a/admin-frontend-vue/scripts/mock-admin-server.mjs +++ b/admin-frontend-vue/scripts/mock-admin-server.mjs @@ -152,33 +152,93 @@ const TUTORIAL_PACKAGES = [ ] /* ===================== 站内通知夹具(铃铛面板:搜索/按天分组/分页验收用) ===================== */ +/** + * 通知夹具。两条约定不能破: + * ① id 与 createdAt 同为插入时单调(09-10 最早 ⇒ id 最小)——与真库一致;倒挂会让 + * "按 id 倒序即按天倒序"这种隐藏假设在 mock 里成立、上线就翻车。 + * ② 场景显式给,不从 id 取模推——否则换一批 id,「余额不足」命中数与聚合组数一起漂, + * 用例断言就成了跟着夹具跑的活字。 + * 共 14 行、5 行密钥告警;按 场景×自然日×主体用户 折成 10 组,其中 2 组未读、3 行未读。 + */ const NOTIFICATIONS = [ - ...[6, 5, 4, 3, 2, 1].map((seq) => notif(seq, '2026-09-13', 22, seq, seq <= 3)), - ...[4, 3, 2, 1].map((seq) => notif(20 + seq, '2026-09-12', 20, seq, true)), - ...[4, 3, 2, 1].map((seq) => notif(30 + seq, '2026-09-10', 18, seq, true)), -] + ['2026-09-10', 18, 1, true, 'task_failed'], + ['2026-09-10', 18, 2, true, 'task_failed'], + ['2026-09-10', 18, 3, true, 'secret_balance'], + ['2026-09-10', 18, 4, true, 'task_failed'], + ['2026-09-12', 20, 1, true, 'secret_balance'], + ['2026-09-12', 20, 2, true, 'task_failed'], + ['2026-09-12', 20, 3, true, 'task_failed'], + ['2026-09-12', 20, 4, true, 'secret_balance'], + ['2026-09-13', 22, 1, true, 'task_failed'], + ['2026-09-13', 22, 2, true, 'task_failed'], + ['2026-09-13', 22, 3, true, 'secret_balance'], + ['2026-09-13', 22, 4, false, 'task_failed'], + ['2026-09-13', 22, 5, false, 'task_failed'], + ['2026-09-13', 22, 6, false, 'secret_balance'], +].map(([day, hour, seq, read, scene], index) => notif(index + 1, day, hour, seq, read, scene)) -function notif(id, day, hour, seq, read) { +const NOTIFICATION_SEED = structuredClone(NOTIFICATIONS) + +function notif(id, day, hour, seq, read, scene) { const minutes = String(seq * 7).padStart(2, '0') + const secret = scene === 'secret_balance' return { id, - scene: id % 3 === 0 ? 'secret_balance' : 'task_failed', - level: id % 3 === 0 ? 'error' : 'warning', - title: id % 3 === 0 ? `用户密钥异常:测试用户${seq}` : `跟价任务失败`, - content: id % 3 === 0 ? `用户 测试用户${seq}(uid=${1100 + seq})的代理设置对应服务商余额不足` : `用户 测试用户${seq} 有 ${seq} 个跟价任务失败`, + scene, + level: secret ? 'error' : 'warning', + title: secret ? `用户密钥异常:测试用户${seq}` : `跟价任务失败`, + content: secret + ? `用户 测试用户${seq}(uid=${1100 + seq})的代理设置对应服务商余额不足` + : `用户 测试用户${seq} 有 ${seq} 个跟价任务失败`, + // 事件主体用户:与后端 V158 那列同义,聚合分组键的第三维。seq>3 归 1196、其余归 1160, + // 让"同一天两个用户"在夹具里真的存在(否则聚合视图测不到按用户拆组这一维)。 + subjectUserId: seq > 3 ? 1196 : 1160, read, readAt: read ? `${day} ${hour}:${minutes}:00` : null, createdAt: `${day} ${hour}:${minutes}:00`, } } +/** 与后端 groups 出口同形的聚合:场景 × 自然日 × 主体用户。 */ +function groupRows(rows) { + const byKey = new Map() + for (const item of [...rows].sort((a, b) => b.id - a.id)) { + const day = item.createdAt.slice(0, 10) + const key = `${item.scene}|${day}|${item.subjectUserId ?? 'none'}` + let group = byKey.get(key) + if (!group) { + group = { + latestId: item.id, + scene: item.scene, + category: item.scene === 'secret_balance' ? 'config_error' : 'task_error', + day, + subjectUserId: item.subjectUserId ?? null, + rowCount: 0, + unreadCount: 0, + level: item.level, + title: item.title, + content: item.content, + createdAt: item.createdAt, + } + byKey.set(key, group) + } + group.rowCount += 1 + if (!item.read) group.unreadCount += 1 + if (item.level === 'error') group.level = 'error' + } + return [...byKey.values()] +} + /** 通知列表:关键字匹配标题/内容,日期按年月日区间(与 Java 侧同语义)。 */ -function notificationPage(searchParams) { +/** 列表与聚合共用的筛选:关键字 / 日期区间 / 展开某一组(场景 + 自然日 + 主体用户)。 */ +function filteredRows(searchParams) { const keyword = (searchParams.get('keyword') || '').trim() const startDate = searchParams.get('startDate') || '' const endDate = searchParams.get('endDate') || '' - const page = Math.max(1, Number(searchParams.get('page') || 1)) - const pageSize = Math.min(100, Math.max(1, Number(searchParams.get('pageSize') || 20))) + const scene = searchParams.get('scene') || '' + const day = searchParams.get('day') || '' + const subjectUserId = searchParams.get('subjectUserId') + const subjectUnlabelled = searchParams.get('subjectUnlabelled') === 'true' let rows = NOTIFICATIONS if (keyword) { rows = rows.filter((item) => `${item.title}${item.content}`.includes(keyword)) @@ -189,7 +249,29 @@ function notificationPage(searchParams) { if (endDate) { rows = rows.filter((item) => item.createdAt.slice(0, 10) <= endDate) } - const start = (page - 1) * pageSize + if (scene) { + rows = rows.filter((item) => item.scene === scene) + } + if (day) { + rows = rows.filter((item) => item.createdAt.slice(0, 10) === day) + } + if (subjectUserId) { + rows = rows.filter((item) => String(item.subjectUserId) === String(subjectUserId)) + } else if (subjectUnlabelled) { + rows = rows.filter((item) => item.subjectUserId === null || item.subjectUserId === undefined) + } + return rows +} + +function readPaging(searchParams) { + const page = Math.max(1, Number(searchParams.get('page') || 1)) + const pageSize = Math.min(100, Math.max(1, Number(searchParams.get('pageSize') || 20))) + return { page, pageSize, start: (page - 1) * pageSize } +} + +function notificationPage(searchParams) { + const rows = filteredRows(searchParams) + const { page, pageSize, start } = readPaging(searchParams) return { success: true, data: { @@ -202,6 +284,25 @@ function notificationPage(searchParams) { } } +/** 聚合出口:分页按组切,total=组数、rowCount=折叠前的明细条数,两个都给前端。 */ +function notificationGroupsPage(searchParams) { + const rows = filteredRows(searchParams) + const groups = groupRows(rows) + const { page, pageSize, start } = readPaging(searchParams) + return { + success: true, + data: { + groups: groups.slice(start, start + pageSize), + total: groups.length, + rowCount: rows.length, + page, + pageSize, + unreadGroupCount: groups.filter((group) => group.unreadCount > 0).length, + unreadCount: rows.filter((item) => !item.read).length, + }, + } +} + const server = createServer((req, res) => { const url = (req.url || '').split('?')[0] const method = req.method || 'GET' @@ -410,15 +511,44 @@ const server = createServer((req, res) => { data: { pending: false, scanned_at: '2026-09-05 08:30:00', items: ALL_ROWS, total: ALL_ROWS.length, page: 1, page_size: 20 }, }) } + // 已读标记会改内存里的夹具(不是幂等只读口)⇒ 用例之间要靠下面这条重置口隔离, + // 否则同一份 mock 服务被 reuseExistingServer 复用时,第二次跑就会带着上一次的已读态。 + if (method === 'POST' && url === '/api/admin/notifications/__reset') { + NOTIFICATIONS.splice(0, NOTIFICATIONS.length, ...structuredClone(NOTIFICATION_SEED)) + return json(res, { success: true, data: NOTIFICATIONS.length }) + } + if (method === 'POST' && /^\/api\/admin\/notifications\/\d+\/read$/.test(url)) { + const id = Number(url.split('/')[3]) + const item = NOTIFICATIONS.find((row) => row.id === id) + if (item && !item.read) { + item.read = true + item.readAt = `${item.createdAt.slice(0, 10)} 23:59:59` + } + return json(res, { success: true, data: true }) + } + if (method === 'POST' && url === '/api/admin/notifications/read-all') { + for (const item of NOTIFICATIONS) { + if (!item.read) { + item.read = true + item.readAt = `${item.createdAt.slice(0, 10)} 23:59:59` + } + } + return json(res, { success: true, data: NOTIFICATIONS.length }) + } if (url === '/api/admin/notifications/summary') { + const groups = groupRows(NOTIFICATIONS) return json(res, { success: true, data: { unreadCount: NOTIFICATIONS.filter((item) => !item.read).length, + unreadGroupCount: groups.filter((group) => group.unreadCount > 0).length, latestId: NOTIFICATIONS.reduce((max, item) => Math.max(max, item.id), 0), }, }) } + if (url === '/api/admin/notifications/groups') { + return json(res, notificationGroupsPage(new URL(req.url || '/', 'http://127.0.0.1').searchParams)) + } if (url === '/api/admin/notifications') { return json(res, notificationPage(new URL(req.url || '/', 'http://127.0.0.1').searchParams)) } diff --git a/admin-frontend-vue/src/api/notifications.ts b/admin-frontend-vue/src/api/notifications.ts index 081c31b58..fe00b1d0d 100644 --- a/admin-frontend-vue/src/api/notifications.ts +++ b/admin-frontend-vue/src/api/notifications.ts @@ -23,9 +23,38 @@ export interface AdminNotificationPage { export interface AdminNotificationSummary { unreadCount: number + /** 有未读的聚合组数;徽标用它。unreadCount 仍是"条数",给老明细视图与对账用。 */ + unreadGroupCount?: number latestId: number } +/** 聚合组:一个「场景 × 自然日 × 事件主体用户」折成的一行。 */ +export interface AdminNotificationGroup { + latestId: number + scene: string + category: string + day: string + subjectUserId: number | null + rowCount: number + unreadCount: number + level: string + title: string + content: string + createdAt: string | null +} + +export interface AdminNotificationGroupPage { + groups: AdminNotificationGroup[] + /** 组数(分页分母)。 */ + total: number + /** 折叠前的明细条数——必须与 total 同屏,否则「共 12 条」会被读成只有 12 条通知。 */ + rowCount: number + page: number + pageSize: number + unreadGroupCount: number + unreadCount: number +} + /** 铃铛轮询:未读数 + 最新通知 id。 */ export async function fetchNotificationSummary(): Promise { const { data } = await http.get('/api/admin/notifications/summary') @@ -40,6 +69,30 @@ export interface AdminNotificationListParams { keyword?: string startDate?: string endDate?: string + /** 展开聚合组:三个条件取自该组自己返回的值,原样回传。 */ + scene?: string + day?: string + subjectUserId?: number | null + /** true 表示展开「未区分用户」那一组(subject_user_id 为空的存量行)。 */ + subjectUnlabelled?: boolean +} + +/** 聚合列表(铃铛默认视图)。分页按组切。 */ +export async function fetchNotificationGroups( + params: AdminNotificationListParams = {}, +): Promise { + const keyword = (params.keyword ?? '').trim() + const { data } = await http.get('/api/admin/notifications/groups', { + params: { + page: params.page ?? 1, + pageSize: params.pageSize ?? 20, + onlyUnread: params.onlyUnread ? 'true' : 'false', + keyword: keyword || undefined, + startDate: params.startDate || undefined, + endDate: params.endDate || undefined, + }, + }) + return unwrap(data) } export async function fetchNotificationList( @@ -54,6 +107,10 @@ export async function fetchNotificationList( keyword: keyword || undefined, startDate: params.startDate || undefined, endDate: params.endDate || undefined, + scene: params.scene || undefined, + day: params.day || undefined, + subjectUserId: params.subjectUserId ?? undefined, + subjectUnlabelled: params.subjectUnlabelled ? 'true' : undefined, }, }) return unwrap(data) diff --git a/admin-frontend-vue/src/components/NotificationBell.vue b/admin-frontend-vue/src/components/NotificationBell.vue index 7288cec91..b550f2c00 100644 --- a/admin-frontend-vue/src/components/NotificationBell.vue +++ b/admin-frontend-vue/src/components/NotificationBell.vue @@ -77,25 +77,48 @@ -
正在加载...
-
{{ loadError }}
-
{{ hasFilter ? '没有符合条件的通知' : '暂无通知' }}
+
正在加载...
+
{{ loadError }}
+
{{ hasFilter ? '没有符合条件的通知' : '暂无通知' }}
    -