feat(护栏): 后管补挂载测试与 readSource 逐文件台账,另加一支 CI job(runner 现状见正文)

这面此前 0 个挂载测试(@vue/test-utils 不在 package.json、node_modules 是空目录),
.vite 页面全靠"读源码做正则断言"钉住,改法一旦不是那个字面写法就失明。
装上 @vue/test-utils + vitest + jsdom 后补了 2 文件 7 例挂载测试,靶子选两处只 console
不给用户提示的失败路径(公司目录没取到时原先只剩"tab 条没画出来")。

source-pin 台账用锚点分段口径:实测这棵树 1,704 个 test(/it( 全部行首出现、无循环生成,
而括号配对切块会被正则字面量里的 ) 提前收口、漏 48 处——分母悄悄变小对"只许减"是沉默的,
所以另加一条"与独立出现次数对平"的断言。基线落在每个文件上:只钉"总数+文件数"两个标量时,
A 加一条配 B 减一条就能双双不动地绕过去。

⚠ 这支 CI job 今天是纸面的:Gitea Actions 只列得出 3 次 run,末次停在 2026-08-11 且全是
failure,此后 origin/master 又推进 1,131 笔没有产生任何 run。同一个 workflow 里 backend 的
mvn test、frontend 的 npm test 也一并不会执行——"CI 强制"这一项要成立,得先恢复 runner。
This commit is contained in:
2026-10-08 17:37:00 +08:00
parent cd715d66ac
commit c363683184
14 changed files with 2785 additions and 4 deletions
@@ -136,12 +136,15 @@ import {
type AdminNotificationItem,
} from '@/api/notifications'
import { useAdminSessionStore } from '@/stores/admin-session'
import { showAdminFeedback } from '@/components/admin-feedback-ui'
import {
NOTIFICATION_POLL_INTERVAL_MS,
createSummaryFailureAlerter,
formatNotificationTime,
formatUnreadBadge,
groupNotificationsByDay,
hasNewNotification,
markReadFailureMessage,
readLastNotifiedId,
writeLastNotifiedId,
} from '@/layout/notification-bell-model'
@@ -208,10 +211,17 @@ function normalizedDayRange(): { startDate?: string; endDate?: string } {
return { startDate: start || undefined, endDate: end || undefined }
}
/**
* 未读数轮询失败的可见提示闸门(同场故障只提示一次,轮询 60s 一轮)。
* 出口只走 admin-feedback-ui 的 showAdminFeedback,不在组件里另起一层提示。
*/
const summaryFailures = createSummaryFailureAlerter((message, kind) => showAdminFeedback(message, kind))
/** 拉未读数:发现新通知提醒一次(localStorage 记录已提醒过的最大 id,避免重复弹)。 */
async function refreshSummary() {
try {
const summary = await fetchNotificationSummary()
summaryFailures.reportSuccess()
unreadCount.value = Number(summary?.unreadCount ?? 0)
const latestId = Number(summary?.latestId ?? 0)
if (hasNewNotification(latestId, readLastNotifiedId(currentUid()))) {
@@ -220,8 +230,10 @@ async function refreshSummary() {
console.log('[admin-notification] 检测到新通知 latestId=', latestId)
}
} catch (error) {
// 通知接口失败静默降级:不显示红点、不打扰使用者
// 接口失败时红点不亮(与改前一致),但要让用户知道「没数」不等于「没通知」:
// 同一场故障只提示一次,成功一轮后重新武装(见 createSummaryFailureAlerter)。
console.warn('[admin-notification] 未读数刷新失败(静默降级):', error)
summaryFailures.reportFailure(error)
}
}
@@ -312,7 +324,9 @@ async function onItemClick(item: AdminNotificationItem) {
item.read = true
unreadCount.value = Math.max(0, unreadCount.value - 1)
} catch (error) {
// 改前只 console.warn:点了通知没反应,用户只能反复点。失败必须可见(统一出口)。
console.warn('[admin-notification] 标记已读失败:', error)
showAdminFeedback(markReadFailureMessage(error), 'error')
}
}
@@ -7,7 +7,8 @@ import { useRoute } from 'vue-router'
import { COMPANY_STATUS_ACTIVE } from '@/api/companies-dto'
import { useCompanyTabStore } from '@/stores/company-tab'
import { useAdminSessionStore } from '@/stores/admin-session'
import { companyTabAppliesTo } from '@/layout/company-tab-model'
import { companyTabAppliesTo, companyTabInitFailureMessage } from '@/layout/company-tab-model'
import { showAdminFeedback } from '@/components/admin-feedback-ui'
const route = useRoute()
const tab = useCompanyTabStore()
@@ -22,8 +23,12 @@ watch(() => session.isSuperAdmin, (v) => {
// 现场只剩"tab 条没画出来",Task 13 人工清单第一项无从判断是权限问题还是接口挂了。
// 取不到目录 ⇒ fail-closed 不画 tab 条:store 不翻转 loaded,visibleForOperator 仍为 false,观感与改前一致。
// store 照 admin-session.ts:37-39 的口径 catch 出 error 之后仍然 rethrow,所以这一侧必须 .catch 接住。
// 只写 console.warn:不许在模板里长出任何新的用户可见文字/提示条/图标(§12 第 5 条未批的暴露)。
tab.initialize().catch((error: unknown) => console.warn('[company-tab] 公司目录没取到,tab 条不渲染', error))
// 模板里仍不长出任何新的常驻文字/提示条/图标(§12 第 5 条未批的暴露),但失败不许只剩 console.warn:
// 文案由 company-tab-model 出,可见出口统一走 admin-feedback-ui 的 showAdminFeedback(一次性提示)。
tab.initialize().catch((error: unknown) => {
console.warn('[company-tab] 公司目录没取到,tab 条不渲染', error)
showAdminFeedback(companyTabInitFailureMessage(error), 'warning')
})
}, { immediate: true })
</script>
@@ -23,6 +23,20 @@ export function companyIdForRequest(isSuperAdmin: boolean, activeId: number | nu
return isSuperAdmin ? activeId : null
}
/**
* 公司目录没取到时的可见文案(四面9分口径 §2 后管「错误静默」)。
*
* <p>改前 CompanyTabs.vue 的 `.catch` 只 console.warn,现场只剩「tab 条没画出来」,
* 判断不了是权限问题还是接口挂了。文案住在这里(不引组件、不引 element-plus),
* 可见出口由组件用 admin-feedback-ui 的 showAdminFeedback 承接;tab 条模板本身仍不产出
* 任何文字节点(§12 第 5 条那处未批的页头暴露没被绕过——这是一次性提示,不是常驻文案)。</p>
*/
export function companyTabInitFailureMessage(error: unknown): string {
const base = '公司目录没取到,公司切换条暂不可用'
const reason = error instanceof Error ? error.message.trim() : String(error ?? '').trim()
return reason ? `${base}:${reason}` : base
}
/** 「默认选中第一家」= id 最小的启用公司(spec §4 口径:不是超管自己所属公司,也不是返回顺序首条)。 */
export function firstSelectableCompanyId(companies: readonly CompanyItem[]): number | null {
const active = companies.filter((c) => c.status === COMPANY_STATUS_ACTIVE && c.id > 0)
@@ -145,3 +145,63 @@ export function formatNotificationTime(
}
return `${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${hourMinute}`
}
/**
* 失败反馈的文案与「同场故障只提示一次」的闸门(四面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
},
}
}