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。
This commit is contained in:
2026-10-05 11:51:33 +08:00
parent 265f31681f
commit 95e2318c42
62 changed files with 2866 additions and 112 deletions
@@ -0,0 +1,164 @@
<script setup lang="ts">
/**
* 到期续费提醒(V146,2026-10-05 需求):
* 「管理员快过期的时候(仅剩 5 天不到开始)要在数富后台界面上有个弹窗去提醒,
* 只能缩小但是不能关闭,直到续费超过 5 天才消失。」
*
* - 数据源:/api/admin/current-user 的 expiresAt/daysToExpire(session store 的 user 上);
* 只反映账号自身 expires_at,不级联——续费是账号自己的事。
* - 触发:0 ≤ daysToExpire < 5(剩余不足 5 天)。刷新/重新登录后按最新值判定,
* 续费到 ≥5 天自动消失,无需手动关。
* - 只能缩小不能关闭:无关闭按钮;缩小态是右下角常驻浮标,点开即恢复。
* - 缩小状态按「用户 + 到期值」记 localStorage:续费(到期值变化)后重置为展开。
*/
import { computed, ref, watch } from 'vue'
import { useAdminSessionStore } from '@/stores/admin-session'
const props = defineProps<{
/** 展示阈值(天):daysToExpire < EXPIRY_NOTICE_DAYS 时展示。需求口径 = 5(不足 5 天)。 */
threshold?: number
}>()
const THRESHOLD = props.threshold ?? 5
const session = useAdminSessionStore()
const user = computed(() => session.user)
const daysToExpire = computed<number | null>(() => {
const value = user.value?.daysToExpire
return typeof value === 'number' && Number.isFinite(value) ? value : null
})
const visible = computed(() => daysToExpire.value !== null && daysToExpire.value < THRESHOLD)
const expiresAt = computed(() => (user.value?.expiresAt || '').trim())
const minimized = ref(false)
const minimizedKey = computed(() =>
user.value ? `admin-expiry-notice-min:${user.value.id}:${expiresAt.value}` : '',
)
watch(
minimizedKey,
(key) => {
minimized.value = key ? localStorage.getItem(key) === '1' : false
},
{ immediate: true },
)
function minimize(): void {
minimized.value = true
if (minimizedKey.value) {
try {
localStorage.setItem(minimizedKey.value, '1')
} catch {
/* localStorage 不可用时仅本次会话生效 */
}
}
}
function restore(): void {
minimized.value = false
if (minimizedKey.value) {
try {
localStorage.removeItem(minimizedKey.value)
} catch {
/* 同上 */
}
}
}
const daysText = computed(() => {
const days = daysToExpire.value
if (days === null) return ''
return days <= 0 ? '不足 1 天' : `还剩 ${days} 天`
})
</script>
<template>
<template v-if="visible">
<div
v-if="!minimized"
class="expiry-notice"
role="alert"
aria-live="assertive"
>
<div class="expiry-notice-body">
<strong>服务即将到期</strong>
<span>
您的账号{{ expiresAt ? `(${expiresAt})` : '' }}即将到期,{{ daysText }}。
到期后账号将无法登录,名下账号与正在执行的任务也会一并停止,请联系管理员续费。
</span>
</div>
<button
class="expiry-notice-min"
type="button"
title="收起(不可关闭,续费前会一直提醒)"
@click="minimize"
>
收起
</button>
</div>
<button
v-else
class="expiry-notice-chip"
type="button"
:title="`服务即将到期:${daysText},点击展开`"
@click="restore"
>
⏰ {{ daysText }}
</button>
</template>
</template>
<style scoped>
.expiry-notice {
position: fixed;
right: 24px;
bottom: 24px;
z-index: 3000;
display: flex;
align-items: center;
gap: 12px;
max-width: 420px;
padding: 14px 16px;
border: 1px solid #e4b363;
border-radius: 12px;
background: #fffaf0;
color: #7a4d0b;
box-shadow: 0 12px 32px -18px rgba(122, 77, 11, 0.55);
}
.expiry-notice-body {
display: flex;
flex-direction: column;
gap: 4px;
font-size: 13px;
line-height: 1.55;
}
.expiry-notice-body strong {
font-size: 14px;
}
.expiry-notice-min {
flex-shrink: 0;
padding: 6px 12px;
border: 1px solid #e4b363;
border-radius: 8px;
background: #ffffff;
color: #7a4d0b;
font-size: 12.5px;
cursor: pointer;
}
.expiry-notice-min:hover {
background: #fdf3dd;
}
.expiry-notice-chip {
position: fixed;
right: 24px;
bottom: 24px;
z-index: 3000;
padding: 8px 14px;
border: 1px solid #e4b363;
border-radius: 999px;
background: #fffaf0;
color: #7a4d0b;
font-size: 13px;
cursor: pointer;
box-shadow: 0 8px 20px -12px rgba(122, 77, 11, 0.5);
}
</style>