From b90ae89b0ec94067e1097a31968eb3a28949f0a5 Mon Sep 17 00:00:00 2001
From: oneao <hi_itao@163.com>
Date: Mon, 17 Aug 2026 22:52:27 +0800
Subject: [PATCH] 20260817225227

---
 .../layouts-dark-light-adaptation_aa221499.md |   74 +
 code/fms/FMS新系统架构设计.md                 | 2481 +++++++++++++++++
 code/fms/fms-vue/index.html                   |  800 +++++-
 .../src/components/ui/ColorThemePicker.vue    |   98 -
 .../fms-vue/src/components/ui/ThemeToggle.vue |   61 -
 .../src/components/ui/button/button.vue       |    7 +-
 .../fms-vue/src/components/ui/demo/date.vue   |    4 +-
 .../fms-vue/src/components/ui/demo/drawer.vue |   10 +-
 .../src/components/ui/demo/dropdown.vue       |    7 +-
 .../fms-vue/src/components/ui/demo/form.vue   |    7 +-
 .../fms-vue/src/components/ui/demo/modal.vue  |    5 +-
 .../fms-vue/src/components/ui/demo/select.vue |    7 +-
 .../fms-vue/src/components/ui/demo/spin.vue   |    5 +-
 .../src/components/ui/demo/splitter.vue       |    4 +-
 .../fms-vue/src/components/ui/demo/tabs.vue   |    4 +-
 .../src/components/ui/drawer/drawer.vue       |    7 +-
 .../components/ui/dropdown/DropdownItem.vue   |    4 +-
 .../src/components/ui/dropdown/dropdown.vue   |   10 +-
 .../ui/message/message-container.vue          |   12 +-
 .../fms-vue/src/components/ui/modal/modal.vue |   24 +-
 .../notification/notification-container.vue   |   12 +-
 .../components/ui/pagination/pagination.vue   |    4 +-
 .../src/components/ui/popover/popover.vue     |    9 +-
 .../fms-vue/src/components/ui/spin/spin.vue   |    4 +-
 .../src/components/ui/switch/index.scss       |    4 +-
 .../fms-vue/src/components/ui/tabs/tabs.vue   |    3 +-
 .../fms/fms-vue/src/components/ui/tag/tag.vue |    3 +-
 .../fms/fms-vue/src/layouts/DefaultLayout.vue |   64 +-
 .../src/layouts/components/AppSidebar.vue     |   11 +-
 .../src/layouts/components/AppTabs.vue        |   15 +-
 .../src/layouts/components/AppTopbar.vue      |   91 +-
 code/fms/fms-vue/src/router/index.js          |   24 +-
 code/fms/fms-vue/src/stores/app.js            |   33 +-
 code/fms/fms-vue/src/utils/cacheKey.js        |   11 +
 .../fms/fms-vue/src/views/dashboard/index.vue |   26 +-
 code/fms/fms-vue/src/views/demo/index.vue     |  116 +-
 .../fms-vue/src/views/detail/DetailPage.vue   |  129 +
 code/fms/fms-vue/src/views/login/index.vue    |   14 +-
 code/fms/fms-vue/src/views/test/TestPage.vue  |   10 +-
 39 files changed, 3861 insertions(+), 353 deletions(-)
 create mode 100644 code/fms/.codebuddy/plans/layouts-dark-light-adaptation_aa221499.md
 create mode 100644 code/fms/FMS新系统架构设计.md
 delete mode 100644 code/fms/fms-vue/src/components/ui/ColorThemePicker.vue
 delete mode 100644 code/fms/fms-vue/src/components/ui/ThemeToggle.vue
 create mode 100644 code/fms/fms-vue/src/utils/cacheKey.js
 create mode 100644 code/fms/fms-vue/src/views/detail/DetailPage.vue

diff --git a/code/fms/.codebuddy/plans/layouts-dark-light-adaptation_aa221499.md b/code/fms/.codebuddy/plans/layouts-dark-light-adaptation_aa221499.md
new file mode 100644
index 00000000..eb3f571e
--- /dev/null
+++ b/code/fms/.codebuddy/plans/layouts-dark-light-adaptation_aa221499.md
@@ -0,0 +1,74 @@
+---
+name: layouts-dark-light-adaptation
+overview: 修复 layouts 下未做 dark/light 主题适配的硬编码样式，统一改用 --fms-* token。
+todos:
+  - id: fix-apptabs-active
+    content: 修改 AppTabs.vue 激活态与关闭按钮的硬编码白色为 var(--fms-primary-text) 与 color-mix 派生
+    status: completed
+  - id: fix-apptopbar-check
+    content: 修改 AppTopbar.vue .check 对勾 color:#fff 为 var(--fms-primary-text)
+    status: completed
+  - id: lint-check
+    content: 运行 pnpm lint 静态检查确认无新增告警
+    status: completed
+    dependencies:
+      - fix-apptabs-active
+      - fix-apptopbar-check
+---
+
+## 用户需求
+
+检查 `src/layouts` 下所有文件并结合 `src/theme/tokens.css`，定位未做 dark/light 模式适配的硬编码样式，并用 `--fms-*` token 替换修复，使其跟随主题切换。
+
+## 产品概述
+
+FMS Vue 前端布局壳（顶栏 / 侧栏 / 页签 / 导航菜单）基于 `tokens.css` 的 CSS 变量做深浅色适配。本次仅修复布局层残留的硬编码颜色，保证切换深色模式时视觉一致。
+
+## 核心功能
+
+- 修复 `AppTabs.vue` 激活页签的硬编码白色文字与关闭按钮白色（含 hover 态），改用 `var(--fms-primary-text)` 及基于主色文字色的 `color-mix` 派生。
+- 修复 `AppTopbar.vue` 主题色板选中对勾的硬编码 `color: #fff`，改用 `var(--fms-primary-text)`。
+- 保持其余已正确使用 token 的样式不变（DefaultLayout / AppSidebar / NavMain / NavMenuItem 及 AppTopbar 其他部分均无需改动）。
+
+## 技术栈
+
+- Vue 3 `<script setup>` + SCSS（scoped）+ CSS 变量（`:root` 浅色 / `.dark` 深色，主色 `--fms-primary` 由 JS 写入，`--fms-primary-text` 语义色）。
+- 适配方式：所有颜色引用 `--fms-*` token；半透明白使用 `color-mix(in srgb, var(--fms-primary-text) x%, transparent)` 派生，不裸写 `rgba(255,255,255,...)`。
+
+## 实现方案
+
+逐项替换 layouts 下两处文件的硬编码颜色，全部复用现有 token，不新增 token、不改 JS 逻辑：
+
+1. **AppTabs.vue 激活态**
+
+- `.fms-tab.is-active`：`color: #fff` → `color: var(--fms-primary-text)`；`background/border-color` 已用 `var(--fms-primary)`，保持。
+- `.fms-tab.is-active .fms-tab-close`：`color: rgba(255,255,255,0.85)` → `color: color-mix(in srgb, var(--fms-primary-text) 85%, transparent)`；hover 背景 `rgba(255,255,255,0.22)` → `color-mix(in srgb, var(--fms-primary-text) 22%, transparent)`；`color: #fff` → `var(--fms-primary-text)`。
+- 理由：`#fff` 在浅色主色（墨蓝 `#0f172b`）下成立，但用户可切换主色且深色模式下主色文字语义由 `--fms-primary-text` 统一表达，裸白会破坏换肤一致性。
+
+2. **AppTopbar.vue 色板对勾**
+
+- `.check { color: #fff }` → `color: var(--fms-primary-text)`。彩色块源于主色/预设色，对勾需高对比，`primary-text` 在浅色为白、深色主色深时仍为白，视觉等价且符合规范。
+
+## 实现要点
+
+- 仅改 scoped `<style>`，不动 `<script>`/`<template>`。
+- 沿用项目现有 `color-mix` 派生写法（参考 `AppTopbar.vue` 搜索框 `color-mix(in srgb, var(--fms-secondary-hover) 50%, var(--fms-card))`），保持一致。
+- 不引入过渡/动画之外的额外复杂度；`prefers-reduced-motion` 已处理，无需改动。
+- 按开发规范：修改后只做静态检查（oxlint），不主动 `pnpm build` / 启动服务，除非用户要求。
+
+## 架构与目录
+
+仅修改以下两个文件（均属 `src/layouts`）：
+
+```
+src/layouts/components/AppTabs.vue    # [MODIFY] 激活态与关闭按钮颜色改用 primary-text / color-mix
+src/layouts/components/AppTopbar.vue # [MODIFY] .check 对勾颜色改用 primary-text
+```
+
+其余 `DefaultLayout.vue` / `AppSidebar.vue` / `NavMain.vue` / `NavMenuItem.vue` 经核查已正确使用 token，不在本次改动范围。
+
+## 验证
+
+- 浅色模式：激活页签文字/对勾为白（主色墨蓝，primary-text=白），与现状一致。
+- 切换深色模式（`.dark`）：`--fms-primary-text` 维持白，激活态与对勾仍清晰；若未来主色改为浅色，`primary-text` 会反转，样式自动跟随。
+- 运行 `pnpm lint`（oxlint）确认无新增告警（不主动 build）。
\ No newline at end of file
diff --git a/code/fms/FMS新系统架构设计.md b/code/fms/FMS新系统架构设计.md
new file mode 100644
index 00000000..18388a05
--- /dev/null
+++ b/code/fms/FMS新系统架构设计.md
@@ -0,0 +1,2481 @@
+# FMS 新系统架构设计
+
+## 1. 文档目的
+
+本文档整理 FMS 新系统重构的核心架构方向。新系统不是传统的固定功能 ERP，也不是完全依赖代码开发的业务系统，而是面向内部 ERP 场景的模块化低代码平台。
+
+系统需要同时满足三类使用者：
+
+- 开发人员：开发复杂业务规则、专用页面、流程、算法和外部接口。
+- 售后技术人员：不修改代码即可新增实体、字段、引用关系、列表、表单、查询和基础页面。
+- 业务人员：通过统一的 ERP 页面和 AI 助手完成日常业务操作。
+
+本次重构不以兼容旧架构或最小迁移成本为目标，可以重新设计模块模型、元数据模型、数据库变更机制和运行时。
+
+## 2. 当前问题
+
+旧系统以 `s_module` 为中心，将多种职责集中在同一套模块元数据中：
+
+- 菜单和路由
+- 数据表和视图
+- 字段定义
+- 列表、编辑和查询配置
+- 操作权限
+- 多语言
+- 自动编码
+
+这种设计导致数据库结构和配置元数据相互依赖。创建或迁移一个功能时，通常需要执行以下步骤：
+
+```text
+创建业务表
+-> 创建查询视图
+-> 注册模块
+-> 拉取数据库字段
+-> 刷新字段元数据
+-> 配置列表
+-> 配置表单
+-> 配置查询
+```
+
+主要问题包括：
+
+1. 数据库迁移和元数据迁移必须同时维护，迁移流程复杂。
+2. 新增字段后需要手工刷新和同步，数据库不是唯一事实来源，元数据也不是唯一事实来源。
+3. 模块、实体、页面、菜单和数据源概念混杂。
+4. 配置步骤多，售后技术人员难以独立完成小功能调整。
+5. 前端依赖表名、视图名和 SQL 条件，配置容易与数据库结构失配。
+6. 配置缺少完整的版本、发布、校验和跨环境迁移机制。
+
+## 3. 业务需求、产品边界与设计目标
+
+架构回答“系统怎么建设”，业务需求回答“系统需要建设什么”。在继续设计数据库和元数据之前，需要选择真实业务，从开始到结束梳理完整流程。
+
+例如一票海运出口可能经历：
+
+```text
+客户询价
+-> 报价
+-> 接单
+-> 向船公司订舱
+-> 收到订舱确认
+-> 安排拖车和报关
+-> 装船
+-> 制作提单
+-> 录入应收应付
+-> 开票和收付款
+-> 业务归档
+```
+
+对每一个流程步骤都需要确认：
+
+1. 谁执行该步骤。
+2. 输入什么数据和文件。
+3. 产生或修改哪些实体。
+4. 状态如何变化。
+5. 哪些条件允许或禁止执行。
+6. 会触发哪些通知、任务、费用或后续流程。
+7. 失败、退回、取消和重新打开时如何处理。
+
+除正常流程外，需要重点收集异常场景，例如改单、退单、拆单、并单、船期延误、费用冲销、跨币种结算和已完成业务重新打开。ERP 的复杂度通常来自状态变化和异常流程，而不是普通字段录入。
+
+### 3.1 状态与动作
+
+业务状态不能由用户直接随意修改，应通过动作完成。例如：
+
+```text
+草稿 -> 已提交 -> 已确认 -> 已装船 -> 已完成
+            |          |
+            v          v
+          已拒绝      已取消
+```
+
+每个状态动作需要定义执行人、输入参数、前置条件、是否可撤销、审计内容，以及对费用、任务和其他实体的影响。
+
+### 3.2 ERP 横向能力
+
+以下能力通常会被多个业务模块共同使用，应作为平台能力统一考虑：
+
+- 组织、部门、岗位和人员
+- 客户、供应商和联系人
+- 国家、港口、机场、币种和计量单位
+- 业务编号和编号规则
+- 附件、文件版本、打印和模板
+- 数据修改历史和操作审计
+- 备注、评论、消息和待办
+- 导入、导出和批量处理
+- 审批和工作流
+- 定时任务和通知
+- 全局搜索、报表和统计
+- 多语言、时区、币种、汇率和税率
+- 数据归档、备份和恢复
+
+### 3.3 低代码边界
+
+售后可以配置不代表所有功能都配置化。建议将能力划分为四级：
+
+| 级别 | 能力 | 实现方式 |
+| --- | --- | --- |
+| L1 | 修改名称、顺序、显示、必填 | 售后直接配置 |
+| L2 | 新增字段、实体、关系和普通页面 | 元数据和 Schema Compiler |
+| L3 | 简单校验、公式、动作和流程 | 受限制的规则或流程设计器 |
+| L4 | 复杂业务、复杂页面和外部接口 | 开发人员编码 |
+
+复杂费用分摊、多票合并拆分、财务冲销、复杂单证生成和外部 EDI 等功能不应被强行塞入通用字段配置。低代码平台的目标是让简单需求不需要开发，而不是用配置重新发明一门难以维护的编程语言。
+
+### 3.4 推荐验证方式
+
+不要先完成整个平台再开发业务。应选择一个真实模块做纵向验证，例如海运订舱：
+
+```text
+梳理完整流程和异常流程
+-> 设计订舱、客户、船公司等实体
+-> 实现元数据和 Schema Compiler
+-> 生成通用列表和表单
+-> 实现确认、取消等业务动作
+-> 接入权限和审计
+-> 由真实用户试用
+-> 根据实际问题抽象平台能力
+```
+
+需求阶段至少应形成角色清单、业务流程、状态流转、实体关系、业务规则、权限矩阵、文件模板、报表、外部系统、异常场景和数据量预估。
+
+### 3.5 设计目标
+
+新系统的目标是：
+
+- 继续以海运、空运、财务等业务模块为中心组织系统。
+- 售后技术人员可以通过界面新增表、字段、引用关系和基础页面。
+- 修改显示名称、显示顺序和启用状态不需要数据库迁移。
+- 新增字段和实体时，由系统自动生成数据库结构变更。
+- 普通业务页面可以由通用运行时生成，复杂业务允许代码扩展。
+- IT 开发人员可以方便地增加特殊 Vue 页面、业务 Handler 和特殊 POST 接口。
+- 每次模块配置保存都生成不可变配置版本，默认可以立即生效，也可以先预览验证再激活，并支持回滚、导出、导入和跨环境迁移。
+- 菜单、动作、数据范围和配置管理权限由统一权限中心处理，字段级隐藏和脱敏作为后续扩展。
+- 菜单、页面、字段、动作、字典和主数据支持统一多语言解析与回退。
+- 技术可观测日志和客户可见的业务操作日志分层存储并可关联追踪。
+- 系统元数据具备完整业务语义，可直接供 AI 理解和调用。
+- AI 能查询数据、执行业务动作、生成配置变更和处理业务文档。
+
+## 4. 核心架构决策
+
+新系统采用以下总体方向：
+
+```text
+模块化低代码平台
+= 模块中心
++ 实体语义模型
++ 元数据中心
++ 数据库结构编译器
++ 通用数据运行时
++ 页面配置运行时
++ 业务动作与扩展机制
++ 开发扩展 SDK
++ 统一权限中心
++ 双层日志与可观测性
++ 事件中心
++ AI 工具网关
+```
+
+核心原则如下：
+
+1. 模块是业务能力边界，不是数据库表的别名。
+2. 实体是数据和字段的所有者，页面只是实体的一种展示方式。
+3. 核心业务字段使用真实数据库列，不采用全量 EAV 模型。
+4. 元数据描述目标结构，Schema Compiler 负责将目标结构落实到数据库。
+5. 普通 CRUD 由通用运行时完成，复杂业务通过动作和代码扩展实现。
+6. 配置保存时生成不可变版本；默认保存并生效，也允许候选版本验证后再激活，运行时只读取当前版本。
+7. 页面、数据、动作、报表、配置和 AI 工具使用同一个权限决策结果。
+8. 技术日志和业务日志职责分离，通过统一请求标识关联。
+9. AI 负责理解意图和提出方案，平台负责校验、编译和确定性执行。
+10. 一个租户使用一个独立业务数据库，所有客户定制继续使用同一套平台架构和扩展机制。
+
+## 5. 总体架构
+
+```text
++----------------------------------------------------------+
+|                       使用入口                           |
+|  ERP 页面 | 配置中心 | AI 助手 | 移动端 | 外部集成       |
++-----------------------------+----------------------------+
+                              |
++-----------------------------v----------------------------+
+|                    能力与工具网关                        |
+|  通用数据接口 | 特殊接口 | 业务动作 | 配置 | 报表 | 文档   |
++-----------------------------+----------------------------+
+                              |
++-----------------------------v----------------------------+
+|                      通用运行时                          |
+| 数据运行时 | 动作 | 权限 | 事件 | 业务审计 | AI 网关     |
++-----------------------------+----------------------------+
+                              |
++-----------------------------v----------------------------+
+|                 元数据中心与 Schema Compiler             |
+|  模块 | 实体 | 字段 | 关系 | 页面 | 动作 | 版本 | 变更集   |
++-----------------------------+----------------------------+
+                              |
++-----------------------------v----------------------------+
+|                       基础设施                           |
+|  业务数据库 | 文件存储 | 搜索索引 | 消息队列 | 模型服务   |
++----------------------------------------------------------+
+```
+
+系统可以先采用模块化单体，暂不为拆分微服务而增加额外复杂度。模块边界应在代码、数据库命名、事件和依赖关系中保持清晰，以便未来按实际需要拆分。
+
+## 6. 模块模型
+
+### 6.1 模块职责
+
+模块用于表达完整的业务能力和边界。例如：
+
+```text
+platform
+|- identity          用户、组织、角色
+|- master-data       客户、联系人、港口、机场、币种
+|- file              文件和附件
+|- audit             审计记录
+|- workflow          工作流
+|- reporting         报表
+
+modules
+|- ocean             海运
+|- air               空运
+|- finance           财务
+|- contract          合同
+|- crm               客户和销售
+```
+
+海运模块可以包含：
+
+```text
+ocean
+|- booking            订舱
+|- shipment           海运单
+|- container          集装箱
+|- bill-of-lading     提单
+|- sailing            船期
+```
+
+空运模块可以包含：
+
+```text
+air
+|- booking            订舱
+|- shipment           空运单
+|- mawb               主单
+|- hawb               分单
+|- flight             航班
+```
+
+海运和空运可以共享客户、地点、货物、附件、币种和费用等稳定概念，但不应为了复用而强行合并成一个包含大量类型判断的超级模块。
+
+### 6.2 模块定义
+
+每个模块拥有稳定的模块编码和依赖关系：
+
+```yaml
+key: ocean
+name: 海运
+dependencies:
+  - platform.master-data
+  - platform.file
+entities:
+  - ocean.booking
+  - ocean.shipment
+  - ocean.container
+routes:
+  - /ocean/bookings
+  - /ocean/shipments
+```
+
+模块依赖必须形成有向无环图，不能循环依赖。每个实体、动作、事件和特殊页面只能有一个所属模块；其他模块通过声明依赖后使用公开实体、查询、动作或事件，不能绕过通用运行时直接修改其他模块的数据表。
+
+跨模块访问不要求为每个领域开发 Controller。普通读写仍使用 `EntityService`，业务状态变化使用 `ActionService`，异步协作使用事件。这样既保留内部 ERP 的开发灵活性，又不会让模块边界只停留在目录名称上。
+
+模块定义可以从配置中心导出为当前快照 bundle，并进入 Git、测试和发布流程。
+
+## 7. 实体模型
+
+### 7.1 模块与实体分离
+
+模块负责组织业务能力，实体负责数据结构。例如：
+
+```text
+模块：ocean
+实体：ocean.booking
+物理表：ocean_booking
+默认列表：ocean.booking.default-list
+默认表单：ocean.booking.default-form
+```
+
+一个实体可以有多个列表、表单和详情页面。页面配置不能反过来决定实体的数据结构。
+
+### 7.2 字段的稳定标识
+
+字段必须区分技术标识和显示名称：
+
+```text
+field_key: carrier_id
+label: 船公司
+```
+
+规则如下：
+
+- `field_key` 是程序、配置、迁移和 AI 使用的稳定标识，创建后尽量不修改。
+- `label` 是显示名称，可以随时修改，不触发数据库迁移。
+- 禁用字段只修改元数据状态并从页面隐藏，默认保留数据库列和历史数据。
+- 真正修改字段技术名或类型时，必须生成显式结构迁移。
+- 删除字段默认采用先停用、后归档的方式，不直接删除数据。
+
+### 7.3 字段语义
+
+字段元数据不仅用于生成页面，还要供 AI 和自动化理解：
+
+```yaml
+key: carrier_id
+label: 船公司
+description: 承担本次海运运输的承运人
+semanticType: organization.carrier
+aliases:
+  - 承运人
+  - 船东
+  - Carrier
+dataType: reference
+referenceEntity: base.company
+required: true
+searchable: true
+writeMode: direct
+```
+
+建议字段支持以下语义属性：
+
+| 属性 | 说明 |
+| --- | --- |
+| `key` | 稳定技术标识 |
+| `label` | 当前显示名称 |
+| `description` | 业务含义 |
+| `aliases` | 中文、英文和行业别名 |
+| `semanticType` | 客户、地点、金额、重量等语义类型 |
+| `dataType` | 数据类型 |
+| `example` | 示例值 |
+| `unit` | 金额、重量、体积等单位 |
+| `required` | 是否必填 |
+| `enabled` | 是否启用 |
+| `searchable` | 是否支持查询 |
+| `writeMode` | 后端允许的写入方式 |
+| `aiHints` | AI 使用提示 |
+
+### 7.4 字段写入策略
+
+字段是否显示和后端是否允许写入是两个不同概念。实体字段使用 `writeMode` 控制后端写入；页面是否显示输入框、是否只读由 `meta_form_field` 控制，不能使用一个 `editable` 同时表达两层含义：
+
+| 模式 | 说明 | 示例 |
+| --- | --- | --- |
+| `direct` | 可以通过 `saveobjt` 普通保存 | 备注、ETD、件数 |
+| `createOnly` | 仅创建时允许写入 | 来源系统、初始业务类型 |
+| `readOnly` | 前端和普通接口只读 | 汇总金额、关联展示值 |
+| `computed` | 由公式或计算服务生成 | 毛利、计费重量 |
+| `actionOnly` | 只能通过指定业务动作修改 | 审核状态、确认时间 |
+| `system` | 仅平台内部维护 | 创建人、版本、流水状态 |
+
+`saveobjt` 必须根据 `writeMode` 拒绝不允许的字段，而不是只根据前端是否显示输入框判断。状态字段、审核人、审核时间、结算状态和作废标记通常应配置为 `actionOnly` 或 `system`。
+
+实体还需要支持保存前业务校验器。通用保存负责类型、必填和权限校验，实体校验器负责跨字段规则；涉及状态变化、跨实体事务和外部副作用的行为必须通过 `action.execute` 或特殊 Handler 完成。
+
+### 7.5 关系与主从生命周期
+
+`meta_relation` 不能只描述引用目标，还需要描述：
+
+```text
+关系类型          one-to-one、one-to-many、many-to-one、many-to-many
+所有权            引用、组合、主从
+是否必填
+删除策略          restrict、set-null、cascade、archive
+保存策略          独立保存、随主实体事务保存
+排序字段
+唯一性约束
+```
+
+客户、港口等共享主数据通常是普通引用，删除业务单不能删除客户；订舱明细、箱信息等可能属于组合关系，需要明确随主单归档或删除。`saveobjt` 的多实体事务必须按照关系元数据检查外键、所有权和删除顺序。
+
+### 7.6 删除策略
+
+不采用所有实体统一软删除。`meta_entity` 必须声明 `deletePolicy`，通用保存和动作引擎根据实体类型、引用关系和业务状态决定是否允许删除：
+
+| 策略 | 适用对象 | 行为 |
+| --- | --- | --- |
+| `restrictWhenReferenced` | 公司、客户、港口、费用类型等主数据 | 无引用时物理删除；有引用时拒绝删除，只能停用或合并 |
+| `lifecycle` | 订舱、提单、发票、结算单等业务单据 | 草稿且没有下游业务时可以删除；正式后只能取消或作废 |
+| `cascadeOwned` | 订舱明细、箱信息等主表拥有的从数据 | 删除允许删除的主表时在同一事务级联删除 |
+| `hardDelete` | 临时记录、缓存和确定不需要保留的数据 | 校验权限后直接物理删除 |
+
+`enabled = false` 表示数据仍然存在但不再允许新业务选择，不等于删除；`status = cancelled/void` 表示正式业务已经取消或作废，也不等于删除。系统不默认给所有业务表增加 `deleted` 字段，只有未来确实需要回收站和恢复能力的实体才单独采用软删除。
+
+例如删除公司时：
+
+```text
+读取 meta_relation 和数据库外键
+-> 检查海运、空运、财务、合同等引用
+-> 没有引用：物理删除
+-> 存在引用：拒绝删除并显示引用实体和数量
+-> 提供“停用”或“合并到另一家公司”动作
+```
+
+通用运行时负责在删除前生成友好提示，数据库外键使用 `restrict` 作为并发情况下的最后保护。合并主数据属于特殊动作：把允许迁移的引用改到目标记录，保存完整审计，确认原记录不再被引用后再删除或停用。
+
+## 8. 元数据中心
+
+建议将元数据拆分为明确的资源，而不是继续扩展单一模块表：
+
+| 元数据资源 | 职责 |
+| --- | --- |
+| `meta_module` | 模块、依赖、启用状态 |
+| `meta_entity` | 实体和物理表映射 |
+| `meta_field` | 字段结构和业务语义 |
+| `meta_relation` | 实体关系和引用规则 |
+| `meta_dictionary` | 固定字典和选项 |
+| `meta_query_source` | 复杂查询数据源 |
+| `meta_view` | 列表、详情等视图定义 |
+| `meta_view_field` | 列表字段、顺序、宽度和格式 |
+| `meta_form` | 表单定义 |
+| `meta_form_field` | 表单分组、控件、校验和布局 |
+| `meta_action` | 通用动作和业务动作 |
+| `meta_i18n` | 多语言资源 |
+| `meta_change_set` | 配置和结构变更集 |
+| `meta_release` | 不可变配置版本及 checksum |
+| `meta_release_resource` | 配置版本包含的资源修订快照 |
+| `meta_runtime_state` | 当前租户正在使用的 `current_release_id` |
+| `meta_release_activation` | 发布和回滚的激活历史 |
+
+关系应使用稳定的 module key、entity key 和 field key 表达。数据库内部可以使用数值或 UUID 主键，但导入、导出和 AI 工具不能依赖环境相关的内部 ID。
+
+### 8.1 多语言资源模型
+
+多语言是元数据运行时的一部分，不能只在前端写固定翻译文件。需要区分四类内容：
+
+| 类型 | 示例 | 处理方式 |
+| --- | --- | --- |
+| 系统元数据 | 模块、菜单、实体、字段、动作名称 | `meta_i18n` |
+| 字典选项 | 草稿、已确认、运输条款 | `meta_i18n` 或字典翻译表 |
+| 主数据名称 | 国家、港口、机场名称 | 实体多语言子表或翻译字段 |
+| 用户业务内容 | 备注、邮件正文、业务说明 | 默认保留原文，按需提供 AI 翻译 |
+
+多语言 key 必须由稳定技术 key 生成，不能依赖显示名称、物理字段名或环境相关 ID：
+
+```text
+module.ocean
+entity.ocean.booking
+field.ocean.booking.carrier_id
+action.ocean.booking.confirm
+dictionary.shipment_status.confirmed
+```
+
+建议的多语言资源结构：
+
+```text
+resource_key
+locale
+value
+source             手工、导入或 AI
+status             草稿、已确认
+version
+updated_at
+updated_by
+```
+
+语言回退采用确定性顺序：
+
+```text
+用户语言 zh-CN
+-> 通用语言 zh
+-> 租户默认语言
+-> 系统默认语言
+-> 元数据基础 label
+-> 稳定 key
+```
+
+页面运行时、菜单、字段、动作、字典和 Select 回显都通过统一 i18n 服务解析。运行时请求在上下文中传递 `locale`，但业务数据存储不因显示语言而改变。
+
+模块 bundle 必须携带多语言资源。售后可以补充和修改翻译，配置发布时一同生成变更集。AI 可以生成批量翻译草稿，但需要保留来源、模型版本并经过人工确认后发布。
+
+## 9. Select 与引用关系
+
+Select 选项应当是一等模型，不再要求为每一个下拉框创建数据库视图。
+
+### 9.1 固定字典
+
+用于状态、运输条款、包装类型等固定选项：
+
+```yaml
+type: dictionary
+dictionary: shipment.status
+```
+
+### 9.2 实体引用
+
+用于客户、供应商、港口、船公司等来自其他实体的数据：
+
+```yaml
+type: reference
+targetEntity: base.company
+valueField: id
+labelTemplate: "{code} - {name}"
+filter:
+  company_type: carrier
+  enabled: true
+orderBy:
+  - name asc
+multiple: false
+```
+
+通用运行时根据实体和关系元数据自动完成搜索、分页、回显和关联查询。
+
+### 9.3 复杂查询数据源
+
+复杂选项允许引用独立的查询资源：
+
+```yaml
+key: available-carriers
+sourceType: sql
+parameters:
+  - route_id
+```
+
+复杂 SQL、脚本或代码查询必须作为独立且版本化的查询资源存在，不能散落在每个表单字段配置中。
+
+## 10. 数据库存储策略
+
+### 10.1 真实列优先
+
+核心字段和售后新增的常用字段默认创建为真实数据库列，以保证：
+
+- 查询和索引性能
+- 报表和数据分析便利性
+- 数据迁移可控
+- SQL 排查方便
+- 外部系统集成清晰
+
+不建议把所有数据存成 EAV：
+
+```text
+entity_id + field_id + value
+```
+
+EAV 或 JSON 扩展字段仅用于极少查询、变化频繁、租户高度个性化的补充字段。
+
+### 10.2 表归属
+
+数据库表需要体现模块归属。可以使用 SQL schema：
+
+```text
+core.user
+master.company
+ocean.booking
+ocean.container
+air.booking
+finance.invoice
+```
+
+如果现有数据库规范不适合使用 schema，也可以使用稳定前缀：
+
+```text
+core_user
+master_company
+ocean_booking
+air_booking
+finance_invoice
+```
+
+所有新实体自动包含统一技术字段，例如：
+
+```text
+id
+created_at
+created_by
+updated_at
+updated_by
+version
+enabled
+```
+
+当前的 `orgId` 已经对应一个独立租户数据库，因此普通业务表不需要再保存 `tenant_id`。总分公司暂不纳入第一阶段，当前业务表也不统一增加 `business_org_id`。未来确实需要时，在同一个租户数据库中增加业务组织树和 `business_org_id`，它只负责总分公司数据归属，不承担租户隔离，也不改变现有数据源注入模型。
+
+业务编号与内部主键分离，由统一编号服务管理。
+
+### 10.3 一租户一数据库
+
+FMS 采用一个租户一个业务数据库的物理隔离模式。当前 `fms-api` 中的 `orgId` 就是租户路由标识，应沿用现有的数据源注入机制：
+
+```text
+登录时提交 orgId
+-> AuthService 使用该 orgId 对应的数据源验证用户
+-> JWT 保存 orgId
+-> JwtAuthFilter 将 orgId 注入 OrgContext
+-> OrgRoutingDataSource 根据 OrgContext 取得连接
+-> Service 只需注入统一 DataSource
+-> 本次请求的所有数据操作进入当前租户数据库
+```
+
+`OrgContext.requireOrgId()` 在上下文缺失时直接失败，`OrgDataSourceManager` 按 orgId 创建和缓存连接池，现有实现已经具备清晰的物理隔离边界。新系统不需要为了元数据和配置另外建设一个参与运行时的租户控制数据库。
+
+每个租户数据库本身就是一个完整、独立的运行单元：
+
+```text
+租户数据库
+|- 业务数据
+|- 元数据和页面配置
+|- Schema 历史和 change_set
+|- 菜单、权限和多语言
+|- 业务审计和 Outbox
+|- 后台任务和集成记录
+```
+
+售后或 AI 发起配置修改时，请求已经绑定当前 `OrgContext`，Schema Compiler、元数据发布和缓存失效都只作用于当前数据库。无论修改平台通用配置还是客户定制配置，都不会改变其他租户的数据库、配置或运行状态，也不要求其他租户执行刷新、迁移或重启。
+
+元数据缓存、实体注册表和权限快照如果放在共享后端进程中，缓存 key 必须包含 `orgId`，发布时只清理当前 orgId 的缓存。后台任务、消息消费和异步线程没有 Web Filter 自动注入上下文，任务入口需要携带并设置 `orgId`，执行结束后清理 `OrgContext`；之后继续使用同一个统一 `DataSource` 即可。
+
+当前数据库连接配置可以继续由 `config/dbconfigs/{ORG}.properties` 管理。将来如果租户数量增加，可以把连接配置改为配置服务或密钥服务，但这只是数据源配置来源的变化，不改变一租户一库和请求级注入模型。
+
+这里的“通用配置”是指所有租户使用同一种元数据结构、配置界面和运行时能力，不是指所有租户共同读取一条全局配置。通用字段、页面、Select 或权限模板一旦安装到某个租户，就成为该租户数据库中的配置；对它的修改仍然只影响当前租户。
+
+页面运行时、查询运行时、保存运行时、权限引擎和 AI 工具都是读取“当前数据源中的当前配置”的通用组件。修改某个租户配置时，不需要修改或重新注册这些组件；下一次处理该租户请求时，它们使用该租户的新 `current_release_id` 即可。只有新增 Java Handler、Vue 专用组件或新的底层平台能力时才涉及代码部署。
+
+### 10.4 客户定制不分叉架构
+
+客户定制必须继续使用同一套模块、实体、字段、页面、动作、权限、Schema Compiler 和扩展 SDK，不允许为单个客户复制并长期维护另一套平台架构。
+
+推荐配置层次：
+
+```text
+module bundle 作为安装或升级输入
+-> 当前租户数据库中的完整活动配置
+-> 用户个人偏好
+```
+
+运行时只读取当前租户数据库，不需要跨租户合并配置，也不需要依赖其他租户的版本。为了后续升级能够识别平台资源和客户定制，租户新增或修改的实体、字段、页面和动作仍应使用稳定 key，并标记来源：
+
+```text
+origin              platform 或 tenant
+```
+
+导入 module bundle 时，只把 bundle 当前快照与当前租户配置做双向差异比较，不维护旧平台定义和新平台定义。存在以下冲突时，停止当前导入并让技术人员选择保留本地、采用导入内容、重命名或跳过：
+
+- 相同稳定 key 的字段类型或资源类型不同。
+- 导入内容要求删除当前仍被依赖的字段或页面。
+- 特殊页面或 Handler 依赖的实体、字段或动作不存在。
+- 导入内容与当前租户定制使用了相同 key，但定义不同。
+
+客户定制可以包含配置、特殊页面和特殊 Handler，但交付物仍然是标准 module bundle 或 extension bundle，并通过统一发布机制安装到目标租户。
+
+## 11. Schema Compiler
+
+Schema Compiler 是新架构的关键组件，用于把实体元数据转换成实际数据库结构。
+
+```text
+当前数据库结构
++ 目标实体元数据
+        |
+        v
+结构差异分析
+        |
+        v
+迁移计划和影响预览
+        |
+        v
+执行 DDL
+        |
+        v
+生成配置 release 并更新运行时缓存
+```
+
+Schema Compiler 应支持：
+
+- 创建实体和物理表
+- 新增字段
+- 修改字段类型和长度
+- 新增索引和唯一约束
+- 创建引用关系和外键
+- 生成默认列表、表单和查询配置
+- 识别数据库结构与元数据之间的漂移
+- 生成可导出、可审查的迁移脚本
+- 记录执行状态、错误和校验结果
+
+外部工具直接修改数据库后，可以提供结构对账和导入功能，但正常操作应始终从元数据配置中心发起，不需要人工点击“拉取字段”或“刷新字段”。
+
+### 11.1 不可变配置版本
+
+每次保存配置都创建一个新的 `meta_release`，版本包含的配置内容不可变，旧版本不覆盖、不修改。租户数据库通过 `meta_runtime_state.current_release_id` 指向当前版本，普通页面、通用数据运行时、权限和 AI 工具始终读取它。
+
+```text
+meta_release
+release_id
+release_no              当前租户内递增编号
+change_set_id
+checksum
+created_at
+created_by
+
+meta_runtime_state
+current_release_id
+
+meta_release_activation
+activation_id
+release_id
+previous_release_id
+reason                   PUBLISH 或 ROLLBACK
+activated_at
+activated_by
+```
+
+界面显示的 `CANDIDATE`、`CURRENT`、`HISTORY` 和 `FAILED` 状态由校验结果、当前指针和激活记录得出，不通过修改历史版本内容实现。
+
+配置界面提供两种保存方式：
+
+```text
+保存并生效
+-> 创建新版本
+-> 校验
+-> 激活为 CURRENT
+
+保存候选版本
+-> 创建 CANDIDATE
+-> 预览或测试
+-> 确认后激活为 CURRENT
+```
+
+不需要再额外定义“测试版本”和“正式版本”两套类型。同一个候选版本验证通过后直接激活；被替换的版本自然成为历史版本。运行时绝不能读取正在编辑、尚未验证或执行失败的版本。
+
+元数据可以采用“资源修订 + 发布快照”存储：每个资源修订不可变，`meta_release_resource` 记录某个 release 使用哪些实体、字段、页面、动作和权限修订。发布时只原子切换 `current_release_id`，避免复制全部元数据，也避免草稿修改污染当前配置。
+
+一个 release 表示当前租户整套配置的一致快照，不只是某一个模块。一次 change_set 可以只修改海运模块，但新 release 会继续引用其他模块原来的资源修订，从而避免模块之间出现半新半旧的组合。
+
+### 11.2 Schema 变更执行状态
+
+普通名称、布局、菜单和多语言变更只涉及元数据，可以快速创建并激活版本。新增表、字段或修改类型时，需要先完成 Schema 变更：
+
+```text
+VALIDATING
+-> PREPARING
+-> APPLYING
+-> VERIFYING
+-> SUCCEEDED
+
+任意阶段失败 -> FAILED -> 修复后 RESUMING
+```
+
+执行机制必须满足：
+
+- 当前租户数据库同一时间只能有一个结构变更任务，锁记录直接保存在该数据库中；其他租户不受影响。
+- 每一个迁移步骤记录开始时间、结束时间、checksum 和执行结果。
+- 重启或网络中断后可以从最后一个已确认步骤继续执行。
+- DDL、数据转换和结构校验全部成功后，才能把对应配置版本设为 `CURRENT`。
+- DDL 成功但配置激活失败时保持原当前版本，并进入可修复状态。
+- 激活后只失效当前 `orgId` 的元数据、实体注册和权限缓存。多个后端节点如果都可能服务该 orgId，应加载同一个 `current_release_id`。
+- 完成后重新执行数据库结构对账，确认物理结构可以支持当前配置。
+
+### 11.3 破坏性变更
+
+删除字段、缩短长度、改变类型和修改唯一约束不能直接一步完成。推荐采用 expand-contract：
+
+```text
+新增兼容结构
+-> 双写或分批迁移数据
+-> 校验新旧数据
+-> 激活对应配置 release
+-> 停止写入旧结构
+-> 经过保留期后归档或删除旧结构
+```
+
+类型变更发布前必须扫描不能转换的数据并生成错误清单。大表 DDL 需要评估锁表时间，并支持后台迁移、进度查询、暂停和取消。
+
+### 11.4 资源依赖图
+
+平台需要维护稳定 key 之间的依赖关系：
+
+```text
+字段
+<- 列表、表单和查询
+<- Select 和实体关系
+<- 注册 SQL 和报表
+<- 权限和业务审计
+<- 特殊 Vue 页面
+<- Java Handler
+<- AI 工具和文档抽取模板
+```
+
+特殊页面、Handler、注册查询和报表在 manifest 中声明所需字段、动作和最低平台 API 兼容要求。核心资源可以标记：
+
+```text
+protected
+requiredByCode
+deprecatedSince
+removableAfterVersion
+```
+
+禁用、改名、改类型或删除资源之前必须执行依赖分析。存在不兼容依赖时停止发布并生成处理清单，不能仅依靠运行时报错发现问题。
+
+## 12. 售后技术人员的配置流程
+
+### 12.1 新增字段
+
+```text
+选择模块和实体
+-> 填写字段编码、名称、类型和引用
+-> 系统生成结构差异
+-> 自动生成默认列表、表单和查询配置
+-> 预览变更
+-> 发布
+```
+
+### 12.2 修改名称
+
+仅修改字段 `label` 或多语言资源，不修改物理字段名，不产生数据库迁移。
+
+### 12.3 禁用字段
+
+设置 `enabled = false`，通用页面和普通数据接口默认忽略该字段，数据库中的历史数据继续保留。
+
+### 12.4 新增实体和表
+
+技术人员通过实体设计器创建实体并定义字段，系统自动完成：
+
+1. 创建物理表和标准技术字段。
+2. 创建索引和引用关系。
+3. 生成默认列表页。
+4. 生成默认编辑表单。
+5. 生成默认查询条件。
+6. 注册菜单和基础操作。
+7. 生成模块变更集。
+
+### 12.5 修改字段类型与删除字段
+
+使用平台已经支持的字段类型时，新增字段、调整长度或精度、改变字段类型、停用字段和删除字段都不需要开发新代码，也不需要部署或重启后端，但其中一部分需要由 Schema Compiler 执行数据库迁移。
+
+应区分三类操作：
+
+| 操作 | 是否需要 DDL | 是否需要部署或重启 |
+| --- | --- | --- |
+| 修改显示名称、多语言、页面布局 | 否 | 否 |
+| 新增字段、调整已有类型、改变长度或精度 | 通常需要 | 否 |
+| 停用字段 | 否，默认保留物理列 | 否 |
+| 最终物理删除字段 | 需要，并经过依赖分析和保留期 | 否 |
+| 引入平台从未支持的底层类型或映射能力 | 需要 | 需要发布平台代码 |
+
+例如把已有的 `varchar(50)` 扩大到 `varchar(200)`，或把平台已支持的整数字段迁移为 decimal，属于配置发布和数据库迁移，不属于增加代码能力。变更前仍需完成数据可转换检查、依赖分析、备份检查和影响预览。缩短长度、改变精度或物理删除字段应采用第 11.3 节的渐进式迁移，不能因为“不需要重启”就直接执行危险 DDL。
+
+## 13. 通用数据运行时
+
+内部 ERP 以灵活性和开发效率为优先。后端保留少量、稳定、全部使用 POST 的通用能力接口，不为海运订舱、空运单、客户等每个普通实体新增 Controller 和 URL。
+
+```text
+POST /data/loaddata
+POST /data/page
+POST /data/saveobjt
+POST /data/runquery
+POST /data/loaddatabysql
+POST /action/execute
+POST /metadata/publish
+```
+
+这些接口表达稳定的技术能力，而不是具体业务。新增一百个普通实体也不需要增加后端接口。
+
+### 13.1 通用查询协议
+
+`loaddata` 和 `page` 保留，并共用一个底层 `EntityQueryEngine`。查询目标优先使用实体 key，不强制要求先创建数据库视图：
+
+```json
+{
+  "requestId": "01J...",
+  "entity": "ocean.booking",
+  "fields": ["booking_no", "customer_id", "etd", "status"],
+  "filter": {
+    "status": { "in": ["draft", "confirmed"] },
+    "etd": { "gte": "2026-08-01" }
+  },
+  "sort": ["etd desc"],
+  "pageNo": 1,
+  "pageSize": 50,
+  "context": {
+    "locale": "zh-CN"
+  }
+}
+```
+
+两者的职责如下：
+
+```text
+loaddata -> 返回符合条件的数据，可用于小数据集和下拉引用
+page     -> 返回当前页、总数、页码和分页大小
+```
+
+前端、AI 和外部集成优先使用结构化条件，不拼接 SQL。物理表名、列名和数据库方言由实体元数据及查询引擎映射。
+
+复杂查询分为两类：
+
+- `runquery`：执行已经注册并版本化的查询资源，只传 query key 和参数。
+- `loaddatabysql`：执行临时只读 SQL，供 IT、售后查询工具、迁移工具和高级报表使用。
+
+注册查询示例：
+
+```json
+{
+  "query": "ocean.available-carriers",
+  "parameters": {
+    "route_id": "..."
+  }
+}
+```
+
+`loaddatabysql` 可以保留，因为它对内部 ERP 的开发、售后排查和迁移非常方便，但普通页面和 AI 不应默认依赖任意 SQL。系统应记录 SQL、参数、执行人、耗时和结果数量，便于定位问题和迁移引用。
+
+`loaddatabysql` 必须始终使用当前 `OrgContext` 注入的租户数据库，并使用该数据库对应的只读连接。该接口还需要配置：
+
+- 最大执行时间和最大返回行数
+- SQL 参数化和结果分页
+- 查询取消
+- 并发数限制
+- 禁止写操作和多语句执行
+- 完整技术审计
+
+任意 SQL 无法可靠自动追加实体数据权限，因此它只能作为 IT 技术工具使用。普通业务页面、报表和 AI 应使用 `loaddata`、`page` 或声明了关联实体、输出字段和权限策略的 `runquery`。
+
+### 13.2 通用保存协议
+
+`saveobjt` 保留，并支持在一个事务内处理一个或多个实体的新增、修改和删除：
+
+```json
+{
+  "atomic": true,
+  "changes": [
+    {
+      "entity": "ocean.booking",
+      "inserts": [],
+      "updates": [
+        {
+          "id": "...",
+          "version": 3,
+          "values": {
+            "carrier_id": "...",
+            "etd": "2026-08-20"
+          }
+        }
+      ],
+      "deletes": []
+    }
+  ]
+}
+```
+
+通用运行时根据当前已发布的元数据完成：
+
+- 字段解析和类型转换
+- 默认值
+- 必填和格式校验
+- 字段 `writeMode` 和实体业务校验
+- 引用关系查询
+- 分页、筛选和排序
+- 列表和表单数据装配
+- 自动编号
+- 权限和数据范围合并
+- 多语言元数据解析
+- 乐观锁和事务
+- 操作与字段变更记录
+- 批量新增、修改和按 `deletePolicy` 删除
+
+`saveobjt` 不允许直接写入 `actionOnly`、`computed` 和 `system` 字段。业务状态变化必须通过动作引擎执行，从而统一应用前置条件、权限、审计和事件。
+
+`saveobjt` 收到删除请求时必须读取实体删除策略并检查全部引用。`lifecycle` 实体只有满足“草稿、无下游引用”等配置条件时才允许删除；否则要求调用取消、作废或合并等业务动作。数据库外键冲突需要转换为客户能够理解的引用清单，不能直接返回 SQL 异常。
+
+### 13.3 请求幂等与安全重试
+
+网络超时并不代表服务器没有执行成功。所有可能产生副作用的请求，包括 `saveobjt`、`action.execute`、导入、外部回调和特殊接口，都应支持 `idempotencyKey`：
+
+```json
+{
+  "requestId": "01J...",
+  "idempotencyKey": "ocean.booking.confirm:123:version-3",
+  "action": "ocean.booking.confirm",
+  "payload": {
+    "bookingId": "123"
+  }
+}
+```
+
+平台以以下组合作为唯一键：
+
+```text
+operation/action_key + idempotency_key
+```
+
+租户数据库本身已经是隔离边界，因此幂等表不需要再把租户标识放入唯一键。第一次请求在当前数据库中保存请求摘要、执行状态和结果。相同 key、相同参数再次提交时返回第一次结果；相同 key、不同参数时返回幂等冲突。业务数据、幂等记录、业务审计和 Outbox 事件必须在同一个租户数据库事务中提交；外部调用通过提交后的 Outbox 消费执行，技术日志由日志框架独立输出。
+
+普通新增还应支持客户端预生成稳定 ID 或业务唯一键，并由数据库唯一约束作为最后一道重复保护。乐观锁解决并发修改，幂等 key 解决重复执行，两者不能互相替代。
+
+### 13.4 对外简单，对内分层
+
+通用 POST 接口数量少，不代表所有逻辑堆在一个数据服务中。建议内部按能力分层：
+
+```text
+DataController
+|- LoadDataService
+|- PageDataService
+|- SaveObjectService
+|- RegisteredQueryService
+|- RawSqlQueryService
+
+ActionController
+|- ActionDispatcher
+|- ConfiguredActionHandler
+|- CustomActionHandler
+
+MetadataController
+|- MetadataPublishService
+```
+
+这样对外接口始终稳定，对内每种技术能力仍然可以独立测试、维护和扩展。
+
+### 13.5 热发布与重启边界
+
+下列变更通过配置 release、Schema 迁移、发布事件和缓存失效，在激活完成后生效；它们不需要新增接口，也不需要重启后端：
+
+- 新增实体和物理表
+- 新增、改名、禁用和删除字段
+- 在平台已有类型范围内修改字段类型、长度和精度
+- 新增字典和 Select 引用
+- 调整列表、表单和查询
+- 新增普通 CRUD 页面
+- 新增配置型校验、公式和动作
+- 修改菜单、权限和多语言资源
+
+激活后，运行时只为当前 `orgId` 加载新的 `current_release_id`，更新对应的实体注册表、字段解析器和权限快照，其他租户缓存不发生变化。
+
+真正增加以下代码能力时仍然需要部署新版本，除非未来专门建设动态插件或脚本运行环境：
+
+- 新的 Java Handler
+- 平台从未支持的底层 SQL 类型、数据库方言、自定义序列化方式或查询运算符
+- 新的复杂算法
+- 新的外部系统协议
+- 新的专用 Vue 组件或复杂页面
+
+为了减少部署，可以为 L3 能力提供受限制的规则 DSL、公式引擎、流程设计器或脚本沙箱，但不应为了完全避免重启而把所有复杂业务逻辑变成任意动态脚本。
+
+### 13.6 通用响应
+
+所有通用接口和特殊接口使用统一响应格式：
+
+```json
+{
+  "requestId": "01J...",
+  "success": true,
+  "code": "OK",
+  "message": "",
+  "data": {},
+  "meta": {
+    "configRelease": 42
+  }
+}
+```
+
+错误码、校验错误、权限拒绝、乐观锁冲突和配置 release 不一致都应结构化返回，避免前端依赖后端异常字符串。
+
+## 14. 页面运行时
+
+页面运行时根据实体、列表和表单元数据生成通用页面。
+
+适合配置生成的页面包括：
+
+- 基础资料维护
+- 客户和联系人
+- 字典和分类
+- 普通业务数据列表
+- 简单主表编辑
+- 通用查询和导出
+
+复杂页面仍由开发人员编写 Vue 组件，例如：
+
+- 海运工作台
+- 订舱操作台
+- 多箱、多提单联动编辑
+- 费用结算
+- 拖拽式单证编排
+
+复杂页面仍然使用相同的实体、字段、引用、动作和通用数据能力，不应建立另一套数据定义。
+
+### 14.1 通用页面与特殊页面双轨运行
+
+页面开发分为两条路径：
+
+```text
+普通页面
+-> 售后配置实体、列表和表单
+-> 页面运行时动态生成
+-> 配置发布后即时生效
+
+特殊页面
+-> IT 开发 Vue 组件
+-> 使用通用数据接口和特殊业务接口
+-> 通过模块 manifest 注册
+-> 随前端版本部署
+```
+
+特殊页面适合海运工作台、多箱多提单联动、费用结算、拖拽编排和高交互批量操作。不能为了追求完全配置化而降低开发人员实现复杂页面的效率。
+
+### 14.2 特殊页面注册
+
+特殊页面仍然注册到模块元数据中：
+
+```yaml
+pages:
+  - key: ocean.booking.workbench
+    nameKey: page.ocean.booking.workbench
+    component: OceanBookingWorkbench
+    route: /ocean/booking-workbench
+    permission: ocean.booking.workbench
+    entities:
+      - ocean.booking
+      - ocean.container
+    actions:
+      - ocean.booking.split
+      - ocean.booking.confirm
+```
+
+这样特殊页面与通用页面共享菜单、路由、权限、多语言、审计、动作和 AI 语义，不形成第二套孤立体系。
+
+## 15. 业务动作与代码扩展
+
+通用 CRUD 无法表达确认订舱、审核费用、作废提单等业务行为，因此动作必须是一等资源。
+
+```yaml
+key: ocean.booking.confirm
+name: 确认订舱
+entity: ocean.booking
+inputSchema:
+  bookingId: id
+  confirmedAt: datetime
+preconditions:
+  - status == draft
+result:
+  status: confirmed
+handler: OceanBookingConfirmHandler
+```
+
+系统提供标准扩展点：
+
+```text
+beforeCreate
+afterCreate
+beforeUpdate
+afterUpdate
+beforeDelete
+afterDelete
+validate
+calculate
+beforeAction
+afterAction
+```
+
+简单动作可以通过规则配置，复杂动作由开发人员实现 Handler。开发人员提供能力，售后技术人员组合和配置能力。
+
+### 15.1 特殊接口
+
+通用接口负责普通查询和保存，以下情况允许 IT 开发特殊 POST 接口：
+
+- 跨多个实体的复杂事务
+- 拆单、并单、冲销和复杂费用计算
+- 长时间运行的批处理任务
+- 特殊报表和性能优化查询
+- 文件生成、打印和流式处理
+- 船公司、海关、财务等外部系统集成
+
+特殊接口可以采用明确的业务路径：
+
+```text
+POST /ocean/booking/split
+POST /ocean/shipment/merge
+POST /finance/settlement/recalculate
+POST /integration/carrier/sync
+```
+
+也可以注册到统一动作入口：
+
+```json
+{
+  "action": "ocean.booking.split",
+  "payload": {
+    "bookingId": "...",
+    "items": []
+  }
+}
+```
+
+特殊接口必须注册 action key、输入输出 Schema、权限、业务说明、多语言名称和审计策略。这样前端、AI 和运维工具都能理解并调用同一能力。
+
+### 15.2 开发扩展 SDK
+
+平台应为特殊页面和特殊接口提供统一 SDK，避免开发人员每次重复处理基础能力：
+
+```text
+EntityService
+QueryService
+SaveService
+ActionService
+PermissionService
+I18nService
+FileService
+AuditService
+EventService
+```
+
+特殊 Handler 只处理真正的业务逻辑：
+
+```java
+@FmsAction("ocean.booking.split")
+public class SplitBookingHandler {
+    public ActionResult execute(SplitBookingCommand command) {
+        // 只实现拆单规则，事务、权限、审计和事件由平台统一处理。
+    }
+}
+```
+
+平台统一完成参数解析、事务、权限和数据范围、多语言错误、审计、事件、统一响应，以及 AI 工具描述注册。
+
+### 15.3 部署边界
+
+配置型实体、字段、页面、规则和动作可以热发布。新增 Vue 特殊页面、Java Handler、特殊接口或外部系统协议属于新增代码，需要进行前端或后端部署。
+
+可以通过滚动发布降低停机影响。初期不建议为了避免后端重启而建设复杂的 Java 动态插件 ClassLoader；只有在模块需要独立交付和频繁热插拔时再评估插件化。
+
+## 16. 统一权限中心
+
+权限是通用运行时的横切能力，不能由菜单、页面、后端接口和 AI 分别维护。新系统采用以下组合模型：
+
+```text
+统一权限中心
+= RBAC 功能授权
++ ABAC 数据策略
++ 配置管理权限
++ AI 工具权限
+```
+
+即：角色负责授予用户可以使用哪些功能，数据策略决定用户可以操作哪些记录，配置权限决定谁能修改实体、页面、权限和 Schema。字段级隐藏和脱敏暂不作为第一阶段要求。
+
+### 16.1 权限主体
+
+权限主体应支持：
+
+```text
+用户
+角色
+部门
+岗位
+用户组
+```
+
+用户可以通过多个角色、部门和岗位关系获得权限。权限规则应使用稳定业务 key 表达，不能依赖不同环境中不稳定的数据库内部 ID。
+
+### 16.2 权限资源
+
+权限资源与前述元数据模型直接关联：
+
+| 资源 | 示例 |
+| --- | --- |
+| 模块 | `ocean` |
+| 页面/视图 | `ocean.booking.default-list` |
+| 实体 | `ocean.booking` |
+| 动作 | `ocean.booking.confirm` |
+| 字段 | `ocean.booking.cost_price` |
+| 配置能力 | `platform.metadata.publish` |
+| AI 工具 | `data.query`、`action.execute` |
+
+### 16.3 页面与菜单权限
+
+页面访问权限控制用户能否进入页面。菜单显示应尽量从页面访问权限推导，而不是再维护一套容易冲突的菜单授权：
+
+- 用户拥有页面访问权限时，该页面菜单才可以显示。
+- 父菜单下至少有一个可访问子页面时，父菜单才显示。
+- 页面可以单独配置 `visible = false`，表示允许通过链接访问但不显示在菜单中。
+- 菜单只是页面和模块的导航表现，不是最终权限判断点。
+
+建议的页面权限 key：
+
+```text
+ocean.booking.view
+ocean.shipment.view
+finance.invoice.view
+```
+
+### 16.4 按钮与动作权限
+
+按钮权限不单独创造一套按钮编码，而是直接绑定 `meta_action`：
+
+```text
+ocean.booking.create
+ocean.booking.update
+ocean.booking.delete
+ocean.booking.confirm
+ocean.booking.cancel
+ocean.booking.export
+```
+
+前端根据动作权限显示或禁用按钮，通用数据运行时和动作引擎必须再次检查同一个 action key。
+
+权限与业务前置条件必须分开：
+
+```text
+权限：用户是否拥有 ocean.booking.confirm
+前置条件：当前订舱是否处于 draft 状态
+```
+
+用户拥有权限但业务状态不满足时，动作仍然不能执行。
+
+### 16.5 数据权限
+
+数据权限决定用户可以访问实体中的哪些记录。系统应内置常用数据范围：
+
+```text
+全部数据
+当前部门
+当前部门及下级部门
+本人创建
+本人负责
+指定业务团队
+指定客户范围
+自定义条件
+```
+
+数据策略使用结构化表达式，不直接保存散落的 SQL：
+
+```yaml
+key: ocean.booking.sales-scope
+entity: ocean.booking
+actions:
+  - view
+  - update
+scope:
+  any:
+    - owner_id == currentUser.id
+    - sales_department_id in currentUser.departmentTree
+    - customer_id in currentUser.authorizedCustomers
+```
+
+权限中心将数据策略编译为通用查询运行时可以理解的过滤树。实际查询等价于：
+
+```text
+用户提交的查询条件
+AND
+系统生成的数据权限条件
+```
+
+同一数据权限必须应用于：
+
+- 列表和详情查询
+- 新增、修改和删除
+- 批量操作
+- 导入和导出
+- 报表和统计
+- 后台任务
+- AI 数据查询和动作执行
+
+数据权限不能只在前端列表中处理，也不能只限制查询而放过更新和删除。
+
+未来启用总分公司后，再增加独立的业务组织范围，例如当前分公司、分公司及下级、指定分公司和全部分公司。默认策略应把查看范围和修改范围分开：总公司可以查看汇总，但不自动获得修改分公司数据的权限。该扩展使用 `business_org_id`，不能与用于选择租户数据库的 `orgId/OrgContext` 混为一谈。
+
+### 16.6 字段显示与写入边界
+
+第一阶段不建设复杂的字段隐藏和脱敏权限。列表、表单是否显示某字段以及是否渲染为只读，由页面配置决定；后端是否允许写入由实体字段的 `writeMode` 决定。
+
+```text
+页面显示或只读       -> meta_view_field / meta_form_field
+后端允许普通写入     -> meta_field.writeMode
+状态变化和受控字段   -> action.execute
+```
+
+页面配置只是交互表现，不能把 `actionOnly`、`computed` 或 `system` 字段变成可写。以后出现采购底价、证件号等确实需要按角色隐藏或脱敏的字段时，再在统一权限中心增加可选字段策略，并让页面、数据 API、导出、报表和 AI 使用同一个策略；当前架构不预先实现这部分复杂度。
+
+### 16.7 配置管理权限
+
+售后配置能力需要与普通业务权限分离。建议至少包含：
+
+```text
+platform.metadata.view
+platform.metadata.edit
+platform.entity.create
+platform.field.create
+platform.schema.preview
+platform.schema.publish
+platform.permission.edit
+platform.permission.publish
+platform.ai.configure
+```
+
+例如，某个售后人员可以修改字段显示名称和布局，但不一定拥有发布数据库结构变更或权限策略的能力。
+
+配置中心和 AI 配置助手生成的变更集，在预览、发布时都需要检查对应的配置管理权限。
+
+### 16.8 权限合并规则
+
+多个角色和策略叠加时必须采用固定、可解释的规则：
+
+- 多个角色的功能权限取并集。
+- 显式禁止优先于普通允许。
+- 数据范围在系统强制边界内取允许范围并集。
+- 用户级特殊策略优先于角色普通策略。
+- 系统保留字段和强制数据边界不能被普通配置覆盖。
+
+权限中心应提供“权限解释”能力，能够说明某个用户为什么可以或不可以访问某个页面、动作或数据范围。
+
+### 16.9 权限快照与缓存
+
+权限中心可以为用户生成已编译的权限快照：
+
+```json
+{
+  "actions": [
+    "ocean.booking.view",
+    "ocean.booking.confirm"
+  ],
+  "dataPolicies": {
+    "ocean.booking": ["department-tree", "owner"]
+  }
+}
+```
+
+前端使用快照控制菜单和按钮，后端运行时使用已编译策略控制数据范围。权限发生变化时发布权限失效事件，清除相关用户、角色和部门的缓存。
+
+### 16.10 权限元数据
+
+建议建立以下权限资源：
+
+| 权限资源 | 职责 |
+| --- | --- |
+| `auth_role` | 角色定义 |
+| `auth_user_role` | 用户角色关系 |
+| `auth_permission` | 页面、实体和动作权限定义 |
+| `auth_role_permission` | 角色功能授权 |
+| `auth_data_policy` | 数据范围策略 |
+| `auth_role_data_policy` | 角色数据策略关系 |
+| `auth_permission_snapshot` | 可选的编译缓存 |
+
+权限定义、角色模板和数据策略应包含在模块 bundle 中，通过稳定 key 跨环境迁移。具体用户与角色的分配属于环境或租户数据，不应随模块定义覆盖。
+
+### 16.11 AI 权限继承
+
+AI Gateway 必须继承发起用户的身份和权限上下文：
+
+```text
+用户发起 AI 请求
+-> AI Gateway 获取用户权限快照
+-> 根据动作权限生成可用工具
+-> 查询工具自动追加数据权限
+-> 动作工具再次检查动作权限和业务前置条件
+```
+
+用户没有 `finance.invoice.approve` 时，AI 不应获得对应动作工具；用户只能查看自己负责的订舱时，AI 查询也只能得到相同范围的数据。
+
+AI 可以帮助生成角色和数据范围候选配置，但权限生效仍通过配置 release、校验和确认流程完成。
+
+### 16.12 权限审计
+
+权限中心应记录：
+
+- 角色和策略的创建、修改和发布
+- 用户角色变更
+- 权限拒绝及其原因
+- 高影响动作的执行人和来源
+- AI 代表用户执行的工具和动作
+- 数据导出、批量修改和配置发布
+
+审计记录需要保留用户、角色、权限快照版本、动作参数、结果和关联变更集，确保问题可以回溯。
+
+## 17. 配置版本、生效与回滚
+
+每次配置保存都生成不可变 release 和 `change_set`。默认操作是“保存并生效”，因此日常修改名称、布局、Select 和普通规则不需要额外发布步骤；需要先给用户验证时，选择“保存候选版本”。
+
+```text
+编辑配置
+-> 生成 change_set 和候选 release
+-> 校验与结构差异分析
+-> 可选预览或用户测试
+-> 激活 release
+-> 原子切换 current_release_id
+-> 清除当前 orgId 的运行时缓存
+```
+
+`change_set` 至少包含：
+
+- 变更资源和稳定 key
+- 修改前后内容
+- 生成的 DDL 和数据转换计划
+- 操作人、时间和原因
+- 校验及依赖分析结果
+- 执行状态和结果
+- 变更 checksum
+
+`POST /metadata/publish` 继续作为唯一配置写入口，通过 `operation` 支持四种稳定操作：
+
+```text
+SAVE_AND_ACTIVATE     保存新版本并立即生效，作为默认操作
+SAVE_CANDIDATE        保存候选版本但不影响普通用户
+ACTIVATE              激活已经验证的候选版本
+ROLLBACK              切换到指定历史版本
+```
+
+保存请求必须携带 `baseReleaseId`。如果当前版本已经被其他技术人员修改，平台返回配置并发冲突并展示差异，不能静默覆盖别人的配置。
+
+配置版本以当前 `OrgContext` 注入的数据库为边界。release 编号只需在当前租户库内递增；`orgId` 写入集中技术日志，便于售后定位请求。一个租户激活或回滚配置不会改变其他租户的 Schema、配置或缓存。
+
+### 17.1 预览与用户测试
+
+普通页面布局、名称、Select 和规则可以通过 `preview_release_id` 让指定用户加载候选版本，普通用户仍使用当前版本。候选预览默认只允许查询和页面验证，避免测试操作污染正式业务数据。
+
+需要验证完整保存、动作、工作流或外部接口时，应把同一个 bundle 和 checksum 安装到独立测试数据库，让用户在测试数据上验收；通过后再把完全相同的内容导入生产租户数据库。不能把“能够回滚配置”当成直接在生产数据上随意测试的替代品。
+
+### 17.2 回滚边界
+
+回滚前必须重新执行依赖和 Schema 兼容检查，然后把 `current_release_id` 指向历史版本并记录新的回滚事件。不同变更的回滚能力不同：
+
+| 变更类型 | 回滚方式 |
+| --- | --- |
+| 名称、布局、菜单、Select、多语言、普通规则 | 直接切回历史 release |
+| 新增表、字段或索引 | 切回旧配置，新增物理结构暂时保留 |
+| 扩大字段长度 | 通常可切回旧配置，物理长度不缩回 |
+| 删除字段、缩短长度、改变类型、数据转换 | 不能承诺直接回滚，需要保留旧结构、反向迁移或备份恢复 |
+| 已经产生业务副作用的动作或外部调用 | 配置回滚不能撤销业务结果，必须使用业务补偿动作 |
+
+因此删除字段和改变类型继续采用 expand-contract，并设置旧结构保留期。系统可以提供“一键回滚版本”，但只有通过兼容检查的版本才允许直接激活，不能把回滚按钮等同于数据库和业务数据的时间倒流。
+
+## 18. 模块迁移与跨环境发布
+
+模块需要支持导出为可迁移 bundle：
+
+```text
+ocean-module/
+|- manifest.yaml
+|- entities.json
+|- relations.json
+|- views.json
+|- forms.json
+|- dictionaries.json
+|- actions.json
+|- queries.json
+|- menus.json
+|- permissions.json
+|- reports.json
+|- workflows.json
+|- events.json
+|- i18n.json
+|- extensions.json
+|- ai-tools.json
+|- data-transforms/
+|- seeds/
+|- importers/
+```
+
+bundle 是某次导出的当前模块配置快照，应包含 `bundle_id`、来源 release、导出时间和整体 checksum。所有资源使用稳定业务 key，不使用环境相关的数据库内部 ID。
+
+同一个 bundle 可以安装到多个租户数据库，但每次安装都是一次独立的当前租户操作：注入目标 `OrgContext`，把 bundle 当前快照与目标配置做双向差异，执行备份检查、Schema 变更、元数据导入和结果校验，然后生成目标租户自己的新 release。不要求其他租户同时安装或保持相同 release 编号。
+
+跨环境发布流程：
+
+```text
+开发或测试环境配置
+-> 导出模块变更集
+-> checksum 和依赖校验
+-> 在目标环境生成差异和影响预览
+-> 应用结构迁移
+-> 导入元数据和种子数据
+-> 执行校验
+-> 生成候选 release
+-> 激活或保留为候选版本
+```
+
+目标租户存在定制时，不做旧版本、新版本和本地版本的三方合并。导入器只比较“bundle 当前快照”和“目标当前配置”，按资源列出新增、修改、删除和冲突。无冲突内容可以自动应用；字段类型不同、稳定 key 冲突、删除仍被依赖资源和特殊代码不兼容必须进入人工处理清单，不能静默覆盖租户定制。
+
+数据库迁移应满足：
+
+- 每次生成的迁移计划有模块、change_set 和 checksum。
+- 已经执行成功的迁移记录不可修改。
+- 支持从空库完整初始化。
+- 根据目标快照与当前数据库状态生成差异，不依赖连续旧版本链。
+- 结构迁移和数据迁移分离。
+- CI 自动测试空库安装、典型现有结构导入和回滚兼容性。
+
+## 19. 旧系统数据导入
+
+旧数据导入不应混入通用运行时和模块配置逻辑。每个模块拥有独立导入器：
+
+```text
+旧库
+-> staging 原始数据
+-> 数据清洗和映射
+-> 领域数据导入
+-> 数量与业务规则校验
+-> 对账报告
+```
+
+导入器应满足：
+
+- 可重复执行
+- 支持断点续传
+- 使用稳定业务键或外部引用去重
+- 输出无法映射和校验失败的数据
+- 保存旧系统记录与新系统记录的对应关系
+
+建议提供统一外部引用表：
+
+```text
+source_system
+source_table
+source_id
+target_entity
+target_id
+```
+
+## 20. AI 原生架构
+
+### 20.1 AI 友好的含义
+
+AI 友好不等于增加一个聊天窗口。系统必须让 AI 能够：
+
+- 理解模块、实体、字段、关系和业务术语。
+- 查询结构化业务数据。
+- 执行可描述的业务动作。
+- 创建配置候选版本。
+- 生成结构化变更集。
+- 解析提单、发票、合同和邮件附件。
+- 根据事件执行自动化任务。
+- 给出执行预览并接受人工确认。
+
+### 20.2 AI Gateway
+
+建议建立独立 AI Gateway / Agent Runtime：
+
+```text
+AI 助手
+    |
+    v
+AI Gateway
+|- 上下文装配
+|- 模型路由
+|- 工具调用
+|- 任务编排
+|- 人工确认
+|- 执行记录
+|- 结果评估
+    |
+    v
+元数据工具 / 数据工具 / 动作工具 / 配置工具 / 文档工具
+```
+
+业务模块不直接依赖具体模型 SDK。AI Gateway 通过统一 Provider 接口连接不同模型：
+
+```text
+AiProvider
+|- chat
+|- toolCall
+|- structuredOutput
+|- embedding
+|- documentVision
+|- speech
+```
+
+### 20.3 AI 工具中心
+
+建议提供以下标准工具：
+
+```text
+metadata.listModules
+metadata.describeModule
+metadata.describeEntity
+metadata.describeAction
+data.query
+data.get
+data.create
+data.update
+data.batchUpdate
+action.execute
+report.run
+document.extract
+config.proposeChange
+config.validateChange
+config.publishChange
+```
+
+工具的输入和输出使用 JSON Schema 描述。同一份定义可以生成：
+
+- 固定通用 POST 接口与特殊动作协议
+- OpenAPI 文档
+- 前端 SDK
+- AI Tool Calling 定义
+- MCP Server 接口
+
+AI 不直接修改数据库和元数据表。AI 产生结构化意图或变更集，由平台校验和执行。
+
+AI 工具不是另一套后端逻辑，而是现有通用能力的适配层：
+
+```text
+data.create / data.update / data.batchUpdate
+-> 调用与 POST /data/saveobjt 相同的 SaveService
+
+action.execute
+-> 调用与 POST /action/execute 相同的动作引擎
+
+config.proposeChange / config.publishChange
+-> 调用与配置中心相同的校验、Schema Compiler 和 release 机制
+```
+
+因此 AI 写入同样受到 `writeMode`、数据权限、业务前置条件、乐观锁、幂等、事务和业务审计约束。确认订舱、审核费用和作废发票必须调用动作，不能用 `data.update` 直接修改状态字段。文档、邮件和用户输入只是待解析数据，不能因为其中包含类似“调用工具”或“忽略规则”的文字就绕过平台校验。
+
+### 20.4 AI 配置助手
+
+例如售后输入：
+
+> 在海运订舱增加“船公司”字段，数据来源为合作伙伴中类型为承运人的公司，并加入编辑表单、列表和查询，列表宽度 180。
+
+AI 将请求转换为确定性的变更集：
+
+```json
+{
+  "changes": [
+    {
+      "type": "addField",
+      "entity": "ocean.booking",
+      "field": {
+        "key": "carrier_id",
+        "label": "船公司",
+        "dataType": "reference",
+        "targetEntity": "base.company",
+        "filter": { "company_type": "carrier" }
+      }
+    },
+    {
+      "type": "addListField",
+      "view": "ocean.booking.default-list",
+      "field": "carrier_id",
+      "width": 180
+    },
+    {
+      "type": "addQueryField",
+      "view": "ocean.booking.default-query",
+      "field": "carrier_id"
+    }
+  ]
+}
+```
+
+执行流程：
+
+```text
+AI 理解需求
+-> 读取模块和实体语义
+-> 生成候选变更集
+-> 元数据校验
+-> Schema Compiler 生成 DDL
+-> 显示影响范围
+-> 技术人员确认
+-> 执行并发布
+```
+
+### 20.5 文档智能
+
+货代 ERP 应重点建设文档处理能力：
+
+```text
+文件上传
+-> OCR
+-> 文档分类
+-> 字段抽取
+-> 实体匹配
+-> 置信度校验
+-> 人工确认
+-> 写入业务实体
+```
+
+适用文档包括：
+
+- 提单
+- 订舱确认书
+- 发票
+- 装箱单
+- 报关资料
+- 合同
+- 邮件及附件
+
+每一个抽取值都应记录：
+
+- 来源文件和页码
+- 原始文本
+- 目标实体和字段
+- 置信度
+- 使用的模型和提示词版本
+- 人工是否修正
+
+结构化 ERP 数据通过实体查询工具访问；合同、邮件和附件等非结构化内容才进入全文索引或向量检索系统。
+
+### 20.6 AI 可替换和可评估
+
+AI 能力应独立于具体供应商，模型、提示词和任务配置都需要版本化：
+
+```text
+ai_provider
+ai_model
+ai_prompt
+ai_task
+ai_execution
+ai_evaluation
+```
+
+需要持续记录和评估：
+
+- 工具调用成功率
+- 结构化输出合法率
+- 文档字段抽取准确率
+- 人工修改率
+- 配置建议通过率
+- 任务耗时和成本
+
+## 21. 事件与自动化
+
+系统应发布版本化的业务事件：
+
+```text
+ocean.booking.created
+ocean.booking.confirmed
+document.uploaded
+invoice.received
+shipment.delayed
+```
+
+事件可以触发：
+
+- 工作流
+- 通知
+- 数据同步
+- AI 文档解析
+- AI 风险分析
+- 自动生成任务
+
+建议采用事务 Outbox 保存业务事件，保证业务数据和事件的一致性。
+
+### 21.1 可靠任务执行
+
+Outbox 只保证事件不会随着业务事务丢失，后台消费者仍需要统一任务运行框架。长任务和异步动作返回 `job_id`，任务记录保存在当前租户数据库中：
+
+```text
+job_id
+job_type
+dedup_key
+status
+progress
+attempt_count
+next_run_at
+lease_owner
+lease_expires_at
+input
+result
+last_error
+```
+
+任务表位于独立租户库中，所以不需要重复保存租户字段。调度消息或 Worker 的执行入口需要携带 `orgId`，先恢复 `OrgContext` 并选中数据源，再读取和执行该租户库中的任务，最后清理上下文。
+
+任务状态建议为：
+
+```text
+PENDING -> RUNNING -> SUCCEEDED
+                 |-> RETRY_WAIT -> RUNNING
+                 |-> FAILED -> MANUAL_RETRY
+                 |-> CANCELLED
+                 |-> DEAD_LETTER
+```
+
+任务框架需要支持：
+
+- 消费幂等和 `dedup_key`
+- 指数退避重试
+- 最大重试次数和死信
+- 带租约的任务锁，Worker 异常退出后可以接管
+- 进度、暂停、取消和人工重跑
+- 执行日志和业务审计
+- 单租户并发限制，避免一个租户任务占满全部资源
+- 失败数据清单和对账报告
+
+### 21.2 外部系统集成
+
+船公司、海关、财务和 EDI 集成需要统一保存外部交互记录：
+
+```text
+integration_message
+external_reference
+webhook_delivery
+reconciliation_result
+```
+
+出站消息使用 Outbox 和幂等 key，入站回调使用外部消息 ID 去重。每个集成定义超时、重试、限流、错误映射、人工重发和对账规则。不能仅依靠技术日志判断某条业务数据是否已经被外部系统接受。
+
+### 21.3 工作流版本
+
+工作流定义必须版本化。流程实例启动时固定使用一个流程版本，后续发布的新版本默认只影响新实例。需要把运行中的实例迁移到新版本时，必须提供节点映射、条件校验和人工确认，不能自动替换。
+
+工作流至少需要处理人工任务、定时器、超时、撤回、退回、取消、补偿和重新打开，并通过业务动作调用实体和 Handler，而不是直接绕过动作修改状态字段。
+
+### 21.4 报表与大查询隔离
+
+普通列表使用租户业务库即可。大报表、复杂统计、批量导出和 AI 分析需要设置异步阈值、最大扫描量和超时；数据量增长后应支持租户只读副本、报表读模型或独立分析库，避免复杂查询阻塞在线保存事务。
+
+报表指标应使用稳定 metric key、统计口径、时间范围、币种和权限策略定义。注册 SQL 只是技术实现，不能代替业务指标定义。
+
+## 22. 双层日志与审计
+
+系统需要严格区分两类日志：
+
+```text
+技术可观测日志
+-> 给开发、运维和售后排查问题
+
+业务操作日志
+-> 给客户、业务人员和管理人员查看业务发生了什么
+```
+
+两类日志来源于同一次请求，可以通过 `request_id` 和 `trace_id` 关联，但不能混在同一张表或保存成同一种文本。
+
+| 对比项 | 技术日志 | 业务操作日志 |
+| --- | --- | --- |
+| 使用者 | 开发、运维、售后 | 客户、业务人员、管理人员 |
+| 目标 | 排查错误、性能和调用链 | 了解业务变化和责任追踪 |
+| 内容 | SQL、异常、耗时、节点和版本 | 谁在什么时候对什么做了什么 |
+| 表达 | 技术语言 | 可多语言渲染的业务语言 |
+| 存储 | 日志平台或日志文件 | 业务审计数据库 |
+| 保留时间 | 按级别和容量设置 | 通常长期保留 |
+| 修改方式 | 按日志平台策略归档和清理 | 只追加，原则上不修改 |
+
+### 22.1 统一追踪上下文
+
+每个页面请求、通用 POST 接口、特殊接口、后台任务、导入任务和 AI 工具调用都生成统一上下文：
+
+```text
+request_id
+trace_id
+org_id
+user_id
+source
+module_key
+entity_key
+action_key
+application_version
+```
+
+`source` 至少支持：
+
+```text
+WEB
+AI
+IMPORT
+SCHEDULED_JOB
+EXTERNAL_API
+SYSTEM
+```
+
+业务人员在页面上看到一条失败或成功记录时，售后可以使用 `trace_id` 找到对应的请求、SQL、外部接口和异常信息。
+
+### 22.2 技术可观测日志
+
+技术日志用于定位系统问题，主要包括：
+
+- HTTP 和通用 POST 请求日志
+- SQL、慢查询和数据库连接日志
+- 系统异常和异常堆栈
+- 外部接口请求、响应和重试日志
+- 定时任务和批处理日志
+- 文件上传、下载和转换日志
+- Schema Compiler 和配置发布日志
+- 缓存命中、缓存失效和配置 release 日志
+- AI 模型、提示词和工具调用日志
+- 性能指标、服务器节点和应用版本
+
+建议技术日志统一输出结构化 JSON，并进入 Loki、OpenSearch、Elasticsearch 或类似日志平台，不要把所有技术日志长期写入业务数据库。
+
+技术日志至少包含：
+
+```text
+timestamp
+level
+request_id
+trace_id
+org_id
+user_id
+source
+module
+operation
+entity
+action
+duration
+result
+error_code
+exception
+application_version
+server_node
+```
+
+日志级别、保留时间和采样规则应当可配置。错误、发布、外部接口失败和高影响动作应完整保留，普通成功查询可以缩短保留时间或采样。
+
+### 22.3 业务操作日志
+
+业务日志是不可变的结构化事件，不能只保存一句已经渲染好的中文。建议的数据结构：
+
+```json
+{
+  "event": "ocean.booking.confirmed",
+  "entity": "ocean.booking",
+  "entityId": "123",
+  "businessNo": "BK20260817001",
+  "operatorId": "10023",
+  "operatorName": "张三",
+  "source": "WEB",
+  "occurredAt": "2026-08-17T14:32:00+08:00",
+  "changes": [
+    {
+      "field": "status",
+      "before": "draft",
+      "after": "confirmed"
+    }
+  ],
+  "traceId": "01J...",
+  "visibility": "customer"
+}
+```
+
+业务日志至少记录：
+
+- 稳定事件 key
+- 模块、实体、记录 ID 和业务编号
+- 操作人、组织和来源
+- 动作和状态变化
+- 重要字段修改前后的值
+- 发生时间
+- 关联文件、任务或外部业务号
+- `request_id` 和 `trace_id`
+- 可见范围
+- 配置 `release_id`
+
+推荐使用以下业务审计表：
+
+```text
+audit_business_event
+audit_field_change
+```
+
+业务事件只追加不覆盖。订正错误时产生新的订正事件，而不是修改历史记录。
+
+### 22.4 客户可见时间线
+
+业务日志根据稳定事件 key 和当前语言渲染。例如同一事件：
+
+```text
+中文：张三确认了订舱 BK20260817001
+英文：Zhang San confirmed booking BK20260817001
+```
+
+翻译 key 可以采用：
+
+```text
+audit.ocean.booking.confirmed
+audit.ocean.booking.field_changed
+audit.finance.invoice.approved
+```
+
+为了保证字段改名后历史日志仍可理解，应同时保存稳定 field key、原始值以及必要的字段名称快照。显示时优先使用当前多语言资源，资源不存在时回退到快照。
+
+业务日志需要配置可见范围：
+
+```text
+customer     客户可见
+business     内部业务人员可见
+internal     仅内部管理或售后可见
+technical    仅技术日志系统可见
+```
+
+例如：
+
+- “订舱已确认”可以对客户可见。
+- “客户要求修改 ETD”可以仅业务人员可见。
+- “船公司接口自动重试 3 次”属于内部信息。
+- SQL 和异常堆栈只进入技术日志。
+
+客户可见时间线只展示有业务含义的动作、状态和重要字段变化，不能把每一次查询、缓存刷新和技术字段修改都显示出来。
+
+### 22.5 字段变更审计
+
+`saveobjt` 在运行时读取修改前后的数据，自动生成重要字段变更：
+
+```text
+ETD：2026-08-20 -> 2026-08-22
+船公司：COSCO -> EMC
+件数：100 -> 120
+```
+
+字段元数据增加审计配置：
+
+```yaml
+key: etd
+audit: true
+auditVisibility: business
+auditLabelKey: field.ocean.booking.etd
+```
+
+以下技术字段默认不进入客户时间线：
+
+```text
+updated_at
+updated_by
+version
+cache_key
+internal_status
+```
+
+对于引用字段，日志应保存引用 ID，并保存当时的显示值快照，避免关联对象改名后无法理解历史变更。
+
+### 22.6 平台自动接入日志
+
+日志不应依靠每个页面和 Handler 手工拼接。平台在以下位置统一生成：
+
+```text
+loaddata/page       -> 技术查询日志和性能指标
+saveobjt            -> 技术执行日志、字段变更和业务审计
+action.execute      -> 技术执行日志和业务动作事件
+特殊接口/Handler    -> 通过扩展 SDK 自动接入两类日志
+Schema Compiler     -> 技术日志和配置发布审计
+权限中心            -> 权限拒绝和高影响授权变更审计
+AI Gateway          -> AI 执行日志和业务动作审计
+```
+
+特殊 Handler 可以声明业务审计事件：
+
+```java
+@FmsAction("ocean.booking.split")
+@BusinessAudit("audit.ocean.booking.split")
+public class SplitBookingHandler {
+    // 只实现业务逻辑，日志上下文和审计事件由平台处理。
+}
+```
+
+### 22.7 AI 双层日志
+
+AI 同样需要生成两类日志。
+
+技术日志记录：
+
+- 模型和模型版本
+- 提示词版本
+- 工具调用和参数
+- 结构化输出
+- Token 数量、耗时和成本
+- 重试、错误和评估结果
+
+客户或业务人员看到的日志应表达为业务行为：
+
+```text
+张三通过 AI 助手从订舱确认书中提取了船名、航次和 ETD。
+张三确认并保存了 AI 提取结果。
+```
+
+AI 修改业务数据时，业务日志仍归属真实用户，并额外记录：
+
+```text
+source = AI
+ai_execution_id
+confirmed_by
+```
+
+AI 生成但未被确认、未写入业务数据的建议只进入 AI 执行日志，不应伪装成已经发生的业务事件。
+
+### 22.8 日志与事件的关系
+
+业务事件、业务审计和技术日志含义不同：
+
+- 业务事件用于驱动工作流、通知和集成。
+- 业务审计用于展示历史和责任追踪。
+- 技术日志用于排查系统运行问题。
+
+一次业务动作可以同时产生三者，并通过相同的 `trace_id` 和 `business_event_id` 关联。事务内先保存业务数据、业务审计和 Outbox 事件，技术日志由日志框架输出。
+
+## 23. ERP 基础数据规则
+
+元数据和通用接口解决的是“如何存取”，但 ERP 还必须统一定义“数据代表什么”。时间、金额、编号和文件如果由各模块自行处理，即使接口统一，最终仍会产生无法对账的数据。
+
+### 23.1 日期、时间与时区
+
+时间至少分为两种语义：
+
+| 类型 | 示例 | 存储规则 |
+| --- | --- | --- |
+| 时间点 | 创建时间、确认时间、航班实际起飞时间 | 使用 UTC 时间点存储，显示时按用户时区转换 |
+| 业务本地日期 | 开票日期、账期、ETD 日期 | 使用 `date` 保存，不做时区换算 |
+
+字段元数据需要明确 `temporalType`、精度和业务时区来源。不能仅用一个没有时区语义的字符串或 datetime 表达所有时间。当前阶段区分租户默认时区和用户显示时区；跨时区船期、航班和操作节点还应保存原始地点时区，避免只保存转换后的显示值。未来启用总分公司后再增加业务组织时区。
+
+### 23.2 金额、币种与汇率
+
+金额和数量使用确定精度的 decimal，不能使用浮点数。字段或金额对象必须明确：
+
+```text
+原币金额
+币种代码
+汇率
+汇率日期和来源
+本位币金额
+舍入规则
+```
+
+每个租户需要配置本位币。汇率在业务确认、结算或记账时形成快照，历史单据不能因为汇率表后来更新而自动改变。税额、费用合计、毛利和分摊结果应由统一金额计算组件处理，并记录计算规则版本，避免前端、报表和后端各自舍入后无法对账。未来存在多个独立核算法人时，再允许按业务组织配置本位币。
+
+### 23.3 业务编号
+
+内部主键和客户可见业务编号必须分离。编号规则应作为版本化元数据管理，支持前缀、日期、组织、业务类型和流水位数等组成部分。
+
+唯一范围需要明确，例如：
+
+```text
+entity + number_rule + period
+```
+
+租户数据库已经提供最外层唯一范围，因此编号表和唯一约束不需要再包含 tenant 字段。未来启用总分公司且各分公司独立编号时，再把 `business_org_id` 加入唯一范围。
+
+编号分配应使用数据库序列、号段或带锁的编号服务，不能通过查询 `max(number) + 1` 生成。已经正式签发的发票号、提单号等不能被修改或重复使用；作废时保留原编号和作废记录。是否允许流水号有空洞由具体编号规则决定，不能假设所有业务编号都必须连续。
+
+### 23.4 文件与附件
+
+提单、发票、合同、邮件附件和打印件不应直接作为大字段散落在业务表中。推荐由文件服务统一保存对象内容，租户数据库保存文件元数据和业务关联：
+
+```text
+file_id
+storage_key
+original_name
+content_type
+size
+checksum
+version
+scan_status
+created_by
+created_at
+```
+
+文件元数据保存在当前租户数据库中，不需要 tenant 字段；对象存储的 bucket 或路径前缀使用当前 `orgId` 隔离，这也与现有 `FileService` 的处理方式一致。文件服务还需要支持访问权限、版本、校验和、病毒扫描、上传失败清理、生命周期和保留策略。AI 文档解析必须引用不可变的文件版本；用户替换附件后创建新版本，不能让原有抽取和审计记录失去来源。
+
+### 23.5 归档、备份与恢复
+
+一租户一数据库使单个客户恢复更容易。租户数据库、对应文件存储、搜索索引和消息状态必须按依赖关系设计恢复方案：
+
+- 租户数据库支持全量备份和时间点恢复。
+- Schema 发布和大批量导入前创建可验证的恢复点。
+- 文件内容与文件元数据使用一致的保留策略，并定期检查孤立文件和缺失文件。
+- 搜索索引和报表读模型应能从业务数据库重建，不作为唯一事实来源。
+- 数据源配置文件或未来替代它的配置服务需要单独备份，确保恢复后仍能根据 `orgId` 找到数据库。
+- 恢复先在隔离环境校验数据库版本、文件引用、关键数量和业务合计，再切换正式流量。
+
+正式上线前必须由业务确定恢复目标。建议初期至少以“生产数据最多丢失 15 分钟（RPO 15 分钟）、单租户核心业务 4 小时内恢复（RTO 4 小时）”作为讨论基线，再根据成本和客户承诺调整。备份成功不等于可以恢复，必须定期执行单租户恢复演练并记录实际 RPO、RTO 和校验结果。
+
+## 24. 测试与非功能要求
+
+这套系统大量行为来自元数据，不能只测试 Java 和 Vue 代码。元数据定义、Schema 迁移、租户定制和模块 bundle 都是需要自动化验证的正式产品代码。
+
+### 24.1 自动化测试范围
+
+最低测试矩阵包括：
+
+| 范围 | 重点验证 |
+| --- | --- |
+| 元数据 | 稳定 key、类型、关系、引用、公式和依赖合法性 |
+| Schema Compiler | 空库安装、快照差异计算、失败恢复、重复执行、结构对账和回滚兼容检查 |
+| 通用运行时 | 类型转换、关系保存、`writeMode`、删除策略、乐观锁、事务和批量操作 |
+| 权限 | 菜单、动作、数据范围、导出、后台任务和 AI 使用相同决策 |
+| 数据源上下文 | 保持现有 Web 请求注入机制，并验证任务、发布和消息入口会正确设置及清理 `OrgContext` |
+| 幂等与任务 | 超时重试、重复回调、Worker 崩溃接管、死信和人工重跑 |
+| 模块兼容 | bundle 双向差异、稳定 key 冲突、特殊页面与 Handler 的 manifest 契约 |
+| 日志与审计 | 成功、失败、回滚、批量和 AI 操作都能正确关联且不泄漏技术异常 |
+| AI | 工具输入输出 Schema、权限继承、确认流程和固定样本回归评估 |
+
+每个 module bundle 的持续集成至少执行：元数据静态校验、空库安装、典型现有结构差异导入、关键业务动作、回滚兼容和依赖契约测试。生产激活前先在与目标租户结构一致的测试库演练；不能只验证一个“标准租户”，还需要选择存在典型定制的租户样本。
+
+### 24.2 性能与容量
+
+性能目标必须通过数据而不是“感觉够快”来验收。上线前按典型租户和最大租户分别确认：
+
+```text
+在线用户数和峰值并发
+主要实体的数据量和年增长量
+普通 page 查询与保存的 P95/P99 延迟
+批量导入、导出和任务吞吐量
+最大报表扫描量和完成时间
+单租户与全平台数据库连接上限
+日志、审计、Outbox 和文件的增长与保留周期
+```
+
+所有列表必须分页并限制最大页大小；导出、大报表、大文件处理和 AI 批量任务超过阈值后自动转为后台任务。压测应使用接近真实的关联关系、数据权限和字段数量，因为空表上的简单 SQL 不能代表 ERP 实际性能。
+
+### 24.3 可用性与运维
+
+平台需要统一提供健康检查、指标、告警和运行面板，至少覆盖：
+
+- 各租户数据源可用性和连接池使用率。
+- 通用接口与特殊动作的错误率和延迟。
+- Schema 变更、bundle 安装、`current_release_id` 和缓存一致性。
+- Outbox 堆积、任务延迟、重试和死信。
+- 外部系统调用成功率和对账差异。
+- 日志、数据库、文件和消息存储容量。
+- AI 调用失败率、耗时、成本和人工修正率。
+
+每项告警必须对应责任人和处置手册。配置激活、代码发布和数据库迁移都应支持停止继续放量；发生问题时优先回退应用流量或切换到兼容的历史 release，数据已经发生不可逆变化时按迁移补偿和恢复流程处理，不能承诺所有 DDL 都能一键回滚。
+
+### 24.4 契约与兼容
+
+配置 release 不依赖连续的新旧模块升级链，但特殊 Vue 页面、Java Handler 和 extension bundle 仍需要声明最低平台 API、所需实体、字段和动作。稳定 key 的废弃采用“标记废弃、停止新引用、迁移已有依赖、经过保留期后移除”的流程。
+
+每次激活或回滚至少应明确：
+
+- 当前应用代码和扩展是否支持目标 release。
+- 目标 release 需要的表、字段、动作和事件是否存在。
+- 哪些资源已经废弃或被特殊代码依赖。
+- 哪些 Schema 变更不可逆以及恢复前提。
+- bundle 与当前租户定制存在哪些稳定 key 冲突。
+
+## 25. 开发人员与售后技术人员的职责边界
+
+| 能力 | 开发人员 | 售后技术人员 |
+| --- | --- | --- |
+| 新增普通实体和表 | 提供平台能力 | 通过设计器完成 |
+| 新增普通字段 | 提供字段类型 | 通过配置完成 |
+| 修改名称和布局 | 无需参与 | 通过配置完成 |
+| 配置 Select 引用 | 提供引用运行时 | 选择目标实体和显示规则 |
+| 普通 CRUD 页面 | 提供通用页面运行时 | 配置生成 |
+| 复杂业务页面 | 编写代码 | 调整允许开放的配置 |
+| 复杂业务动作 | 编写 Handler | 绑定和配置动作 |
+| 特殊业务接口 | 使用扩展 SDK 开发 | 配置权限、菜单和参数 |
+| 权限中心 | 提供决策引擎和策略类型 | 配置角色、菜单、动作和数据范围 |
+| 双层日志 | 提供追踪、日志和审计框架 | 配置字段审计和客户可见范围 |
+| 模块迁移机制 | 提供 Compiler 和发布工具 | 导出、导入和发布变更集 |
+| AI 能力 | 提供工具和扩展点 | 使用 AI 生成配置候选版本 |
+
+总体原则：
+
+> 开发人员提供稳定能力，售后技术人员组合能力，AI 理解意图并生成方案，平台负责确定性执行。
+
+## 26. 不建议采用的方案
+
+新系统应避免以下设计：
+
+- 使用一个模块表同时表达菜单、页面、实体、数据源和权限。
+- 所有字段都采用 EAV 存储。
+- 每新增实体都必须手工创建视图。
+- 每新增字段都需要手工拉取和刷新。
+- 直接使用显示名称作为数据库字段名。
+- 在前端配置中大量保存物理表名和 SQL 片段。
+- 让复杂 SQL 散落在 Select、列表和表单配置中。
+- 为每个普通实体重复开发一套查询和保存接口。
+- Handler 绕过 `EntityService`、`ActionService` 和审计机制直接修改其他模块的数据表。
+- 强迫复杂页面和复杂业务全部通过低代码配置实现。
+- 特殊页面和接口绕开统一实体、权限、多语言、审计和动作体系。
+- 技术异常、SQL 和堆栈直接显示在客户业务时间线中。
+- 技术日志和业务日志使用同一张表或只保存不可解析的文本。
+- 依靠每个页面和 Handler 手工编写审计日志。
+- 配置修改后立即无版本地影响生产运行。
+- 所有实体不分业务含义统一软删除，或正式业务单据允许无条件物理删除。
+- 只在前端隐藏菜单或按钮，不在数据和动作运行时执行相同权限判断。
+- 为菜单、按钮、数据、报表和 AI 分别维护互不关联的权限体系。
+- AI 直接生成并执行任意 SQL。
+- 业务模块直接依赖某一个 AI 模型供应商。
+- 依赖 `max(number) + 1` 生成并发业务编号。
+- 金额使用浮点数，或历史单据随最新汇率自动变化。
+- 只做备份不做恢复演练，或承诺所有数据库变更都可自动回滚。
+- 为单个客户复制并长期维护另一套平台架构。
+
+## 27. 建议实施顺序
+
+测试、权限、审计、可观测性和租户隔离不是最后增加的阶段，而是每个阶段的完成条件。实施过程始终选择一条真实业务纵向验证，例如“基础资料 + 海运订舱 + 确认动作”，避免先花很长时间建设没有业务验证的通用平台。
+
+### 第一阶段：建立基础元数据模型
+
+- 沿用并固化现有 `orgId -> OrgContext -> OrgRoutingDataSource` 数据源注入机制。
+- 完成模块、实体、字段、关系、字典模型。
+- 建立稳定 key 规则和语义描述规范。
+- 确定真实列与扩展字段的边界。
+- 实现不可变配置 release、当前指针、候选预览、回滚和变更集。
+- 完成多语言资源、稳定 i18n key 和语言回退规则。
+- 完成权限主体、权限资源和稳定权限 key 设计。
+- 完成时间、金额、汇率、编号和文件的基础模型。
+
+### 第二阶段：建立 Schema Compiler
+
+- 支持创建实体、字段、索引和关系。
+- 支持结构差异预览、Schema 执行状态机、当前数据库变更锁和中断恢复。
+- 支持数据库结构对账。
+- 支持空库初始化和模块 bundle 导入。
+- 建立依赖图、破坏性变更保护和当前 `orgId` 的 `current_release_id` 缓存收敛。
+- 自动测试空库安装、快照差异、重复执行、失败恢复和回滚兼容。
+
+### 第三阶段：建立通用运行时
+
+- 实现通用数据查询和保存。
+- 实现 `writeMode`、乐观锁、请求幂等和数据库唯一约束。
+- 实现字典和引用字段。
+- 实现默认列表、表单和查询页面。
+- 实现运行时多语言解析、租户默认语言和用户语言切换。
+- 实现售后配置中心。
+- 实现动作和数据范围权限决策引擎。
+- 实现用户权限快照、缓存失效和权限解释。
+- 实现统一 request/trace 上下文和结构化技术日志。
+- 实现业务审计事件、字段变更和客户时间线。
+- 完成 `OrgContext` 数据源注入、权限和通用接口的集成测试与基准压测。
+
+### 第四阶段：建立动作与扩展机制
+
+- 实现动作注册中心。
+- 实现 Handler 和生命周期扩展点。
+- 实现开发扩展 SDK 和特殊接口注册规范。
+- 实现特殊 Vue 页面 manifest 注册机制。
+- 实现事件中心和 Outbox。
+- 实现可靠任务框架、重试、死信、进度、取消和人工重跑。
+- 建立外部消息幂等、交互记录和对账机制。
+- 确保特殊 Handler 自动接入技术日志和业务审计。
+- 开始开发海运、空运等复杂业务模块。
+
+### 第五阶段：建立 AI 基础设施
+
+- 完成语义元数据查询工具。
+- 完成通用数据和动作工具。
+- 提供 OpenAPI、Tool Calling 和 MCP 适配。
+- 确保 AI 工具继承动作和数据范围权限。
+- 实现 AI 技术执行日志和客户可见业务日志的分离。
+- 实现 AI 配置助手和人工确认流程。
+- 建立模型、提示词、执行和评估记录。
+
+### 第六阶段：建设货代文档智能
+
+- 建立文件分类、OCR 和结构化抽取管道。
+- 建立提单、发票和合同抽取模板。
+- 建立置信度、人工校验和来源追踪。
+- 将抽取结果与海运、空运和财务实体关联。
+- 建立固定文档样本集，持续评估抽取准确率和人工修正率。
+
+### 第七阶段：上线准备与持续演进
+
+- 根据真实租户数据量完成容量评估和性能验收。
+- 完成代码、配置、Schema 和租户定制的联合发布演练。
+- 完成单租户数据库、对应文件和数据源配置的恢复演练。
+- 建立监控告警、值班责任、问题处置和外部集成对账流程。
+- 选取首批租户逐步放量，验证后再扩大范围。
+- 把生产问题沉淀为自动化测试、依赖规则和发布检查。
+
+## 28. 最终结论
+
+FMS 新系统应定位为一个以业务模块为中心、以实体语义模型为基础的内部 ERP 低代码平台。系统采用一租户一业务数据库的物理隔离方式，客户定制通过同一套元数据、配置 release、module bundle 和 extension bundle 交付，不复制另一套平台架构。
+
+模块负责业务边界，实体负责数据结构，页面负责展示，动作负责业务行为，统一权限中心负责页面、动作、数据范围和配置访问决策，双层日志体系负责技术可观测和客户业务追踪，Schema Compiler 负责数据库演进，配置 release 负责候选验证、激活和回滚，通用运行时负责普通业务能力，特殊页面、特殊接口和扩展 SDK 负责复杂逻辑，AI Gateway 负责连接模型与系统工具。
+
+最终目标不是让所有功能都由配置完成，也不是让所有需求都回到开发人员，而是建立清晰的能力层次：
+
+```text
+简单数据结构和页面：售后配置
+复杂业务规则、特殊页面和特殊接口：IT 开发实现
+自然语言理解和方案生成：AI 完成
+结构校验、数据库变更和业务执行：平台完成
+```
+
+这套架构可以同时解决旧系统迁移困难、配置繁琐、维护成本高、权限规则分散和日志难以追踪的问题，并为未来 AI 在继承用户权限、保留完整技术与业务审计记录的前提下深度参与 ERP 查询、操作、配置、分析和文档处理提供稳定基础。
diff --git a/code/fms/fms-vue/index.html b/code/fms/fms-vue/index.html
index 1a6f3996..fab08f0e 100644
--- a/code/fms/fms-vue/index.html
+++ b/code/fms/fms-vue/index.html
@@ -38,8 +38,9 @@
         position: fixed;
         inset: 0;
         z-index: 9999;
-        display: grid;
-        place-items: center;
+        display: flex;
+        align-items: center;
+        justify-content: center;
         color: var(--boot-fg);
         font-family:
           Inter,
@@ -50,8 +51,7 @@
           'Segoe UI',
           sans-serif;
         background:
-          radial-gradient(120% 120% at 50% 0%, var(--boot-glow), transparent 55%),
-          var(--boot-bg);
+          radial-gradient(120% 120% at 50% 0%, var(--boot-glow), transparent 55%), var(--boot-bg);
         transition: opacity 0.4s ease;
       }
 
@@ -59,70 +59,91 @@
         display: flex;
         flex-direction: column;
         align-items: center;
+        justify-content: center;
         gap: 24px;
       }
 
-      .app-boot__mark {
-        position: relative;
-        display: grid;
-        width: 104px;
-        height: 104px;
-        place-items: center;
+      .app-boot__svg {
+        display: flex;
+        flex-direction: column;
+        align-items: center;
+        justify-content: center;
       }
 
-      .app-boot__ring {
-        position: absolute;
-        inset: 0;
-        box-sizing: border-box;
-        border-radius: 50%;
+      .app-boot__svg svg {
+        display: block;
+        height: auto;
       }
 
-      .app-boot__ring--1 {
-        border: 2px solid color-mix(in srgb, var(--boot-accent) 22%, transparent);
-        border-top-color: var(--boot-accent);
-        animation: app-boot-spin 1.1s linear infinite;
+      /* 开屏 SVG 动画（原样移植自 demo.html 的 3D 服务器插画） */
+      #svg_svg {
+        zoom: 0.6;
       }
 
-      .app-boot__ring--2 {
-        inset: 11px;
-        border: 2px solid transparent;
-        border-bottom-color: var(--boot-accent-2);
-        animation: app-boot-spin 1.7s linear infinite reverse;
+      .estrobo_animation {
+        animation:
+          floatAndBounce 4s infinite ease-in-out,
+          strobe 0.8s infinite;
       }
 
-      .app-boot__ring--3 {
-        inset: 22px;
-        border: 2px dashed color-mix(in srgb, var(--boot-accent) 30%, transparent);
-        animation: app-boot-spin 2.6s linear infinite;
+      .estrobo_animationV2 {
+        animation:
+          floatAndBounce 4s infinite ease-in-out,
+          strobev2 0.8s infinite;
       }
 
-      .app-boot__logo {
-        width: 46px;
-        height: 46px;
-        font-size: 20px;
-        font-weight: 800;
-        letter-spacing: 0.5px;
-        line-height: 1;
-        display: grid;
-        place-items: center;
-        background: linear-gradient(135deg, var(--boot-accent), var(--boot-accent-2));
-        -webkit-background-clip: text;
-        background-clip: text;
-        color: transparent;
-        animation: app-boot-pulse 1.9s ease-in-out infinite;
+      #float_server {
+        animation: floatAndBounce 4s infinite ease-in-out;
       }
 
-      .app-boot__title {
-        margin: 0;
-        font-size: 17px;
-        font-weight: 700;
-        letter-spacing: 0.5px;
-        background: linear-gradient(90deg, var(--boot-accent), var(--boot-accent-2), var(--boot-accent));
-        background-size: 200% auto;
-        -webkit-background-clip: text;
-        background-clip: text;
-        color: transparent;
-        animation: app-boot-flow 2.4s linear infinite;
+      @keyframes floatAndBounce {
+        0%,
+        100% {
+          transform: translateY(0);
+        }
+        50% {
+          transform: translateY(-20px);
+        }
+      }
+
+      @keyframes strobe {
+        0%,
+        50%,
+        100% {
+          fill: #17e300;
+        }
+        25%,
+        75% {
+          fill: #17e300b4;
+        }
+      }
+
+      @keyframes strobev2 {
+        0%,
+        50%,
+        100% {
+          fill: rgb(255, 95, 74);
+        }
+        25%,
+        75% {
+          fill: rgb(16, 53, 115);
+        }
+      }
+
+      @keyframes animateGradient {
+        0% {
+          stop-color: #313f8773;
+        }
+        50% {
+          stop-color: #040d3a;
+        }
+        100% {
+          stop-color: #313f8773;
+        }
+      }
+
+      #paint13_linear_163_1030 stop {
+        animation: animateGradient 4s infinite alternate;
       }
 
       .app-boot__hint {
@@ -133,8 +154,7 @@
       }
 
       .app-boot__message {
-        max-width: 320px;
-        margin: 0;
+        margin: 4px 0 0;
         color: var(--boot-error);
         font-size: 13px;
         line-height: 1.5;
@@ -143,6 +163,7 @@
 
       .app-boot__retry {
         height: 32px;
+        margin-top: 16px;
         padding: 0 14px;
         color: var(--boot-fg);
         font: inherit;
@@ -158,35 +179,10 @@
         background: color-mix(in srgb, var(--boot-fg) 8%, transparent);
       }
 
-      .app-boot--error .app-boot__ring,
-      .app-boot--error .app-boot__logo,
-      .app-boot--error .app-boot__title,
-      .app-boot--error .app-boot__hint {
-        display: none;
-      }
-
       [hidden] {
         display: none !important;
       }
 
-      @keyframes app-boot-spin {
-        to {
-          transform: rotate(360deg);
-        }
-      }
-
-      @keyframes app-boot-pulse {
-        0%,
-        100% {
-          transform: scale(1);
-          opacity: 1;
-        }
-        50% {
-          transform: scale(1.12);
-          opacity: 0.82;
-        }
-      }
-
       @keyframes app-boot-flow {
         to {
           background-position: 200% center;
@@ -194,9 +190,9 @@
       }
 
       @media (prefers-reduced-motion: reduce) {
-        .app-boot__ring,
-        .app-boot__logo,
-        .app-boot__title {
+        #float_server,
+        .estrobo_animation,
+        .estrobo_animationV2 {
           animation-duration: 2.4s;
         }
       }
@@ -226,7 +222,7 @@
             function () {
               window.location.reload()
             },
-            { once: true }
+            { once: true },
           )
         }
         window.__appBoot = {
@@ -243,7 +239,7 @@
               message.hidden = false
             }
             bindRetry(retry)
-          }
+          },
         }
       })()
     </script>
@@ -259,16 +255,632 @@
         aria-busy="true"
       >
         <div class="app-boot__content">
-          <div class="app-boot__mark" aria-hidden="true">
-            <span class="app-boot__ring app-boot__ring--1"></span>
-            <span class="app-boot__ring app-boot__ring--2"></span>
-            <span class="app-boot__ring app-boot__ring--3"></span>
-            <span class="app-boot__logo">FMS</span>
+          <div class="app-boot__svg" aria-hidden="true">
+            <div>
+              <svg
+                id="svg_svg"
+                xmlns="http://www.w3.org/2000/svg"
+                fill="none"
+                viewBox="0 0 477 578"
+                height="578"
+                width="477"
+              >
+                <g filter="url(#filter0_i_163_1030)">
+                  <path
+                    fill="#E9E9E9"
+                    d="M235.036 304.223C236.949 303.118 240.051 303.118 241.964 304.223L470.072 435.921C473.898 438.13 473.898 441.712 470.072 443.921L247.16 572.619C242.377 575.38 234.623 575.38 229.84 572.619L6.92817 443.921C3.10183 441.712 3.10184 438.13 6.92817 435.921L235.036 304.223Z"
+                  ></path>
+                </g>
+                <path
+                  stroke="white"
+                  d="M235.469 304.473C237.143 303.506 239.857 303.506 241.531 304.473L469.639 436.171C473.226 438.242 473.226 441.6 469.639 443.671L246.727 572.369C242.183 574.992 234.817 574.992 230.273 572.369L7.36118 443.671C3.77399 441.6 3.774 438.242 7.36119 436.171L235.469 304.473Z"
+                ></path>
+                <path
+                  stroke="white"
+                  fill="#C3CADC"
+                  d="M234.722 321.071C236.396 320.105 239.111 320.105 240.785 321.071L439.477 435.786C443.064 437.857 443.064 441.215 439.477 443.286L240.785 558.001C239.111 558.967 236.396 558.967 234.722 558.001L36.0304 443.286C32.4432 441.215 32.4432 437.857 36.0304 435.786L234.722 321.071Z"
+                ></path>
+                <path
+                  fill="#4054B2"
+                  d="M234.521 366.089C236.434 364.985 239.536 364.985 241.449 366.089L406.439 461.346L241.247 556.72C239.333 557.825 236.231 557.825 234.318 556.72L69.3281 461.463L234.521 366.089Z"
+                ></path>
+                <path
+                  fill="#30439B"
+                  d="M237.985 364.089L237.984 556.972C236.144 556.941 235.082 556.717 233.13 556.043L69.3283 461.463L237.985 364.089Z"
+                ></path>
+                <path
+                  fill="url(#paint0_linear_163_1030)"
+                  d="M36.2146 117.174L237.658 0.435217V368.615C236.541 368.598 235.686 368.977 233.885 370.124L73.1836 463.678L39.2096 444.075C37.0838 442.229 36.285 440.981 36.2146 438.027V117.174Z"
+                  id="layer_pared"
+                ></path>
+                <path
+                  fill="url(#paint1_linear_163_1030)"
+                  d="M439.1 116.303L237.657 0.435568V368.616C238.971 368.585 239.822 369.013 241.43 370.135L403.64 462.925L436.128 444.089C437.832 442.715 438.975 441.147 439.1 439.536V116.303Z"
+                  id="layer_pared"
+                ></path>
+                <path
+                  fill="#27C6FD"
+                  d="M64.5447 181.554H67.5626V186.835L64.5447 188.344V181.554Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#138EB9"
+                  d="M88.3522 374.347L232.415 457.522C234.202 458.405 234.866 458.629 236.335 458.71V468.291C235.356 468.291 234.086 468.212 232.415 467.275L88.3522 384.1C86.3339 382.882 85.496 382.098 85.4707 380.198V370.428L88.3522 374.347Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#138EB9"
+                  d="M384.318 374.445L240.254 457.62C238.914 458.385 238.295 458.629 236.335 458.71V468.291C237.315 468.291 238.704 468.211 240.236 467.274L384.318 384.198C386.457 383.091 387.151 382.244 387.258 380.228V370.917C386.768 372.387 386.21 373.295 384.318 374.445Z"
+                  id="float_server"
+                ></path>
+                <path
+                  stroke="url(#paint3_linear_163_1030)"
+                  fill="url(#paint2_linear_163_1030)"
+                  d="M240.452 226.082L408.617 323.172C412.703 325.531 412.703 329.355 408.617 331.713L240.452 428.803C238.545 429.904 235.455 429.904 233.548 428.803L65.3832 331.713C61.298 329.355 61.298 325.531 65.3832 323.172L233.548 226.082C235.455 224.982 238.545 224.982 240.452 226.082Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#5B6CA2"
+                  d="M408.896 332.123L241.489 428.775C240.013 429.68 238.557 430.033 236.934 430.033V464.518C238.904 464.518 239.366 464.169 241.489 463.233L408.896 366.58C411.372 365.292 412.125 363.262 412.312 361.317C412.312 361.317 412.312 326.583 412.312 327.722C412.312 328.86 411.42 330.514 408.896 332.123Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#6879AF"
+                  d="M240.92 429.077L255.155 420.857V432.434L251.511 439.064V457.432L241.489 463.242C240.116 463.858 239.141 464.518 236.934 464.518V430.024C238.695 430.024 239.862 429.701 240.92 429.077Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="url(#paint4_linear_163_1030)"
+                  d="M65.084 331.984L232.379 428.571C233.882 429.619 235.101 430.005 236.934 430.005V464.523C234.656 464.523 234.285 464.215 232.379 463.214L65.084 366.442C62.4898 365 61.6417 362.992 61.6699 361.29V327.125C61.6899 329.24 62.4474 330.307 65.084 331.984Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#20273A"
+                  d="M400.199 361.032C403.195 359.302 405.623 355.096 405.623 351.637C405.623 348.177 403.195 346.775 400.199 348.505C397.203 350.235 394.775 354.441 394.775 357.9C394.775 361.359 397.203 362.762 400.199 361.032Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#20273A"
+                  d="M221.404 446.444C224.4 448.174 226.828 446.771 226.828 443.312C226.828 439.853 224.4 435.646 221.404 433.917C218.408 432.187 215.979 433.589 215.979 437.049C215.979 440.508 218.408 444.714 221.404 446.444Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#494F76"
+                  d="M102.895 359.589L97.9976 356.762V380.07L102.895 382.897V359.589Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#313654"
+                  d="M102.895 359.619L98.3394 356.989V379.854L102.895 382.484V359.619Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#494F76"
+                  d="M78.9793 345.923L74.0823 343.096V366.37L78.9793 369.198V345.923Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#494F76"
+                  d="M86.9512 350.478L82.0542 347.651V370.959L86.9512 373.787V350.478Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#494F76"
+                  d="M94.9229 355.034L90.0259 352.206V375.515L94.9229 378.342V355.034Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#313654"
+                  d="M86.951 350.509L82.3958 347.879V370.743L86.951 373.373V350.509Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#313654"
+                  d="M94.9227 355.064L90.3674 352.434V375.299L94.9227 377.929V355.064Z"
+                  class="estrobo_animation"
+                ></path>
+                <path
+                  fill="#313654"
+                  d="M78.9794 345.954L74.4241 343.324V366.188L78.9794 368.818V345.954Z"
+                  class="estrobo_animation"
+                ></path>
+                <path
+                  fill="#333B5F"
+                  d="M221.859 446.444C224.855 448.174 227.284 446.771 227.284 443.312C227.284 439.853 224.855 435.646 221.859 433.917C218.863 432.187 216.435 433.589 216.435 437.049C216.435 440.508 218.863 444.714 221.859 446.444Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#333B5F"
+                  d="M399.516 361.032C402.511 359.302 404.94 355.096 404.94 351.637C404.94 348.177 402.511 346.775 399.516 348.505C396.52 350.235 394.091 354.441 394.091 357.9C394.091 361.359 396.52 362.762 399.516 361.032Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#27C6FD"
+                  d="M88.3522 317.406L232.415 400.581C234.202 401.464 234.866 401.688 236.335 401.769V411.35C235.356 411.35 234.086 411.271 232.415 410.334L88.3522 327.159C86.3339 325.941 85.496 325.157 85.4707 323.256V313.486L88.3522 317.406Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#27C6FD"
+                  d="M384.318 317.504L240.254 400.679C238.914 401.444 238.295 401.688 236.335 401.769V411.35C237.315 411.35 238.704 411.27 240.236 410.333L384.318 327.257C386.457 326.15 387.151 325.303 387.258 323.287V313.976C386.768 315.446 386.21 316.354 384.318 317.504Z"
+                  id="float_server"
+                ></path>
+                <path
+                  stroke="url(#paint6_linear_163_1030)"
+                  fill="url(#paint5_linear_163_1030)"
+                  d="M240.452 169.141L408.617 266.231C412.703 268.59 412.703 272.414 408.617 274.772L240.452 371.862C238.545 372.962 235.455 372.962 233.548 371.862L65.3832 274.772C61.298 272.414 61.298 268.59 65.3832 266.231L233.548 169.141C235.455 168.04 238.545 168.04 240.452 169.141Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#5B6CA2"
+                  d="M408.896 275.182L241.489 371.834C240.013 372.739 238.557 373.092 236.934 373.092V407.577C238.904 407.577 239.366 407.229 241.489 406.292L408.896 309.64C411.372 308.352 412.125 306.321 412.312 304.376C412.312 304.376 412.312 269.642 412.312 270.781C412.312 271.92 411.42 273.573 408.896 275.182Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#6879AF"
+                  d="M240.92 372.135L255.155 363.915V375.493L251.511 382.123V400.491L241.489 406.3C240.116 406.916 239.141 407.577 236.934 407.577V373.083C238.695 373.083 239.862 372.759 240.92 372.135Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="url(#paint7_linear_163_1030)"
+                  d="M65.084 275.043L232.379 371.63C233.882 372.678 235.101 373.064 236.934 373.064V407.582C234.656 407.582 234.285 407.274 232.379 406.273L65.084 309.501C62.4898 308.059 61.6417 306.051 61.6699 304.349V270.184C61.6899 272.299 62.4474 273.366 65.084 275.043Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#20273A"
+                  d="M400.199 304.091C403.195 302.362 405.623 298.155 405.623 294.696C405.623 291.237 403.195 289.835 400.199 291.564C397.203 293.294 394.775 297.5 394.775 300.959C394.775 304.419 397.203 305.821 400.199 304.091Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#20273A"
+                  d="M221.404 389.503C224.4 391.232 226.828 389.83 226.828 386.371C226.828 382.912 224.4 378.705 221.404 376.976C218.408 375.246 215.979 376.648 215.979 380.107C215.979 383.567 218.408 387.773 221.404 389.503Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#494F76"
+                  d="M102.553 301.281L97.656 298.454V321.762L102.553 324.59V301.281Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#313654"
+                  d="M102.553 301.312L97.9976 298.682V321.546L102.553 324.176V301.312Z"
+                  class="estrobo_animation"
+                ></path>
+                <path
+                  fill="#494F76"
+                  d="M78.6377 287.615L73.7407 284.788V308.063L78.6377 310.89V287.615Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#494F76"
+                  d="M86.6094 292.171L81.7124 289.343V312.652L86.6094 315.479V292.171Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#494F76"
+                  d="M94.5811 296.726L89.6841 293.899V317.207L94.5811 320.034V296.726Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#313654"
+                  d="M86.6095 292.201L82.0542 289.571V312.436L86.6095 315.066V292.201Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#313654"
+                  d="M94.5812 296.756L90.0259 294.126V316.991L94.5812 319.621V296.756Z"
+                  class="estrobo_animationV2"
+                ></path>
+                <path
+                  fill="#313654"
+                  d="M78.6376 287.646L74.0823 285.016V307.88L78.6376 310.51V287.646Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#333B5F"
+                  d="M221.859 389.503C224.855 391.232 227.284 389.83 227.284 386.371C227.284 382.912 224.855 378.705 221.859 376.976C218.863 375.246 216.435 376.648 216.435 380.107C216.435 383.567 218.863 387.773 221.859 389.503Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#333B5F"
+                  d="M399.516 304.091C402.511 302.362 404.94 298.155 404.94 294.696C404.94 291.237 402.511 289.835 399.516 291.564C396.52 293.294 394.091 297.5 394.091 300.959C394.091 304.419 396.52 305.821 399.516 304.091Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#27C6FD"
+                  d="M89.4907 214.912L233.554 298.087C235.341 298.97 236.003 299.194 237.474 299.275V308.856C236.494 308.856 235.223 308.777 233.554 307.84L89.4907 224.665C87.4726 223.447 86.6347 222.663 86.6094 220.762V210.993L89.4907 214.912Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#27C6FD"
+                  d="M385.457 215.01L241.393 298.185C240.053 298.951 239.434 299.194 237.474 299.275V308.856C238.454 308.856 239.844 308.776 241.375 307.839L385.457 224.763C387.597 223.656 388.29 222.809 388.397 220.793V211.482C387.907 212.953 387.349 213.86 385.457 215.01Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="url(#paint8_linear_163_1030)"
+                  d="M66.1102 196.477L233.517 293.129C235.593 294.154 236.364 294.416 238.073 294.509V305.642C236.934 305.642 235.458 305.551 233.517 304.463L66.1102 207.81C63.7651 206.394 62.7914 205.483 62.762 203.275V191.922L66.1102 196.477Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#5B6CA2"
+                  d="M410.101 196.591L242.694 293.243C241.135 294.132 240.35 294.375 238.073 294.468V305.643C239.211 305.643 240.892 305.55 242.671 304.46L410.101 207.923C412.587 206.638 413.392 205.653 413.517 203.31V192.491C412.948 194.199 412.3 195.254 410.101 196.591Z"
+                  id="float_server"
+                ></path>
+                <path
+                  stroke="url(#paint10_linear_163_1030)"
+                  fill="url(#paint9_linear_163_1030)"
+                  d="M241.59 90.5623L409.756 187.652C413.842 190.011 413.842 193.835 409.756 196.194L241.59 293.284C239.684 294.384 236.593 294.384 234.687 293.284L66.5219 196.194C62.4367 193.835 62.4367 190.011 66.5219 187.652L234.687 90.5623C236.593 89.4616 239.684 89.4616 241.59 90.5623Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#20273A"
+                  d="M89.0427 195.334C92.0385 197.063 96.8956 197.063 99.8914 195.334C102.887 193.604 102.887 190.8 99.8914 189.07C96.8956 187.341 92.0385 187.341 89.0427 189.07C86.0469 190.8 86.0469 193.604 89.0427 195.334Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#20273A"
+                  d="M231.396 111.061C234.391 112.791 239.249 112.791 242.244 111.061C245.24 109.331 245.24 106.527 242.244 104.798C239.249 103.068 234.391 103.068 231.396 104.798C228.4 106.527 228.4 109.331 231.396 111.061Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#20273A"
+                  d="M374.887 194.195C377.883 195.925 382.74 195.925 385.736 194.195C388.732 192.465 388.732 189.661 385.736 187.932C382.74 186.202 377.883 186.202 374.887 187.932C371.891 189.661 371.891 192.465 374.887 194.195Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#20273A"
+                  d="M231.396 279.607C234.391 281.336 239.249 281.336 242.244 279.607C245.24 277.877 245.24 275.073 242.244 273.343C239.249 271.613 234.391 271.613 231.396 273.343C228.4 275.073 228.4 277.877 231.396 279.607Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#333B5F"
+                  d="M232.109 279.607C235.104 281.336 239.962 281.336 242.957 279.607C245.953 277.877 245.953 275.073 242.957 273.343C239.962 271.613 235.104 271.613 232.109 273.343C229.113 275.073 229.113 277.877 232.109 279.607Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#333B5F"
+                  d="M89.7563 195.334C92.7521 197.063 97.6092 197.063 100.605 195.334C103.601 193.604 103.601 190.8 100.605 189.07C97.6092 187.341 92.7521 187.341 89.7563 189.07C86.7605 190.8 86.7605 193.604 89.7563 195.334Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#333B5F"
+                  d="M232.109 111.061C235.104 112.791 239.962 112.791 242.957 111.061C245.953 109.331 245.953 106.527 242.957 104.798C239.962 103.068 235.104 103.068 232.109 104.798C229.113 106.527 229.113 109.331 232.109 111.061Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#333B5F"
+                  d="M375.6 194.195C378.595 195.925 383.453 195.925 386.448 194.195C389.444 192.465 389.444 189.661 386.448 187.932C383.453 186.202 378.595 186.202 375.6 187.932C372.604 189.661 372.604 192.465 375.6 194.195Z"
+                  id="float_server"
+                ></path>
+                <path
+                  stroke="#313654"
+                  d="M371.315 166.009L354.094 176.748C351.92 178.337 350.677 179.595 350.677 181.872L351.247 196.108C351.412 198.824 350.734 200.095 347.83 201.802L251.03 257.603C248.955 258.968 247.598 259.356 244.767 259.312L215.727 258.743C212.711 258.605 211.233 259.005 208.894 260.45L193.659 269.072"
+                  id="float_server"
+                ></path>
+                <path
+                  stroke="#313654"
+                  d="M345.691 151.204L328.328 161.374C326.154 162.963 324.911 164.221 324.911 166.498L325.481 180.734C325.646 183.45 324.968 184.721 322.064 186.428L225.264 242.229C223.19 243.594 221.832 243.982 219.001 243.938L189.961 243.369C186.946 243.231 185.468 243.631 183.128 245.076L167.124 253.698"
+                  id="float_server"
+                ></path>
+                <path
+                  stroke="#313654"
+                  d="M105.482 218.098L122.697 207.363C124.87 205.773 126.111 204.516 126.111 202.24L125.537 188.007C125.371 185.291 126.048 184.02 128.951 182.314L225.715 126.533C227.788 125.17 229.146 124.782 231.976 124.825L261.012 125.398C264.026 125.535 265.503 125.136 267.842 123.691L283.072 115.072"
+                  id="float_server"
+                ></path>
+                <path
+                  stroke="#313654"
+                  d="M131.121 232.893L148.482 222.725C150.656 221.136 151.898 219.879 151.898 217.601L151.327 203.367C151.162 200.65 151.839 199.379 154.743 197.673L251.531 141.878C253.605 140.514 254.962 140.126 257.794 140.17L286.832 140.74C289.847 140.878 291.325 140.478 293.664 139.032L309.667 130.412"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#313654"
+                  d="M327.961 242.79L301.907 227.748L300.673 228.46L326.727 243.503L327.961 242.79Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#313654"
+                  d="M354.625 227.426L328.56 212.377L327.326 213.09L353.392 228.139L354.625 227.426Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#313654"
+                  d="M300.864 258.519L274.707 243.417L273.474 244.129L299.631 259.231L300.864 258.519Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#313654"
+                  d="M176.498 155.101L150.21 139.924L148.977 140.636L175.264 155.813L176.498 155.101Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#313654"
+                  d="M193.703 145.191L167.388 129.998L166.154 130.711L192.469 145.903L193.703 145.191Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#313654"
+                  d="M158.333 165.69L131.974 150.472L130.74 151.184L157.099 166.402L158.333 165.69Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="#20273A"
+                  d="M232.079 135.83C234.258 134.573 237.79 134.573 239.969 135.83L329.717 187.647C334.074 190.163 334.074 194.242 329.717 196.757L239.969 248.574C237.79 249.832 234.258 249.832 232.079 248.574L142.33 196.757C137.972 194.242 137.972 190.163 142.33 187.647L232.079 135.83Z"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="url(#paint11_linear_163_1030)"
+                  d="M234.357 135.83C236.535 134.573 240.068 134.573 242.246 135.83L331.995 187.647C336.352 190.163 336.352 194.242 331.995 196.757L242.246 248.574C240.068 249.832 236.535 249.832 234.357 248.574L144.608 196.757C140.25 194.242 140.25 190.163 144.608 187.647L234.357 135.83Z"
+                  id="float_server"
+                ></path>
+                <path
+                  stroke-width="3"
+                  stroke="#27C6FD"
+                  d="M380.667 192.117V181.97C380.667 179.719 383.055 178.27 385.052 179.309L409.985 192.282C410.978 192.799 411.601 193.825 411.601 194.943V301.113C411.601 302.642 409.953 303.606 408.62 302.856L399.529 297.742"
+                  class="after_animation"
+                  id="float_server"
+                ></path>
+                <path
+                  stroke-width="3"
+                  stroke="#27C6FD"
+                  d="M94.7234 192.117V180.306C94.7234 179.214 94.1301 178.208 93.1744 177.68L70.5046 165.152C68.5052 164.047 66.0536 165.493 66.0536 167.778V185.326"
+                  id="float_server"
+                ></path>
+                <ellipse
+                  fill="#27C6FD"
+                  ry="1.50894"
+                  rx="1.50894"
+                  cy="192.117"
+                  cx="380.667"
+                  id="float_server"
+                ></ellipse>
+                <ellipse
+                  fill="#27C6FD"
+                  ry="1.50894"
+                  rx="1.50894"
+                  cy="192.117"
+                  cx="94.7235"
+                  id="float_server"
+                ></ellipse>
+                <ellipse
+                  fill="#27C6FD"
+                  ry="1.50894"
+                  rx="1.50894"
+                  cy="297.742"
+                  cx="399.529"
+                  id="float_server"
+                ></ellipse>
+                <ellipse
+                  fill="#27C6FD"
+                  ry="1.50894"
+                  rx="1.50894"
+                  cy="383.751"
+                  cx="221.474"
+                  id="float_server"
+                ></ellipse>
+                <ellipse
+                  fill="#27C6FD"
+                  ry="1.50894"
+                  rx="1.50894"
+                  cy="439.583"
+                  cx="221.474"
+                  id="float_server"
+                ></ellipse>
+                <path
+                  stroke-width="3"
+                  stroke="#27C6FD"
+                  d="M221.474 383.752L211.746 388.941C210.768 389.462 210.157 390.48 210.157 391.588V444.34C210.157 445.108 210.988 445.589 211.654 445.208L221.474 439.583"
+                  id="float_server"
+                ></path>
+                <path
+                  fill="url(#paint13_linear_163_1030)"
+                  d="M237.376 236.074L36 119.684V439.512C36.0957 441.966 36.7214 443.179 39.0056 445.021L200.082 538.547L231.362 556.441C233.801 557.806 235.868 558.222 237.376 558.328V236.074Z"
+                  id="layer_pared"
+                ></path>
+                <defs>
+                  <linearGradient
+                    gradientUnits="userSpaceOnUse"
+                    y2="556.454"
+                    x2="438.984"
+                    y1="235.918"
+                    x1="237.376"
+                    id="paint13_linear_163_1030"
+                  >
+                    <stop style="stop-color: #4457b3; stop-opacity: 0" offset="10%"></stop>
+                    <stop style="stop-color: #4457b3; stop-opacity: 1" offset="100%"></stop>
+                  </linearGradient>
+                </defs>
+                <path
+                  fill="url(#paint13_linear_163_1030)"
+                  d="M237.376 235.918L438.984 119.576V439.398C439.118 441.699 438.452 442.938 435.975 444.906L274.712 538.539L243.397 556.454C240.955 557.821 238.886 558.23 237.376 558.336V235.918Z"
+                  class="animatedStop"
+                  id="layer_pared"
+                ></path>
+                <defs>
+                  <filter
+                    color-interpolation-filters="sRGB"
+                    filterUnits="userSpaceOnUse"
+                    height="275.295"
+                    width="468.883"
+                    y="303.394"
+                    x="4.05835"
+                    id="filter0_i_163_1030"
+                  >
+                    <feFlood result="BackgroundImageFix" flood-opacity="0"></feFlood>
+                    <feBlend
+                      result="shape"
+                      in2="BackgroundImageFix"
+                      in="SourceGraphic"
+                      mode="normal"
+                    ></feBlend>
+                    <feColorMatrix
+                      result="hardAlpha"
+                      values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0"
+                      type="matrix"
+                      in="SourceAlpha"
+                    ></feColorMatrix>
+                    <feOffset dy="4"></feOffset>
+                    <feGaussianBlur stdDeviation="2"></feGaussianBlur>
+                    <feComposite k3="1" k2="-1" operator="arithmetic" in2="hardAlpha"></feComposite>
+                    <feColorMatrix
+                      values="0 0 0 0 0.220833 0 0 0 0 0.220833 0 0 0 0 0.220833 0 0 0 1 0"
+                      type="matrix"
+                    ></feColorMatrix>
+                    <feBlend
+                      result="effect1_innerShadow_163_1030"
+                      in2="shape"
+                      mode="normal"
+                    ></feBlend>
+                  </filter>
+                  <linearGradient
+                    gradientUnits="userSpaceOnUse"
+                    y2="336.055"
+                    x2="294.366"
+                    y1="60.1113"
+                    x1="135.05"
+                    id="paint0_linear_163_1030"
+                  >
+                    <stop stop-opacity="0.01" stop-color="white" offset="0.305"></stop>
+                    <stop stop-color="#4054B2" offset="1"></stop>
+                  </linearGradient>
+                  <linearGradient
+                    gradientUnits="userSpaceOnUse"
+                    y2="335.208"
+                    x2="180.935"
+                    y1="59.2405"
+                    x1="340.265"
+                    id="paint1_linear_163_1030"
+                  >
+                    <stop stop-opacity="0.01" stop-color="white" offset="0.305"></stop>
+                    <stop stop-color="#4054B2" offset="1"></stop>
+                  </linearGradient>
+                  <linearGradient
+                    gradientUnits="userSpaceOnUse"
+                    y2="420.619"
+                    x2="88.5367"
+                    y1="327.152"
+                    x1="412.313"
+                    id="paint2_linear_163_1030"
+                  >
+                    <stop stop-color="#313654"></stop>
+                    <stop stop-color="#313654" offset="1"></stop>
+                  </linearGradient>
+                  <linearGradient
+                    gradientUnits="userSpaceOnUse"
+                    y2="211.092"
+                    x2="168.239"
+                    y1="426.799"
+                    x1="236.934"
+                    id="paint3_linear_163_1030"
+                  >
+                    <stop stop-color="#7281B8"></stop>
+                    <stop stop-color="#333952" offset="1"></stop>
+                  </linearGradient>
+                  <linearGradient
+                    gradientUnits="userSpaceOnUse"
+                    y2="349.241"
+                    x2="232.379"
+                    y1="349.241"
+                    x1="65.0839"
+                    id="paint4_linear_163_1030"
+                  >
+                    <stop stop-color="#7281B8"></stop>
+                    <stop stop-color="#5D6EA4" offset="1"></stop>
+                  </linearGradient>
+                  <linearGradient
+                    gradientUnits="userSpaceOnUse"
+                    y2="363.678"
+                    x2="88.5367"
+                    y1="270.211"
+                    x1="412.313"
+                    id="paint5_linear_163_1030"
+                  >
+                    <stop stop-color="#313654"></stop>
+                    <stop stop-color="#313654" offset="1"></stop>
+                  </linearGradient>
+                  <linearGradient
+                    gradientUnits="userSpaceOnUse"
+                    y2="154.15"
+                    x2="168.239"
+                    y1="369.858"
+                    x1="236.934"
+                    id="paint6_linear_163_1030"
+                  >
+                    <stop stop-color="#7281B8"></stop>
+                    <stop stop-color="#333952" offset="1"></stop>
+                  </linearGradient>
+                  <linearGradient
+                    gradientUnits="userSpaceOnUse"
+                    y2="292.3"
+                    x2="232.379"
+                    y1="292.3"
+                    x1="65.0839"
+                    id="paint7_linear_163_1030"
+                  >
+                    <stop stop-color="#7281B8"></stop>
+                    <stop stop-color="#5D6EA4" offset="1"></stop>
+                  </linearGradient>
+                  <linearGradient
+                    gradientUnits="userSpaceOnUse"
+                    y2="198.899"
+                    x2="238.073"
+                    y1="198.899"
+                    x1="62.762"
+                    id="paint8_linear_163_1030"
+                  >
+                    <stop stop-color="#7382B9"></stop>
+                    <stop stop-color="#5D6EA4" offset="1"></stop>
+                  </linearGradient>
+                  <linearGradient
+                    gradientUnits="userSpaceOnUse"
+                    y2="191.599"
+                    x2="67.1602"
+                    y1="191.633"
+                    x1="413.451"
+                    id="paint9_linear_163_1030"
+                  >
+                    <stop stop-color="#5F6E99"></stop>
+                    <stop stop-color="#465282" offset="1"></stop>
+                  </linearGradient>
+                  <linearGradient
+                    gradientUnits="userSpaceOnUse"
+                    y2="191.599"
+                    x2="63.6601"
+                    y1="191.599"
+                    x1="417.16"
+                    id="paint10_linear_163_1030"
+                  >
+                    <stop stop-color="#7281B8"></stop>
+                    <stop stop-color="#333952" offset="1"></stop>
+                  </linearGradient>
+                  <linearGradient
+                    gradientUnits="userSpaceOnUse"
+                    y2="243.221"
+                    x2="156.734"
+                    y1="191.633"
+                    x1="335.442"
+                    id="paint11_linear_163_1030"
+                  >
+                    <stop stop-color="#313654"></stop>
+                    <stop stop-color="#313654" offset="1"></stop>
+                  </linearGradient>
+                  <linearGradient
+                    gradientUnits="userSpaceOnUse"
+                    y2="421.983"
+                    x2="-1.9283"
+                    y1="179.292"
+                    x1="138.189"
+                    id="paint12_linear_163_1030"
+                  >
+                    <stop stop-opacity="0.01" stop-color="white" offset="0.305"></stop>
+                    <stop stop-color="#4054B2" offset="1"></stop>
+                  </linearGradient>
+                </defs>
+              </svg>
+            </div>
+            <p id="app-boot-message" class="app-boot__message" hidden></p>
+            <button id="app-boot-retry" class="app-boot__retry" type="button" hidden>
+              重新加载
+            </button>
           </div>
-          <h1 class="app-boot__title">FMS 企业管理系统</h1>
-          <p class="app-boot__hint" id="app-boot-hint">正在加载应用，请稍候…</p>
-          <p id="app-boot-message" class="app-boot__message" hidden></p>
-          <button id="app-boot-retry" class="app-boot__retry" type="button" hidden>重新加载</button>
         </div>
       </div>
     </div>
diff --git a/code/fms/fms-vue/src/components/ui/ColorThemePicker.vue b/code/fms/fms-vue/src/components/ui/ColorThemePicker.vue
deleted file mode 100644
index 97b4c7eb..00000000
--- a/code/fms/fms-vue/src/components/ui/ColorThemePicker.vue
+++ /dev/null
@@ -1,98 +0,0 @@
-<script setup>
-import { computed } from 'vue'
-import { PRESETS } from '@/theme/presets'
-import { useAppStore } from '@/stores/app'
-
-const appStore = useAppStore()
-
-const activeColor = computed(() => appStore.primaryColor)
-
-function pick(color) {
-  appStore.setPrimary(color)
-}
-</script>
-
-<template>
-  <div class="color-picker" role="group" aria-label="主题色">
-    <button
-      v-for="preset in PRESETS"
-      :key="preset.color"
-      class="swatch"
-      type="button"
-      :style="{ background: preset.color }"
-      :aria-label="preset.name"
-      :title="preset.name"
-      :aria-pressed="activeColor === preset.color"
-      @click="pick(preset.color)"
-    >
-      <svg
-        v-if="activeColor === preset.color"
-        class="check"
-        viewBox="0 0 24 24"
-        width="14"
-        height="14"
-        fill="none"
-        stroke="#fff"
-        stroke-width="3"
-        stroke-linecap="round"
-        stroke-linejoin="round"
-      >
-        <path d="M20 6 9 17l-5-5" />
-      </svg>
-    </button>
-  </div>
-</template>
-
-<style scoped>
-.color-picker {
-  display: flex;
-  flex-wrap: wrap;
-  gap: 8px;
-  align-items: center;
-}
-
-.swatch {
-  position: relative;
-  width: 24px;
-  height: 24px;
-  padding: 0;
-  border: none;
-  border-radius: 50%;
-  cursor: pointer;
-  box-shadow: inset 0 0 0 2px transparent;
-  transition:
-    transform 150ms ease,
-    box-shadow 150ms ease;
-}
-
-.swatch:hover {
-  transform: scale(1.15);
-  box-shadow:
-    inset 0 0 0 2px var(--fms-border),
-    var(--fms-shadow);
-}
-
-.swatch[aria-pressed='true'] {
-  box-shadow:
-    inset 0 0 0 2px var(--fms-card),
-    0 0 0 2px var(--fms-text);
-}
-
-.check {
-  position: absolute;
-  inset: 0;
-  margin: auto;
-  filter: drop-shadow(0 1px 1px rgba(0, 0, 0, 0.35));
-}
-
-.swatch:focus-visible {
-  outline: 2px solid var(--fms-primary);
-  outline-offset: 2px;
-}
-
-@media (prefers-reduced-motion: reduce) {
-  .swatch {
-    transition: none;
-  }
-}
-</style>
diff --git a/code/fms/fms-vue/src/components/ui/ThemeToggle.vue b/code/fms/fms-vue/src/components/ui/ThemeToggle.vue
deleted file mode 100644
index 9eac7368..00000000
--- a/code/fms/fms-vue/src/components/ui/ThemeToggle.vue
+++ /dev/null
@@ -1,61 +0,0 @@
-<script setup>
-import { Moon, Sun } from '@lucide/vue'
-import { computed } from 'vue'
-import { useAppStore } from '@/stores/app'
-
-const appStore = useAppStore()
-const isDark = computed(() => appStore.darkMode)
-function toggle() {
-  appStore.toggleDark()
-}
-</script>
-
-<template>
-  <button
-    class="theme-toggle"
-    type="button"
-    :aria-label="isDark ? '切换到浅色模式' : '切换到深色模式'"
-    :title="isDark ? '浅色模式' : '深色模式'"
-    @click="toggle"
-  >
-    <Sun v-if="!isDark" class="theme-toggle-icon" aria-hidden="true" />
-    <Moon v-else class="theme-toggle-icon" aria-hidden="true" />
-  </button>
-</template>
-
-<style scoped>
-.theme-toggle {
-  display: inline-flex;
-  align-items: center;
-  justify-content: center;
-  width: 32px;
-  height: 32px;
-  padding: 0;
-  border: none;
-  border-radius: var(--fms-control-radius);
-  background: transparent;
-  color: var(--fms-text);
-  cursor: pointer;
-  transition: background 150ms ease;
-}
-
-.theme-toggle:hover {
-  background: var(--fms-secondary-hover);
-}
-
-.theme-toggle:focus-visible {
-  outline: 2px solid var(--fms-primary);
-  outline-offset: 2px;
-}
-
-.theme-toggle-icon {
-  width: 16px;
-  height: 16px;
-}
-
-@media (prefers-reduced-motion: reduce) {
-  .theme-toggle {
-    transition: none;
-  }
-}
-</style>
diff --git a/code/fms/fms-vue/src/components/ui/button/button.vue b/code/fms/fms-vue/src/components/ui/button/button.vue
index c7a7a57f..7a73cf8d 100644
--- a/code/fms/fms-vue/src/components/ui/button/button.vue
+++ b/code/fms/fms-vue/src/components/ui/button/button.vue
@@ -52,7 +52,12 @@ const classes = computed(() => [
 </script>
 
 <template>
-  <button :type="htmlType" :class="classes" :disabled="isDisabled" :aria-busy="loading || undefined">
+  <button
+    :type="htmlType"
+    :class="classes"
+    :disabled="isDisabled"
+    :aria-busy="loading || undefined"
+  >
     <Loader v-if="loading" class="button-spinner" aria-hidden="true" />
     <slot />
   </button>
diff --git a/code/fms/fms-vue/src/components/ui/demo/date.vue b/code/fms/fms-vue/src/components/ui/demo/date.vue
index 294e6e2e..d9258018 100644
--- a/code/fms/fms-vue/src/components/ui/demo/date.vue
+++ b/code/fms/fms-vue/src/components/ui/demo/date.vue
@@ -22,8 +22,8 @@ const multiFormat = ['YYYY年MM月DD日', 'YYYY-MM-DD']
       <p class="eyebrow">Components</p>
       <h2 id="date-title">DatePicker 日期选择</h2>
       <p>
-        format 同时决定选择面板、选择精度和展示格式；valueFormat 仅控制绑定值格式，
-        未设置时自动跟随 format。
+        format 同时决定选择面板、选择精度和展示格式；valueFormat 仅控制绑定值格式， 未设置时自动跟随
+        format。
       </p>
     </div>
 
diff --git a/code/fms/fms-vue/src/components/ui/demo/drawer.vue b/code/fms/fms-vue/src/components/ui/demo/drawer.vue
index f85861e1..493be487 100644
--- a/code/fms/fms-vue/src/components/ui/demo/drawer.vue
+++ b/code/fms/fms-vue/src/components/ui/demo/drawer.vue
@@ -46,7 +46,10 @@ function openDrawer(placement) {
       :placement="drawerPlacement"
       :width="360"
     >
-      <p>抽屉从<strong>{{ drawerPlacement }}</strong>侧滑入，拖动边缘可调整尺寸；点击遮罩、关闭按钮或按 Esc 均可关闭。</p>
+      <p>
+        抽屉从<strong>{{ drawerPlacement }}</strong
+        >侧滑入，拖动边缘可调整尺寸；点击遮罩、关闭按钮或按 Esc 均可关闭。
+      </p>
       <p style="margin-top: 12px">适用于表单填写、详情查看等需要更大空间的场景。</p>
     </Drawer>
 
@@ -54,7 +57,10 @@ function openDrawer(placement) {
       <template #extra>
         <Button type="link">帮助</Button>
       </template>
-      <p>头部左侧通过 <code>#extra</code> 插槽放入附加操作，底部通过 <code>#footer</code> 插槽放置按钮。</p>
+      <p>
+        头部左侧通过 <code>#extra</code> 插槽放入附加操作，底部通过
+        <code>#footer</code> 插槽放置按钮。
+      </p>
       <template #footer>
         <Button type="outline" @click="drawerCustomOpen = false">取消</Button>
         <Button type="default" @click="drawerCustomOpen = false">确定</Button>
diff --git a/code/fms/fms-vue/src/components/ui/demo/dropdown.vue b/code/fms/fms-vue/src/components/ui/demo/dropdown.vue
index 5de06311..6ba5d5da 100644
--- a/code/fms/fms-vue/src/components/ui/demo/dropdown.vue
+++ b/code/fms/fms-vue/src/components/ui/demo/dropdown.vue
@@ -122,7 +122,12 @@ const contextItems = [
 
     <p class="demo-label">右键触发</p>
     <div class="demo-panel">
-      <Dropdown :items="contextItems" trigger="contextmenu" placement="bottom-start" @click="onSelect">
+      <Dropdown
+        :items="contextItems"
+        trigger="contextmenu"
+        placement="bottom-start"
+        @click="onSelect"
+      >
         <template #trigger>
           <div class="dropdown-demo-context">在此区域右键</div>
         </template>
diff --git a/code/fms/fms-vue/src/components/ui/demo/form.vue b/code/fms/fms-vue/src/components/ui/demo/form.vue
index 14a21df7..f00d405a 100644
--- a/code/fms/fms-vue/src/components/ui/demo/form.vue
+++ b/code/fms/fms-vue/src/components/ui/demo/form.vue
@@ -155,7 +155,12 @@ function onPickerReset() {
         @reset="onCustomReset"
       >
         <FormItem name="phone" label="手机号">
-          <Input v-model="customModel.phone" placeholder="请输入 11 位手机号" maxlength="11" allow-clear />
+          <Input
+            v-model="customModel.phone"
+            placeholder="请输入 11 位手机号"
+            maxlength="11"
+            allow-clear
+          />
         </FormItem>
         <FormItem name="code" label="验证码" help="输入短信中的 6 位数字">
           <Input v-model="customModel.code" placeholder="6 位数字" maxlength="6" allow-clear />
diff --git a/code/fms/fms-vue/src/components/ui/demo/modal.vue b/code/fms/fms-vue/src/components/ui/demo/modal.vue
index 8b8c8108..9c3ca17a 100644
--- a/code/fms/fms-vue/src/components/ui/demo/modal.vue
+++ b/code/fms/fms-vue/src/components/ui/demo/modal.vue
@@ -63,7 +63,10 @@ function saveWithFeedback() {
     </div>
 
     <Modal v-model:open="modalBasicOpen" title="基础模态框" :width="440">
-      <p>这是一个基础模态框。拖动标题栏可移动位置，拖动右下角可调整尺寸；右上角可切换全屏；点击遮罩、关闭按钮或按 Esc 均可关闭。</p>
+      <p>
+        这是一个基础模态框。拖动标题栏可移动位置，拖动右下角可调整尺寸；右上角可切换全屏；点击遮罩、关闭按钮或按
+        Esc 均可关闭。
+      </p>
     </Modal>
 
     <Modal v-model:open="modalCenteredOpen" title="垂直居中" :width="440" centered>
diff --git a/code/fms/fms-vue/src/components/ui/demo/select.vue b/code/fms/fms-vue/src/components/ui/demo/select.vue
index 1265b5d1..e120a0b4 100644
--- a/code/fms/fms-vue/src/components/ui/demo/select.vue
+++ b/code/fms/fms-vue/src/components/ui/demo/select.vue
@@ -134,12 +134,7 @@ onBeforeUnmount(() => {
 
     <p class="demo-label">自定义字段名（labelKey / valueKey）</p>
     <div class="demo-panel demo-panel-grid">
-      <Select
-        v-model="regionValue"
-        :options="regionOptions"
-        label-key="name"
-        value-key="code"
-      />
+      <Select v-model="regionValue" :options="regionOptions" label-key="name" value-key="code" />
     </div>
 
     <p class="demo-label">插槽自定义选项</p>
diff --git a/code/fms/fms-vue/src/components/ui/demo/spin.vue b/code/fms/fms-vue/src/components/ui/demo/spin.vue
index 0b937327..d82ae940 100644
--- a/code/fms/fms-vue/src/components/ui/demo/spin.vue
+++ b/code/fms/fms-vue/src/components/ui/demo/spin.vue
@@ -13,7 +13,6 @@ const tableRows = [
   { name: '组件库', version: '1.2.0', status: '运行中' },
   { name: '主题系统', version: '2.0.0', status: '已停用' },
 ]
-
 </script>
 
 <template>
@@ -111,7 +110,9 @@ const tableRows = [
         </Spin>
       </div>
 
-      <p class="spin-hint">同一卡片在未包裹与包裹 Spin（含加载中）两种状态下尺寸一致，内部元素位置不偏移。</p>
+      <p class="spin-hint">
+        同一卡片在未包裹与包裹 Spin（含加载中）两种状态下尺寸一致，内部元素位置不偏移。
+      </p>
     </div>
   </section>
 </template>
diff --git a/code/fms/fms-vue/src/components/ui/demo/splitter.vue b/code/fms/fms-vue/src/components/ui/demo/splitter.vue
index 628a0489..bb2d2304 100644
--- a/code/fms/fms-vue/src/components/ui/demo/splitter.vue
+++ b/code/fms/fms-vue/src/components/ui/demo/splitter.vue
@@ -15,7 +15,9 @@ function onSplitterResize(sizes) {
     <div class="section-heading">
       <p class="eyebrow">Components</p>
       <h2 id="splitter-title">Splitter 分割面板</h2>
-      <p>水平或垂直分割容器，拖动分隔条调整各面板尺寸，支持固定尺寸、最小/最大约束与键盘方向键操作。</p>
+      <p>
+        水平或垂直分割容器，拖动分隔条调整各面板尺寸，支持固定尺寸、最小/最大约束与键盘方向键操作。
+      </p>
     </div>
 
     <p class="demo-label">水平分割（首尾固定，中间自适应）</p>
diff --git a/code/fms/fms-vue/src/components/ui/demo/tabs.vue b/code/fms/fms-vue/src/components/ui/demo/tabs.vue
index 236fe508..dfcb93c9 100644
--- a/code/fms/fms-vue/src/components/ui/demo/tabs.vue
+++ b/code/fms/fms-vue/src/components/ui/demo/tabs.vue
@@ -19,7 +19,9 @@ const tabsItems = [
     <div class="section-heading">
       <p class="eyebrow">Components</p>
       <h2 id="tabs-title">Tabs 标签页</h2>
-      <p>line 线型标签页，支持 TabPane 插槽与 items 数组两种数据源、左右侧边布局与键盘方向键导航。</p>
+      <p>
+        line 线型标签页，支持 TabPane 插槽与 items 数组两种数据源、左右侧边布局与键盘方向键导航。
+      </p>
     </div>
 
     <p class="demo-label">基础用法（TabPane 插槽）</p>
diff --git a/code/fms/fms-vue/src/components/ui/drawer/drawer.vue b/code/fms/fms-vue/src/components/ui/drawer/drawer.vue
index 4e6c15d1..c17ac0e0 100644
--- a/code/fms/fms-vue/src/components/ui/drawer/drawer.vue
+++ b/code/fms/fms-vue/src/components/ui/drawer/drawer.vue
@@ -157,7 +157,12 @@ onBeforeUnmount(() => {
 <template>
   <Teleport to="body">
     <Transition name="fms-drawer-mask">
-      <div v-if="isOpen && mask" class="fms-drawer-mask" aria-hidden="true" @click="onMaskClick"></div>
+      <div
+        v-if="isOpen && mask"
+        class="fms-drawer-mask"
+        aria-hidden="true"
+        @click="onMaskClick"
+      ></div>
     </Transition>
     <Transition name="fms-drawer">
       <div v-if="isOpen" class="fms-drawer-wrap" :class="`fms-drawer-${placement}`">
diff --git a/code/fms/fms-vue/src/components/ui/dropdown/DropdownItem.vue b/code/fms/fms-vue/src/components/ui/dropdown/DropdownItem.vue
index 7df2861d..68459813 100644
--- a/code/fms/fms-vue/src/components/ui/dropdown/DropdownItem.vue
+++ b/code/fms/fms-vue/src/components/ui/dropdown/DropdownItem.vue
@@ -6,7 +6,7 @@
  * 从而复用现有的键盘导航 / 高亮 / 子菜单体系。
  *
  * 支持的属性与 items 数组项一一对应：
- *   key      标识，点击时回传 @click 的 { key, item }
+ *   itemKey  标识，点击时回传 @click 的 { key, item }
  *   icon     图标组件（Lucide）
  *   label    菜单文本（也可直接用默认插槽写富内容，由父级读取 children）
  *   danger   危险项（红色）
@@ -15,7 +15,7 @@
  *   onClick  项自带点击回调，命中时优先执行
  */
 defineProps({
-  key: { type: [String, Number], default: undefined },
+  itemKey: { type: [String, Number], default: undefined },
   icon: { type: [Object, Function], default: undefined },
   label: { type: String, default: '' },
   danger: { type: Boolean, default: false },
diff --git a/code/fms/fms-vue/src/components/ui/dropdown/dropdown.vue b/code/fms/fms-vue/src/components/ui/dropdown/dropdown.vue
index 201be165..dbaa366b 100644
--- a/code/fms/fms-vue/src/components/ui/dropdown/dropdown.vue
+++ b/code/fms/fms-vue/src/components/ui/dropdown/dropdown.vue
@@ -50,7 +50,7 @@ function collectDropdownItems() {
       continue
     }
     const item = {}
-    if (p.key != null) item.key = p.key
+    if (p.itemKey != null) item.key = p.itemKey
     if (p.icon != null) item.icon = p.icon
     if (p.label != null) item.label = p.label
     if (p.danger) item.danger = true
@@ -188,13 +188,7 @@ provide('dropdownActiveIndex', activeIndex)
     </template>
 
     <template #content>
-      <div
-        ref="menuEl"
-        class="dropdown-menu"
-        role="menu"
-        tabindex="-1"
-        @keydown="onMenuKeydown"
-      >
+      <div ref="menuEl" class="dropdown-menu" role="menu" tabindex="-1" @keydown="onMenuKeydown">
         <!-- 富头部插槽：菜单项列表上方的自定义区域（头像+名字+组织等），有内容时才渲染 -->
         <div v-if="$slots.header" class="dropdown-header">
           <slot name="header" />
diff --git a/code/fms/fms-vue/src/components/ui/message/message-container.vue b/code/fms/fms-vue/src/components/ui/message/message-container.vue
index 9c939daa..a9d8fc16 100644
--- a/code/fms/fms-vue/src/components/ui/message/message-container.vue
+++ b/code/fms/fms-vue/src/components/ui/message/message-container.vue
@@ -4,9 +4,15 @@ import { messageState } from './message-store.js'
 
 /* 9 个方位：分组容器始终存在，仅消息项进出，保证 enter/leave 动画稳定触发 */
 const PLACEMENTS = [
-  'top-left', 'top-center', 'top-right',
-  'center-left', 'center', 'center-right',
-  'bottom-left', 'bottom-center', 'bottom-right',
+  'top-left',
+  'top-center',
+  'top-right',
+  'center-left',
+  'center',
+  'center-right',
+  'bottom-left',
+  'bottom-center',
+  'bottom-right',
 ]
 
 /* ---------- 关闭某条 ---------- */
diff --git a/code/fms/fms-vue/src/components/ui/modal/modal.vue b/code/fms/fms-vue/src/components/ui/modal/modal.vue
index c1b93c28..d3e244bf 100644
--- a/code/fms/fms-vue/src/components/ui/modal/modal.vue
+++ b/code/fms/fms-vue/src/components/ui/modal/modal.vue
@@ -258,10 +258,26 @@ onBeforeUnmount(() => {
           </div>
           <!-- 四边缩放手柄：拖动调整面板宽高，全屏时不可用 -->
           <template v-if="resizable && !isFullscreen">
-            <div ref="resizeERef" class="fms-modal-resizer fms-modal-resizer-e" aria-hidden="true"></div>
-            <div ref="resizeWRef" class="fms-modal-resizer fms-modal-resizer-w" aria-hidden="true"></div>
-            <div ref="resizeSRef" class="fms-modal-resizer fms-modal-resizer-s" aria-hidden="true"></div>
-            <div ref="resizeNRef" class="fms-modal-resizer fms-modal-resizer-n" aria-hidden="true"></div>
+            <div
+              ref="resizeERef"
+              class="fms-modal-resizer fms-modal-resizer-e"
+              aria-hidden="true"
+            ></div>
+            <div
+              ref="resizeWRef"
+              class="fms-modal-resizer fms-modal-resizer-w"
+              aria-hidden="true"
+            ></div>
+            <div
+              ref="resizeSRef"
+              class="fms-modal-resizer fms-modal-resizer-s"
+              aria-hidden="true"
+            ></div>
+            <div
+              ref="resizeNRef"
+              class="fms-modal-resizer fms-modal-resizer-n"
+              aria-hidden="true"
+            ></div>
           </template>
         </div>
       </div>
diff --git a/code/fms/fms-vue/src/components/ui/notification/notification-container.vue b/code/fms/fms-vue/src/components/ui/notification/notification-container.vue
index e2a2b1fd..2990cb61 100644
--- a/code/fms/fms-vue/src/components/ui/notification/notification-container.vue
+++ b/code/fms/fms-vue/src/components/ui/notification/notification-container.vue
@@ -5,9 +5,15 @@ import { notificationState } from './notification-store.js'
 
 /* 9 个方位：分组容器始终存在，仅通知项进出，保证 enter/leave 动画稳定触发 */
 const PLACEMENTS = [
-  'top-left', 'top-center', 'top-right',
-  'center-left', 'center', 'center-right',
-  'bottom-left', 'bottom-center', 'bottom-right',
+  'top-left',
+  'top-center',
+  'top-right',
+  'center-left',
+  'center',
+  'center-right',
+  'bottom-left',
+  'bottom-center',
+  'bottom-right',
 ]
 
 /* ---------- 关闭某条 ---------- */
diff --git a/code/fms/fms-vue/src/components/ui/pagination/pagination.vue b/code/fms/fms-vue/src/components/ui/pagination/pagination.vue
index a7d8aaf9..ef1808a6 100644
--- a/code/fms/fms-vue/src/components/ui/pagination/pagination.vue
+++ b/code/fms/fms-vue/src/components/ui/pagination/pagination.vue
@@ -48,9 +48,7 @@ const pageSizeValue = computed(() =>
 // 每页条数选项统一转为数字，保证与 pageSize 值类型匹配
 const sizeOptions = computed(() => props.pageSizeOptions.map((item) => Number(item)))
 
-const totalPages = computed(() =>
-  Math.max(1, Math.ceil((props.total || 0) / pageSizeValue.value)),
-)
+const totalPages = computed(() => Math.max(1, Math.ceil((props.total || 0) / pageSizeValue.value)))
 
 // 显示层当前页：受控取 props，非受控取内部值；越界时收敛到 [1, totalPages]，
 // 受控模式不写回 props，保持受控语义由调用方同步
diff --git a/code/fms/fms-vue/src/components/ui/popover/popover.vue b/code/fms/fms-vue/src/components/ui/popover/popover.vue
index 431a77a6..5534e554 100644
--- a/code/fms/fms-vue/src/components/ui/popover/popover.vue
+++ b/code/fms/fms-vue/src/components/ui/popover/popover.vue
@@ -157,7 +157,14 @@ function onContextMenu(event) {
   event.preventDefault()
   const { clientX, clientY } = event
   // 右键在鼠标位置弹出：构造零尺寸锚点矩形，computePosition 的 flip/shift 会兜底防溢出
-  pointAnchor = { left: clientX, top: clientY, width: 0, height: 0, right: clientX, bottom: clientY }
+  pointAnchor = {
+    left: clientX,
+    top: clientY,
+    width: 0,
+    height: 0,
+    right: clientX,
+    bottom: clientY,
+  }
   if (isOpen.value) {
     // 已打开时右键到新位置，仅重新定位不重置状态
     updatePosition()
diff --git a/code/fms/fms-vue/src/components/ui/spin/spin.vue b/code/fms/fms-vue/src/components/ui/spin/spin.vue
index 481f9faa..38958287 100644
--- a/code/fms/fms-vue/src/components/ui/spin/spin.vue
+++ b/code/fms/fms-vue/src/components/ui/spin/spin.vue
@@ -48,9 +48,7 @@ function hasDefaultSlot() {
   return !!(slots.default && slots.default().length > 0)
 }
 
-const hasDescription = computed(
-  () => !!props.description || !!slots.description,
-)
+const hasDescription = computed(() => !!props.description || !!slots.description)
 </script>
 
 <template>
diff --git a/code/fms/fms-vue/src/components/ui/switch/index.scss b/code/fms/fms-vue/src/components/ui/switch/index.scss
index 6a77a81a..9d4308a6 100644
--- a/code/fms/fms-vue/src/components/ui/switch/index.scss
+++ b/code/fms/fms-vue/src/components/ui/switch/index.scss
@@ -45,8 +45,8 @@
 .switch-checked .switch-thumb {
   transform: translateX(
     calc(
-      var(--fms-switch-width) - var(--fms-switch-thumb-size) -
-      var(--fms-switch-thumb-offset) - var(--fms-switch-thumb-offset)
+      var(--fms-switch-width) - var(--fms-switch-thumb-size) - var(--fms-switch-thumb-offset) -
+        var(--fms-switch-thumb-offset)
     )
   );
 }
diff --git a/code/fms/fms-vue/src/components/ui/tabs/tabs.vue b/code/fms/fms-vue/src/components/ui/tabs/tabs.vue
index 04968fc1..c2760824 100644
--- a/code/fms/fms-vue/src/components/ui/tabs/tabs.vue
+++ b/code/fms/fms-vue/src/components/ui/tabs/tabs.vue
@@ -81,8 +81,7 @@ const slotPanes = computed(() => {
     const paneProps = node.props ?? {}
     const { content, label } = extractChildren(node.children)
     // key 解析顺序：tabKey prop > vnode.key > 出现顺序索引
-    const rawKey =
-      paneProps.tabKey != null ? paneProps.tabKey : node.key != null ? node.key : index
+    const rawKey = paneProps.tabKey != null ? paneProps.tabKey : node.key != null ? node.key : index
     panes.push({
       key: String(rawKey),
       rawKey,
diff --git a/code/fms/fms-vue/src/components/ui/tag/tag.vue b/code/fms/fms-vue/src/components/ui/tag/tag.vue
index 28a6a7a8..a5f9caeb 100644
--- a/code/fms/fms-vue/src/components/ui/tag/tag.vue
+++ b/code/fms/fms-vue/src/components/ui/tag/tag.vue
@@ -14,8 +14,7 @@ const props = defineProps({
     /** @type {TagVariant} */
     type: String,
     default: 'default',
-    validator: (value) =>
-      ['default', 'secondary', 'outline', 'danger', 'ghost'].includes(value),
+    validator: (value) => ['default', 'secondary', 'outline', 'danger', 'ghost'].includes(value),
   },
   /** 是否可关闭：显示关闭按钮，点击后触发 close 并隐藏自身 */
   closable: { type: Boolean, default: false },
diff --git a/code/fms/fms-vue/src/layouts/DefaultLayout.vue b/code/fms/fms-vue/src/layouts/DefaultLayout.vue
index ab9bb3ad..7a5b207f 100644
--- a/code/fms/fms-vue/src/layouts/DefaultLayout.vue
+++ b/code/fms/fms-vue/src/layouts/DefaultLayout.vue
@@ -1,5 +1,5 @@
 <script setup>
-import { computed, ref } from 'vue'
+import { computed, defineComponent, h, ref, watch } from 'vue'
 import { useRoute } from 'vue-router'
 import { useAppStore } from '@/stores/app'
 import Splitter from '@/components/ui/splitter/splitter.vue'
@@ -7,13 +7,54 @@ import SplitterPanel from '@/components/ui/splitter/panel.vue'
 import AppSidebar from './components/AppSidebar.vue'
 import AppTabs from './components/AppTabs.vue'
 import AppTopbar from './components/AppTopbar.vue'
+import DetailPage from '@/views/detail/DetailPage.vue'
+import { cacheKeyOf } from '@/utils/cacheKey'
 
 const route = useRoute()
 const appStore = useAppStore()
 
-// 路由实例 key：fullPath + 刷新计数，双击页签刷新时强制重渲染
-const routeInstanceKey = computed(
-  () => `${route.fullPath}:${appStore.getRouteRefreshKey(route.fullPath)}`,
+/* 页签缓存核心（统一处理所有页签，含详情页）：
+ * - keep-alive 的 cache key = 外层 <component> 的 :key = route.fullPath（稳定）。
+ *   因此切来切去、刷新都不会生成新的 keep-alive 缓存项 —— 消除「刷新泄漏」。
+ * - 刷新（双击页签）仅改变内层 <component> 的 :key（fullPath:refreshKey），
+ *   使页面组件自身重新挂载、状态归零，而外层缓存槽位不变。
+ * - 每个页签一个命名包装组件（include 名：普通页 = componentName，详情页 =
+ *   cacheKeyOf(fullPath)），使 keep-alive 的 include 能按页签精确销毁实例；
+ *   不同参数（/detail/1、/detail/2）因外层 key = fullPath 不同而天然多个独立缓存。 */
+const pageWrapperCache = {}
+function getPageWrapper(name, fullPath, innerComponent) {
+  if (!pageWrapperCache[name]) {
+    pageWrapperCache[name] = {
+      fullPath,
+      comp: defineComponent({
+        name,
+        setup() {
+          const r = useRoute()
+          const app = useAppStore()
+          return () => {
+            const inner = r.meta?.cacheByKey ? h(DetailPage, { id: r.params.id }) : innerComponent
+            const innerKey = `${r.fullPath}:${app.getRouteRefreshKey(r.fullPath)}`
+            return h(inner, { key: innerKey })
+          }
+        },
+      }),
+    }
+  }
+  return pageWrapperCache[name].comp
+}
+
+/* 回收已关闭详情页（page_ 前缀）的包装组件定义，避免 pageWrapperCache 随访问过的
+ * fullPath 无限增长（普通页的 componentName 数量有限、实例本身由 keep-alive :max 限制）。 */
+watch(
+  () => appStore.visitedTabs.map((t) => t.key),
+  (keys) => {
+    const keep = new Set(keys)
+    for (const name of Object.keys(pageWrapperCache)) {
+      if (name.startsWith('page_') && !keep.has(pageWrapperCache[name].fullPath)) {
+        delete pageWrapperCache[name]
+      }
+    }
+  },
 )
 
 /* ---------- 侧栏宽度（展开态可拖拽调宽，由 Splitter 接管） ---------- */
@@ -70,8 +111,19 @@ function onSplitterResize(sizes) {
             <div class="fms-content">
               <router-view v-slot="{ Component }">
                 <transition name="page" mode="out-in">
-                  <keep-alive :max="8">
-                    <component :is="Component" :key="routeInstanceKey" />
+                  <keep-alive :include="appStore.cachedViews" :max="8">
+                    <component
+                      :is="
+                        getPageWrapper(
+                          route.meta?.cacheByKey
+                            ? cacheKeyOf(route.fullPath)
+                            : route.meta?.componentName,
+                          route.fullPath,
+                          Component,
+                        )
+                      "
+                      :key="route.fullPath"
+                    />
                   </keep-alive>
                 </transition>
               </router-view>
diff --git a/code/fms/fms-vue/src/layouts/components/AppSidebar.vue b/code/fms/fms-vue/src/layouts/components/AppSidebar.vue
index 04109bc1..cdf2e081 100644
--- a/code/fms/fms-vue/src/layouts/components/AppSidebar.vue
+++ b/code/fms/fms-vue/src/layouts/components/AppSidebar.vue
@@ -1,6 +1,14 @@
 <script setup>
 import { computed, onMounted, ref } from 'vue'
-import { AudioWaveform, Check, ChevronsUpDown, Command, Component, GalleryVerticalEnd, LayoutGrid } from '@lucide/vue'
+import {
+  AudioWaveform,
+  Check,
+  ChevronsUpDown,
+  Command,
+  Component,
+  GalleryVerticalEnd,
+  LayoutGrid,
+} from '@lucide/vue'
 import { useAppStore } from '@/stores/app'
 import { usePermissionStore } from '@/stores/permissions'
 import { getIcon } from '@/utils/lucideIcons'
@@ -41,7 +49,6 @@ const navMain = computed(() => {
     ],
   })
 
-
   const menuModules = permissionStore.modules.filter(
     (m) => m.b_canmenu === 1 && m.b_canuse === 1 && ['directory', 'page'].includes(m.b_module_type),
   )
diff --git a/code/fms/fms-vue/src/layouts/components/AppTabs.vue b/code/fms/fms-vue/src/layouts/components/AppTabs.vue
index 824157f1..f7900659 100644
--- a/code/fms/fms-vue/src/layouts/components/AppTabs.vue
+++ b/code/fms/fms-vue/src/layouts/components/AppTabs.vue
@@ -5,6 +5,7 @@ import { useRoute, useRouter } from 'vue-router'
 import { useAppStore } from '@/stores/app'
 import Button from '@/components/ui/button/button.vue'
 import Dropdown from '@/components/ui/dropdown/dropdown.vue'
+import { cacheKeyOf } from '@/utils/cacheKey'
 
 const route = useRoute()
 const router = useRouter()
@@ -23,10 +24,14 @@ watch(
   async () => {
     const title = route.meta?.title
     if (title) {
+      // cacheByKey 路由（如 /detail/:id）：每个 fullPath 一个独立组件名，
+      // 使 keep-alive 的 include 能按参数精确销毁其实例，且不同参数天然多个独立缓存。
+      const name = route.meta?.cacheByKey ? cacheKeyOf(route.fullPath) : route.meta?.componentName
       appStore.addVisitedTab({
         key: route.fullPath,
         label: title,
         closable: route.fullPath !== '/dashboard',
+        name,
       })
     }
     await nextTick()
@@ -325,21 +330,21 @@ function refreshTab(key) {
   &.is-active {
     background: var(--fms-primary);
     border-color: var(--fms-primary);
-    color: #fff;
+    color: var(--fms-primary-text);
   }
 
   &.is-active:hover {
     background: var(--fms-primary);
     border-color: var(--fms-primary);
-    color: #fff;
+    color: var(--fms-primary-text);
   }
 
   &.is-active .fms-tab-close {
-    color: rgba(255, 255, 255, 0.85);
+    color: color-mix(in srgb, var(--fms-primary-text) 85%, transparent);
 
     &:hover {
-      background: rgba(255, 255, 255, 0.22);
-      color: #fff;
+      background: color-mix(in srgb, var(--fms-primary-text) 22%, transparent);
+      color: var(--fms-primary-text);
     }
   }
 }
diff --git a/code/fms/fms-vue/src/layouts/components/AppTopbar.vue b/code/fms/fms-vue/src/layouts/components/AppTopbar.vue
index 0ba7541f..075fc494 100644
--- a/code/fms/fms-vue/src/layouts/components/AppTopbar.vue
+++ b/code/fms/fms-vue/src/layouts/components/AppTopbar.vue
@@ -3,29 +3,43 @@ import { computed, ref, onMounted, onBeforeUnmount } from 'vue'
 import {
   BadgeCheck,
   Bell,
+  Check,
   CreditCard,
   Languages,
   LogOut,
   Maximize,
   Minimize,
+  Moon,
   Palette,
   PanelLeft,
   Search,
+  Sun,
 } from '@lucide/vue'
 import { useRouter } from 'vue-router'
 import { useAppStore } from '@/stores/app'
 import { useAuthStore } from '@/stores/auth'
 import { Message } from '@/components/ui/message/message-manager'
+import { PRESETS } from '@/theme/presets'
 import Dropdown from '@/components/ui/dropdown/dropdown.vue'
 import Button from '@/components/ui/button/button.vue'
 import Input from '@/components/ui/input/input.vue'
-import ThemeToggle from '@/components/ui/ThemeToggle.vue'
-import ColorThemePicker from '@/components/ui/ColorThemePicker.vue'
 
 const router = useRouter()
 const appStore = useAppStore()
 const authStore = useAuthStore()
 
+/* 深浅色切换：原 ThemeToggle 组件逻辑内联，按钮样式复用 .fms-icon-btn */
+const isDark = computed(() => appStore.darkMode)
+function toggleDark() {
+  appStore.toggleDark()
+}
+
+/* 主色选择：原 ColorThemePicker 组件逻辑内联，直接复用 .fms-icon-btn 风格 */
+const activeColor = computed(() => appStore.primaryColor)
+function pickColor(color) {
+  appStore.setPrimary(color)
+}
+
 const user = computed(() => ({
   name: authStore.user?.name ?? '用户',
   account: authStore.user?.account ?? '',
@@ -128,13 +142,35 @@ onBeforeUnmount(() => document.removeEventListener('fullscreenchange', syncFulls
         </template>
         <template #menu>
           <div class="fms-topbar-scheme">
-            <ColorThemePicker />
+            <div class="color-picker" role="group" aria-label="主题色">
+              <button
+                v-for="preset in PRESETS"
+                :key="preset.color"
+                class="swatch"
+                type="button"
+                :style="{ background: preset.color }"
+                :aria-label="preset.name"
+                :title="preset.name"
+                :aria-pressed="activeColor === preset.color"
+                @click="pickColor(preset.color)"
+              >
+                <Check v-if="activeColor === preset.color" class="check" />
+              </button>
+            </div>
           </div>
         </template>
       </Dropdown>
 
       <!-- 深浅色切换 -->
-      <ThemeToggle />
+      <Button
+        type="ghost"
+        class="fms-icon-btn"
+        :aria-label="isDark ? '切换到浅色模式' : '切换到深色模式'"
+        :title="isDark ? '浅色模式' : '深色模式'"
+        @click="toggleDark"
+      >
+        <component :is="isDark ? Moon : Sun" />
+      </Button>
 
       <!-- 全屏切换 -->
       <Button
@@ -153,12 +189,7 @@ onBeforeUnmount(() => document.removeEventListener('fullscreenchange', syncFulls
       <span class="fms-separator" aria-hidden="true" />
 
       <!-- 用户下拉：菜单项走组件库标准 items，不手写；富头部渲染头像+名字+组织 -->
-      <Dropdown
-        placement="bottom-end"
-        :offset="8"
-        :items="userMenuItems"
-        @click="onUserMenuClick"
-      >
+      <Dropdown placement="bottom-end" :offset="8" :items="userMenuItems" @click="onUserMenuClick">
         <template #trigger>
           <button class="fms-user-trigger" type="button" :title="user.name">
             <span class="fms-avatar">{{ user.name.slice(0, 1) }}</span>
@@ -303,6 +334,46 @@ onBeforeUnmount(() => document.removeEventListener('fullscreenchange', syncFulls
   padding: 4px 8px 8px;
 }
 
+/* 色板（原 ColorThemePicker 组件内联） */
+.color-picker {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+  align-items: center;
+}
+
+.swatch {
+  position: relative;
+  width: 22px;
+  height: 22px;
+  border: none;
+  border-radius: 50%;
+  padding: 0;
+  cursor: pointer;
+  outline: 2px solid transparent;
+  outline-offset: 1px;
+  transition:
+    outline-color 120ms ease,
+    transform 120ms ease;
+
+  &:hover {
+    transform: scale(1.1);
+  }
+
+  &:focus-visible {
+    outline-color: var(--fms-primary);
+  }
+}
+
+.check {
+  position: absolute;
+  inset: 0;
+  margin: auto;
+  width: 14px;
+  height: 14px;
+  color: var(--fms-primary-text);
+}
+
 /* 用户触发按钮 */
 .fms-user-trigger {
   display: flex;
diff --git a/code/fms/fms-vue/src/router/index.js b/code/fms/fms-vue/src/router/index.js
index 2f471ee5..dcee93de 100644
--- a/code/fms/fms-vue/src/router/index.js
+++ b/code/fms/fms-vue/src/router/index.js
@@ -26,51 +26,59 @@ const router = createRouter({
           path: '/dashboard',
           name: 'dashboard',
           component: () => import('@/views/dashboard/index.vue'),
-          meta: { title: '工作台' },
+          meta: { title: '工作台', componentName: 'Dashboard' },
         },
         // 测试页：用于演练 Tabs 导航（无需权限，纯布局验证）
         {
           path: '/test/list',
           name: 'test-list',
           component: () => import('@/views/test/TestPage.vue'),
-          meta: { title: '测试-列表' },
+          meta: { title: '测试-列表', componentName: 'TestPage' },
         },
         {
           path: '/test/form',
           name: 'test-form',
           component: () => import('@/views/test/TestPage.vue'),
-          meta: { title: '测试-表单' },
+          meta: { title: '测试-表单', componentName: 'TestPage' },
         },
         {
           path: '/test/detail',
           name: 'test-detail',
           component: () => import('@/views/test/TestPage.vue'),
-          meta: { title: '测试-详情' },
+          meta: { title: '测试-详情', componentName: 'TestPage' },
         },
         {
           path: '/test/chart',
           name: 'test-chart',
           component: () => import('@/views/test/TestPage.vue'),
-          meta: { title: '测试-图表' },
+          meta: { title: '测试-图表', componentName: 'TestPage' },
         },
         {
           path: '/test/table',
           name: 'test-table',
           component: () => import('@/views/test/TestPage.vue'),
-          meta: { title: '测试-表格' },
+          meta: { title: '测试-表格', componentName: 'TestPage' },
         },
         {
           path: '/test/settings',
           name: 'test-settings',
           component: () => import('@/views/test/TestPage.vue'),
-          meta: { title: '测试-设置' },
+          meta: { title: '测试-设置', componentName: 'TestPage' },
         },
         // 组件库演练场：纳入业务布局（带侧栏 / 顶栏 / Tabs）
         {
           path: '/demo',
           name: 'demo',
           component: () => import('@/views/demo/index.vue'),
-          meta: { title: '组件库' },
+          meta: { title: '组件库', componentName: 'Demo' },
+        },
+        // 详情页：同一组件按参数复用，但每个 fullPath 独立缓存、关闭即销毁
+        // （per-param 的命名组件由 DefaultLayout 的 getPageWrapper 按路由动态生成）
+        {
+          path: '/detail/:id',
+          name: 'detail',
+          component: () => import('@/views/detail/DetailPage.vue'),
+          meta: { title: '详情', cacheByKey: true },
         },
         // 业务页面后续在此追加，配置 meta.moduleId 后自动走权限校验
       ],
diff --git a/code/fms/fms-vue/src/stores/app.js b/code/fms/fms-vue/src/stores/app.js
index 120ae5c8..4fedbdcb 100644
--- a/code/fms/fms-vue/src/stores/app.js
+++ b/code/fms/fms-vue/src/stores/app.js
@@ -12,11 +12,21 @@ export const useAppStore = defineStore('app', {
     /** 界面语言（占位：项目暂无 i18n 文案，仅保留切换状态） */
     locale: 'zh-CN',
     /** 已访问页签列表；工作台固定不可关闭 */
-    visitedTabs: [{ key: '/dashboard', label: '工作台', closable: false }],
+    visitedTabs: [{ key: '/dashboard', label: '工作台', closable: false, name: 'Dashboard' }],
     /** 路由刷新计数表：key 为路由 fullPath，值变化即强制重渲染该路由 */
     routeRefreshKeys: {},
   }),
 
+  getters: {
+    /** keep-alive 的 include 列表：当前打开页签对应的组件名（去重）。
+     *  页签关闭时该集合随之缩小，keep-alive 据此销毁对应缓存实例，
+     *  实现"关闭页签即销毁缓存" */
+    cachedViews: (state) => {
+      const names = state.visitedTabs.map((t) => t.name).filter(Boolean)
+      return [...new Set(names)]
+    },
+  },
+
   actions: {
     setDark(value) {
       this.darkMode = !!value
@@ -43,30 +53,39 @@ export const useAppStore = defineStore('app', {
     removeVisitedTab(key) {
       const index = this.visitedTabs.findIndex((t) => t.key === key)
       if (index >= 0) this.visitedTabs.splice(index, 1)
+      // 同步清理该页签的刷新计数（对齐 old1：关闭即释放，避免 key 无限累积）
+      if (key in this.routeRefreshKeys) delete this.routeRefreshKeys[key]
     },
     /** 关闭其他：保留工作台（不可关）与指定 key */
     closeOthers(key) {
-      this.visitedTabs = this.visitedTabs.filter(
-        (t) => t.key === '/dashboard' || t.key === key,
-      )
+      this.visitedTabs = this.visitedTabs.filter((t) => t.key === '/dashboard' || t.key === key)
+      this.pruneOrphanRefreshKeys()
     },
     /** 关闭左侧：保留工作台与指定 key 及其右侧 */
     closeLeft(key) {
       const idx = this.visitedTabs.findIndex((t) => t.key === key)
       if (idx <= 0) return
-      this.visitedTabs = this.visitedTabs.filter(
-        (t, i) => i >= idx || t.key === '/dashboard',
-      )
+      this.visitedTabs = this.visitedTabs.filter((t, i) => i >= idx || t.key === '/dashboard')
+      this.pruneOrphanRefreshKeys()
     },
     /** 关闭右侧：保留指定 key 及其左侧（含工作台） */
     closeRight(key) {
       const idx = this.visitedTabs.findIndex((t) => t.key === key)
       if (idx < 0) return
       this.visitedTabs = this.visitedTabs.filter((t, i) => i <= idx)
+      this.pruneOrphanRefreshKeys()
     },
     /** 关闭全部：仅保留工作台 */
     closeAll() {
       this.visitedTabs = this.visitedTabs.filter((t) => t.key === '/dashboard')
+      this.pruneOrphanRefreshKeys()
+    },
+    /** 清理已关闭页签残留的刷新计数，避免 routeRefreshKeys 无限增长 */
+    pruneOrphanRefreshKeys() {
+      const keep = new Set(this.visitedTabs.map((t) => t.key))
+      for (const key of Object.keys(this.routeRefreshKeys)) {
+        if (!keep.has(key)) delete this.routeRefreshKeys[key]
+      }
     },
     getRouteRefreshKey(key) {
       return this.routeRefreshKeys[key] ?? 0
diff --git a/code/fms/fms-vue/src/utils/cacheKey.js b/code/fms/fms-vue/src/utils/cacheKey.js
new file mode 100644
index 00000000..0bd9a318
--- /dev/null
+++ b/code/fms/fms-vue/src/utils/cacheKey.js
@@ -0,0 +1,11 @@
+/**
+ * 页签缓存标识：把路由 fullPath 映射为 keep-alive include 可匹配的唯一组件名。
+ *
+ * 背景：keep-alive 的 include/exclude 只能按「组件名」匹配，无法按 :key（fullPath）精确销毁。
+ * 对于「同一组件被不同参数复用」（如 /detail/1、/detail/2 共用 DetailPage）的场景，
+ * 需要让每个 fullPath 拥有独立的组件类型与组件名，include 才能按参数精确销毁其实例，
+ * 同时不同参数天然成为多个独立缓存。
+ */
+export function cacheKeyOf(fullPath) {
+  return `page_${encodeURIComponent(fullPath)}`
+}
diff --git a/code/fms/fms-vue/src/views/dashboard/index.vue b/code/fms/fms-vue/src/views/dashboard/index.vue
index 019f57af..8d6f27c0 100644
--- a/code/fms/fms-vue/src/views/dashboard/index.vue
+++ b/code/fms/fms-vue/src/views/dashboard/index.vue
@@ -1,5 +1,16 @@
 <script setup>
 import { LayoutDashboard } from '@lucide/vue'
+import { useRouter } from 'vue-router'
+import Button from '@/components/ui/button/button.vue'
+
+defineOptions({ name: 'Dashboard' })
+
+const router = useRouter()
+
+// 跳转到详情页（不同 id = 不同路由缓存），用于验证「多参数独立缓存」
+function goDetail(id) {
+  router.push(`/detail/${id}`)
+}
 </script>
 
 <template>
@@ -8,7 +19,13 @@ import { LayoutDashboard } from '@lucide/vue'
       <LayoutDashboard />
     </div>
     <h1 class="dashboard-title">工作台</h1>
-    <p class="dashboard-desc">布局壳与业务页面正在搭建中，敬请期待。</p>
+    <p class="dashboard-desc">布局壳与业务页面已就绪，点击下方按钮进入详情页验证多参数缓存。</p>
+
+    <div class="dashboard-actions">
+      <Button type="primary" @click="goDetail(1)">打开详情 #1</Button>
+      <Button type="primary" @click="goDetail(2)">打开详情 #2</Button>
+      <Button type="primary" @click="goDetail(3)">打开详情 #3</Button>
+    </div>
   </div>
 </template>
 
@@ -53,4 +70,11 @@ import { LayoutDashboard } from '@lucide/vue'
   font-size: 14px;
   color: var(--fms-text-secondary);
 }
+
+.dashboard-actions {
+  display: flex;
+  gap: 12px;
+  flex-wrap: wrap;
+  margin-top: 8px;
+}
 </style>
diff --git a/code/fms/fms-vue/src/views/demo/index.vue b/code/fms/fms-vue/src/views/demo/index.vue
index 8d2890af..c0b1b794 100644
--- a/code/fms/fms-vue/src/views/demo/index.vue
+++ b/code/fms/fms-vue/src/views/demo/index.vue
@@ -1,7 +1,11 @@
 <script setup>
-import { ref } from 'vue'
-import ThemeToggle from '@/components/ui/ThemeToggle.vue'
-import ColorThemePicker from '@/components/ui/ColorThemePicker.vue'
+import { ref, computed } from 'vue'
+
+defineOptions({ name: 'Demo' })
+import { Check, Moon, Sun } from '@lucide/vue'
+import { useAppStore } from '@/stores/app'
+import { PRESETS } from '@/theme/presets'
+import Button from '@/components/ui/button/button.vue'
 import ButtonDemo from '@/components/ui/demo/button.vue'
 import ButtonGroupDemo from '@/components/ui/demo/button-group.vue'
 import TabsDemo from '@/components/ui/demo/tabs.vue'
@@ -27,6 +31,18 @@ import TagDemo from '@/components/ui/demo/tag.vue'
 import TreeDemo from '@/components/ui/demo/tree.vue'
 
 /* ---------- 导航分类 ---------- */
+const appStore = useAppStore()
+const isDark = computed(() => appStore.darkMode)
+function toggleDark() {
+  appStore.toggleDark()
+}
+
+/* 主色选择：原 ColorThemePicker 组件逻辑内联 */
+const activeColor = computed(() => appStore.primaryColor)
+function pickColor(color) {
+  appStore.setPrimary(color)
+}
+
 const activeKey = ref('button')
 
 const categories = [
@@ -112,8 +128,29 @@ const demoMap = {
       </div>
 
       <div class="theme-controls">
-        <ColorThemePicker />
-        <ThemeToggle />
+        <div class="color-picker" role="group" aria-label="主题色">
+          <button
+            v-for="preset in PRESETS"
+            :key="preset.color"
+            class="swatch"
+            type="button"
+            :style="{ background: preset.color }"
+            :aria-label="preset.name"
+            :title="preset.name"
+            :aria-pressed="activeColor === preset.color"
+            @click="pickColor(preset.color)"
+          >
+            <Check v-if="activeColor === preset.color" class="check" />
+          </button>
+        </div>
+        <Button
+          type="ghost"
+          class="theme-toggle-btn"
+          :title="isDark ? '浅色模式' : '深色模式'"
+          @click="toggleDark"
+        >
+          <component :is="isDark ? Moon : Sun" />
+        </Button>
       </div>
     </header>
 
@@ -179,6 +216,75 @@ const demoMap = {
   gap: 12px;
 }
 
+.theme-toggle-btn {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 32px;
+  height: 32px;
+  padding: 0;
+  border: none;
+  border-radius: var(--fms-control-radius);
+  background: transparent;
+  color: var(--fms-text);
+  cursor: pointer;
+  transition: background-color 150ms ease;
+}
+
+.theme-toggle-btn:hover {
+  background: var(--fms-secondary-hover);
+}
+
+.theme-toggle-btn:focus-visible {
+  outline: 2px solid var(--fms-primary);
+  outline-offset: 2px;
+}
+
+.theme-toggle-btn svg {
+  width: 16px;
+  height: 16px;
+}
+
+/* 色板（原 ColorThemePicker 组件内联） */
+.color-picker {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+  align-items: center;
+}
+
+.swatch {
+  position: relative;
+  width: 22px;
+  height: 22px;
+  border: none;
+  border-radius: 50%;
+  padding: 0;
+  cursor: pointer;
+  outline: 2px solid transparent;
+  outline-offset: 1px;
+  transition:
+    outline-color 120ms ease,
+    transform 120ms ease;
+
+  &:hover {
+    transform: scale(1.1);
+  }
+
+  &:focus-visible {
+    outline-color: var(--fms-primary);
+  }
+}
+
+.check {
+  position: absolute;
+  inset: 0;
+  margin: auto;
+  width: 14px;
+  height: 14px;
+  color: #fff;
+}
+
 .app-body {
   display: flex;
   align-items: flex-start;
diff --git a/code/fms/fms-vue/src/views/detail/DetailPage.vue b/code/fms/fms-vue/src/views/detail/DetailPage.vue
new file mode 100644
index 00000000..4cbffad8
--- /dev/null
+++ b/code/fms/fms-vue/src/views/detail/DetailPage.vue
@@ -0,0 +1,129 @@
+<script setup>
+import { ref } from 'vue'
+
+const props = defineProps({
+  /** 详情 id（由路由参数经工厂注入，保证每个 fullPath 拿到自己的 id） */
+  id: { type: [String, Number], default: '' },
+})
+
+// 下面这个输入框用于验证「缓存按 fullPath 隔离」：
+// 在同一参数页输入内容后切换/关闭再回来，值应保留；不同参数之间互不影响。
+const draft = ref('')
+const counter = ref(0)
+</script>
+
+<template>
+  <div class="detail-page">
+    <h1 class="detail-title">详情页 #{{ id }}</h1>
+    <p class="detail-sub">
+      当前路由：<code>{{ $route.fullPath }}</code>
+    </p>
+
+    <div class="detail-card">
+      <p class="detail-hint">
+        本页每个 <code>id</code> 是<strong>独立缓存</strong>：切换 / 关闭后再回到相同
+        <code>id</code>，下方输入内容与计数会保留；不同 <code>id</code> 之间互不影响。
+      </p>
+
+      <label class="detail-field">
+        <span>测试输入（验证缓存隔离）</span>
+        <input v-model="draft" class="detail-input" placeholder="输入点什么，再切换页签回来看看" />
+      </label>
+
+      <div class="detail-row">
+        <Button type="primary" @click="counter += 1">计数 +1（当前 {{ counter }}）</Button>
+        <span class="detail-tip">关闭本页签再重开，计数归零说明缓存已销毁；保留说明命中缓存。</span>
+      </div>
+    </div>
+  </div>
+</template>
+
+<style lang="scss" scoped>
+.detail-page {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+  color: var(--fms-text);
+}
+
+.detail-title {
+  margin: 0;
+  font-size: 20px;
+  font-weight: 600;
+}
+
+.detail-sub {
+  margin: 0;
+  font-size: 13px;
+  color: var(--fms-text-secondary);
+
+  code {
+    padding: 1px 6px;
+    border-radius: 4px;
+    background: var(--fms-secondary-hover);
+    font-size: 12px;
+  }
+}
+
+.detail-card {
+  display: flex;
+  flex-direction: column;
+  gap: 16px;
+  padding: 16px;
+  border: 1px solid var(--fms-border);
+  border-radius: var(--fms-control-radius);
+  background: var(--fms-card);
+}
+
+.detail-hint {
+  margin: 0;
+  font-size: 13px;
+  line-height: 20px;
+  color: var(--fms-text-secondary);
+
+  code {
+    padding: 1px 6px;
+    border-radius: 4px;
+    background: var(--fms-secondary-hover);
+    font-size: 12px;
+  }
+}
+
+.detail-field {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  font-size: 13px;
+  color: var(--fms-text-secondary);
+}
+
+.detail-input {
+  width: 320px;
+  max-width: 100%;
+  height: 32px;
+  padding: 0 10px;
+  border: 1px solid var(--fms-border);
+  border-radius: var(--fms-control-radius);
+  background: var(--fms-background);
+  color: var(--fms-text);
+  font-size: 14px;
+  font-family: inherit;
+
+  &:focus {
+    outline: 2px solid var(--fms-primary);
+    outline-offset: -2px;
+  }
+}
+
+.detail-row {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  flex-wrap: wrap;
+}
+
+.detail-tip {
+  font-size: 12px;
+  color: var(--fms-text-secondary);
+}
+</style>
diff --git a/code/fms/fms-vue/src/views/login/index.vue b/code/fms/fms-vue/src/views/login/index.vue
index 41f4ceb6..3e7d7e49 100644
--- a/code/fms/fms-vue/src/views/login/index.vue
+++ b/code/fms/fms-vue/src/views/login/index.vue
@@ -94,13 +94,23 @@ function onFailed() {
         @submit-failed="onFailed"
       >
         <FormItem name="orgId" label="机构码">
-          <Input id="orgId" v-model="formModel.orgId" placeholder="请输入机构码" :disabled="submitting">
+          <Input
+            id="orgId"
+            v-model="formModel.orgId"
+            placeholder="请输入机构码"
+            :disabled="submitting"
+          >
             <template #prefix><Building2 /></template>
           </Input>
         </FormItem>
 
         <FormItem name="userId" label="账号">
-          <Input id="userId" v-model="formModel.userId" placeholder="请输入账号" :disabled="submitting">
+          <Input
+            id="userId"
+            v-model="formModel.userId"
+            placeholder="请输入账号"
+            :disabled="submitting"
+          >
             <template #prefix><User /></template>
           </Input>
         </FormItem>
diff --git a/code/fms/fms-vue/src/views/test/TestPage.vue b/code/fms/fms-vue/src/views/test/TestPage.vue
index deb5b160..5dd0bb4d 100644
--- a/code/fms/fms-vue/src/views/test/TestPage.vue
+++ b/code/fms/fms-vue/src/views/test/TestPage.vue
@@ -1,6 +1,8 @@
 <script setup>
 import { computed } from 'vue'
 import { useRoute } from 'vue-router'
+
+defineOptions({ name: 'TestPage' })
 import Button from '@/components/ui/button/button.vue'
 
 const route = useRoute()
@@ -19,8 +21,12 @@ const index = computed(() => Number(route.params.id ?? 0))
     <div class="fms-test-page__body">
       <div class="fms-test-page__card">
         <p>这是用于测试 Tabs 导航的占位页面。</p>
-        <p>当前路由：<code>{{ route.fullPath }}</code></p>
-        <p>页签索引：<strong>{{ index }}</strong></p>
+        <p>
+          当前路由：<code>{{ route.fullPath }}</code>
+        </p>
+        <p>
+          页签索引：<strong>{{ index }}</strong>
+        </p>
       </div>
 
       <div class="fms-test-page__actions">