= {
steps: ['筛选用户或状态', '立即检测连通性', '必要时清空'],
},
admin_companies: {
- text: '公司决定账号归属:新建账号自动落在操作者自己所在的公司,页面上不出现公司选项——要给别的公司建号,请用那个公司自己的管理员登录。公司只做启用/停用,不提供删除。',
+ text: '公司决定账号归属:新建普通账号/管理员自动落在操作者自己所在的公司,页面上不出现公司选项——要给别的公司建号,请用那个公司自己的管理员登录。唯一例外是「公司超级管理员」:由站点超管开设、需在建号弹窗中显式选择所属公司。公司只做启用/停用,不提供删除。',
steps: ['查看公司列表', '新建公司', '改名或启停'],
},
admin_dedupe_total_data: {
diff --git a/admin-frontend-vue/src/pages/account/CreateUserDialog.vue b/admin-frontend-vue/src/pages/account/CreateUserDialog.vue
index ebbd9b43b..f2d1f40a9 100644
--- a/admin-frontend-vue/src/pages/account/CreateUserDialog.vue
+++ b/admin-frontend-vue/src/pages/account/CreateUserDialog.vue
@@ -1,5 +1,5 @@
@@ -150,6 +165,7 @@ onMounted(() => {
+
@@ -170,6 +186,7 @@ onMounted(() => {
| 用户名 |
角色 |
所属管理员 |
+ 到期时间 |
创建时间 |
更新时间 |
操作 |
@@ -182,6 +199,9 @@ onMounted(() => {
{{ row.username }} |
{{ roleLabel(row.role) }} |
{{ row.creatorUsername || '-' }} |
+
+ {{ formatExpiryCell(row).text }}
+ |
{{ formatDateTime(row.createdAt) }} |
{{ formatDateTime(row.updatedAt) }} |
@@ -207,10 +227,10 @@ onMounted(() => {
|
- | 加载中... |
+ 加载中... |
- | {{ userListEmptyHint() }} |
+ {{ userListEmptyHint() }} |
@@ -222,7 +242,9 @@ onMounted(() => {
@@ -415,6 +437,10 @@ h3 {
gap: 8px;
white-space: nowrap;
}
+.expiry-cell-expired {
+ color: #c0392b;
+ font-weight: 600;
+}
.empty-tip {
padding: 44px 24px;
diff --git a/admin-frontend-vue/src/pages/account/user-create-model.ts b/admin-frontend-vue/src/pages/account/user-create-model.ts
index d98f03d14..01ec6873f 100644
--- a/admin-frontend-vue/src/pages/account/user-create-model.ts
+++ b/admin-frontend-vue/src/pages/account/user-create-model.ts
@@ -3,8 +3,11 @@
export const CREATE_USERNAME_MIN_LEN = 2
export const CREATE_PASSWORD_MIN_LEN = 6
-/** 新建用户可选角色:super_admin 不可由表单创建(后端只收 admin|normal)。 */
-export type CreatableUserRole = 'normal' | 'admin'
+/**
+ * 新建用户可选角色:super_admin 不可由表单创建;company_super_admin 仅站点超管可选
+ * (后端 403「只有超级管理员可以创建公司超级管理员」兜底)。
+ */
+export type CreatableUserRole = 'normal' | 'admin' | 'company_super_admin'
export interface CreateUserForm {
username: string
@@ -14,11 +17,16 @@ export interface CreateUserForm {
columnIds: number[]
/** 所属管理员 id(超管创建普通账号时可指定,对齐 admin 的 created_by_id)。 */
createdBy?: number | null
+ /** 到期时间(yyyy-MM-dd HH:mm:ss);空串 = 永不过期(V146)。 */
+ expiresAt: string
+ /** 所属公司 id:仅 role=company_super_admin 时由站点超管必选(2026-10-05 需求)。 */
+ companyId?: number | null
}
export interface CreateUserFormErrors {
username?: string
password?: string
+ companyId?: string
}
/** 发送 POST /api/admin/user 的请求体(与 Java AdminUserCreateRequest camelCase 对齐)。 */
@@ -29,18 +37,27 @@ export interface CreateUserPayload {
columnIds: number[]
/** 仅 role=normal 且选了所属管理员时发送,与参考 admin.js 的 created_by_id 语义一致。 */
createdById?: number
+ /** 到期时间;空串=永不过期,不下发。 */
+ expiresAt?: string
+ /** 仅 role=company_super_admin 且显式选了公司时下发——这是「建号不带 company_id」
+ * 反向钉(company-user-create.test.ts)唯一豁免的例外:公司超管必须落指定公司,
+ * 否则会静默落操作者自己的公司(公司 1),用户需求就是给别家公司开超管。 */
+ companyId?: number
}
export function createEmptyCreateUserForm(): CreateUserForm {
- return { username: '', password: '', role: 'normal', columnIds: [], createdBy: null }
+ return { username: '', password: '', role: 'normal', columnIds: [], createdBy: null, expiresAt: '', companyId: null }
}
-/** 未知/空白/超管角色一律归一到 normal,与后端 "admin"/"normal" 白名单一致。 */
+/** 未知/空白/超管角色归一:admin/company_super_admin/normal 白名单,其余归 normal。 */
export function normalizeCreateRole(role: string | null | undefined): CreatableUserRole {
- return (role || '').trim().toLowerCase() === 'admin' ? 'admin' : 'normal'
+ const value = (role || '').trim().toLowerCase()
+ if (value === 'admin') return 'admin'
+ if (value === 'company_super_admin') return 'company_super_admin'
+ return 'normal'
}
-/** 表单校验(镜像后端:用户名≥2、密码≥6、均必填);返回逐字段错误。 */
+/** 表单校验(镜像后端:用户名≥2、密码≥6、均必填;公司超管必须选公司);返回逐字段错误。 */
export function validateCreateUserForm(form: CreateUserForm): {
valid: boolean
errors: CreateUserFormErrors
@@ -58,6 +75,9 @@ export function validateCreateUserForm(form: CreateUserForm): {
} else if (password.length < CREATE_PASSWORD_MIN_LEN) {
errors.password = `密码至少${CREATE_PASSWORD_MIN_LEN}个字符`
}
+ if (normalizeCreateRole(form.role) === 'company_super_admin' && form.companyId == null) {
+ errors.companyId = '公司超级管理员必须指定所属公司'
+ }
return { valid: Object.keys(errors).length === 0, errors }
}
@@ -65,19 +85,26 @@ export function validateCreateUserForm(form: CreateUserForm): {
* 表单 → 创建请求体:用户名去空格、角色归一、菜单 id 拷贝不共享引用;
* createdById 仅在 role=normal 且选了所属管理员时携带(对齐 admin.js 的 created_by_id 语义)。
*
- * 故意不带 company_id:归属由后端 `AdminUserService#resolveTargetCompanyId` 落操作者自己的公司。
- * 页面上没有公司可选项(2026-10-04 定案),所以这条是"新账号归哪家公司"的唯一口径 ——
- * 想给别的公司建号,得用那个公司自己的 admin 登录,不是在这里改请求体。
+ * company_id 仅在 role=company_super_admin 且显式选择时下发(见 CreateUserPayload 注释);
+ * 其余角色不带——归属由后端 `AdminUserService#resolveTargetCompanyId` 落操作者自己的公司,
+ * 想给别的公司建普通账号,得用那个公司自己的管理员登录,不是在这里改请求体。
*/
export function toCreateUserRequest(form: CreateUserForm): CreateUserPayload {
+ const role = normalizeCreateRole(form.role)
const payload: CreateUserPayload = {
username: (form.username || '').trim(),
password: form.password || '',
- role: normalizeCreateRole(form.role),
+ role,
columnIds: Array.isArray(form.columnIds) ? form.columnIds.slice() : [],
}
if (payload.role === 'normal' && form.createdBy != null) {
payload.createdById = form.createdBy
}
+ if (form.expiresAt && String(form.expiresAt).trim()) {
+ payload.expiresAt = String(form.expiresAt).trim()
+ }
+ if (role === 'company_super_admin' && form.companyId != null) {
+ payload.companyId = form.companyId
+ }
return payload
}
diff --git a/admin-frontend-vue/src/pages/account/user-edit-model.ts b/admin-frontend-vue/src/pages/account/user-edit-model.ts
index cd857a50a..84b205e30 100644
--- a/admin-frontend-vue/src/pages/account/user-edit-model.ts
+++ b/admin-frontend-vue/src/pages/account/user-edit-model.ts
@@ -2,7 +2,7 @@
import type { AdminUser } from '../../types/admin'
import { CREATE_PASSWORD_MIN_LEN } from './user-create-model.ts'
-/** 编辑可选角色:超管不可改,未知归 normal;后端只收 admin|normal。 */
+/** 编辑可选角色:站点/公司超管不可改,未知归 normal;后端只收 admin|normal。 */
export type EditUserRole = 'normal' | 'admin'
export interface EditUserForm {
@@ -16,6 +16,8 @@ export interface EditUserForm {
columnIds: number[]
/** 后端原角色字符串,用于超管禁止编辑判定。 */
originalRole: string
+ /** 到期时间(yyyy-MM-dd HH:mm:ss);空串 = 永不过期。null = 后端本来就无到期。 */
+ expiresAt: string
}
export interface EditUserFormErrors {
@@ -24,9 +26,12 @@ export interface EditUserFormErrors {
/** 序列化到 PUT /api/admin/user/{uid} 的请求体(Java AdminUserUpdateRequest,空密码不下发)。 */
export interface EditUserUpdateRequest {
- role: EditUserRole
+ /** 目标是公司超管时不携带(防止表单把公司超管误降级);站点超管改其密码/到期时间即可。 */
+ role?: EditUserRole
columnIds: number[]
password?: string
+ /** 到期时间:空串=清除(恢复永不过期),有值=改期;总是下发(与后端"传了就更新"对齐)。 */
+ expiresAt: string
}
/** 行角色 → 可编辑角色:仅 admin 映射 admin,其余(含 unknown)归 normal。 */
@@ -34,9 +39,31 @@ export function editRoleOf(role: string | null | undefined): EditUserRole {
return (role || '').trim().toLowerCase() === 'admin' ? 'admin' : 'normal'
}
-/** 该角色是否允许被编辑:超级管理员不可编辑(镜像后端“不能修改超级管理员”)。 */
+/** 该角色是否允许被编辑:站点/公司超级管理员不可经普通编辑入口修改(镜像后端闸门)。 */
export function isEditableUser(role: string | null | undefined): boolean {
- return (role || '').trim().toLowerCase() !== 'super_admin'
+ const value = (role || '').trim().toLowerCase()
+ return value !== 'super_admin' && value !== 'company_super_admin'
+}
+
+/**
+ * 结合操作者角色判断可编辑性(UsersPage 用):公司超管的目标只有站点超管能编辑
+ * (改密码/到期时间做续费),站点超管目标谁都不能编辑。
+ */
+export function editableBy(
+ targetRole: string | null | undefined,
+ operatorRole: string | null | undefined,
+): boolean {
+ const target = (targetRole || '').trim().toLowerCase()
+ if (target === 'super_admin') return false
+ if (target === 'company_super_admin') return (operatorRole || '').trim().toLowerCase() === 'super_admin'
+ return true
+}
+
+/** 列表的 expires_at 是 yyyy-MM-dd HH:mm;日期选择器按 yyyy-MM-dd HH:mm:ss 回填,秒位补 :00。 */
+export function normalizeExpiryForPicker(raw: string | null | undefined): string {
+ const value = (raw || '').trim()
+ if (!value) return ''
+ return /^\d{4}-\d{2}-\d{2} \d{2}:\d{2}$/.test(value) ? `${value}:00` : value
}
/** 从用户行回填编辑表单:用户名只读、密码留空、columnIds 待授权加载填充。 */
@@ -49,6 +76,7 @@ export function fillEditUserForm(user: AdminUser): EditUserForm {
role: editRoleOf(role),
columnIds: [],
originalRole: role,
+ expiresAt: normalizeExpiryForPicker(user.expiresAt),
}
}
@@ -62,16 +90,20 @@ export function validateEditUserForm(form: EditUserForm): { valid: boolean; erro
return { valid: Object.keys(errors).length === 0, errors }
}
-/** 编辑表单 → 更新请求体:超管拒绝、空密码不下发、columnIds 拷贝不共享引用。 */
+/** 编辑表单 → 更新请求体:站点超管拒绝、空密码不下发、columnIds 拷贝不共享引用。 */
export function toEditUserUpdateRequest(form: EditUserForm): EditUserUpdateRequest {
const originalRole = (form.originalRole || '').trim().toLowerCase()
if (originalRole === 'super_admin') {
throw new Error('不能修改超级管理员')
}
- const role: EditUserRole = form.role === 'admin' ? 'admin' : 'normal'
const request: EditUserUpdateRequest = {
- role,
columnIds: Array.isArray(form.columnIds) ? form.columnIds.slice() : [],
+ expiresAt: (form.expiresAt || '').trim(),
+ }
+ // 公司超管目标不带 role:弹窗里的单选是给管理员/普通用户用的,带着它会整树提交把
+ // 公司超管静默降级。站点超管要调角色,请删号重建或走接口。
+ if (originalRole !== 'company_super_admin') {
+ request.role = form.role === 'admin' ? 'admin' : 'normal'
}
const password = form.password || ''
if (password) request.password = password
diff --git a/admin-frontend-vue/src/pages/account/user-expiry.ts b/admin-frontend-vue/src/pages/account/user-expiry.ts
new file mode 100644
index 000000000..ac507e1b5
--- /dev/null
+++ b/admin-frontend-vue/src/pages/account/user-expiry.ts
@@ -0,0 +1,19 @@
+/** 用户列表「到期时间」单元格渲染(V146):永不过期 / 具体时间 / 已过期。 */
+
+export interface ExpiryCell {
+ text: string
+ expired: boolean
+}
+
+/** 行 expiresAt 是 yyyy-MM-dd HH:mm 或空(后端空串=永不过期);解析失败按永不过期兜底。 */
+export function formatExpiryCell(row: { expiresAt?: string | null }): ExpiryCell {
+ const raw = (row?.expiresAt || '').trim()
+ if (!raw) {
+ return { text: '永不过期', expired: false }
+ }
+ const parsed = new Date(raw.replace(' ', 'T'))
+ if (Number.isNaN(parsed.getTime())) {
+ return { text: raw, expired: false }
+ }
+ return { text: raw, expired: parsed.getTime() < Date.now() }
+}
diff --git a/admin-frontend-vue/src/pages/account/user-role-map.ts b/admin-frontend-vue/src/pages/account/user-role-map.ts
index 2d0ec3686..164ddc637 100644
--- a/admin-frontend-vue/src/pages/account/user-role-map.ts
+++ b/admin-frontend-vue/src/pages/account/user-role-map.ts
@@ -2,24 +2,26 @@
import { roleKind } from '../../types/admin.ts'
/** 后台角色域(与 AdminUserItemVo.role / is_admin 对齐)。 */
-export type RoleDomain = 'super_admin' | 'admin' | 'normal'
+export type RoleDomain = 'super_admin' | 'company_super_admin' | 'admin' | 'normal'
/** 用户角色下拉可选值;super_admin 只能由系统持有,不入下拉。 */
-export type EditableRole = 'admin' | 'normal'
+export type EditableRole = 'company_super_admin' | 'admin' | 'normal'
export interface UserRoleOption {
value: EditableRole
label: string
}
-/** 编辑/创建表单角色下拉候选(镜像后端 admin|normal 白名单)。 */
+/** 建/编辑表单角色下拉候选(镜像后端白名单;company_super_admin 仅站点超管可选)。 */
export const USER_ROLE_OPTIONS: readonly UserRoleOption[] = [
+ { value: 'company_super_admin', label: '公司超级管理员' },
{ value: 'admin', label: '管理员' },
{ value: 'normal', label: '普通用户' },
]
const ROLE_DOMAIN_LABELS: Record = {
super_admin: '超级管理员',
+ company_super_admin: '公司超级管理员',
admin: '管理员',
normal: '普通用户',
}
@@ -27,14 +29,15 @@ const ROLE_DOMAIN_LABELS: Record = {
/** 行字段 → 角色域:优先 role;为空时按 is_admin 布尔推断(1=管理员);未知归 normal。 */
export function roleDomainOf(row: { role?: string | null; isAdmin?: boolean }): RoleDomain {
const kind = roleKind(row?.role)
- if (kind === 'super_admin' || kind === 'admin' || kind === 'normal') return kind
+ if (kind === 'super_admin' || kind === 'company_super_admin' || kind === 'admin' || kind === 'normal') return kind
return row?.isAdmin ? 'admin' : 'normal'
}
-/** 行 → 可编辑角色值:超级管理员返回 null(不可编辑),其余返回 admin/normal。 */
+/** 行 → 可编辑角色值:站点/公司超管不可在此编辑角色(返回 null),其余返回对应值。 */
export function selectRoleOf(row: { role?: string | null; isAdmin?: boolean }): EditableRole | null {
const domain = roleDomainOf(row)
- return domain === 'super_admin' ? null : domain
+ if (domain === 'super_admin' || domain === 'company_super_admin') return null
+ return domain
}
/** 角色域展示文案。 */
@@ -43,14 +46,16 @@ export function roleDomainLabel(domain: RoleDomain): string {
}
/**
- * 角色下拉锁定原因:目标为超管、或操作者非超管(镜像后端:admin 编辑时强制不调角色、
- * super_admin 不可改)。无锁定时返回 undefined。
+ * 角色下拉锁定原因:目标为站点/公司超管、或操作者非站点超管(镜像后端:admin/公司超管
+ * 编辑时角色不可调、super_admin 与同公司公司超管不可改)。无锁定时返回 undefined。
*/
export function userRoleLockMessage(
operatorRole: string | null | undefined,
target: { role?: string | null; isAdmin?: boolean },
): string | undefined {
- if (roleDomainOf(target) === 'super_admin') return '不能修改超级管理员'
+ const targetDomain = roleDomainOf(target)
+ if (targetDomain === 'super_admin') return '不能修改超级管理员'
+ if (targetDomain === 'company_super_admin') return '只有超级管理员可以修改公司超级管理员'
if (roleKind(operatorRole) !== 'super_admin') return '仅超级管理员可调整角色'
return undefined
}
diff --git a/admin-frontend-vue/src/types/admin.ts b/admin-frontend-vue/src/types/admin.ts
index cd6fecb0d..cce968d5c 100644
--- a/admin-frontend-vue/src/types/admin.ts
+++ b/admin-frontend-vue/src/types/admin.ts
@@ -1,7 +1,7 @@
/** 后台前端类型契约(任务 21):与 Java Admin 接口返回字段对齐。 */
/** 管理角色域(与后端 current-user / users 返回一致)。 */
-export type AdminRole = 'super_admin' | 'admin' | 'normal'
+export type AdminRole = 'super_admin' | 'company_super_admin' | 'admin' | 'normal'
export interface AdminUser {
id: number
@@ -13,6 +13,10 @@ export interface AdminUser {
creatorUsername?: string
createdAt?: string
updatedAt?: string
+ /** 到期时间(yyyy-MM-dd HH:mm);空串/缺省 = 永不过期(V146)。 */
+ expiresAt?: string
+ /** 自身到期剩余整天数(floor,来自 current-user);null/缺省 = 永不过期。续费提醒按它 <5 判定。 */
+ daysToExpire?: number | null
pinyinAbbr?: string
}
@@ -28,12 +32,13 @@ export interface AdminMenuNode {
icon?: string
}
-export type AdminRoleKind = 'super_admin' | 'admin' | 'normal' | null
+export type AdminRoleKind = 'super_admin' | 'company_super_admin' | 'admin' | 'normal' | null
/** 把任意角色字符串归一为角色域;未知/空返回 null。 */
export function roleKind(role: string | null | undefined): AdminRoleKind {
const value = (role || '').trim().toLowerCase()
if (value === 'super_admin') return 'super_admin'
+ if (value === 'company_super_admin') return 'company_super_admin'
if (value === 'admin') return 'admin'
if (value === 'normal') return 'normal'
return null
@@ -44,10 +49,15 @@ export function isSuperAdminRole(role: string | null | undefined): boolean {
return roleKind(role) === 'super_admin'
}
-/** 是否管理员级(super_admin 或 admin,可进后台菜单管理类)。 */
+/** 是否公司超级管理员(单家公司内的最高账号,数据只看本公司)。 */
+export function isCompanySuperAdminRole(role: string | null | undefined): boolean {
+ return roleKind(role) === 'company_super_admin'
+}
+
+/** 是否管理员级(super_admin / company_super_admin / admin,可进后台菜单管理类)。 */
export function isAdminRole(role: string | null | undefined): boolean {
const kind = roleKind(role)
- return kind === 'super_admin' || kind === 'admin'
+ return kind === 'super_admin' || kind === 'company_super_admin' || kind === 'admin'
}
/** 顶部栏角色展示文案。 */
@@ -55,6 +65,8 @@ export function roleLabel(role: string | null | undefined): string {
switch (roleKind(role)) {
case 'super_admin':
return '超级管理员'
+ case 'company_super_admin':
+ return '公司超级管理员'
case 'admin':
return '管理员'
case 'normal':
diff --git a/admin-frontend-vue/tests/company-config-entry-super-only.test.ts b/admin-frontend-vue/tests/company-config-entry-super-only.test.ts
index fe26c6941..69a84e0f8 100644
--- a/admin-frontend-vue/tests/company-config-entry-super-only.test.ts
+++ b/admin-frontend-vue/tests/company-config-entry-super-only.test.ts
@@ -31,13 +31,16 @@ test('名单里的每个 menuKey 都在页面注册表上打了 superAdminOnly',
}
})
-test('公司 API 模块的消费者集合恰好是公司管理两文件 + 公司 tab store(账号页已摘干净)', () => {
+test('公司 API 模块的消费者集合是公司管理两文件 + 用户页(建公司超管选公司,2026-10-05 唯一豁免)', () => {
const found = filesWithSuffix(['.vue', '.ts'])
.filter((rel) => readSource(rel).includes("from '@/api/companies'"))
.sort()
assert.deepEqual(found, [
'src/pages/account/CompaniesPage.vue',
'src/pages/account/CompanyEditorDialog.vue',
+ // 2026-10-05 例外:站点超管建「公司超级管理员」必须选公司,UsersPage 因此拉公司目录。
+ // 该用例的姊妹钉在 company-user-create.test.ts:公司下拉被「站点超管 + 公司超管角色」双重门控。
+ 'src/pages/account/UsersPage.vue',
// 2026-10-05 公司 tab(spec §4):store 是目录的第二个消费者,仅超管侧 visibleForOperator 会发 GET。
'src/stores/company-tab.ts',
].sort())
diff --git a/admin-frontend-vue/tests/company-user-create.test.ts b/admin-frontend-vue/tests/company-user-create.test.ts
index b9b9cc99a..ad1a0f44a 100644
--- a/admin-frontend-vue/tests/company-user-create.test.ts
+++ b/admin-frontend-vue/tests/company-user-create.test.ts
@@ -9,31 +9,40 @@ import {
import { OPERATION_GUIDES } from '../src/layout/operation-guides.ts'
/**
- * 建号不再让用户挑公司(2026-10-04 15:4x 定案)。
+ * 建号公司口径(2026-10-05 修订):admin/normal 建号仍不让用户挑公司——请求体不带
+ * company_id 时,`resolveTargetCompanyId` 落操作者自己的公司(下面的 Java 钉子仍然有效)。
*
- * 归属这件事改由后端单点决定:请求体不带 company_id 时,`resolveTargetCompanyId` 落操作者自己的公司。
- * 所以"前端删掉下拉是安全的"这个结论完全靠那条后端分支撑着 —— 下面最后一用例把它钉成可执行断言,
- * 谁把那边改成"必填公司",这边立刻红。
+ * 唯一例外是公司超级管理员(2026-10-05 用户需求「admin 超管可以新建其他公司的
+ * 超级管理员」):不显式选公司就会静默落进操作者自己的公司(公司 1),所以这一例必须
+ * 让站点超管选公司、必选、并随请求体下发。除这一例外,公司维度仍然不回流界面。
*/
function form(overrides: Record = {}) {
return { ...createEmptyCreateUserForm(), username: 'zhangsan', password: 'secret123', ...overrides }
}
-test('空表单里没有公司这一项', () => {
+test('空表单默认没有公司、没有到期时间', () => {
const blank = createEmptyCreateUserForm()
- assert.equal('companyId' in blank, false)
- assert.deepEqual(blank, { username: '', password: '', role: 'normal', columnIds: [], createdBy: null })
+ assert.equal(blank.companyId ?? null, null, 'companyId 默认 null(仅公司超管角色使用)')
+ assert.equal(blank.expiresAt, '', '到期时间默认空 = 永不过期')
+ assert.deepEqual(
+ { ...blank, companyId: null, expiresAt: '' },
+ { username: '', password: '', role: 'normal', columnIds: [], createdBy: null, companyId: null, expiresAt: '' },
+ )
})
-test('校验只看用户名与密码,不再要求选公司', () => {
+test('普通账号校验只看用户名与密码;公司超管必须选公司', () => {
assert.deepEqual(validateCreateUserForm(form()), { valid: true, errors: {} })
assert.equal(validateCreateUserForm(form({ username: 'a' })).errors.username !== undefined, true)
assert.equal(validateCreateUserForm(form({ password: '123' })).errors.password !== undefined, true)
+ const missingCompany = validateCreateUserForm(form({ role: 'company_super_admin' }))
+ assert.equal(missingCompany.valid, false, '公司超级管理员必须指定所属公司')
+ assert.equal(missingCompany.errors.companyId !== undefined, true)
+ const withCompany = validateCreateUserForm(form({ role: 'company_super_admin', companyId: 2 }))
+ assert.equal(withCompany.valid, true)
})
-// 反向钉:公司维度不得回流到界面(2026-10-04 定口径)
-test('请求体不带 companyId,其余字段照旧', () => {
+test('请求体:admin/normal 一律不带 companyId;公司超管必须带且选了公司才带', () => {
assert.deepEqual(toCreateUserRequest(form({ columnIds: [3, 1] })), {
username: 'zhangsan',
password: 'secret123',
@@ -44,17 +53,31 @@ test('请求体不带 companyId,其余字段照旧', () => {
assert.equal(toCreateUserRequest(form({ role: 'normal', createdBy: 5 })).createdById, 5)
assert.equal('createdById' in toCreateUserRequest(form({ role: 'admin', createdBy: 5 })), false)
assert.equal('companyId' in toCreateUserRequest(form()), false,
- '不传 company_id 才会走后端"落操作者公司"那条分支')
+ '不传 company_id 才会走后端"落操作者公司"那条分支(admin/normal 永远如此)')
+
+ // 2026-10-05 例外:公司超级管理员
+ const companyAdmin = toCreateUserRequest(form({ role: 'company_super_admin', companyId: 2 }))
+ assert.equal(companyAdmin.companyId, 2, '公司超管必须把选中的公司带给后端,否则会静默落操作者本公司')
+ assert.equal(companyAdmin.role, 'company_super_admin')
+ assert.equal('companyId' in toCreateUserRequest(form({ role: 'company_super_admin' })), false,
+ '没选公司就不许带(校验层会先拦住,这里兜底不静默)')
})
-// 反向钉:公司维度不得回流到界面(2026-10-04 定口径)
-test('建号模型源码里公司口径已摘干净', () => {
+test('到期时间:空串不下发,有值随请求体走', () => {
+ assert.equal('expiresAt' in toCreateUserRequest(form()), false, '留空 = 永不过期,不下发')
+ assert.equal(toCreateUserRequest(form({ expiresAt: '2026-12-31 23:59:59' })).expiresAt,
+ '2026-12-31 23:59:59')
+})
+
+test('建号模型源码:公司口径只对「公司超管」这一例放行', () => {
const mod = readSource('src/pages/account/user-create-model.ts')
- assert.equal(/companyId|CompanyItem|selectableCompanies|initialCompanyId|CreateOperatorScope/.test(mod), false,
- '公司相关的类型、可选项收窄函数、预选函数都应整体删除')
+ assert.match(mod, /company_super_admin/, '角色白名单要包含公司超管')
+ assert.match(mod, /role === 'company_super_admin' && form\.companyId != null/,
+ 'companyId 只在「角色=公司超管且已选公司」时下发——这是唯一豁免,别放宽成所有角色')
const dialog = readSource('src/pages/account/CreateUserDialog.vue')
- assert.equal(/companyId|CompanyItem|所属公司|selectableCompanies/.test(dialog), false,
- '弹窗不再有公司选择;操作者角色门控(operatorSuper)保留,它管的是角色与所属管理员下拉')
+ assert.match(dialog, /operatorSuper && form\.role === 'company_super_admin'/,
+ '公司下拉必须同时被「站点超管 + 公司超管角色」双重门控,普通建号不能看到公司维度')
+ assert.match(dialog, /公司超级管理员必须指定所属公司|请选择公司/, '公司下拉要有必选提示')
assert.match(dialog, /operatorSuper/, '角色/所属管理员仍按操作者是否超管收窄')
})
@@ -64,12 +87,14 @@ test('建号模型源码里公司口径已摘干净', () => {
* 同理"停用后不能再用于新建账号"也不成立了——requireActive 只在显式传 company_id 时才走,
* 而页面现在一律不传(接口直连的老调用方仍受它保护,那条由上一用例盯着)。
*/
-test('「公司管理」引导文案说的是自动继承,不再让操作员挑公司', () => {
+test('「公司管理」引导文案说的是自动继承,并写清公司超管这一例外', () => {
const guide = OPERATION_GUIDES.admin_companies.text
assert.match(guide, /操作者自己所在的公司/, '要写清归属的真实口径:落在操作者本公司')
assert.match(guide, /请用那个公司自己的管理员登录|用该公司自己的管理员登录/,
'要给别家建号只能换账号登录——不写这句,超管会以为自己建的号能归到别家')
- for (const stale of ['建号时选哪家公司', '选哪家公司', '停用后不能再用于新建账号']) {
+ assert.match(guide, /公司超级管理员/,
+ '2026-10-05 起开设公司超管是唯一要在建号时选公司的例外,文案要说清,别让人以为下拉没了是坏了')
+ for (const stale of ['建号时选哪家公司', '停用后不能再用于新建账号']) {
assert.equal(guide.includes(stale), false, `文案仍含已失效的说法:${stale}`)
}
})
@@ -93,7 +118,7 @@ function javaMethod(source: string, signature: string): string {
return ''
}
-test('后端仍然把"没传公司"落成操作者自己公司(前端删下拉的前提)', () => {
+test('后端仍然把"没传公司"落成操作者自己公司(admin/normal 不带下拉的前提)', () => {
const java = readSource(
'../backend-java/src/main/java/com/nanri/aiimage/modules/admin/service/AdminUserService.java',
)
diff --git a/admin-frontend-vue/tests/company-user-list.test.ts b/admin-frontend-vue/tests/company-user-list.test.ts
index 0769c85c8..5fc412e17 100644
--- a/admin-frontend-vue/tests/company-user-list.test.ts
+++ b/admin-frontend-vue/tests/company-user-list.test.ts
@@ -59,12 +59,18 @@ test('顶栏不再渲染公司名', () => {
assert.equal(topbarUserOf(null).hasUser, false)
})
-// 反向钉:公司维度不得回流到界面(2026-10-04 定口径)
+// 反向钉:公司维度不得回流到「列表/筛选/顶栏」(2026-10-04 定口径;2026-10-05 修订——
+// 唯一例外是建号弹窗里的「公司超级管理员」所属公司下拉,由 company-user-create.test.ts 单独钉住)
test('账号页与顶栏的源码里公司维度已摘干净', () => {
const page = readSource('src/pages/account/UsersPage.vue')
assert.equal(/所属公司/.test(page), false, '账号页不该再出现「所属公司」标签')
- assert.equal(/companyId|companyName|companies/.test(page), false, '页面不再持有公司目录或公司筛选状态')
- assert.equal(/fetchCompanies/.test(page), false, '公司目录接口不该再被账号页调用')
+ // 列表契约层面不许出现公司维度:查询参数 company_id、筛选状态、行级公司列。
+ // (companyOptions/c.companyName 是 2026-10-05 建公司超管选公司的唯一豁免,不在此列。)
+ assert.equal(/company_id|filters\.company|row\.company|companyId/.test(page), false,
+ '列表查询/筛选/行渲染不允许出现公司维度')
+ assert.match(page, /fetchCompanies/, '公司目录仅供建号弹窗的「公司超管」下拉使用(唯一豁免)')
+ assert.match(page, /isSuperAdmin[\s\S]{0,200}fetchCompanies/,
+ '拉公司目录必须按站点超管门控,非超管不发这个请求(后端 403 兜底)')
// 「删了列忘了改占位行 colspan」是这类改动最常留下的残行:按表头列数交叉核对
// (` {
for (const span of spans) assert.equal(span, headers, `占位行 colspan=${span} 与表头列数 ${headers} 不符`)
const dialog = readSource('src/pages/account/CreateUserDialog.vue')
- assert.equal(/所属公司|selectableCompanies|initialCompanyId|companyId/.test(dialog), false,
- '建号弹窗不该再有公司选择')
+ assert.match(dialog, /operatorSuper && form\.role === 'company_super_admin'/,
+ '建号弹窗的公司下拉只许在「站点超管 + 公司超管角色」时出现(例外口径见 company-user-create.test.ts)')
+ assert.equal(/selectableCompanies|initialCompanyId/.test(dialog), false,
+ '一次性预选/收窄的旧公司逻辑不许回流')
const layout = readSource('src/layout/AdminLayout.vue')
assert.equal(/userVm\.company|admin-user-company/.test(layout), false, '顶栏旁白只剩用户名与角色')
diff --git a/admin-frontend-vue/tests/date-filter-default-today.test.ts b/admin-frontend-vue/tests/date-filter-default-today.test.ts
index 0c1887908..83748dadc 100644
--- a/admin-frontend-vue/tests/date-filter-default-today.test.ts
+++ b/admin-frontend-vue/tests/date-filter-default-today.test.ts
@@ -34,6 +34,10 @@ const EXEMPT = new Set([
'src/pages/tasks/ShopDataTasksPage.vue',
'src/pages/tasks/ImageVideoTasksPage.vue',
'src/pages/records/RecordsHistoryPage.vue',
+ // 2026-10-05(V146):两处是「到期时间」表单字段而非列表筛选——留空 = 永不过期,
+ // 是有业务语义的默认值,绝不能默认当天(默认当天等于建号即过期)。
+ 'src/pages/account/CreateUserDialog.vue',
+ 'src/pages/account/EditUserDialog.vue',
])
/** 把日期筛选清回空值的写法(默认当天的页里初值或重置都不许出现)。
diff --git a/admin-frontend-vue/tests/expiry-notice.test.ts b/admin-frontend-vue/tests/expiry-notice.test.ts
new file mode 100644
index 000000000..3c05b0918
--- /dev/null
+++ b/admin-frontend-vue/tests/expiry-notice.test.ts
@@ -0,0 +1,102 @@
+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 的 段:从第一个 到最后一个 (内层还有 v-if 包裹)。 */
+function templateOf(source: string): string {
+ const start = source.indexOf('')
+ const end = source.lastIndexOf('')
+ assert.ok(start !== -1 && end > start, `${COMPONENT} 没有 段`)
+ return source.slice(start, end)
+}
+
+/** ')
+ assert.ok(start !== -1 && end > start, `${COMPONENT} 没有
diff --git a/frontend-vue/src/pages/login/DesktopLoginPage.vue b/frontend-vue/src/pages/login/DesktopLoginPage.vue
index 46b22e63a..7eb3ae7d8 100644
--- a/frontend-vue/src/pages/login/DesktopLoginPage.vue
+++ b/frontend-vue/src/pages/login/DesktopLoginPage.vue
@@ -113,6 +113,7 @@ import { useRouter } from 'vue-router'
import { loginWithDevice } from '@/shared/api/user'
import { KICK_NOTICE_KEY } from '@/shared/auth/kick-handler'
import { COMPANY_NAME_STORAGE_KEY, writeCompanyIdentity } from '@/shared/auth/company-identity'
+import { clearAccountExpiry, writeAccountExpiry } from '@/shared/auth/account-expiry'
import { useVersionUpdate } from '@/shared/composables/useVersionUpdate'
import { clearApiSecretCache } from '@/shared/utils/api-secret-store'
import UpdateProgressBar from '@/shared/components/UpdateProgressBar.vue'
@@ -435,6 +436,8 @@ async function submitLogin() {
}
// 公司名随后端可选返回:没有就删键,顶栏不显示该段(见 shared/auth/company-identity)
writeCompanyIdentity(data)
+ // 到期时间随后端可选返回:没有就删键(续费提醒弹窗的数据源,见 shared/auth/account-expiry)
+ writeAccountExpiry(data)
// 登录成功即持久化记住/自动登录凭据(桌面与网页均可,密码 AES 加密落 localStorage)
void saveCredentials(account)
// 桌面端 Flask cookie 同步已随瘦身下线:登录态只存 localStorage(JWT 走 Bearer),无 cookie 依赖
@@ -457,6 +460,7 @@ onMounted(() => {
window.localStorage.removeItem('uid')
window.localStorage.removeItem('username')
window.localStorage.removeItem(COMPANY_NAME_STORAGE_KEY)
+ clearAccountExpiry()
} catch {
/* 忽略 */
}
diff --git a/frontend-vue/src/shared/api/user.ts b/frontend-vue/src/shared/api/user.ts
index f6e734bd5..fcfb0b6e7 100644
--- a/frontend-vue/src/shared/api/user.ts
+++ b/frontend-vue/src/shared/api/user.ts
@@ -20,6 +20,8 @@ export interface LoginData {
/** 所属公司(company.id,V143 新增;旧 jar 不返回该字段) */
companyId?: number | string
companyName?: string
+ /** 自身账号到期时间(yyyy-MM-dd HH:mm,V146);缺省 = 永不过期,续费提醒用 */
+ expiresAt?: string
[key: string]: unknown
}
diff --git a/frontend-vue/src/shared/auth/account-expiry.ts b/frontend-vue/src/shared/auth/account-expiry.ts
new file mode 100644
index 000000000..0615a47f6
--- /dev/null
+++ b/frontend-vue/src/shared/auth/account-expiry.ts
@@ -0,0 +1,66 @@
+/**
+ * 用户端账号到期信息(V146,2026-10-05)
+ *
+ * app-web 无 Pinia,登录态走 localStorage;到期时间同理:登录 / check_login 的 data 里带
+ * expiresAt(yyyy-MM-dd HH:mm)就落键,没有就删键——换账号登录时不能残留上一个账号的到期值。
+ * 只反映账号自身 expires_at(续费提醒用),级联停用判定全部在服务端,这里不做任何本地推断。
+ */
+
+export const ACCOUNT_EXPIRY_STORAGE_KEY = 'account_expires_at'
+
+function storage(): Storage | null {
+ if (typeof window === 'undefined') return null
+ try {
+ return window.localStorage
+ } catch {
+ return null
+ }
+}
+
+/** 从登录/check_login 的 data 段落到期时间;缺字段或空白一律清键(= 永不过期/未知)。 */
+export function writeAccountExpiry(data: unknown): void {
+ const db = storage()
+ if (!db) return
+ const raw =
+ data && typeof data === 'object'
+ ? (data as { expiresAt?: unknown; expires_at?: unknown }).expiresAt ??
+ (data as { expires_at?: unknown }).expires_at
+ : undefined
+ const value = typeof raw === 'string' ? raw.trim() : ''
+ if (value) db.setItem(ACCOUNT_EXPIRY_STORAGE_KEY, value)
+ else db.removeItem(ACCOUNT_EXPIRY_STORAGE_KEY)
+}
+
+/** 当前账号到期时间字符串(yyyy-MM-dd HH:mm);无到期/未知返回空串。 */
+export function readAccountExpiry(): string {
+ const db = storage()
+ if (!db) return ''
+ try {
+ return (db.getItem(ACCOUNT_EXPIRY_STORAGE_KEY) || '').trim()
+ } catch {
+ return ''
+ }
+}
+
+/** 登出/切号/被顶下线时清键。 */
+export function clearAccountExpiry(): void {
+ const db = storage()
+ if (!db) return
+ try {
+ db.removeItem(ACCOUNT_EXPIRY_STORAGE_KEY)
+ } catch {
+ /* 忽略 */
+ }
+}
+
+/**
+ * 距到期还剩整天数(floor);无到期返回 null,已过期返回负数。
+ * 续费提醒按 0 ≤ days < 5 判定(剩余不足 5 天开始提醒,续到 ≥5 天消失)。
+ */
+export function daysToAccountExpiry(): number | null {
+ const raw = readAccountExpiry()
+ if (!raw) return null
+ const parsed = new Date(raw.replace(' ', 'T'))
+ if (Number.isNaN(parsed.getTime())) return null
+ return Math.floor((parsed.getTime() - Date.now()) / 86400_000)
+}
diff --git a/frontend-vue/src/shared/auth/ensure-auth.ts b/frontend-vue/src/shared/auth/ensure-auth.ts
index ce77dd831..cd2d41a5b 100644
--- a/frontend-vue/src/shared/auth/ensure-auth.ts
+++ b/frontend-vue/src/shared/auth/ensure-auth.ts
@@ -10,6 +10,7 @@
import { get } from '@/shared/api/http'
import { writeCompanyIdentity } from './company-identity'
+import { writeAccountExpiry } from './account-expiry'
const AUTH_TOKEN_KEY = 'aiimage_auth_token'
const UID_KEY = 'uid'
@@ -42,6 +43,7 @@ export async function ensureAuth(): Promise {
window.localStorage.setItem('username', String(response.data.username))
}
writeCompanyIdentity(response.data)
+ writeAccountExpiry(response.data)
return true
} catch {
// token 失效:清掉本地登录态(跳转交给路由守卫)
@@ -79,6 +81,7 @@ export async function restoreLoginUser(): Promise<{ username?: string } | null>
window.localStorage.setItem('username', String(response.data.username))
}
writeCompanyIdentity(response.data)
+ writeAccountExpiry(response.data)
return { username: response.data.username }
} catch {
return null
diff --git a/frontend-vue/src/shared/auth/kick-handler.ts b/frontend-vue/src/shared/auth/kick-handler.ts
index 1695e59f7..bb4ac7cf9 100644
--- a/frontend-vue/src/shared/auth/kick-handler.ts
+++ b/frontend-vue/src/shared/auth/kick-handler.ts
@@ -9,6 +9,7 @@
*/
import { COMPANY_NAME_STORAGE_KEY } from './company-identity.ts'
+import { ACCOUNT_EXPIRY_STORAGE_KEY } from './account-expiry.ts'
const AUTH_TOKEN_KEY = 'aiimage_auth_token'
const UID_KEY = 'uid'
@@ -72,6 +73,7 @@ export function handleKicked(): void {
storage.removeItem(UID_KEY)
storage.removeItem(USERNAME_KEY)
storage.removeItem(COMPANY_NAME_STORAGE_KEY)
+ storage.removeItem(ACCOUNT_EXPIRY_STORAGE_KEY)
storage.setItem(AUTO_LOGIN_KEY, '0')
storage.setItem(KICK_NOTICE_KEY, '1')
} catch {
diff --git a/frontend-vue/src/shared/components/ExpiryNotice.vue b/frontend-vue/src/shared/components/ExpiryNotice.vue
new file mode 100644
index 000000000..9f26fef01
--- /dev/null
+++ b/frontend-vue/src/shared/components/ExpiryNotice.vue
@@ -0,0 +1,153 @@
+
+
+
+
+
+
+ 服务即将到期
+
+ 您的账号{{ expiresAt ? `(${expiresAt})` : '' }}即将到期,{{ daysText }}。
+ 到期后账号将无法登录,名下账号与正在执行的任务也会一并停止,请联系管理员续费。
+
+
+
+
+
+
+
+
+
diff --git a/frontend-vue/tests/expiry-notice.test.ts b/frontend-vue/tests/expiry-notice.test.ts
new file mode 100644
index 000000000..8711d03a1
--- /dev/null
+++ b/frontend-vue/tests/expiry-notice.test.ts
@@ -0,0 +1,201 @@
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { readFileSync } from 'node:fs'
+import { join } from 'node:path'
+
+/**
+ * 用户端(app-web / 桌面壳内页)「服务即将到期」续费提醒护栏(V146,2026-10-05 需求)。
+ *
+ * 需求原话:仅剩不到 5 天开始提醒、只能缩小不能关闭、续费到超过 5 天才消失。
+ * 用户端与后台不同:后端只在登录/check_login 时下发 expiresAt,剩余天数由页面自己按
+ * 当前时间算——所以分两层钉:
+ * ① 行为层:account-expiry.ts 的落键/清键/算天数(可真跑,用 window 桩);
+ * ② 源码层:ExpiryNotice.vue 的阈值、按钮、收起态键(SFC 编译不了,断言打在实际源码上)。
+ * 链路断言(登录写键、恢复会话写键、被顶下线清键、挂载点)防的是"数据源断了但界面静默不弹"。
+ */
+
+const COMPONENT = 'src/shared/components/ExpiryNotice.vue'
+const APP = 'src/App.vue'
+const LOGIN = 'src/pages/login/DesktopLoginPage.vue'
+const ENSURE = 'src/shared/auth/ensure-auth.ts'
+const KICK = 'src/shared/auth/kick-handler.ts'
+
+function read(rel: string): string {
+ return readFileSync(join(process.cwd(), rel), 'utf8')
+}
+
+/** 非重叠子串计数。不走 execSync('grep'):node 在 Windows 上交给 cmd.exe,那里没 grep,命令会「成功返回空串」而不是报错——正是恒绿的形状。 */
+function occurrences(text: string, token: string): number {
+ if (!token) return 0
+ let count = 0
+ let index = text.indexOf(token)
+ while (index !== -1) {
+ count += 1
+ index = text.indexOf(token, index + token.length)
+ }
+ return count
+}
+
+function templateOf(source: string): string {
+ const start = source.indexOf('')
+ const end = source.lastIndexOf('')
+ assert.ok(start !== -1 && end > start, `${COMPONENT} 没有 段`)
+ return source.slice(start, end)
+}
+
+function scriptOf(source: string): string {
+ const start = source.indexOf(' |