task-53(账号/权限页面): 定义菜单管理 DTO

新增 menu-manage-model.ts 纯 DTO：parseMenuManageItem/List 归一 PermissionMenuItemVo(snake)、 MenuManageForm 工厂、validateMenuManageForm 镜像后端 NotBlank 文案、toMenuCreate/UpdateRequest camelCase 对齐 Java PermissionMenuCreate/UpdateRequest(menuType=admin 固定)。8 用例全过， 387 单测 + build 绿。
2026-09-05 15:15:08 +08:00
parent 916f179fca
commit 5d9019a40d
2 changed files with 217 additions and 0 deletions
@@ -0,0 +1,123 @@
+/** 菜单管理 DTO/模型（任务 53）：扁平 PermissionMenuItemVo → 可编辑节点 + 创建/更新请求体。 */
+import { unwrap } from '../../api/envelope.ts'
+
+/** 后台 Vue 控制台菜单类型。 */
+export const ADMIN_MENU_TYPE = 'admin'
+
+export interface MenuManageNode {
+  id: number
+  name: string
+  /** column_key，稳定权限标识。 */
+  columnKey: string
+  parentId: number | null
+  rootColumnKey?: string
+  menuType: string
+  routePath: string
+  sortOrder: number
+}
+
+export interface MenuManageForm {
+  name: string
+  columnKey: string
+  parentId: number | null
+  menuType: string
+  routePath: string
+  sortOrder: number
+}
+
+/** 请求体字段与 Java PermissionMenuCreate/UpdateRequest 对齐（camelCase）。 */
+export interface MenuManagePayload {
+  name: string
+  columnKey: string
+  parentId: number | null
+  menuType: string
+  routePath: string
+  sortOrder: number
+}
+
+export interface MenuManageFormErrors {
+  name?: string
+  columnKey?: string
+  menuType?: string
+  routePath?: string
+}
+
+function numberOrNull(value: unknown): number | null {
+  return typeof value === 'number' && Number.isFinite(value) ? Math.floor(value) : null
+}
+
+function text(value: unknown): string {
+  return typeof value === 'string' ? value.trim() : ''
+}
+
+/** 排序归一：非负整数，非法回 0。 */
+export function normalizeMenuSort(value: unknown): number {
+  const n = numberOrNull(value)
+  return n !== null && n >= 0 ? n : 0
+}
+
+/** 把单条 PermissionMenuItemVo(snake_case) 归一为可编辑节点；缺 id 视为无效。 */
+export function parseMenuManageItem(raw: unknown): MenuManageNode | null {
+  if (!raw || typeof raw !== 'object') return null
+  const record = raw as Record<string, unknown>
+  const id = numberOrNull(record.id)
+  if (id === null) return null
+  const parentId = numberOrNull(record.parent_id)
+  const node: MenuManageNode = {
+    id,
+    name: text(record.name),
+    columnKey: text(record.column_key) || String(id),
+    parentId: parentId === null ? null : parentId,
+    menuType: text(record.menu_type) || ADMIN_MENU_TYPE,
+    routePath: text(record.route_path),
+    sortOrder: normalizeMenuSort(record.sort_order),
+  }
+  const rootColumnKey = text(record.root_column_key)
+  if (rootColumnKey) node.rootColumnKey = rootColumnKey
+  return node
+}
+
+/** 归一化 permission-menus 响应（信封或裸数组）为可编辑节点列表。 */
+export function parseMenuManageList(payload: unknown): MenuManageNode[] {
+  const data = unwrap<unknown>(payload)
+  if (!Array.isArray(data)) return []
+  return data
+    .map((raw) => parseMenuManageItem(raw))
+    .filter((node): node is MenuManageNode => node !== null)
+}
+
+/** 新建/编辑表单空值工厂：默认菜单类型为 admin、排序 0、根父节点。 */
+export function emptyMenuManageForm(): MenuManageForm {
+  return { name: '', columnKey: '', parentId: null, menuType: ADMIN_MENU_TYPE, routePath: '', sortOrder: 0 }
+}
+
+/** 表单校验（镜像后端 NotBlank 文案）；返回逐字段错误。 */
+export function validateMenuManageForm(form: MenuManageForm): { valid: boolean; errors: MenuManageFormErrors } {
+  const errors: MenuManageFormErrors = {}
+  if (!text(form.name)) errors.name = '菜单名称不能为空'
+  if (!text(form.columnKey)) errors.columnKey = '菜单标识不能为空'
+  if (!text(form.menuType)) errors.menuType = '菜单类型不能为空'
+  if (!text(form.routePath)) errors.routePath = '菜单路由不能为空'
+  return { valid: Object.keys(errors).length === 0, errors }
+}
+
+function toMenuManagePayload(form: MenuManageForm): MenuManagePayload {
+  return {
+    name: text(form.name),
+    columnKey: text(form.columnKey),
+    parentId: typeof form.parentId === 'number' ? form.parentId : null,
+    menuType: text(form.menuType),
+    routePath: text(form.routePath),
+    sortOrder: normalizeMenuSort(form.sortOrder),
+  }
+}
+
+/** 表单 → POST /api/admin/permission-menus 请求体。 */
+export function toMenuCreateRequest(form: MenuManageForm): MenuManagePayload {
+  return toMenuManagePayload(form)
+}
+
+/** 表单 → PUT /api/admin/permission-menus/{id} 请求体。 */
+export function toMenuUpdateRequest(form: MenuManageForm): MenuManagePayload {
+  return toMenuManagePayload(form)
+}