20260917165839

code/fms/.workbuddy-ai/memory/2026-09-17.md

@@ -0,0 +1,17 @@
+# 2026-09-17
+
+## 修复：合作伙伴分类删除报「order_by 不能为空」
+
+- 现象：`base/othercompany` 删除分类 → 「分类数据检查失败：order_by 不能为空」。
+- 根因：`onCategoryDelete` 的守卫查询调 `pageDataApi`（`/data/page`）**漏传 `orderBy`**；
+  后端 `DataService.page` 用 `getRequiredString(params,"order_by")`，`DbUtils.buildPageOrderBy`
+  对空值抛「order_by 不能为空」。`/data/loaddata` 的 order_by 是可选的，`/data/page` 是必填
+  （分页需要确定性排序），所以同类守卫在 `views/system/user` 用 loaddata 没问题、这里用 page 就炸。
+- 改动：`src/views/base/othercompany/index.vue` 守卫查询加 `orderBy: 'b_id ASC'`；
+  `tests/views/othercompany.spec.js` 新增回归用例断言 pageDataApi 的入参（含 orderBy）。
+  全套 10 个用例通过；oxlint 干净（oxfmt 全仓库既有 format issues，未动）。
+- 已核对仓库内另 3 处 `pageDataApi` 调用（FileListPanel / useLookupOptions / FmsModuleListPage）都传了 orderBy。
+
+## 维护
+
+- `MEMORY.md` 超限被截断，已按主题重写精简（合并重复项、删掉过期与可推导内容）。

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

@@ -1,195 +1,92 @@
 # FMS 项目长期约定
 
-## 目录与文件
+## 目录 / 文档 / 库
 
-- 后端 `fms-api`，前端 `fms-vue`（Vue 3.5 + Vite 8 + Pinia 4 + pnpm，**纯 JS 无 TS**）。
-- 设计文档集中在仓库根：`FMS新系统核心表结构设计.md`（新库 FMS）、`FMS业务表设计.md`、
-  `Fms旧系统表结构.md`（旧库 G3HY2025，**只有表、不含视图**）、`开发规范.md`、`FMS删除规则引擎设计.md`。
-- 建库/注册脚本在 `sql/`：`fms_core.sql`、`fms_business_*.sql`（建表+视图）、`fms_module_*.sql`（模块元数据）。
+- 后端 `fms-api`（Spring Boot + JDK21，JDBC+Druid 无 ORM）；前端 `fms-vue`（Vue 3.5 + Vite 8 + Pinia，纯 JS）。
+  `fms-vue-old1/old2` 仅供历史参考，**不要改**。
+- 根目录设计文档：`FMS新系统核心表结构设计.md`（权威表结构）、`FMS业务表设计.md`、`开发规范.md`（AI 规范）、
+  `Fms旧系统表结构.md`（旧库 G3HY2025，只有表无视图）、`FMS删除规则引擎设计.md`。
+- 建库/模块注册脚本在 `sql/`（`fms_core.sql`、`fms_business_*.sql`、`fms_module_*.sql`）。
+- SQL Server `118.89.70.199:1433`：旧库 `G3HY2025`，新库 **FMS**（新系统一律用 FMS，**生产库，写前先确认**）。
+- 机构→库映射在 `fms-api/config/dbconfigs/{ORG_ID}.properties`（gitignore）：`G3HD.properties` → FMS，
+  `G3HY2025.properties` → G3HY2025。**没有 FMS.properties**。
+- 后端 8088（context-path `/api`），前端 dev 5082（`/api` → 127.0.0.1:8088）。直连接口需先 `/auth/login`。
 
-## 数据库
+## 元数据核心表（真实列名，已连库核对，别再猜）
 
-- 服务器 `118.89.70.199:1433`；**旧库 `G3HY2025`**、**新库 `FMS`**（新系统一律用 FMS）。
-- 机构与库的映射写在 `fms-api/config/dbconfigs/{ORG_ID}.properties`（该目录被 gitignore）。
-  已存在：`G3HD.properties` → databaseName=**FMS**；`G3HY2025.properties` → databaseName=G3HY2025。
-  **没有 FMS.properties**，G3HD 就是指向新库的那份。
-- 后端 `fms-api` 监听 **8088**（context-path `/api`）；前端 dev server **5082**（proxy `/api` → 127.0.0.1:8088）。
-- 直接 curl 后端接口会返回 `401 未登录或登录已失效`，需先 `/auth/login`。
+- `s_module`：PK **`b_id`**（无 `b_module_code`；无 `b_route`，那是 `s_menu` 的）；本身是树：
+  `b_parent_id`/`b_depth`/`b_path`；另有 `b_module_type`(module/data/virtual)、`b_view_table`、`b_save_table`、
+  `b_key_field`、`b_order_sql`、`b_query_sql`、`b_config_json`、`b_canuse`、`b_xh`、`b_bz`、`b_name`、`b_i18n`。
+- `s_field`：PK **`(b_module_id, b_field)`**，无 `b_id`；`b_type` 实测 `input`/`number`/`checkbox`/`datetime`/`date`。
+- `s_module_schema`：PK `(b_module_id, b_schema_type∈view|edit|query)`，`b_schema_json`。
+- `s_menu`：`b_id`/`b_parent_id`/`b_depth`/`b_path`/`b_menu_type`(directory|page)/`b_route`/`b_icon`；`s_menu_module` 绑菜单与模块。
+- **权限靠 `b_id`**：permissionStore 的 `moduleCodes` 即 `s_module.b_id`，页面 `MODULE_CODE` 必须等于它；
+  还要在 `s_menu_module` 里绑菜单，否则非超管看不到授权入口。
+- 列表模块编码统一 `v_`+表名（`v_b_othercompany`），`b_view_table`→视图，`b_save_table`→真实表。
+- schema JSON 形状：`view{columns:[{field,width}|{type:group,title,children}]}`、
+  `edit{children:[{field,span,required,readonly,defaultValue}|group]}`、`query{groups:[{conditions}],quick}`。
+- 路由守卫只看 `meta.moduleId`/`meta.adminOnly`；`views/module/**` 是 adminOnly（仅 g3soft）。
 
-## 元数据驱动的核心约定
+## 树结构规范（模块/菜单/部门/分类树通用）
 
-- 模块树 `s_module`（`b_module_type` ∈ module/data/virtual），字段 `s_field`，
-  界面配置 `s_module_schema`（PK = `b_module_id` + `b_schema_type` ∈ view/edit/query，JSON 存在 `b_schema_json`）。
-- **这三张表的真实列名（已连库核对，写脚本时别再猜）**：
-  - `s_module`：PK 是 **`b_id`**（**没有** `b_module_code` 列）；且它**本身就是树** ——
-    `b_parent_id` / `b_depth` / `b_path`；另有 `b_module_type`（`module` / `data`）、
-    `b_view_table` / `b_save_table` / `b_key_field` / `b_order_sql` / `b_query_sql` / `b_config_json`
-    / `b_canuse` / `b_xh` / `b_bz` / `b_name` / `b_i18n`。**没有 `b_route`**（那是 `s_menu` 的列）。
-  - `s_field`：PK 是 **`(b_module_id, b_field)`**，**没有 `b_id`**；列为
-    `b_field` / `b_name` / `b_i18n` / `b_type` / `b_canuse` / `b_xh`。`b_type` 实测取值：
-    `input` / `number` / `checkbox` / `datetime` / `date`。
-  - `s_module_schema`：PK `(b_module_id, b_schema_type)`，另有 `b_schema_json` / `b_canuse`。
-  - `s_menu`：`b_id` / `b_parent_id` / `b_depth` / `b_path` / `b_name` / `b_i18n` /
-    `b_menu_type`（`directory` 或 `page`）/ `b_route` / `b_icon` / `b_xh` / `b_canuse`。
-  - `s_menu_module`：`b_menu_id` / `b_module_id` / `b_xh` / `b_canuse`。
-- **模块编码写法**：列表模块统一 `v_` + 表名（如 `v_b_contact`），`b_view_table` 指向查询视图，
-  `b_save_table` 指向真实表。数据模块挂在分组 module 节点下（如 `base`、`system`）。
-- **前端权限靠 `b_id`**：`usePermissionStore` 的 `moduleCodes` 就是 `s_module.b_id`；
-  `canPower(code, power)` 查 `${b_id}.${power}`。所以页面里写的 `MODULE_CODE` 必须等于模块 `b_id`。
-  另外要记得在 `s_menu_module` 里把菜单绑到模块，否则侧栏入口不会出现在角色的「菜单权限」树中，非超管无法授权。
-- **s_module_schema JSON 真实形状**（与 `schemaRender.js` 一一对应，别写错）：
-  - `view`：`{ schemaVersion, columns: [ {field,width} | {type:'group',title,children} ] }`
-  - `edit`：`{ schemaVersion, children: [ {field,span,required,readonly,defaultValue} | {type:'group',...} ] }`
-  - `query`：`{ schemaVersion, groups: [ { conditions: [ {field,operator} ] } ], quick: [field] }`
-- **s_menu 无种子数据**，业务菜单由「菜单管理」页面维护。`s_menu_module` 把菜单关联到 data/virtual 模块。
-- 路由守卫只看 `meta.moduleId` / `meta.adminOnly`（`to.matched.some`），**没有 moduleId 的路由不需要模块记录即可访问**。
+`b_parent_id` 是权威关系，`b_depth`（根=0）、`b_path`（`/cn/east/`）是派生字段，移动节点要同事务更新全部后代；
+不一致时以 `b_parent_id` 为准。工具在 `src/utils/tree.js`（`buildSortedTree`/`computeTreeMove`/`collectDescendantIds`/
+`applyTreePosition`/`filterTreeByText`/`findTreeNode`），展示层用 `components/fms-tree/FmsTree.vue`（自管虚拟根）。
 
-## 树结构规范（模块树 / 菜单树 / 部门树通用）
+## 后端通用接口（前端业务数据只走这几个）
 
-见 `FMS新系统核心表结构设计.md` 第 1.7 节：**邻接表为主 + `b_depth`/`b_path` 冗余**。
+- `POST /auth/login`：字段是**小写** `orgid`/`userid`/`password`；`orgid=G3HD`。
+- `/data/loaddata`：`view_name`/`search_condition`/**可选** `order_by`/`search_columns`（真 JSON 数组）。
+- `/data/page`：**`order_by` 必填**（`DbUtils.buildPageOrderBy` 会报「order_by 不能为空」），
+  分页参数名是 **`page_no`/`page_size`**（不是 pageindex/pagesize）。
+- `/data/saveobjt`：body 是数组，每项 `{table, key_field, deletes, updates, inserts}`，**`key_field` 必填**
+  （复合主键逗号分隔），顺序 delete→update→insert。
+- 模块元数据不由接口下发，前端读本地 schema JSON，改元数据无需重启后端。
+- `DbUtils` 是 SQL 唯一出口：标识符加 `[]`，`validateReadOnlySql()` 只允许查询。
 
-- `b_parent_id` 是**权威关系**；`b_depth`、`b_path` 是业务层维护的**派生字段**。
-- 根节点 `b_parent_id` 为 `NULL`，`b_depth` 从 0 起算；`b_path` 形如 `/cn/east/`（前后都带 `/`）。
-- 新增/移动节点时必须在同一事务中同步当前节点及**全部后代**的 `b_depth`/`b_path`。
-- 二者不一致时**以 `b_parent_id` 为准**，并提供按父子关系重建冗余字段的能力。
-- 全项目通用的树工具在 **`fms-vue/src/utils/tree.js`**（`buildSortedTree` / `computeTreeMove` /
-  `collectDescendantIds` / `applyTreePosition` / `filterTreeByText` 等）。新增一棵树优先复用它。
-- 展示层适配器 **`fms-vue/src/components/fms-tree/FmsTree.vue`**：自管 `loading` 遮罩与
-  「全部分类」虚拟根（空选中键 ⟺ 虚拟根，调用方不需要知道 `rootKey`）。
+## 环境坑（本机特有）
 
-## 主题与样式约定
+- **编译/测试 fms-api 唯一可行命令**（start.cmd 里的 JDK/Maven 路径都是坏的）：
+  ```
+  cd /d/workspace/code/fms/fms-api && /d/devtool/jdk/jdk21/bin/java \
+    -Dclassworlds.conf="D:/devtool/maven/bin/m2.conf" -Dmaven.home="D:/devtool/maven" \
+    -Dmaven.multiModuleProjectDirectory="D:/workspace/code/fms/fms-api" \
+    -cp "D:/devtool/maven/boot/plexus-classworlds-2.11.0.jar" \
+    org.codehaus.plexus.classworlds.launcher.Launcher -o -Dtest=XxxTests test
+  ```
+  本地仓库是 `D:\data\maven`（不是 ~/.m2）；联网下载去掉 `-o`；`target/` 被 git 跟踪，编译后有噪音。
+- 无 sqlcmd/pyodbc/pymssql：用 `fms-api/tools/migration/RunSqlFile.java` 或一次性 `SqlRunner.java`
+  + JDBC jar（`~/.m2/.../mssql-jdbc-13.4.0.jre11.jar`）+ `/d/devtool/jdk/jdk17/bin/java`。
+  脚本要按行首 `GO` 分批，路径传绝对路径。
+- `vite build` 被 safe-delete 守卫拦（要删 600+ 文件）：用 `--outDir dist-verify --emptyOutDir`；
+  清理用 `find dist-verify -type f -delete` 再 `find dist-verify -type d -empty -delete`。
+- `oxfmt --check` 全仓库都报 format issues（版本漂移），**不是自己引入的**，别顺手格式化整个仓库。
+- 本工作区可能被多会话同时编辑，验证失败项先用 `find <dir> -mmin -N` 确认是否自己引入。
 
-- 全站配色唯一真相是 **`fms-vue/src/theme/tokens.css`**：浅色定义在 `:root`，
-  深色覆盖在 `.dark`，**两组必须同步增删同名变量**；`--fms-primary` 由 JS 写入，
-  衍生色一律用 `color-mix()` 派生。改主题只动这个文件，不在组件里硬编码颜色。
-- **侧栏当前是浅色的**（`--fms-surface` 白底 + `box-shadow: var(--fms-shadow-right)`），
-  与顶栏同为「框架面」。2026-09-16 曾改造为黑色并已**按用户要求全部回退**，
-  现存代码里**没有** `--fms-sidebar-*` 变量。若再看到「侧栏是黑的」的描述即为过期信息。
-- 主色预设（`src/theme/presets.js`）**默认是「墨蓝」`#0f172b`，本身就是近黑**。
-  所以任何深色底上做主题色元素时，别直接套浅底模板（见下条实测结论）。
-- **深色底 + 主题色高亮态的实测结论（回退前验证过，重做深色侧栏时直接复用）**：
-  「浅底 + 白字」走不通 —— 主色向白混到能看清色相时已成 pastel，白字对比度实测仅
-  **1.4~2.7:1**（9 个预设色全不合格）。必须用「深底 + 白字 + 主色亮描边」三件套：
-  填充 = `color-mix(primary 38%, #000)`（白字 5.1~19.2:1 达标），
-  描边 = `color-mix(primary 40%, #fff)`（近黑主色填充与黑底仅 1.04:1，全靠描边勾边界）。
-  即**文字可读性靠填充、可辨识性靠描边，二者分离**才能覆盖全部预设色。
-- **要改侧栏配色时的正确做法**：新增一组 `--fms-sidebar-*` 专用 token，
-  只给 `layouts/components/AppSidebar.vue` 与 `NavMenuItem.vue` 用。
-  **不要改 `--fms-surface` / `--fms-text` 等全局中性色** —— 那些是顶栏、内容卡、
-  全部业务页面共用的，改了会让整个主区一起变。
-- **Teleport 到 `body` 的浮层不算侧栏内元素**（如团队下拉 `.fms-team-menu-*`）：
-  它们渲染在浅色浮层容器里，改侧栏配色时必须保持全局浅色 token，不能跟着一起改。
+## 测试基线（既有失败，别去修）
 
-## 测试
+- 后端 `OrgDataSourceFactoryTests.databaseConnectionFailureDoesNotRetry`（断言 Druid retry=0，实测 1）。
+- 前端 `tests/unit/fms-module-list-page.spec.js` 里引用 `.filter-drawer`/`.filter-row__*` 的用例
+  （类名已不存在，是高级查询面板改版后的过期断言）—— 另有约 13 个长期失败基线。
+- `tests/helpers/app.js` 的 `mountPage` 用 shallowMount 且默认打桩子组件：给 `Splitter`/`SplitterPanel`
+  打桩时键名要写 **Vue 推断名 `'splitter'`/`'panel'`**（文件名小写），写 `'SplitterPanel'` 打不上桩；
+  自定义组件传 `false` 可强制真实挂载。`global` 会整体覆盖内部 stubs，别在里面再写 stubs。
 
-- 测试 harness 在 `fms-vue/tests/helpers/app.js`：`mountPage` 内部用 **shallowMount**，默认打桩所有子组件。
-- **陷阱**：给布局容器（`Splitter`/`SplitterPanel`）打桩时，键名要写 **Vue 推断出的组件名**。
-  这两个 SFC 文件名是 `splitter.vue` / `panel.vue`，推断名是 `'splitter'` / `'panel'`，
-  **不是** `'SplitterPanel'`；写错键就打不上桩，容器成空壳、插槽不渲染。
-  自定义组件（如 `DeptTreePanel`）传 `false` 可强制真实挂载。
-- `mountPage` 的 `global` 选项会整体覆盖内部 `stubs`，不要在 `global` 里再写 `stubs`。
-- 既有 13 个失败用例（query-UI / router-auth / login / scratch repro）是长期基线，非新改动引入。
+## 主题约定
 
-## 环境坑
+- 配色唯一真相 `fms-vue/src/theme/tokens.css`：`:root` 浅色 + `.dark` 深色必须同步增删同名变量，
+  `--fms-primary` 由 JS 写入，衍生色用 `color-mix()`。改主题只动这个文件。
+- **侧栏当前是浅色的**（不存在 `--fms-sidebar-*` 变量；若再看到「侧栏是黑的」即为过期信息）。
+  要改侧栏配色就新增 `--fms-sidebar-*` 只给 `AppSidebar.vue`/`NavMenuItem.vue` 用，
+  **别动 `--fms-surface`/`--fms-text` 等全局中性色**（顶栏与所有业务页共用）。
+- 深底+主题色高亮必须用「深底 + 白字 + 主色亮描边」：填充 `color-mix(primary 38%, #000)`、
+  描边 `color-mix(primary 40%, #fff)`；「浅底+白字」对比度只有 1.4~2.7:1，不可用。
+- Teleport 到 body 的浮层（如 `.fms-team-menu-*`）不在侧栏内，保持全局浅色 token。
 
-- `vite build` 会被本机 safe-delete 守卫拦下（默认输出目录要删 672 个文件 > 阈值 50），
-  验证构建请用 `--outDir dist-verify --emptyOutDir`，用完清理。
-- 清理 `dist-verify`（600+ 文件）时 `rm -rf` 同样被 safe-delete 拦（genie-trash 报
-  `Some operations were aborted`）。可行做法：`find dist-verify -type f -delete`，
-  再 `find dist-verify -type d -empty -delete`。
-- 本工作区**可能被多个会话同时编辑**，验证失败项前先用 `find <dir> -mmin -N` 按 mtime 确认是否自己引入。
+## 导出（P0 已落地，摘要）
 
-## 直连 FMS 库执行 SQL（本机无 sqlcmd / pymssql / pyodbc 时）
-
-本机**没有** `sqlcmd`，Python 也**没有** `pymssql` / `pyodbc`。但有两样现成资源可拼出可用客户端：
-
-- JDBC 驱动：`C:/Users/admin/.m2/repository/com/microsoft/sqlserver/mssql-jdbc/13.4.0.jre11/mssql-jdbc-13.4.0.jre11.jar`
-- JDK：`/d/devtool/jdk/jdk17/bin/java`（另有 jdk21 / jdk8 目录）
-
-做法：写一个一次性 `SqlRunner.java`，读脚本文件 → 按**独立成行的 `GO`** 分批 → 逐批
-`Statement.execute` 并把结果集打成对齐表格。编译运行：
-
-```
-/d/devtool/jdk/jdk17/bin/javac -d . SqlRunner.java
-/d/devtool/jdk/jdk17/bin/java -cp ".;<jdbc.jar>" SqlRunner "D:/abs/path/to.sql"
-```
-
-注意：
-- **脚本没有 `GO` 就会被当成一个批次整体发送**，中途一句报错会导致后面全不执行；
-  自检/探查脚本记得用 `GO` 分开。
-- `SqlRunner` 传相对路径会以 `cd` 后的目录解析，**一律传绝对路径**避免踩坑。
-- 连接串取自 `fms-api/config/dbconfigs/G3HD.properties`（gitignored），指向**远端生产库**
-  `118.89.70.199:1433` / `FMS`。**改动生产库前先探查现状、并清理自己造的测试数据。**
-- 该库是**生产环境**，执行任何写操作前先确认清楚。
-
-## 直连后端 API（比查库更接近真实行为）
-
-后端 `fms-api` 跑在 **8088**（context-path `/api`）。验证数据/权限链路时优先走它：
-
-- 登录 `POST /api/auth/login`：字段是**小写** `orgid` / `userid` / `password`。
-  `orgid` 传 `G3HD`（对应 `dbconfigs/G3HD.properties` → `FMS` 库）；缺了报「机构码不能为空」。
-- `POST /api/data/loaddata`：`view_name` / `search_condition` / `order_by` / `search_columns`（JSON 数组）。
-- `POST /api/data/page`：追加 `page_no` / `page_size`。
-  **参数名是 `page_no`/`page_size`，不是 `pageindex`/`pagesize`**；`search_columns` 必须是**真 JSON 数组**，
-  传字符串会报「search_columns 参数类型不正确」。
-- `POST /api/data/saveobjt`：body 是**数组**，每项形如
-  `{table, key_field, deletes, updates, inserts}` —— **`key_field` 必填**，缺了报「key_field 不能为空」；
-  复合主键用逗号分隔（如 `s_field` 传 `b_module_id,b_field`）。执行顺序 delete → update → insert。
-- 模块元数据（`s_module` / `s_field` / `s_module_schema`）**不由后端接口下发**，
-  前端从本地 schema JSON 解析，所以改元数据后无需重启后端。
-
-## 编译 / 测试 fms-api（本机 mvn 入口全是坏的，用这条）
-
-`fms-api/start.cmd` 里的 `JAVA_HOME=D:\devtool\jdk\jdk-21` 与
-`MAVEN_HOME=D:\devtool\maven\apache-maven-3.8.9` **两个路径都不存在**
-（实际是 `D:\devtool\jdk\jdk21`、`D:\devtool\maven`），照抄必失败。
-`/d/devtool/maven/bin/mvn`（shell 脚本）在 Git Bash 下报
-`找不到或无法加载主类 org.codehaus.plexus.classworlds.launcher.Launcher`；
-从 Bash 调 `cmd.exe` 被安全策略拦；另一个 shell 工具的输出不回流（得写文件再读）。
-
-**唯一可行做法：直接用 JDK 拉起 Maven 的 classworlds launcher。**
-
-```bash
-cd /d/workspace/code/fms/fms-api
-/d/devtool/jdk/jdk21/bin/java \
-  -Dclassworlds.conf="D:/devtool/maven/bin/m2.conf" \
-  -Dmaven.home="D:/devtool/maven" \
-  -Dmaven.multiModuleProjectDirectory="D:/workspace/code/fms/fms-api" \
-  -cp "D:/devtool/maven/boot/plexus-classworlds-2.11.0.jar" \
-  org.codehaus.plexus.classworlds.launcher.Launcher -o -Dtest=XxxTests test
-```
-
-- 本地仓库是 **`D:\data\maven`**（settings.xml 里改过 localRepository），不是 `~/.m2`。
-- 新依赖要联网首次下载，去掉 `-o` 即可（`repo1.maven.org` 可达）。
-- 中文乱码时输出里加 `grep -a`。
-- `target/` 被 git 跟踪，编译后会有一堆 `.class` / surefire 报告显示为 modified，属正常噪音。
-
-**既有基线失败（不是自己引入的，别去修）**：
-- `OrgDataSourceFactoryTests.databaseConnectionFailureDoesNotRetry`
-  （断言 Druid `getConnectionErrorRetryAttempts()==0`，实测 1）。
-- 前端 `tests/unit/fms-module-list-page.spec.js` 里所有引用 `.filter-drawer` /
-  `.filter-row__*` 的用例 —— 这些类名在 `src/` 里**已不存在**，是高级查询面板改版后没更新的过期断言。
-
-## 导出功能（P0 已落地）
-
-- 入口：`POST /api/export/list`（`ExportController`），**返回文件流**，不是 ApiResponse。
-- 分层：`SqlPermissionService`（动作权限 + 字段白名单 + 数据范围）→ `ExportSchemaService`
-  （按 moduleId 读 s_module + s_field + s_module_schema.view，**与列表同源推导导出列**）→
-  `ExportService`（拼 SQL、SQL 层聚合合计、JDBC 游标 + Fesod 流式写）→
-  `ExportWorkbookWriter`（表头/明细/合计 → xlsx）→ `ExportHeadBuilder`（表头树 → `List<List<String>>`）
-  + `ExportStyleHandler`（三种样式 + 逐列列宽）。
-- 关键约束：**导出列不由前端传**，否则字段权限（`s_user_field_power.b_export`）形同虚设；
-  **所有校验必须在写 `getOutputStream()` 之前完成**，且游标要「先 `executeQuery()` 再设响应头」，
-  否则 SQL 报错时用户拿到的是半截文件而不是 JSON 错误。
-- 依赖：**`org.apache.fesod:fesod-sheet:2.0.2-incubating`**（Apache Fesod Incubating = EasyExcel 的
-  Apache 续作，包名 `org.apache.fesod.sheet.*`，入口类 `FesodSheet`，API 与 EasyExcel 一致，
-  自带 POI 5.5.1，**不要再单独引 POI**）。多级表头合并用 `automaticMergeHead(true)`，
-  各列标题层数可不同（Fesod 底部对齐补空，列名落在最后一行）。
-  **两个 Fesod 行为坑**：① 0 行导出必须仍调用一次 `write`（哪怕传空集合），否则生成的 xlsx
-  **没有任何工作表**；② 合计行是拼出来的数据行，「合计」标签要自己构造（落在第一个无聚合值的列）。
-- 合计行只在 view schema 的列节点带 `summary: sum|count` 时才出现；**目前没有任何模块配了它**，
-  所以线上看不到合计行（多级表头同理，没有模块配 `type:group`）。
-- 前端：`services/exportService.js` + `FmsModuleListPage` 工具栏「导出」按钮；
-  `services/http.js` 的响应拦截器加了 blob 直通分支（下载类响应要能读 headers）。
-- 权限现状：`s_power` 只有 2 行（`s_i18n_type`），`s_user_field_power` / `s_user_data_power`
-  都是空表。非超管走白名单语义会被拒（「没有导出权限」），**g3soft 提权可直接用**。
+`POST /api/export/list` 返回文件流：`SqlPermissionService` → `ExportSchemaService`（列与列表同源推导）
+→ `ExportService`（Fesod 流式写）→ xlsx。**导出列不由前端传**，否则字段权限形同虚设；
+校验必须在 `getOutputStream()` 前完成。依赖 `org.apache.fesod:fesod-sheet:2.0.2-incubating`（自带 POI，别再引）。
+Fesod 坑：0 行也要调一次 `write`，否则无工作表；合计行要自己构造标签。
+权限现状：`s_power` 只有 2 行，非超管会被拒，g3soft 可直接用。