d268ecdf6b
用户原话「都没体现哪个任务id/店铺/用户,咋排查」:通知表只有 title/content, 失败任务又按「用户×模块×自然日」聚合成一条,明细被 5 个 taskNo 预览 + 512 字截断吃掉。 - V162 给 biz_user_notification 加 ref_json(TEXT,可重跑迁移,存量不回填) - 扫描器把桶内每个失败任务写成锚点(taskId/taskNo/moduleType/reason/updatedAt/ deviceId),上限 20 条;品牌任务无 task_no 用 #<id> 兜底,保证至少一条可定位 - 详情接口回传 refs;同键刷新时锚点变化也更新,且不重新点亮已读 - 后台铃铛「展开明细」渲染成可点行,跳任务中心 ?taskNo= 自动开详情抽屉 - 新增判据 taskFailedAdminNotificationCarriesUidAndTaskNoAnchor:管理端正文必须含 uid、每个桶的 ref_json 至少一条非空 taskNo
223 lines
8.2 KiB
TypeScript
223 lines
8.2 KiB
TypeScript
/**
|
||
* 后台铃铛通知纯逻辑:未读徽标文案、新通知判定、「已提醒过」去重记录、时间展示。
|
||
* 轮询调度与渲染在 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 后管「错误静默」)。
|
||
*
|
||
* <p>改前 NotificationBell.vue 的两处 catch 只 console.warn:未读数接口挂了红点静默消失、
|
||
* 点通知标已读失败界面纹丝不动,使用者无从判断是"没有通知"还是"接口没通"(全仓 src 无
|
||
* errorHandler/unhandledrejection 兜底)。文案在这里出、可见出口由组件注入
|
||
* ({@code showAdminFeedback}),模型层不引 element-plus ⇒ 这一族判据能用 node --test 直接跑真函数,
|
||
* 不必退化成读源码的钉子。</p>
|
||
*/
|
||
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 } }
|
||
}
|