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,52 @@
/** 公司目录 DTO(设计文档 §2.3):纯逻辑,无框架依赖。 */
/** company.company_name 是 varchar(128),前端同步限长,免得撞库上 1406。 */
export const COMPANY_NAME_MAX_LENGTH = 128
/** company.status:1=启用 0=停用(与 V143 列注释同口径)。 */
export const COMPANY_STATUS_ACTIVE = 1
export const COMPANY_STATUS_DISABLED = 0
/** 前端公司项(camelCase,与 Java CompanyVo 的 snake_case 线上字段对应)。 */
export interface CompanyItem {
id: number
companyName: string
status: number
remark: string | null
createdAt: string | null
updatedAt: string | null
}
/** 新建/改名的表单草稿。 */
export interface CompanyDraft {
companyName: string
status?: number
remark?: string | null
}
export function text(value: unknown): string {
return typeof value === 'string' ? value : ''
}
export function trimmedOrNull(value: unknown): string | null {
const raw = text(value).trim()
return raw || null
}
/** 校验草稿,返回错误文案;合法返回空串。 */
export function validateCompanyDraft(draft: CompanyDraft): string {
const name = text(draft.companyName).trim()
if (!name) return '公司名称不能为空'
if (name.length > COMPANY_NAME_MAX_LENGTH) {
return `公司名称长度不能超过 ${COMPANY_NAME_MAX_LENGTH} 个字符`
}
return ''
}
/** 草稿 → POST/PUT 请求体(Java 侧 CompanySaveRequest 是 camelCase,与 AdminUserCreateRequest 同口径)。 */
export function toCompanyPayload(draft: CompanyDraft): Record<string, unknown> {
const payload: Record<string, unknown> = { companyName: text(draft.companyName).trim() }
if (typeof draft.status === 'number') payload.status = draft.status
payload.remark = trimmedOrNull(draft.remark)
return payload
}
@@ -0,0 +1,48 @@
/** 公司目录响应解析:Java CompanyVo(snake_case) → 前端 CompanyItem(camelCase)。 */
import { unwrap } from './envelope.ts'
import {
COMPANY_STATUS_ACTIVE,
COMPANY_STATUS_DISABLED,
text,
trimmedOrNull,
type CompanyItem,
} from './companies-dto.ts'
function numberOrNull(value: unknown): number | null {
return typeof value === 'number' && Number.isFinite(value) ? Math.floor(value) : null
}
/** 单条映射;无 id 视为无效行(列表中直接丢弃,避免编辑时打到 /companies/undefined)。 */
export function toCompanyItem(raw: unknown): CompanyItem | null {
if (!raw || typeof raw !== 'object') return null
const r = raw as Record<string, unknown>
const id = numberOrNull(r.id)
if (id === null) return null
return {
id,
companyName: text(r.company_name),
// status 列 NOT NULL,取不到就是链路异常;未知一律按停用,不把异常状态当启用。
status: r.status === COMPANY_STATUS_ACTIVE ? COMPANY_STATUS_ACTIVE : COMPANY_STATUS_DISABLED,
remark: trimmedOrNull(r.remark),
createdAt: trimmedOrNull(r.created_at),
updatedAt: trimmedOrNull(r.updated_at),
}
}
/** 解析 GET /api/admin/companies:接受 data 为数组或 {items:[...]},success=false 抛后端文案。 */
export function parseCompanyList(payload: unknown): CompanyItem[] {
const core = unwrap<unknown>(payload)
if (!core || typeof core !== 'object') return []
const candidate = Array.isArray(core) ? core : (core as { items?: unknown }).items
if (!Array.isArray(candidate)) return []
return candidate
.map((raw) => toCompanyItem(raw))
.filter((item): item is CompanyItem => item !== null)
}
/** 解析 POST/PUT 回包(data 为 CompanyVo)。 */
export function parseCompany(payload: unknown): CompanyItem | null {
const core = unwrap<unknown>(payload)
if (!core || typeof core !== 'object' || Array.isArray(core)) return null
return toCompanyItem(core)
}
+21
View File
@@ -0,0 +1,21 @@
import { http } from './http'
import { parseCompany, parseCompanyList } from './companies-model'
import { toCompanyPayload, type CompanyDraft, type CompanyItem } from './companies-dto'
/** 公司目录(设计文档 §2.3)。GET 的可见范围由后端收窄:超管全部、公司内 admin 只自己公司。 */
export async function fetchCompanies(): Promise<CompanyItem[]> {
const { data } = await http.get('/api/admin/companies')
return parseCompanyList(data)
}
export async function createCompany(draft: CompanyDraft): Promise<CompanyItem | null> {
const { data } = await http.post('/api/admin/companies', toCompanyPayload(draft))
return parseCompany(data)
}
/** 改名 / 启停;后端不做删除,停用即 status=0。 */
export async function updateCompany(id: number, draft: CompanyDraft): Promise<CompanyItem | null> {
const { data } = await http.put(`/api/admin/companies/${id}`, toCompanyPayload(draft))
return parseCompany(data)
}
+12
View File
@@ -15,6 +15,8 @@ export interface UserListParams {
adminId?: number | null
/** 角色过滤(''=全部)。 */
role?: string
/** 按所属公司过滤(V143);仅超管用得到——公司内 admin 后端本来就只返回本公司账号。 */
companyId?: number | null
}
/** 序列化到 GET /api/admin/users 的查询参数(Java snake_case)。 */
@@ -26,6 +28,7 @@ export interface UserListQuery {
created_by_id?: number
admin_id?: number
role?: string
company_id?: number
}
/** 用户列表项即 AdminUser(与 Java AdminUserItemVo 字段对齐)。 */
@@ -46,6 +49,12 @@ function finiteInt(value: unknown): number | null {
return typeof value === 'number' && Number.isFinite(value) ? Math.floor(value) : null
}
/** 公司 id 只认正整数:0/负数/NaN 一律当"没筛选",否则会下发一个必然查不到账号的过滤。 */
function positiveId(value: unknown): number | null {
const id = finiteInt(value)
return id !== null && id > 0 ? id : null
}
/** 归一化分页/筛选参数:页码下限 1、页大小 1..上限,空关键字视为无过滤。 */
export function normalizeUserPageParams(raw: Partial<UserListParams>): UserListParams {
const page = Math.max(finiteInt(raw.page) ?? USER_PAGE_MIN_PAGE, USER_PAGE_MIN_PAGE)
@@ -61,6 +70,7 @@ export function normalizeUserPageParams(raw: Partial<UserListParams>): UserListP
keyword,
createdById: typeof raw.createdById === 'number' ? raw.createdById : null,
adminId: typeof raw.adminId === 'number' ? raw.adminId : null,
companyId: positiveId(raw.companyId),
role: typeof raw.role === 'string' ? raw.role.trim() || undefined : undefined,
}
}
@@ -72,6 +82,8 @@ export function toUserListQuery(params: UserListParams): UserListQuery {
if (params.createdById != null) query.created_by_id = params.createdById
if (params.adminId != null) query.admin_id = params.adminId
if (params.role) query.role = params.role
const companyId = positiveId(params.companyId)
if (companyId !== null) query.company_id = companyId
return query
}
@@ -27,6 +27,12 @@ export function toAdminUserItem(raw: unknown): AdminUser | null {
if (updatedAt) item.updatedAt = updatedAt
const creator = text(r.creator_username)
if (creator) item.creatorUsername = creator
// 公司维度只在后端带上时才写键:留 undefined 而不是 null,好让"这版后端没带公司"
// 与"账号确实没归属公司"在页面上是两种可读的状态。
const companyId = numberOrNull(r.company_id)
if (companyId !== null) item.companyId = companyId
const companyName = text(r.company_name).trim()
if (companyName) item.companyName = companyName
const abbr = text(r.pinyin_abbr)
if (abbr) item.pinyinAbbr = abbr
return item