/** * 后台铃铛通知纯逻辑:未读徽标文案、新通知判定、「已提醒过」去重记录、时间展示。 * 轮询调度与渲染在 NotificationBell.vue;这里只放可单测的纯函数与存储读写。 */ /** 未读轮询间隔(60 秒)。 */ export const NOTIFICATION_POLL_INTERVAL_MS = 60_000 const NOTIFIED_KEY_PREFIX = 'admin-notification:last-notified-id' /** 未读徽标文案:0 或非法值显示空串,>99 显示 99+。 */ export function formatUnreadBadge(count: number | null | undefined): string { const value = Number(count ?? 0) if (!Number.isFinite(value) || value <= 0) { return '' } return value > 99 ? '99+' : String(Math.floor(value)) } /** 是否出现新通知:latestId 大于上次已提醒过的 id。 */ export function hasNewNotification( latestId: number | null | undefined, lastNotifiedId: number | null | undefined, ): boolean { const latest = Number(latestId ?? 0) const notified = Number(lastNotifiedId ?? 0) if (!Number.isFinite(latest) || latest <= 0) { return false } return latest > (Number.isFinite(notified) && notified > 0 ? notified : 0) } function storageKey(uid: string | number | null | undefined): string { const normalized = uid === null || uid === undefined || String(uid).trim() === '' ? '0' : String(uid) return `${NOTIFIED_KEY_PREFIX}:${normalized}` } /** 读取当前管理员「已提醒过的最大通知 id」。 */ export function readLastNotifiedId(uid: string | number | null | undefined): number { try { const raw = window.localStorage.getItem(storageKey(uid)) const value = Number(raw ?? 0) return Number.isFinite(value) && value > 0 ? value : 0 } catch { return 0 } } export function writeLastNotifiedId(uid: string | number | null | undefined, id: number): void { try { if (Number.isFinite(id) && id > 0) { window.localStorage.setItem(storageKey(uid), String(Math.floor(id))) } } catch { /* 存储不可用时静默忽略(退化为每次都提醒,不影响功能) */ } } /** 通知所属日期键(本地时区 yyyy-MM-dd);时间缺失/非法返回空串。 */ export function notificationDayKey(value: string | null | undefined): string { if (!value) { return '' } const date = new Date(value) if (Number.isNaN(date.getTime())) { return '' } const pad = (input: number) => String(input).padStart(2, '0') return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}` } /** 日期组头文案:今天 / 昨天 / 2026年9月11日;空键兜底「未知时间」。 */ export function formatDayLabel(day: string, now: Date = new Date()): string { if (!day) { return '未知时间' } if (day === notificationDayKey(now.toISOString())) { return '今天' } const yesterday = new Date(now.getFullYear(), now.getMonth(), now.getDate() - 1) if (day === notificationDayKey(yesterday.toISOString())) { return '昨天' } const [year, month, date] = day.split('-').map((part) => Number(part)) if (!Number.isFinite(year) || !Number.isFinite(month) || !Number.isFinite(date)) { return day } return `${year}年${month}月${date}日` } /** 通知时间展示:今天只显示 HH:mm;昨天显示「昨天 HH:mm」;更早显示 MM-DD HH:mm。 */ export function formatNotificationTime( value: string | null | undefined, now: Date = new Date(), ): string { if (!value) { return '' } const date = new Date(value) if (Number.isNaN(date.getTime())) { return '' } const pad = (input: number) => String(input).padStart(2, '0') const hourMinute = `${pad(date.getHours())}:${pad(date.getMinutes())}` const sameDay = date.getFullYear() === now.getFullYear() && date.getMonth() === now.getMonth() && date.getDate() === now.getDate() if (sameDay) { return hourMinute } const yesterday = new Date(now.getFullYear(), now.getMonth(), now.getDate() - 1) const isYesterday = date.getFullYear() === yesterday.getFullYear() && date.getMonth() === yesterday.getMonth() && date.getDate() === yesterday.getDate() if (isYesterday) { return `昨天 ${hourMinute}` } return `${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${hourMinute}` } /** * 聚合组的稳定键:场景 × 自然日 × 事件主体用户,与后端的分组键逐字对应。 * 主体为空(存量未标注那一组)要参与拼键,否则两组不同主体的组会撞成同一个 key, * 展开态就会串台——点开 A 组、展开的却是 B 组。 */ export function notificationGroupKey(group: { scene?: string | null day?: string | null subjectUserId?: number | string | null }): string { const subject = group.subjectUserId === null || group.subjectUserId === undefined ? 'none' : String(group.subjectUserId) return `${group.scene ?? ''}|${group.day ?? ''}|${subject}` } /** 组行上的计数徽语:折叠前有几条、其中几条没读。只报一个数就会被读成"一共就这些通知"。 */ export function formatGroupCounts(rowCount: number | null | undefined, unreadCount: number | null | undefined): string { const total = Number(rowCount ?? 0) const unread = Number(unreadCount ?? 0) return unread > 0 ? `${total} 条 · ${unread} 未读` : `${total} 条` } /** * 失败反馈的文案与「同场故障只提示一次」的闸门(四面9分口径 §2 后管「错误静默」)。 * *

改前 NotificationBell.vue 的两处 catch 只 console.warn:未读数接口挂了红点静默消失、 * 点通知标已读失败界面纹丝不动,使用者无从判断是"没有通知"还是"接口没通"(全仓 src 无 * errorHandler/unhandledrejection 兜底)。文案在这里出、可见出口由组件注入 * ({@code showAdminFeedback}),模型层不引 element-plus ⇒ 这一族判据能用 node --test 直接跑真函数, * 不必退化成读源码的钉子。

*/ export type BellFeedbackKind = 'success' | 'error' | 'warning' /** 可见提示的出口:组件把 admin-feedback-ui 的 showAdminFeedback 递进来。 */ export type BellFeedbackSink = (message: string, kind: BellFeedbackKind) => void function failureReason(error: unknown): string { if (error instanceof Error) { return error.message.trim() } return String(error ?? '').trim() } /** 未读数刷新失败的提示文案:带上原因,便于区分"接口挂了"与"没权限"。 */ export function summaryFailureMessage(error: unknown): string { const reason = failureReason(error) return reason ? `通知未读数刷新失败:${reason}` : '通知未读数刷新失败' } /** 标记已读失败的提示文案:点了必须有回应,失败也要有回应。 */ export function markReadFailureMessage(error: unknown): string { const reason = failureReason(error) return reason ? `这条通知没能标记为已读:${reason}` : '这条通知没能标记为已读' } /** * 轮询失败的提示闸门:一轮 60s,同一场故障只提示一次,成功一轮后重新武装。 * 不设闸等于把「静默失败」换成「每分钟打扰一次」,两个都是错的口径。 */ export function createSummaryFailureAlerter(feedback: BellFeedbackSink): { reportFailure(error: unknown): void reportSuccess(): void isArmed(): boolean } { let alerted = false return { reportFailure(error: unknown): void { if (alerted) { return } alerted = true feedback(summaryFailureMessage(error), 'warning') }, reportSuccess(): void { alerted = false }, isArmed(): boolean { return alerted }, } } /** 通知锚点的最小形状(与 AdminNotificationRef 对齐);不 import api 类型,保持本模块可被 node --test 直接跑。 */ export interface NotificationTaskRef { taskNo?: string | null } /** * 任务锚点 → 任务中心深链。taskNo 是任务详情接口的唯一入参,空值不给链接 * (宁可只显示文本,也不跳到一个必然查不到的任务上)。 */ export function taskCenterRouteForRef( ref: NotificationTaskRef | null | undefined, ): { path: string; query: { taskNo: string } } | null { const taskNo = String(ref?.taskNo ?? '').trim() if (!taskNo) { return null } return { path: '/task-center/board', query: { taskNo } } }