cx-chat 0.0.1

package/src/main.tsx

@@ -0,0 +1,50 @@
+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

@@ -0,0 +1,40 @@
+/**
+ * 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

@@ -0,0 +1,56 @@
+/**
+ * 数据字典（主入口，对外请 `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

@@ -0,0 +1,95 @@
+/**
+ * 静态枚举（主入口，对外请 `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

@@ -0,0 +1,14 @@
+/**
+ * 统一入口：
+ * - 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

@@ -0,0 +1,199 @@
+/**
+ * 数据字典运行时：由 `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

@@ -0,0 +1,17 @@
+/** 与数据字典接口约定一致：每项必有 `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

@@ -0,0 +1,75 @@
+/**
+ * 静态枚举运行时：由 `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

@@ -0,0 +1,18 @@
+/** 静态枚举项（与下拉约定：`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>
+}