fix(角色叫法): 管理员就叫管理员、normal 档统一「普通账号」

同一角色此前有两套叫法:admin 档在界面叫「管理员」、在后端 6 条 403 与 Swagger 说明里叫
「普通管理员」;normal 档在界面叫「普通用户」。清到第四轮才清净,所以把口径做进源码出口:
新增 task-048 的旧词扫描用例,两棵源码树(admin-frontend-vue/src 216 文件、
backend-java/src 1415 java 文件)里出现「普通管理员」「普通用户」即红,分母与出口文件成员
一起钉死,防"扫了个空集合"式假绿。

- 后端 6 条用户可见文案:PermissionMenuService 两判、ShopManageGroupService 一判、
  ShopManageController 三条 @Operation 说明
- company_menu_grant_gate_mutation.py 的 DENIED_THROW 锚同步改,16 条锚命中数逐条复算=1
- 注释与 javadoc 同批收口(等长替换不动排版);NotificationControllerTest 那句讲的是
  非后台账号,按本意改写而不是套「普通账号」
This commit is contained in:
2026-10-05 23:15:57 +08:00
parent c2994b80b0
commit 0e6e844929
17 changed files with 105 additions and 34 deletions
@@ -29,7 +29,7 @@ const errors = reactive<CreateUserFormErrors>({})
const busy = ref(false)
/** 角色下拉:站点超管可选公司超管/管理员/普通账号;公司超管只可选管理员/普通账号;
* 普通管理员不显示角色选择(后端强制 normal)。 */
* 管理员不显示角色选择(后端强制 normal)。 */
const ROLE_CHOICES: Array<{ value: 'company_super_admin' | 'admin' | 'normal'; label: string }> = [
{ value: 'company_super_admin', label: '公司超级管理员' },
{ value: 'admin', label: '管理员' },
@@ -102,7 +102,7 @@ export function toEditUserUpdateRequest(form: EditUserForm): EditUserUpdateReque
if (originalRole === 'super_admin') {
throw new Error('不能修改超级管理员')
}
// 公司超管目标不带 role:弹窗里的单选是给管理员/普通用户用的,带着它会整树提交把
// 公司超管目标不带 role:弹窗里的单选是给管理员/普通账号用的,带着它会整树提交把
// 公司超管静默降级。站点超管要调角色,请删号重建或走接口。
const keepsRole = originalRole !== 'company_super_admin'
const nextRole: EditUserRole = form.role === 'admin' ? 'admin' : 'normal'
@@ -34,7 +34,7 @@ export async function fetchShopManageList(params: Partial<ShopManageListParams>
export const SHOP_MANAGE_GROUPS_ENDPOINT = '/api/admin/shop-manages/groups'
/** 加载店铺分组下拉选项(超级管理员取全部,普通管理员由后端限定可访问分组)。 */
/** 加载店铺分组下拉选项(超级管理员取全部,管理员由后端限定可访问分组)。 */
/** 分组下拉:打的是与分组管理页同一个 GET /groups,所以它也必须跟着公司 tab 收窄,
* 否则店铺列表窄了、下拉里还选得到别家的组。 */
export async function fetchShopManageGroups(companyId?: number | null): Promise<ShopGroupOption[]> {
@@ -22,7 +22,7 @@ const reanalyzing = ref(false)
const filter = reactive({ asin: '', shop: '', group: '', country: '', dateFrom: '', dateTo: '' })
/** 角色范围:超管可看全部分组店铺并可跨分组筛选;普通管理员数据已由后端裁剪到自己分组,无需分组筛选。 */
/** 角色范围:超管可看全部分组店铺并可跨分组筛选;管理员数据已由后端裁剪到自己分组,无需分组筛选。 */
const session = useAdminSessionStore()
const isSuper = computed(() => session.isSuperAdmin)
@@ -83,13 +83,13 @@ test('align_dup_console_role_scope_group_filter_only_super', () => {
})
test('align_dup_console_role_scope_group_controls_only_super', () => {
// 分组撞款/分组说明为超管专属交互;后端超管全量、普通管理员所管分组店铺。
// 分组撞款/分组说明为超管专属交互;后端超管全量、管理员所管分组店铺。
const page = readSource('src/pages/tasks/DuplicateCheckPage.vue')
assert.match(page, /<div v-if="isSuper" class="scope-bar">/, '分组撞款分段仅超管可见')
assert.match(page, /v-if="isSuper" class="btn btn-ghost btn-sm" type="button" @click="groupInfoVisible = true"/, '分组说明按钮仅超管可见')
const service = readSource('../backend-java/src/main/java/com/nanri/aiimage/modules/shopduplicatecheck/service/ShopDataDuplicateCheckQueryService.java')
assert.match(service, /if \(superAdmin\) \{\s*return null;/, '超管可见范围=全量(null)')
assert.match(service, /selectManagedShopNames\(operatorId\)/, '普通管理员可见范围=所管分组店铺')
assert.match(service, /selectManagedShopNames\(operatorId\)/, '管理员可见范围=所管分组店铺')
})
test('align_dup_console_country_labels_chinese', () => {
@@ -8,9 +8,9 @@ import {
parsePermissionMenuItem,
} from '../src/pages/account/user-menu-auth.ts'
// 2026-09-16 线上事故:非超管(普通管理员)在授权树里勾到自己无权授予的菜单后,
// 2026-09-16 线上事故:非超管(管理员)在授权树里勾到自己无权授予的菜单后,
// 后端 ensureGrantable 抛 403 并回滚整笔事务——创建用户与保存权限双双失败,
// 前端只显示「普通管理员只能分配自己已有的菜单权限」。
// 前端只显示「管理员只能分配自己已有的菜单权限」。
//
// 现在的口径:非超管的授权树**只下发**自己已持有的菜单(读接口按操作者过滤),
// 范围外的项连展示都没有。为保留「一级分组 + 子页面」层级,可授予项的祖先分组仍
+71
View File
@@ -1,5 +1,7 @@
import test from 'node:test'
import assert from 'node:assert/strict'
import { readdirSync } from 'node:fs'
import { join } from 'node:path'
import { readSource } from './helpers.ts'
import {
roleDomainOf,
@@ -88,3 +90,72 @@ test('test_task_048_normal_role_wording_agrees_across_all_exits', () => {
)
assert.deepEqual(buttons, [['normal', word], ['admin', '管理员']], '编辑用户弹窗的角色按钮文案')
})
/**
* 2026-10-05 定稿:admin 档只叫「管理员」,normal 档只叫「普通账号」。
* 旧叫法「普通管理员」「普通用户」当天清了三轮才清干净(列表列、下拉、角色域、弹窗按钮四份出口
* 各写一套,后端还留着 6 条 403 与 Swagger 说明),所以钉成尺子而不是记在脑子里。
* 判据只扫两棵源码树的源码扩展名:`.playwright-cli/*.yml` 那批 09-12 的页面快照里印着旧词,
* 那是历史证据不是口径;`tests/` 也不扫——本文件的禁用清单自己就要写这两个词。
*/
const RETIRED_ROLE_WORDS = ['普通管理员', '普通用户'] as const
/** 扫描面。minFiles 是 2026-10-05 实测分母(216 / 1415)的下限,mustInclude 钉"该扫到的文件真在集合里"。 */
const ROLE_WORD_SCOPE: ReadonlyArray<{
readonly dir: string
readonly exts: readonly string[]
readonly minFiles: number
readonly mustInclude: readonly string[]
}> = [
{
dir: 'src',
exts: ['.ts', '.tsx', '.vue', '.js'],
minFiles: 200,
mustInclude: ['src/types/admin.ts', 'src/pages/account/user-role-map.ts', 'src/pages/account/EditUserDialog.vue'],
},
{
dir: '../backend-java/src',
exts: ['.java'],
minFiles: 1300,
mustInclude: [
'../backend-java/src/main/java/com/nanri/aiimage/modules/permission/service/PermissionMenuService.java',
'../backend-java/src/main/java/com/nanri/aiimage/modules/admin/service/AdminUserService.java',
],
},
]
function walkSourceFiles(dir: string, exts: readonly string[], out: string[] = []): string[] {
for (const entry of readdirSync(join(process.cwd(), dir), { withFileTypes: true })) {
const rel = `${dir}/${entry.name}`
if (entry.isDirectory()) {
if (entry.name === 'node_modules' || entry.name === 'dist' || entry.name.startsWith('.')) continue
walkSourceFiles(rel, exts, out)
} else if (exts.some((ext) => entry.name.endsWith(ext))) {
out.push(rel)
}
}
return out
}
test('test_task_048_retired_role_words_are_gone_from_source_trees', () => {
const problems: string[] = []
for (const scope of ROLE_WORD_SCOPE) {
const files = walkSourceFiles(scope.dir, scope.exts)
assert.ok(
files.length >= scope.minFiles,
`${scope.dir} 只扫到 ${files.length} 个文件(下限 ${scope.minFiles}):目录或扩展名写错了,这条尺子没在判任何东西`,
)
for (const needle of scope.mustInclude) {
assert.ok(files.includes(needle), `${scope.dir} 的扫描集合里没有 ${needle},取样面漏了出口文件`)
}
for (const rel of files) {
const lines = readSource(rel).split('\n')
lines.forEach((line, index) => {
for (const word of RETIRED_ROLE_WORDS) {
if (line.includes(word)) problems.push(`${rel}:${index + 1} 出现旧叫法「${word}」→ ${line.trim().slice(0, 60)}`)
}
})
}
}
assert.deepEqual(problems, [], '角色旧叫法回流:' + problems.join(' | '))
})