feat(多公司): 两端接上公司身份 —— 后台公司目录页、建号必选公司、顶栏显示所属公司

- 新后台新增「公司管理」页(列/新建/改名/启停,不提供删除),路由 menuKey 与
  columns 表的 admin_companies 逐字一致,由用例钉住;操作指引补该菜单一条。
- 建号弹窗对超管必须显式选一家(后端对"不传"仍落操作者自己公司,是给旧后台兜底);
  admin 只能落自己公司,越权直接 403。账号列表显示 company_name,可按公司筛。
- 客户端登录后把 companyId/companyName 落到 localStorage 并在顶栏显示;
  两个登出出口(handleKicked 与切号/登出)连公司名一起清 —— 残留会把上一个账号
  的归属显示给下一个账号。
- 契约分层:列表端点用 snake_case(company_id/company_name),current-user 与登录
  回包用 camelCase;解析器读到另一套写法必须忽略,防止前后端各猜一套。

admin-frontend-vue 1678/1678、frontend-vue 672/672,两边 build(含 vue-tsc --noEmit)干净。
This commit is contained in:
2026-10-04 07:11:47 +08:00
parent 4dbac40ef3
commit 15b8e46af8
29 changed files with 1109 additions and 16 deletions
@@ -0,0 +1,71 @@
import { test } from 'node:test'
import assert from 'node:assert/strict'
import { parseCompanyList, parseCompany } from '../src/api/companies-model.ts'
import {
COMPANY_NAME_MAX_LENGTH,
toCompanyPayload,
validateCompanyDraft,
} from '../src/api/companies-dto.ts'
/** 公司目录(设计文档 §2.3)前端侧:Java VO 是 snake_case,请求 DTO 是 camelCase。 */
test('parseCompanyList 按 snake_case 线上字段解析公司列表', () => {
const payload = {
success: true,
data: [
{ id: 1, company_name: '厦门米椿花', status: 1, remark: '初始公司', created_at: '2026-10-04 01:00:00', updated_at: '2026-10-04 02:00:00' },
{ id: 2, company_name: '福州数富', status: 0, remark: null },
],
}
assert.deepEqual(parseCompanyList(payload), [
{ id: 1, companyName: '厦门米椿花', status: 1, remark: '初始公司', createdAt: '2026-10-04 01:00:00', updatedAt: '2026-10-04 02:00:00' },
{ id: 2, companyName: '福州数富', status: 0, remark: null, createdAt: null, updatedAt: null },
])
})
test('parseCompanyList 不认 camelCase:证明上一条不是在测兜底', () => {
const rows = parseCompanyList({ success: true, data: [{ id: 3, companyName: '某某公司', status: 1 }] })
assert.equal(rows.length, 1)
assert.equal(rows[0].companyName, '', '线上字段是 company_name,camelCase 不该被读出来')
})
test('parseCompanyList 丢弃无 id 的行并把未知 status 当停用', () => {
const rows = parseCompanyList({ success: true, data: [
{ company_name: '没有 id', status: 1 },
{ id: 4, company_name: '状态未知', status: null },
] })
assert.deepEqual(rows, [{ id: 4, companyName: '状态未知', status: 0, remark: null, createdAt: null, updatedAt: null }])
})
test('parseCompanyList 对空/异常负载返回空数组', () => {
for (const payload of [null, undefined, {}, { success: true, data: null }, 'x']) {
assert.deepEqual(parseCompanyList(payload), [], `负载 ${JSON.stringify(payload)} 应解析为空列表`)
}
})
test('parseCompanyList 把 success=false 的后端文案抛出来', () => {
assert.throws(() => parseCompanyList({ success: false, message: '无权限访问公司目录' }), /无权限访问公司目录/)
})
test('parseCompany 解析单条(新建/改名回包)', () => {
const item = parseCompany({ success: true, data: { id: 5, company_name: '厦门米椿花', status: 1 } })
assert.ok(item)
assert.equal(item.id, 5)
assert.equal(item.companyName, '厦门米椿花')
assert.equal(parseCompany({ success: true, data: { company_name: '无 id' } }), null)
})
test('公司名必填、去空格后不得为空,且不超过列宽', () => {
assert.equal(validateCompanyDraft({ companyName: ' ' }), '公司名称不能为空')
assert.equal(validateCompanyDraft({ companyName: ' 厦门米椿花 ' }), '')
const tooLong = 'x'.repeat(COMPANY_NAME_MAX_LENGTH + 1)
assert.match(validateCompanyDraft({ companyName: tooLong }), /长度/)
})
test('toCompanyPayload 发 camelCase 且 trim 公司名', () => {
assert.deepEqual(toCompanyPayload({ companyName: ' 福州数富 ', status: 1, remark: ' ' }), {
companyName: '福州数富',
status: 1,
remark: null,
})
})
@@ -0,0 +1,59 @@
import { test } from 'node:test'
import assert from 'node:assert/strict'
import { existsSync, readFileSync } from 'node:fs'
import { join } from 'node:path'
import { adminPages } from '../src/router/routes.ts'
/** V143 往 columns 表插了「公司管理」菜单。侧边栏/路由门禁/面包屑都按
* column_key → adminPages.menuKey 关联(menu-route-map.ts 用注册表算出的规范路径覆盖库里的
* route_path),所以真正的跨产物契约是「迁移插入的菜单 key 必须在注册表登记」。
* 少登记一条 = 菜单看得见、点进去 404,且权限门禁认不出这个 key。 */
const MIGRATION = join(process.cwd(), '..', 'backend-java', 'src', 'main', 'resources', 'db',
'V143__company_and_users_company_id.sql')
interface MigrationMenu {
name: string
columnKey: string
routePath: string
}
/** 从迁移里抓出插入的菜单行(name / column_key / route_path)。 */
function menusInsertedBy(sql: string): MigrationMenu[] {
const menus: MigrationMenu[] = []
const re = /SELECT\s+'([^']+)',\s*'([^']+)',\s*'admin',\s*'([^']+)'/g
let match: RegExpExecArray | null
while ((match = re.exec(sql))) {
menus.push({ name: match[1], columnKey: match[2], routePath: match[3] })
}
return menus
}
function migrationSql(): string {
assert.ok(existsSync(MIGRATION), `迁移文件读不到,护栏无法核对菜单登记: ${MIGRATION}`)
return readFileSync(MIGRATION, 'utf8')
}
test('V143 插入的菜单 key 都必须在路由注册表登记', () => {
const menus = menusInsertedBy(migrationSql())
// 解析自证:正则漏抓就会恒绿,这里用独立的 INSERT INTO columns 计数交叉核对
const insertCount = (migrationSql().match(/INSERT INTO `columns`/g) || []).length
assert.ok(menus.length > 0, '迁移里应当插入了后台菜单,一条都没解析出来说明正则失效')
assert.equal(menus.length, insertCount, `解析到 ${menus.length} 条,但迁移有 ${insertCount} 条 INSERT INTO columns`)
const registered = new Set(adminPages.map((page) => page.menuKey))
for (const menu of menus) {
assert.ok(registered.has(menu.columnKey),
`菜单 key "${menu.columnKey}"(${menu.name})未在 src/router/routes.ts 登记 menuKey`)
}
})
test('V143 的「公司管理」菜单落到已注册的公司管理页', () => {
const menus = menusInsertedBy(migrationSql())
const companies = menus.find((menu) => menu.columnKey === 'admin_companies')
assert.ok(companies, '迁移必须插入 admin_companies 菜单')
const page = adminPages.find((item) => item.menuKey === 'admin_companies')
assert.ok(page, 'routes.ts 必须有 admin_companies 页面')
assert.equal(page.path, companies.routePath, '库里的 route_path 应与注册表路径一致')
assert.equal(page.title, companies.name, '页面标题应与菜单名一致')
})
@@ -0,0 +1,72 @@
import { test } from 'node:test'
import assert from 'node:assert/strict'
import {
initialCompanyId,
selectableCompanies,
toCreateUserRequest,
validateCreateUserForm,
createEmptyCreateUserForm,
} from '../src/pages/account/user-create-model.ts'
import { COMPANY_STATUS_ACTIVE, COMPANY_STATUS_DISABLED, type CompanyItem } from '../src/api/companies-dto.ts'
/** 建号表单的公司归属(设计文档 §2.2):超管必须显式选一家;公司内 admin 只能落自己公司。 */
const xiamen: CompanyItem = { id: 1, companyName: '厦门米椿花', status: COMPANY_STATUS_ACTIVE, remark: null, createdAt: null, updatedAt: null }
const fuzhou: CompanyItem = { id: 2, companyName: '福州数富', status: COMPANY_STATUS_ACTIVE, remark: null, createdAt: null, updatedAt: null }
const stopped: CompanyItem = { id: 3, companyName: '已停用公司', status: COMPANY_STATUS_DISABLED, remark: null, createdAt: null, updatedAt: null }
const ALL = [xiamen, fuzhou, stopped]
const SUPER = { role: 'super_admin', companyId: 1 }
const ADMIN = { role: 'admin', companyId: 2 }
function form(overrides: Record<string, unknown> = {}) {
return { ...createEmptyCreateUserForm(), username: 'zhangsan', password: 'secret123', ...overrides }
}
test('超管可选公司 = 启用中的公司,停用的不出现', () => {
assert.deepEqual(selectableCompanies(ALL, SUPER).map((c) => c.id), [1, 2])
})
test('公司内 admin 只列自己公司,不看状态', () => {
// 后端对非超管直接落 operator.companyId、不校验启用状态;前端跟着把本公司列出,
// 否则会出现「下拉里没得选、提交却能建号」的自相矛盾。
assert.deepEqual(selectableCompanies(ALL, ADMIN).map((c) => c.id), [2])
const ownStopped = [{ ...xiamen, status: COMPANY_STATUS_DISABLED }, fuzhou]
assert.deepEqual(selectableCompanies(ownStopped, { role: 'admin', companyId: 1 }).map((c) => c.id), [1])
})
test('操作者没有公司归属时不给出任何可选项', () => {
assert.deepEqual(selectableCompanies(ALL, { role: 'admin', companyId: null }), [])
assert.deepEqual(selectableCompanies(ALL, { role: 'admin' }), [])
})
test('超管不选公司就是校验不过,不能静默落自己公司', () => {
const missing = validateCreateUserForm(form({ companyId: null }), SUPER)
assert.equal(missing.valid, false)
assert.match(missing.errors.company || '', /公司/)
assert.equal(validateCreateUserForm(form({ companyId: 2 }), SUPER).valid, true)
})
test('非超管不要求选公司(后端强制落自己公司)', () => {
assert.equal(validateCreateUserForm(form({ companyId: null }), ADMIN).valid, true)
})
test('不带操作者时保持原有校验口径(老调用方不受影响)', () => {
assert.equal(validateCreateUserForm(form()).valid, true)
assert.equal(validateCreateUserForm(form({ username: 'a' })).errors.username !== undefined, true)
})
test('请求体带 camelCase companyId,未选时不带该键', () => {
assert.equal(toCreateUserRequest(form({ companyId: 2 })).companyId, 2)
assert.equal('companyId' in toCreateUserRequest(form({ companyId: null })), false)
assert.equal('companyId' in toCreateUserRequest(form({ companyId: 0 })), false)
})
test('弹窗打开时的默认公司:候选只有一个就落它,多个则不替超管决定', () => {
// 公司内 admin 只有一家在选,预选上省一步,也不会出现"没选就提交"的空值。
assert.equal(initialCompanyId(ADMIN, ALL), 2)
// 超管面对多家时必须自己选:默认值等于替他决定账号挂在哪家,这是会写进库的判断。
assert.equal(initialCompanyId(SUPER, ALL), null)
// 本公司压根不在列表里时不猜(返回 null 让后端按 operator 归属落库)。
assert.equal(initialCompanyId(ADMIN, [xiamen]), null)
})
@@ -0,0 +1,85 @@
import test from 'node:test'
import assert from 'node:assert/strict'
import { readSource } from './helpers.ts'
import { normalizeUserPageParams, toUserListQuery } from '../src/api/users-dto.ts'
import { toAdminUserItem } from '../src/api/users-model.ts'
import {
createUserFilterState,
isFilterActive,
toUserListParams,
withFilterReset,
} from '../src/pages/account/users-filter.ts'
import { topbarUserOf } from '../src/layout/topbar-model.ts'
/** 公司维度进账号页(设计文档 §2.3/§5.1):列表列、按公司筛选(仅超管)、顶栏公司名。 */
test('company_user_list_item_reads_snake_case_company_columns', () => {
const item = toAdminUserItem({
id: 7,
username: '张三',
role: 'normal',
company_id: 2,
company_name: '福州数富',
})
assert.equal(item?.companyId, 2)
assert.equal(item?.companyName, '福州数富')
})
test('company_user_list_item_ignores_camel_case_company_keys', () => {
// 反向排他:后端 AdminUserItemVo 走 @JsonProperty snake_case,解析器若跟着读 camelCase 就是双向猜。
const item = toAdminUserItem({ id: 7, username: '张三', role: 'normal', companyId: 9, companyName: '别家' })
assert.equal(item?.companyId, undefined)
assert.equal(item?.companyName, undefined)
})
test('company_user_list_filter_state_defaults_to_no_company', () => {
assert.equal(createUserFilterState().companyId, null)
// 改了公司筛选要回第一页,与其他筛选条件同规则
const next = withFilterReset({ ...createUserFilterState(), page: 5 }, { companyId: 3 })
assert.equal(next.companyId, 3)
assert.equal(next.page, 1)
assert.equal(isFilterActive({ ...createUserFilterState(), companyId: 3 }), true)
})
test('company_user_list_query_sends_company_id_only_when_selected', () => {
const withCompany = toUserListQuery(normalizeUserPageParams({ page: 1, pageSize: 10, companyId: 3 }))
assert.equal(withCompany.company_id, 3)
assert.equal(
'company_id' in toUserListQuery(normalizeUserPageParams({ page: 1, pageSize: 10 })),
false,
'未选公司时不下发 company_id,否则后端会当成"只看这家公司"过滤',
)
})
test('company_user_list_params_adapter_carries_company_id', () => {
const params = toUserListParams({ ...createUserFilterState(), companyId: 2 })
assert.equal(params.companyId, 2)
})
test('company_topbar_shows_company_name', () => {
assert.equal(
topbarUserOf({ id: 1, username: 'admin', role: 'admin', companyName: ' 厦门米椿花 ' }).company,
'厦门米椿花',
)
// 未登录空态与"后端没带公司"都必须是不显示,而不是渲染出 undefined
assert.equal(topbarUserOf(null).company, '')
assert.equal(topbarUserOf({ id: 1, username: 'admin', role: 'admin' }).company, '')
})
test('company_user_list_page_ui_wiring', () => {
const page = readSource('src/pages/account/UsersPage.vue')
assert.match(page, /所属公司/, '账号页要有公司这一列/筛选的中文标签')
assert.match(page, /fetchCompanies/, '公司候选来自 /api/admin/companies')
assert.match(page, /:companies="companies"/, '整份公司目录交给弹窗,由弹窗按操作者收窄')
assert.match(page, /:operator="operatorScope"/, '弹窗要拿到操作者角色与归属才能判必选')
assert.match(page, /colspan="8"/, '加了公司列后空态横跨整表')
const dialog = readSource('src/pages/account/CreateUserDialog.vue')
assert.match(dialog, /selectableCompanies\(/, '下拉选项走同一条后端收窄规则')
assert.match(dialog, /initialCompanyId\(/, '打开弹窗时的默认公司走纯函数,不在模板里现写')
assert.match(dialog, /请选择所属公司/, '下拉占位与校验文案同源')
assert.match(dialog, /validateCreateUserForm\(form, props\.operator\)/, '校验必须带上操作者,否则"超管必选公司"永远不触发')
const layout = readSource('src/layout/AdminLayout.vue')
assert.match(layout, /userVm\.company/, '顶栏走同一条公司名视图模型')
})