lingxi/apps/web/src/pages/system/roles/role-display.spec.ts

import type { PermissionTree, RoleListItem } from '@lingxi/shared';
import { permissionTreeSchema, roleListItemSchema } from '@lingxi/shared';
import { describe, expect, it } from 'vitest';

import {
  buildPermissionMetaMap,
  DEFAULT_ROLE_LIST_FILTERS,
  filterRoles,
  formatRoleDateTime,
  hasActiveRoleFilters,
  permissionNameOf,
  scopeLabelOf,
  summarizePermissionModules,
  summarizeRoles,
} from './role-display';

let index = 0;

function buildRole(overrides: Record<string, unknown> = {}): RoleListItem {
  index += 1;
  return roleListItemSchema.parse({
    id: '01HZZZZZZZZZZZZZZZZZZZZZZZ',
    code: `role_${String(index)}`,
    name: `角色 ${String(index)}`,
    description: '角色说明',
    isSystem: false,
    status: 'active',
    permissionCount: 4,
    specialPermissionCount: 0,
    userCount: 3,
    dataScope: { type: 'department' },
    createdAt: '2026-10-27T02:40:00.000Z',
    updatedAt: '2026-10-27T02:40:00.000Z',
    ...overrides,
  });
}

const tree: PermissionTree = permissionTreeSchema.parse({
  modules: [
    {
      module: 'script',
      moduleLabel: '脚本',
      sortOrder: 10,
      permissions: [
        { code: 'script:read', name: '查看脚本', description: '脚本库', isSpecial: false },
        { code: 'script:write', name: '编辑与生成脚本', description: '编辑', isSpecial: false },
        { code: 'script:review', name: '审核脚本', description: '审核', isSpecial: false },
      ],
    },
    {
      module: 'delivery',
      moduleLabel: '导出交付',
      sortOrder: 40,
      permissions: [
        { code: 'delivery:read', name: '查看交付记录', description: '交付清单', isSpecial: false },
        { code: 'delivery:export', name: '发起导出', description: '数据出口', isSpecial: true },
      ],
    },
  ],
  specialPermissions: [
    { code: 'delivery:export', name: '发起导出', description: '数据出口', isSpecial: true },
  ],
  sodPairs: [
    {
      id: 'script-write-review',
      label: '脚本生成 × 脚本审核',
      description: '不得同时拥有',
      permissions: ['script:write', 'script:review'],
    },
  ],
  totalPermissions: 5,
});

describe('权限点摘要与元数据', () => {
  it('按 10 模块口径统计已选 / 总数（含特殊权限）', () => {
    const summary = summarizePermissionModules(tree, [
      'script:read',
      'script:review',
      'delivery:export',
    ]);
    expect(summary).toEqual([
      { module: 'script', moduleLabel: '脚本', selected: 2, total: 3 },
      { module: 'delivery', moduleLabel: '导出交付', selected: 1, total: 2 },
    ]);
  });

  it('权限点编码映射到名称，缺失时回退编码', () => {
    const meta = buildPermissionMetaMap(tree);
    expect(permissionNameOf(meta, 'delivery:export')).toBe('发起导出');
    expect(meta.get('delivery:export')?.isSpecial).toBe(true);
    expect(permissionNameOf(meta, 'ghost:code')).toBe('ghost:code');
  });
});

describe('数据范围与时间展示', () => {
  it('六类数据范围名称与未知类型兜底', () => {
    expect(scopeLabelOf('customer_groups')).toBe('指定客户组');
    expect(scopeLabelOf('department_and_children')).toBe('本部门及下级');
    expect(scopeLabelOf('created_by_me')).toBe('本人创建');
  });

  it('ISO 时间转 YYYY-MM-DD HH:mm，空值与非法值显示占位符', () => {
    expect(formatRoleDateTime('2026-10-27T02:40:00.000Z')).toMatch(/^2026-10-27 \d{2}:40$/);
    expect(formatRoleDateTime(null)).toBe('—');
    expect(formatRoleDateTime('not-a-date')).toBe('—');
  });
});

describe('角色统计与筛选', () => {
  it('汇总角色 / 启用 / 停用 / 绑定用户 / 特殊授予 / 内置数', () => {
    const stats = summarizeRoles([
      buildRole({ isSystem: true, userCount: 2, specialPermissionCount: 6 }),
      buildRole({ status: 'disabled', userCount: 0 }),
      buildRole({ userCount: 5, specialPermissionCount: 1 }),
    ]);
    expect(stats).toEqual({
      total: 3,
      active: 2,
      disabled: 1,
      boundUsers: 7,
      specialGrants: 7,
      systemCount: 1,
    });
  });

  it('按关键词 / 状态 / 只看特殊权限筛选', () => {
    const roles = [
      buildRole({ name: '审核员', code: 'reviewer', description: '脚本与素材审核' }),
      buildRole({ name: '设计师', code: 'designer', status: 'disabled' }),
      buildRole({ name: '行业配置', specialPermissionCount: 1 }),
    ];
    expect(
      filterRoles(roles, { ...DEFAULT_ROLE_LIST_FILTERS, keyword: '审核' }).map(
        (role) => role.code,
      ),
    ).toEqual(['reviewer']);
    expect(
      filterRoles(roles, { ...DEFAULT_ROLE_LIST_FILTERS, status: 'disabled' }).map(
        (role) => role.name,
      ),
    ).toEqual(['设计师']);
    expect(
      filterRoles(roles, { ...DEFAULT_ROLE_LIST_FILTERS, specialOnly: true }).map(
        (role) => role.name,
      ),
    ).toEqual(['行业配置']);
  });

  it('识别是否存在生效筛选', () => {
    expect(hasActiveRoleFilters(DEFAULT_ROLE_LIST_FILTERS)).toBe(false);
    expect(hasActiveRoleFilters({ ...DEFAULT_ROLE_LIST_FILTERS, keyword: '  ' })).toBe(false);
    expect(hasActiveRoleFilters({ ...DEFAULT_ROLE_LIST_FILTERS, specialOnly: true })).toBe(true);
  });
});