Files
huangzd1997 95e2318c42 feat(账号到期+公司超管): 级联过期判定、过期停任务巡检与两端续费提醒弹窗
需求两条:站点超管可开设其他公司的超级管理员(站点超管看全站、公司超管只看本公司、
组内管理员仍只看本组);账号要有过期时间,管理员过期后名下普通账户一并停用、
正在跑的任务也要停掉。落库只有 users.expires_at(V146,NULL=永不过期),级联一律现算,
不写"上级过期就把下级置成过期"那种续费也救不回来的数据。

- AccountExpiryService:生效到期 = min(自身, 本公司公司超管, 成员表组长, 创建人)。
  登录拦 403(文案给续费提示)、每次请求鉴权拦 401(前端按下线踢回登录页),super_admin
  永不适用。级联口径与数据可见范围同源(成员表基本未用、实际按 created_by_id 派生)。
- ExpiredAccountTaskStopService:每分钟把过期账号(含级联成员)名下 biz_file_task
  PENDING/SCHEDULED/RUNNING → FAILED,含未领取的 PENDING(防内部通道继续派发)。原因文案
  刻意不以「客户端异常中断」开头,否则会被 TaskResumeService 自动复活。品牌采集与跟价循环
  不在那张表上,经 ExpiredAccountTaskStopSpi 由各自模块停:品牌 pending/running→cancelled
  且 UPDATE 的 WHERE 二次核对状态(抢到行后被客户端推进成完成的行不得误杀),跟价循环只置
  stop_requested=1、沿用用户点「停止循环」那条收尾路径,绝不动 status。任务心跳接口保持匿名
  不走 requireUser,所以过期账号的客户端仍能拿到 alive=false 协作停止。
- 角色 company_super_admin:由站点超管开设(唯一要显式选公司的建号场景),建号/授菜单/改用户/
  看数据四条链路都按"本公司"收口;公司超管之间、以及公司超管与站点超管互相碰不得。
- 续费提醒:剩余 <5 天在数富后台与用户端弹窗,只能收起不能关闭(无关闭按钮,收起态是右下角
  浮标),续费到 ≥5 天自动消失。后台读 /api/admin/current-user 的 expiresAt/daysToExpire;
  用户端无 Pinia,走 localStorage 的 account_expires_at(登录/check_login 落键、被顶下线清键,
  换账号不残留)。只反映账号自身到期,弹窗不做任何级联推断。
- V146 撞掉了 V145 那批的一条护栏:它按"db/ 里不许出现 V146__ 前缀"编死号位,被一条正常的
  前向迁移占用就红。改成钉动作——剥注释后的可执行 SQL 不得写 flyway_schema_history(回滚
  一律是扫描路径外的人工补丁),并把盘点文档改 V146 时丢掉的 V145 文件名补回去。

验证(本会话亲跑,不是转述):后端定向 14 类 123/0(同一轮 mvn 里连批次③的 4 类 53 例、以及既有 ShopDataCrawl/SimilarAsin 两条回归对照 21 例一起跑,合计 197 例 0 红);admin-frontend-vue 本批定向 44/0(弹窗 7 +
公司建号/列表/入口/日期默认 21 + 角色 task-48/task-251 16),全量 1726 例里那 1 支红是另一条
会话刻意留的「公司 tab 接线缺口」尺子(点名 admin_task_center 等 6 页,与本批无关);
frontend-vue 弹窗 9/0、全量 710/0。变异自证两批共 34 点:弹窗语义 16 点全杀(阈值 5、只能收起
不能关闭、挂载点含"注释掉挂载"、落键/清键链路),本批 SPI+迁移护栏 17 点全杀(含 G2 反向:
前向迁移只在注释里提 flyway_schema_history 必须照样绿),注入文件还原 dirty=0、探针残留 0。
2026-10-05 11:51:33 +08:00

103 lines
5.6 KiB
TypeScript

import test from 'node:test'
import assert from 'node:assert/strict'
import { occurrences, readSource } from './helpers.ts'
/**
* 数富后台「服务即将到期」续费提醒弹窗(V146,2026-10-05 需求)的口径护栏。
*
* 需求原话:仅剩不到 5 天开始提醒、只能缩小不能关闭、续费到超过 5 天才消失。
* 这三条全靠 ExpiryNotice.vue 一个组件兑现,而组件是 SFC、node --test 编译不了,
* 所以断言打在实际源码上:阈值、渲染条件、可点的按钮、收起态记的是什么键、挂在哪。
*
* 每个正则都必须在真源码上匹配得到(先确认真命中再断言),否则就是恒绿的摆设。
*/
const COMPONENT = 'src/components/ExpiryNotice.vue'
const LAYOUT = 'src/layout/AdminLayout.vue'
const TYPES = 'src/types/admin.ts'
/** SFC 的 <template> 段:从第一个 <template> 到最后一个 </template>(内层还有 v-if 包裹)。 */
function templateOf(source: string): string {
const start = source.indexOf('<template>')
const end = source.lastIndexOf('</template>')
assert.ok(start !== -1 && end > start, `${COMPONENT} 没有 <template> 段`)
return source.slice(start, end)
}
/** <script setup> 段。 */
function scriptOf(source: string): string {
const start = source.indexOf('<script setup')
const end = source.indexOf('</script>')
assert.ok(start !== -1 && end > start, `${COMPONENT} 没有 <script setup> 段`)
return source.slice(start, end)
}
/** 剥掉 HTML 注释:注释掉的 `<ExpiryNotice />` 在源码里照样匹配得上,挂载点断言必须是活代码。 */
function withoutComments(source: string): string {
return source.replace(/<!--[\s\S]*?-->/g, '')
}
const source = readSource(COMPONENT)
const template = templateOf(source)
const script = scriptOf(source)
test('提醒阈值就是 5 天:THRESHOLD 取 props 兜底 5,且全文件没有第二个数字阈值', () => {
assert.match(script, /const THRESHOLD = props\.threshold \?\? 5\b/, '阈值没写成 5 的兜底')
// 排他:别处再写一个数字兜底,就等于偷偷加了第二套口径
const numericFallbacks = script.match(/\?\?\s*\d+/g) ?? []
assert.deepEqual(numericFallbacks, ['?? 5'], '数字兜底只能有阈值 5 这一个')
})
test('渲染条件是「剩余 < 5」而不是「<= 5」:整 5 天不弹,第 4 天起才弹', () => {
assert.match(
script,
/daysToExpire\.value !== null && daysToExpire\.value < THRESHOLD/,
'visible 没按「有到期值且 < 阈值」判定',
)
assert.doesNotMatch(script, /daysToExpire\.value <= THRESHOLD/, '写成了 <=,整 5 天也会弹')
})
test('没有关闭这条路:模板里只有「收起」和浮标两个可点项,没有任何对话框自带的关闭件', () => {
assert.equal(occurrences(template, '@click="'), 2, '可点项必须恰好是收起 + 浮标恢复两个')
assert.match(template, /@click="minimize"/, '收起按钮没接 minimize')
assert.match(template, /@click="restore"/, '缩小态浮标没接 restore')
assert.match(template, /收起\s*<\/button>/, '唯一的收起动作文案是「收起」')
// 关闭语义的三种实际载体:对话框组件、显式 close 处理器、Element 的关闭开关
assert.equal(occurrences(source, 'el-dialog'), 0, '用对话框会带来关闭件')
assert.doesNotMatch(source, /@click="[^"]*close/i, '存在 close 点击处理器')
assert.doesNotMatch(source, /show-close|close-on-click-modal|close-on-press-escape|:closable/, '存在任何关闭开关')
})
test('收起态按「用户 id + 到期值」记键:续费换了到期值,键变了就自动回到展开', () => {
assert.equal(occurrences(script, 'admin-expiry-notice-min:'), 1, '收起态键名只应有一处定义')
assert.match(
script,
/`admin-expiry-notice-min:\$\{user\.value\.id\}:\$\{expiresAt\.value\}`/,
'键里必须同时带用户 id 与到期值,缺到期值则续费后仍停在收起态',
)
// 全组件只写这一个键:任何形式的「已读/忽略」持久化都会让提醒在续费前被永久关掉
assert.equal(occurrences(script, 'localStorage.setItem('), 1, '持久化写入只能有收起态这一处')
assert.equal(occurrences(script, 'localStorage.removeItem('), 1, '只有恢复展开时清键')
})
test('到期值变化会重新判定收起态:watch 键值且 immediate', () => {
assert.match(script, /watch\(\s*minimizedKey,/, '没有监听 minimizedKey')
assert.match(script, /minimized\.value = key \? localStorage\.getItem\(key\) === '1' : false/, '展开态直接由键值决定')
assert.match(script, /\{ immediate: true \}/, '缺 immediate 则首屏不判定,刷新后不提醒')
})
test('挂在后台布局上:AdminLayout 引了组件并且渲染,不挂就整站看不见', () => {
const layout = withoutComments(readSource(LAYOUT))
assert.match(layout, /import ExpiryNotice from '@\/components\/ExpiryNotice\.vue'/, '布局没引组件')
assert.match(layout, /<ExpiryNotice\s*\/>/, '布局没渲染组件(注释掉等于没挂)')
})
test('数据源键名与前端类型对齐:daysToExpire/expiresAt 来自 current-user,没有映射层', () => {
const types = readSource(TYPES)
assert.match(types, /daysToExpire\?: number \| null/, 'AdminUser 类型缺 daysToExpire')
assert.match(types, /expiresAt\?: string/, 'AdminUser 类型缺 expiresAt')
assert.match(readSource('src/api/session.ts'), /\/api\/admin\/current-user/, '会话数据源不是 current-user')
// 组件读的是 store 上的这两个键,不是自己算时间
assert.match(script, /session\.user/, '弹窗数据源是后台会话 store')
assert.match(script, /user\.value\?\.daysToExpire/, '读 daysToExpire 而不是本地算')
})