20260917212907

code/fms/.workbuddy-ai/memory/MEMORY.md

@@ -83,6 +83,33 @@
   描边 `color-mix(primary 40%, #fff)`；「浅底+白字」对比度只有 1.4~2.7:1，不可用。
 - Teleport 到 body 的浮层（如 `.fms-team-menu-*`）不在侧栏内，保持全局浅色 token。
 
+## UI 组件库全局配置
+
+- 唯一入口 `fms-vue/src/components/ui/config.js`：`uiConfig`（reactive）+ `setUIConfig(patch)`（按组件维度浅合并）
+  + `resetUIConfig()`，也从 `@/components/ui` 具名导出。**没有 ConfigProvider、没有 app.use 插件**。
+- 回落顺序固定 **自身 prop > uiConfig > 组件内置默认**；要支持全局覆盖的 prop，`default` 必须写 `undefined`
+  且 validator 要放行 `undefined`（Vue 会拿 default 跑校验）。
+- Form 的 `layout`/`labelAlign`/`labelWidth`/`validateTrigger` 已接入；provide 下发回落后的最终值。
+  语言联动在 `src/App.vue`：中文 `horizontal`、其他语言 `vertical`（判定 `/^zh/i`）。
+- **多列紧凑网格的表单必须显式 `layout="vertical"`**（如自动编码面板 columns=5），
+  否则横排的 88px 标签会把控件压到几十像素。prop 优先于全局配置。
+- `defineModel` 写完**不能立刻回读**：写了只 emit，prop 下一轮才回来；要取刚写入的值就自己先
+  `reactive()` 包一层再赋值，返回其中的代理对象。
+
+## i18n 运行时
+
+- 语言清单 `s_i18n_type`（`b_id` 即语种编码，zh-CN 默认 / en-US）；译文 `s_i18n(b_key, b_locale, b_value)`。
+- store `stores/i18n.js`：`loadLanguages()` 拉清单、**`loadMessages(locale)` 拉译文**（按语种缓存 + 并发去重 +
+  失败静默；只把「当前语种」的译文写进运行时）。**别只看 locale——不调 loadMessages 界面不会变。**
+- 合并顺序 **前端内置 < 库表译文**：内置只有 en-US 的 `common.*`（`src/i18n/builtin-messages.js`，
+  代码约定 `t('common.x', '中文兜底')`）；业务文案/字段名/菜单名的译文一律进 `s_i18n` 由实施维护。
+- 现状：`s_i18n` 只登记了 zh-CN（约 134 条），en-US 尚无数据 → 英文界面只有框架按钮/提示是英文，
+  字段名等仍回落中文，需要补录。
+- 顶栏语种下拉取自 `s_i18n_type` 清单，不要硬编码语言编码。
+- 查询区（`FmsQueryToolbar`）已改用 Form/FormItem，因此也跟随该配置；Form 根靠 `display: contents`
+  透明化，让 FormItem 直接参与 `.query-grid`（`minmax(0,200px)`）布局，label 宽局部 72px。
+  高级查询面板（`FmsAdvancedQueryPanel`）仍是自绘 `.filter-*`，**不受**表单布局配置影响。
+
 ## 导出（P0 已落地，摘要）
 
 `POST /api/export/list` 返回文件流：`SqlPermissionService` → `ExportSchemaService`（列与列表同源推导）