cx-chat 0.0.2 → 0.0.3

package/src/main.tsx

@@ -1,50 +0,0 @@
-import React from 'react';
-import ReactDOM from 'react-dom/client';
-import { HashRouter } from 'react-router-dom';
-import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
-import App from './App';
-import ErrorBoundary from './components/common/error-boundary';
-import { AntdThemeProvider } from './styles/AntdThemeProvider';
-import 'katex/dist/katex.min.css'
-import './index.less';
-import './i18n'; // Initialize i18n
-
-import { mockManager } from '@api/_mock';
-import { loadUnauthDictData, publicDictsReady } from '@/meta';
-import { loadSystemConfigOnBoot } from '@/config/system';
-
-const queryClient = new QueryClient();
-
-// Mock：与 Vite `VITE_ENABLE_MOCK` 一致；生产默认关闭（见 `.env.production`）
-const shouldEnableMock =
-  import.meta.env.MODE === 'production'
-    ? import.meta.env.VITE_ENABLE_MOCK === 'true'
-    : import.meta.env.VITE_ENABLE_MOCK !== 'false'
-if (shouldEnableMock) {
-  mockManager.enable(300)
-} else {
-  mockManager.disable()
-}
-
-/** 应用启动加载：免登录字典 + 系统配置（同步 await，避免首屏品牌信息闪烁）。 */
-async function bootstrap() {
-  loadUnauthDictData()
-  await publicDictsReady
-  await loadSystemConfigOnBoot()
-}
-
-bootstrap().finally(() => {
-  ReactDOM.createRoot(document.getElementById('root')!).render(
-    <React.StrictMode>
-      <ErrorBoundary>
-        <AntdThemeProvider>
-          <QueryClientProvider client={queryClient}>
-            <HashRouter>
-              <App />
-            </HashRouter>
-          </QueryClientProvider>
-        </AntdThemeProvider>
-      </ErrorBoundary>
-    </React.StrictMode>
-  );
-})

package/src/meta/const/index.ts

@@ -1,40 +0,0 @@
-/**
- * Tag / 枚举条 / HTTP 方法等小色块用色（十六进制）。
- * 与 `src/styles/antd-theme.ts` 的 `token.colorSuccess | colorWarning | colorError | colorInfo` 同源；
- * 该文件从本常量注入主题，改色只改此处即可。
- */
-export const TAG_COLOR = {
-  success: '#22c55e',
-  warning: '#f59e0b',
-  error: '#ef4444',
-  /** 与 colorPrimary / colorInfo 一致 */
-  info: '#2563eb',
-  /** GET：查询语义，与 info 蓝区分（略偏青） */
-  httpGet: '#0284c7',
-} as const
-
-export type TagColorKey = keyof typeof TAG_COLOR
-
-/**
- * Table 列对齐（antd `ColumnType.align`）
- * 避免在每个列配置中写 align: 'center' as const
- */
-
-export const ALIGN = {
-  LEFT: 'left' as const,
-  CENTER: 'center' as const,
-  RIGHT: 'right' as const,
-} as const
-
-/**
- * Table 列固定方向（antd `ColumnType.fixed`）
- * 与 {@link ALIGN} 不同：fixed 只有左/右固定，不包含 center。
- */
-export const FIXED = {
-  LEFT: 'start' as const,
-  RIGHT: 'end' as const,
-} as const
-
-/** antd 默认字体栈（用于 httpMethod 等需要与系统字体对齐的场景） */
-export const FONT_FAMILY_ANTD_DEFAULT =
-  "-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, 'Noto Sans', sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol', 'Noto Color Emoji'"

package/src/meta/index-dict.ts

@@ -1,56 +0,0 @@
-/**
- * 数据字典（主入口，对外请 `import … from '@/meta/index-dict'`）。
- *
- * 文档：`src/_doc/meta/comp.2.dict-runtime.md`
- *
- * ## 改配置（本文件下方）
- * 修改 `unauthDictRegistry` / `commonDictRegistry` 即可。
- * 运行时通过 **`initDictDataRuntime({ … })`** 传参注入（见 `./module/dict-data/runtime.ts`），子模块不反向 import 本文件。
- *
- * ## DICT_KEY
- * 映射：前端访问键 → 后台分类 code（与 `DICT_DATA` 槽位 key 一致）。例：`DICT_DATA[DICT_KEY.permission]`。
- *
- * ## DICT_DATA
- * `Record<后台分类code, { option, valueMap, defaultValue }>`；请求未完成前为空，拉取后写入。
- *
- * ## 加载
- * `loadUnauthDictData()` 在应用入口调用；`loadCommonDictData()` 登录后由 Auth 触发。
- * 管理端字典变更后请再调 `loadUnauthDictData()` + `loadCommonDictData(true)` 刷新前端缓存。
- *
- * ## 与 React 同步
- * 使用 `useAuth().commonDictRevision` 或 `registerDictDataLoadedNotifier`。
- */
-
-import { initDictDataRuntime } from './module/dict-data/runtime'
-
-export type { DictCodeSlot, DictOptionItem, DictRegistryItem } from './module/dict-data/types'
-
-// ————————————————————————————————————————————————————————————————————————
-// 免登录字典注册表（键 = 后台分类 code；仅改本段 + 按需调整 constKey）
-// ————————————————————————————————————————————————————————————————————————
-export const unauthDictRegistry = {
-  phone_area_code: { constKey: 'phoneArea' },
-} as const
-
-// ————————————————————————————————————————————————————————————————————————
-// 登录后 batch 字典注册表
-// ————————————————————————————————————————————————————————————————————————
-export const commonDictRegistry = {
-  permission_code: { constKey: 'permission' },
-  LLM: { constKey: 'LLM' },
-  OCRLLM: { constKey: 'OCRLLM' },
-  db_type: { constKey: 'dbType' },
-} as const
-
-initDictDataRuntime({ unauthDictRegistry, commonDictRegistry })
-
-export type DictAccessKey =
-  (typeof unauthDictRegistry)[keyof typeof unauthDictRegistry]['constKey'] |
-  (typeof commonDictRegistry)[keyof typeof commonDictRegistry]['constKey']
-
-export type DictCategoryCode = keyof typeof unauthDictRegistry | keyof typeof commonDictRegistry
-
-export {
-  DICT_DATA, DICT_KEY, getDictDefaultValue, getDictOptions, loadCommonDictData, loadUnauthDictData, publicDictsReady, registerCommonDictLoadedNotifier, registerDictDataLoadedNotifier
-} from './module/dict-data/runtime'
-

package/src/meta/index-enum.ts

@@ -1,95 +0,0 @@
-/**
- * 静态枚举（主入口，对外请 `import … from '@/meta/index-enum'` 或 `@/meta`）。
- *
- * 文档：`src/_doc/meta/comp.1.enum-runtime.md`
- *
- * 结构与 **`index-dict` 对齐**：注册表 + **`initEnumDataRuntime`**，用 **`ENUM_DATA`** 访问（枚举键稳定，无需再维护「访问键 → 分类 code」映射）。
- *
- * ## 改配置（本文件下方 `enumRegistry`）
- * 键 = 稳定访问键（小驼峰，与 `ENUM_DATA` 槽位 key 一致）；值为静态 `{ value, label }[]`，`label` 一般为 i18n key；可选 `color` 会写入该类的 `tagColorMap`（HTTP 方法键为大写）。
- *
- * ## ENUM_DATA
- * 每槽：`option`、`valueMap`（`String(value)` → `label`）、`defaultValue`（当前恒 `''`）、`tagColorMap`。
- *
- * ## 与字典对照
- * - 字典：`DICT_DATA[DICT_KEY.permission].option`、`getDictOptions(DICT_KEY.xxx)`
- * - 枚举：`ENUM_DATA['commonStatus'].option`、`getEnumOptions('commonStatus')`
- */
-
-import { TAG_COLOR } from './const'
-import { initEnumDataRuntime } from './module/enum-data/runtime'
-
-export type { EnumCodeSlot, EnumOptionItem } from './module/enum-data/types'
-
-// ————————————————————————————————————————————————————————————————————————
-
-// 静态枚举注册表（键 = 访问键；仅改本段）
-
-// ————————————————————————————————————————————————————————————————————————
-
-export const enumRegistry = {
-  commonStatus: [
-    { value: 1, label: 'enum.commonStatus.1' },
-    { value: 0, label: 'enum.commonStatus.0' },
-  ],
-  /** 用户管理状态：1=激活 0=禁用（仅用户管理特例使用） */
-  activeStatus: [
-    { value: 1, label: 'enum.activeStatus.1' },
-    { value: 0, label: 'enum.activeStatus.0' },
-  ],
-  commonYesNo: [
-    { value: 1, label: 'enum.commonYesNo.1' },
-    { value: 0, label: 'enum.commonYesNo.0' },
-  ],
-  /** 0=系统内置 1=基础 2=扩展 */
-  permissionApiType: [
-    { value: 0, label: 'enum.permissionApiType.0', color: '#64748b' },
-    { value: 1, label: 'enum.permissionApiType.1', color: '#2563eb' },
-    { value: 2, label: 'enum.permissionApiType.2', color: '#9333ea' },
-  ],
-  /** HTTP 方法（通用枚举，label 与 value 一致，无需国际化；色见 `TAG_COLOR`） */
-  httpMethod: [
-    { value: 'GET', label: 'GET', color: TAG_COLOR.httpGet },
-    { value: 'POST', label: 'POST', color: TAG_COLOR.success },
-    { value: 'PUT', label: 'PUT', color: TAG_COLOR.warning },
-    { value: 'DELETE', label: 'DELETE', color: TAG_COLOR.error },
-  ],
-  /** 审核状态：10 草稿 20 待审核 25 审核中 30 审核通过 40 审核拒绝 */
-  auditStatus: [
-    { value: 10, label: 'enum.auditStatus.10', color: '#94a3b8', icon: 'FileText' },
-    { value: 20, label: 'enum.auditStatus.20', color: '#f59e0b', icon: 'Clock3' },
-    { value: 25, label: 'enum.auditStatus.25', color: '#f59e0b', icon: 'Loader2' },
-    { value: 30, label: 'enum.auditStatus.30', color: '#10b981', icon: 'CheckCircle2' },
-    { value: 40, label: 'enum.auditStatus.40', color: '#ef4444', icon: 'CircleX' },
-  ],
-  /** 知识库类型：0 个人 1 可公开（label 复用菜单 i18n key） */
-  knowledgeType: [
-    { value: 0, label: 'menus.knowledge.type_personal', color: 'blue' },
-    { value: 1, label: 'menus.knowledge.type_public', color: 'green' },
-  ],
-  /** 知识库文档类型：0 文本 1 文件（label 复用菜单 i18n key） */
-  knowledgeDocType: [
-    { value: 0, label: 'menus.knowledge.doc.type_text', color: 'blue' },
-    { value: 1, label: 'menus.knowledge.doc.type_file', color: 'green' },
-  ],
-  /** 常用数据库字符集 */
-  dbCharset: [
-    { value: 'utf8mb4', label: 'utf8mb4' },
-    { value: 'utf8', label: 'utf8' },
-    { value: 'gbk', label: 'gbk' },
-    { value: 'latin1', label: 'latin1' },
-    { value: 'ascii', label: 'ascii' },
-    { value: 'big5', label: 'big5' },
-    { value: 'cp1252', label: 'cp1252' },
-    { value: 'binary', label: 'binary' },
-  ],
-}
-
-initEnumDataRuntime({ enumRegistry })
-
-/** 与 `enumRegistry` / `ENUM_DATA` 槽位 key 一致 */
-
-export type EnumRegistryKey = keyof typeof enumRegistry
-
-export { ENUM_DATA, getEnumDefaultValue, getEnumLabelKey, getEnumOptions } from './module/enum-data/runtime'
-

package/src/meta/index.ts

@@ -1,14 +0,0 @@
-/**
- * 统一入口：
- * - index-enum：静态约定枚举（`ENUM_DATA`，主入口 `meta/index-enum.ts`）
- * - index-dict：动态数据字典（主入口 `meta/index-dict.ts`，实现 `meta/module/dict-data/`）
- * - const：常量定义（如 ALIGN 列对齐、FIXED 列固定）
- *
- * 文档：`src/_doc/meta/0.docs-overview.md`
- */
-
-export { ALIGN, FIXED, FONT_FAMILY_ANTD_DEFAULT, TAG_COLOR } from './const'
-export type { TagColorKey } from './const'
-export * from './index-dict'
-export * from './index-enum'
-

package/src/meta/module/dict-data/runtime.ts

@@ -1,199 +0,0 @@
-/**
- * 数据字典运行时：由 `initDictDataRuntime(config)` 注入注册表，不引用 `meta/index-dict.ts`，避免循环依赖。
- */
-
-import { batchGetDictDataAPI, getDictDataAPI } from '@/api/system/dict'
-import type { DictCodeSlot, DictOptionItem, DictRegistryItem } from './types'
-
-export type { DictCodeSlot } from './types'
-
-export type DictRuntimeInit = {
-  unauthDictRegistry: Record<string, DictRegistryItem>
-  commonDictRegistry: Record<string, DictRegistryItem>
-}
-
-function createEmptyDictCodeSlot(): DictCodeSlot {
-  return {
-    option: [],
-    valueMap: {},
-    defaultValue: '',
-  }
-}
-
-let unauthDictRegistryRef: Record<string, DictRegistryItem> = {}
-let commonDictRegistryRef: Record<string, DictRegistryItem> = {}
-
-function getDictRegistryItem(code: string): DictRegistryItem | undefined {
-  if (Object.prototype.hasOwnProperty.call(unauthDictRegistryRef, code)) {
-    return unauthDictRegistryRef[code]
-  }
-  if (Object.prototype.hasOwnProperty.call(commonDictRegistryRef, code)) {
-    return commonDictRegistryRef[code]
-  }
-  return undefined
-}
-
-function parseDictData(code: string, data: any[]) {
-  const slot = DICT_DATA[code]
-  if (!slot) return
-  const list = data ?? []
-  const valueMap: Record<string, string> = {}
-  let defaultValue = ''
-  const reg = getDictRegistryItem(code)
-  const toOption = (raw: any): DictOptionItem =>
-    reg?.parseItem != null ? reg.parseItem(raw) : { value: raw.value, name: raw.name }
-
-  slot.option = list.map((item: any) => {
-    const opt = toOption(item)
-    valueMap[String(opt.value)] = opt.name
-    if (item.defaultFlag) defaultValue = String(opt.value)
-    return opt
-  })
-  slot.valueMap = valueMap
-  slot.defaultValue = defaultValue
-}
-
-/** 访问键 → 后台分类 code（由 init 填充） */
-export const DICT_KEY = {} as Record<string, string>
-
-export const DICT_DATA = {} as Record<string, DictCodeSlot>
-
-export let publicDictsReady: Promise<void> = Promise.resolve()
-
-let commonDictLoadPromise: Promise<void> | null = null
-let commonDictLoadSettled = false
-let unauthDictLoadSettled = false
-
-const dictDataLoadedNotifiers = new Set<() => void>()
-
-let unauthDictCodes: string[] = []
-let commonDictCodes: string[] = []
-
-function notifyDictDataLoaded() {
-  for (const fn of dictDataLoadedNotifiers) {
-    try {
-      fn()
-    } catch (e) {
-      console.warn('[dict-data] dictDataLoaded notifier failed', e)
-    }
-  }
-}
-
-let runtimeInited = false
-
-/**
- * 注入注册表并初始化 `DICT_KEY` / `DICT_DATA` 槽位。由 `meta/index-dict.ts` 在定义好注册表后调用一次。
- */
-export function initDictDataRuntime(config: DictRuntimeInit): void {
-  if (runtimeInited) return
-  runtimeInited = true
-
-  unauthDictRegistryRef = config.unauthDictRegistry
-  commonDictRegistryRef = config.commonDictRegistry
-
-  unauthDictCodes = Object.keys(unauthDictRegistryRef)
-  commonDictCodes = Object.keys(commonDictRegistryRef)
-
-  const dictByAccessKey: Record<string, string> = {}
-  for (const code of Object.keys(unauthDictRegistryRef)) {
-    dictByAccessKey[unauthDictRegistryRef[code].constKey] = code
-  }
-  for (const code of Object.keys(commonDictRegistryRef)) {
-    dictByAccessKey[commonDictRegistryRef[code].constKey] = code
-  }
-
-  for (const k of Object.keys(DICT_KEY)) {
-    delete (DICT_KEY as Record<string, string | undefined>)[k]
-  }
-  Object.assign(DICT_KEY, dictByAccessKey)
-
-  const registeredDictCodes = [...new Set([...unauthDictCodes, ...commonDictCodes])]
-  for (const k of Object.keys(DICT_DATA)) {
-    delete (DICT_DATA as Record<string, DictCodeSlot | undefined>)[k]
-  }
-  for (const code of registeredDictCodes) {
-    DICT_DATA[code] = createEmptyDictCodeSlot()
-  }
-
-  commonDictLoadPromise = null
-  commonDictLoadSettled = false
-  unauthDictLoadSettled = false
-  publicDictsReady = Promise.resolve()
-}
-
-/**
- * 订阅字典数据写入 `DICT_DATA` 后的刷新时机：
- * - `loadUnauthDictData` 一轮结束（免登录类）
- * - `loadCommonDictData` 一轮结束（登录 batch 类）
- */
-export function registerDictDataLoadedNotifier(listener: () => void): () => void {
-  dictDataLoadedNotifiers.add(listener)
-  if (commonDictLoadSettled || unauthDictLoadSettled) {
-    try {
-      listener()
-    } catch (e) {
-      console.warn('[dict-data] dictDataLoaded notifier failed', e)
-    }
-  }
-  return () => {
-    dictDataLoadedNotifiers.delete(listener)
-  }
-}
-
-/** @deprecated 请使用 `registerDictDataLoadedNotifier` */
-export const registerCommonDictLoadedNotifier = registerDictDataLoadedNotifier
-
-export function getDictOptions(code: string) {
-  return DICT_DATA[code]?.option ?? []
-}
-
-export function getDictDefaultValue(code: string): string {
-  return DICT_DATA[code]?.defaultValue ?? ''
-}
-
-export function loadUnauthDictData(): void {
-  if (!unauthDictCodes.length) return
-  unauthDictLoadSettled = false
-  publicDictsReady = Promise.all(
-    unauthDictCodes.map((code) =>
-      getDictDataAPI(code)
-        .then((res: any) => {
-          if (res.data) {
-            parseDictData(code, res.data)
-          }
-        })
-        .catch(() => {}),
-    ),
-  )
-    .then(() => {})
-    .finally(() => {
-      unauthDictLoadSettled = true
-      notifyDictDataLoaded()
-    })
-}
-
-/**
- * 拉取登录后 batch 字典。
- * @param force 为 true 时丢弃缓存 Promise，重新请求（如管理端字典变更后）
- */
-export function loadCommonDictData(force = false): Promise<void> {
-  if (force) {
-    commonDictLoadPromise = null
-    commonDictLoadSettled = false
-  }
-  if (commonDictLoadPromise == null) {
-    commonDictLoadPromise = batchGetDictDataAPI([...commonDictCodes])
-      .then((res: any) => {
-        if (!res.data) return
-        for (const code of commonDictCodes) {
-          parseDictData(code, res.data[code] ?? [])
-        }
-      })
-      .catch(() => {})
-      .finally(() => {
-        commonDictLoadSettled = true
-        notifyDictDataLoaded()
-      })
-  }
-  return commonDictLoadPromise
-}

package/src/meta/module/dict-data/types.ts

@@ -1,17 +0,0 @@
-/** 与数据字典接口约定一致：每项必有 `value`、`name`（展示名） */
-export type DictOptionItem = { value: string | number; name: string }
-
-/**
- * 字典注册表项：键为后台「分类 code」时在 registry 对象上的 key。
- * - `parseItem` 可选：将接口单条映射为 `DictOptionItem`（预留）。
- */
-export type DictRegistryItem = {
-  constKey: string
-  parseItem?: (raw: any) => DictOptionItem
-}
-
-export type DictCodeSlot = {
-  option: DictOptionItem[]
-  valueMap: Record<string, string>
-  defaultValue: string
-}

package/src/meta/module/enum-data/runtime.ts

@@ -1,75 +0,0 @@
-/**
- * 静态枚举运行时：由 `initEnumDataRuntime({ enumRegistry })` 注入，不引用 `meta/index-enum.ts`。
- */
-
-import type { EnumCodeSlot, EnumOptionItem } from './types'
-
-export type { EnumCodeSlot, EnumOptionItem } from './types'
-
-export type EnumRuntimeInit = {
-  /** 键 = 稳定访问键（小驼峰），与 `ENUM_DATA` 槽位 key 一致；值为选项数组 */
-  enumRegistry: Record<string, readonly EnumOptionItem[] | EnumOptionItem[]>
-}
-
-function buildTagColorMap(items: EnumOptionItem[]): Record<string, string> {
-  const m: Record<string, string> = {}
-  for (const it of items) {
-    if (it.color == null || it.color === '') continue
-    const raw = it.value
-    const k = typeof raw === 'string' ? `${raw}`.toUpperCase() : `${raw}`
-    m[k] = it.color
-  }
-  return m
-}
-
-function createEnumSlot(items: readonly EnumOptionItem[] | EnumOptionItem[]): EnumCodeSlot {
-  const list = [...items]
-  const valueMap = Object.fromEntries(list.map((i) => [`${i.value}`, i.label])) as Record<string, string>
-  const dataMap = Object.fromEntries(list.map((i) => [`${i.value}`, i])) as Record<string, EnumOptionItem>
-  return {
-    option: list,
-    valueMap,
-    defaultValue: '',
-    tagColorMap: buildTagColorMap(list),
-    dataMap,
-  }
-}
-
-export const ENUM_DATA = {} as Record<string, EnumCodeSlot>
-
-let runtimeInited = false
-
-/**
- * 由 `meta/index-enum.ts` 在定义好 `enumRegistry` 后调用一次。
- */
-export function initEnumDataRuntime(config: EnumRuntimeInit): void {
-  if (runtimeInited) return
-  runtimeInited = true
-
-  const { enumRegistry } = config
-  for (const k of Object.keys(ENUM_DATA)) {
-    delete (ENUM_DATA as Record<string, EnumCodeSlot | undefined>)[k]
-  }
-
-  for (const key of Object.keys(enumRegistry)) {
-    ENUM_DATA[key] = createEnumSlot(enumRegistry[key])
-  }
-}
-
-export function getEnumOptions(code: string) {
-  return ENUM_DATA[code]?.option ?? []
-}
-
-export function getEnumDefaultValue(code: string): string {
-  return ENUM_DATA[code]?.defaultValue ?? ''
-}
-
-/**
- * 根据枚举 code 和 value 获取 i18n label key
- * @param code 枚举 code（如 'commonStatus'）
- * @param value 枚举值
- * @returns i18n label key，不存在则返回 undefined
- */
-export function getEnumLabelKey(code: string, value: unknown): string | undefined {
-  return ENUM_DATA[code]?.valueMap[`${value}`]
-}

package/src/meta/module/enum-data/types.ts

@@ -1,18 +0,0 @@
-/** 静态枚举项（与下拉约定：`value` + `label` 为 i18n key；可选 `color` 供 Tag；允许扩展字段如 `icon`） */
-export type EnumOptionItem = {
-  value: string | number
-  label: string
-  color?: string
-  [key: string]: unknown
-}
-
-/** 与 `DICT_DATA` 槽位对齐的内存结构（静态枚举无接口 defaultFlag，故 `defaultValue` 恒为 `''`） */
-export type EnumCodeSlot = {
-  option: EnumOptionItem[]
-  valueMap: Record<string, string>
-  defaultValue: string
-  /** `value`（字符串化；HTTP 方法为大写）→ Tag `color`，无 color 的项为空表 */
-  tagColorMap: Record<string, string>
-  /** `value`（字符串化）→ 原始枚举项（含扩展字段，如 `icon`） */
-  dataMap: Record<string, EnumOptionItem>
-}