This commit is contained in:
liufumingren 2026-11-10 00:09:10 +08:00
commit 2c657bd416
331 changed files with 14769 additions and 6421 deletions

View File

@ -0,0 +1,405 @@
# Layout 框架性能分析与优化建议
> 状态:**阶段 1、2 已实施;阶段 3 部分待定;阶段 4 评估后回滚**
> 范围:首屏加载 + 路由切换响应
> 基线:`npm run build` 产物实测
---
## 〇、实施进展
| 阶段 | 项 | 状态 |
|---|---|---|
| 1 | 生产环境关闭路由树 `console.log` | ✅ 已完成 |
| 1 | `document.title` 去重 | ✅ 已完成 |
| 1 | `beforeEach` 打印连接加一次性标记 | ✅ 已完成 |
| 2 | 切页过渡去掉离开动画(0.2s → 0,进入 0.12s) | ✅ 已完成 |
| 2 | `TaskView` 标签定位改 `Map`(O(1)) | ✅ 已完成 |
| 2 | 打印运行时移到 mount 之后 | ⏭ 跳过(`startConnections` 依赖已初始化的 runtime,后置会漏连接) |
| 3 | `keep-alive` max 降到 4 | ⏸ 暂缓(会改变业务缓存行为) |
| 3 | `TopMenu` 测量缓存 / `Sidebar` 延迟渲染 | ⏸ 暂缓(收益中低、风险中) |
| 4 | Element Plus 按需引入 | ↩️ **已回滚**,详见下方 |
### 阶段 4 回滚原因
启用 `unplugin-auto-import` + `unplugin-vue-components` 后,类型检查暴露出一批**既有的无效用法**(这些代码在全量注册下一直静默失效):
- `el-list` / `el-list-item`:Element Plus 不存在该组件(Element UI 2 遗留)
- `type="link"`:Element Plus 的 Button 用 `link` 属性,`type="link"` 非法
- 若干 `TreeNodeData` / `string | null` 类型不匹配
修复这些用法**会改变页面视觉**,超出「性能优化不影响样式」的范围,因此回滚,建议作为独立任务排期。
> 依赖 `unplugin-auto-import` / `unplugin-vue-components` 已安装,可留作后续实施。
---
## 一、现状基线
### 1.1 首屏加载资源(index.html 实际引用)
| 资源 | 体积 | gzip |
|---|---|---|
| `vendor-element-plus.js` | **809 kB** | 256 kB |
| `vendor-VdJDF3fp.js`(其他第三方) | **416 kB** | 140 kB |
| `index.js`(入口 + 应用代码) | **228 kB** | 65 kB |
| `vendor-vue.js` | **210 kB** | 78 kB |
| **JS 合计** | **≈ 1.66 MB** | **≈ 539 kB** |
| `vendor-element-plus.css` | **347.6 kB** | ≈ 40 kB |
| `index.css` + `vendor*.css` | ≈ 60 kB | — |
| **CSS 合计** | **≈ 400 kB** | — |
✅ 好消息:`vendor-echarts`(1.12 MB)和 `vendor-xlsx`(424 kB)**不在首屏预加载列表**,已是按需加载。
### 1.2 渲染与切换链路
```
main.ts
├─ import ElementPlus(全量)+ 全量 CSS ← 首屏最大负担
├─ import 'virtual:svg-icons-register' (67 个图标内联进入口)
├─ loadServerMessages() (异步 i18n)
├─ initPrinterRuntime() + bindRuntimeEvents() (mount 前同步执行)
└─ app.mount('#app')
permission.ts(beforeEach)
├─ NProgress.start()
├─ hasGetUserInfo 判断
│ └─ 否则:getInfo() → generateRoutes() → addRoute() × N
│ + console.log(formatRoutesForLog(...)) × 3 ← 生产环境也执行
└─ ensurePrinterConnectionsAfterLogin() ← 每次导航都调用
AppMain.vue
└─ keep-alive(:include=cachedViews, :max=8)
+ transition(mode="out-in", 0.2s) ← 感知延迟
TaskView/index.vue
├─ ResizeObserver → 写 --app-header-height
├─ visitedViews v-for + v-memo
├─ moveToCurrentTag():遍历全部标签定位
└─ onBeforeUpdate 清空 tagsRef
TopMenu.vue(top-bottom 布局)
└─ 渲染两份菜单 DOM:真实层 + 隐藏测量层
```
### 1.3 已有的良好实践(无需再改)
- ✅ 路由组件全部 `() => import()` 懒加载(`componentMap`)
- ✅ `keep-alive` 的 `wrapRouteComponent` 修复了 include 匹配失效问题
- ✅ `router-view :key` 收窄为 `route.name ?? route.path`,同页 query 变化不再重建
- ✅ 第三方库按库拆分 chunk,升级应用代码时第三方哈希不变,可长期缓存
- ✅ `tags-view` 已加 `v-memo`
- ✅ `ResizeObserver` 替代轮询式高度同步
- ✅ echarts / xlsx 不在首屏
---
## 二、性能瓶颈清单
### P0 · Element Plus 全量引入
**位置**:`main.ts`
```ts
import ElementPlus from 'element-plus'
import 'element-plus/dist/index.css'
app.use(ElementPlus)
```
**代价**:首屏 JS **809 kB**(gzip 256 kB)+ CSS **347.6 kB**,占首屏 JS 的 **48%**、CSS 的 **87%**。
**实际使用情况**:项目里大量组件是 `<el-*>` 模板标签,全量注册会让所有组件(含几乎不用的 Table/Tree/Cascader/Transfer…)都进入产物。
**建议**:改为按需自动引入
```ts
// vite.config.ts
import AutoImport from 'unplugin-auto-import/vite'
import Components from 'unplugin-vue-components/vite'
import { ElementPlusResolver } from 'unplugin-vue-components/resolvers'
plugins: [
AutoImport({ resolvers: [ElementPlusResolver()] }),
Components({ resolvers: [ElementPlusResolver()] })
]
```
同时 `main.ts` 移除 `app.use(ElementPlus)` 与全量 CSS import(样式由 resolver 按需注入)。
> 注意:`ElMessage` / `ElMessageBox` 这类**函数式调用**不会被模板扫描到,需要 `import { ElMessage } from 'element-plus'` 保持显式导入(项目里已经是这样用的,兼容)。
**预期收益**:首屏 JS **≈ -350~-450 kB**(gzip -100~-130 kB),CSS **≈ -250 kB**。
**风险**:中。需要全量回归一次(尤其是动态渲染的 `h(...)` 用法、`el-config-provider`、`ElLoading` 等指令式组件)。
---
### P0 · 生产环境仍在格式化整棵路由树
**位置**:`permission.ts`
```ts
console.log('[Router] 动态路由 (后端菜单转换):', formatRoutesForLog(accessRoutes))
console.log('[Router] 合并后完整路由 (constantRoutes + 动态):', formatRoutesForLog(permissionStore.routes))
console.log('[Router] Vue Router 实例路由:', formatRoutesForLog(router.getRoutes()))
```
`formatRoutesForLog` 会**递归遍历整棵路由树并为每个节点创建新对象**,且执行了 3 次(其中一次还是合并后的全量路由)。
**代价**:菜单多时(当前 web_pages 89 + api 264 + 其他端),每次登录 / 整页刷新都要构造 3 份完整对象树,同时产生大量对象占用内存。
**建议**:
```ts
if (import.meta.env.DEV) {
console.log(...)
}
```
**预期收益**:登录后首次进入 **-50~150 ms**,并释放可观内存。
**风险**:极低。
---
### P0 · `beforeEach` 每次导航都触发打印连接逻辑
**位置**:`permission.ts`
```ts
if (hasGetUserInfo) {
ensurePrinterConnectionsAfterLogin() // 每次导航都执行
maybeRetryPrintConnectionsAfterRefresh()
return true
}
```
`ensurePrinterConnectionsAfterLogin()` 内部会取 store、检查 `isLoaded`、调用 `startConnections()`(内部虽有幂等标记,但仍有数次函数调用与状态判断)。
**建议**:加一次性标记,仅在本会话首次通过守卫时执行:
```ts
let bootstrapped = false
if (hasGetUserInfo) {
if (!bootstrapped) { bootstrapped = true; ensurePrinterConnectionsAfterLogin() }
...
}
```
**预期收益**:每次切页 **-1~3 ms**(单次不大,但导航频率高)。
**风险**:低(需保留 `/redirect` 软刷新后的重连分支)。
---
### P1 · 切页动画造成的感知延迟
**位置**:`AppMain.vue`
```vue
<transition name="fade-transform" mode="out-in">
```
```scss
.tab-fade-enter-active, .tab-fade-leave-active { transition: opacity .2s; }
```
`mode="out-in"` 表示**旧页面先淡出 200ms,新页面再淡入 200ms**,用户感知的切换延迟累计约 **400ms**。而 keep-alive 命中时页面其实已经缓存好了,这 200ms 完全是等待。
**建议**(按保守程度排序):
1. 只保留进入动画,去掉离开动画:
```scss
.fade-transform-leave-active { transition: opacity 0s; }
```
2. 或缩短到 100~120ms
3. 进阶:keep-alive 命中时跳过动画(按 `route.meta.noCache` 或首次访问判断)
**预期收益**:切页感知 **-200~-300 ms**。
**风险**:低(纯视觉调整)。
---
### P1 · `TaskView` 每次切页线性遍历标签
**位置**:`TaskView/index.vue`
```ts
const moveToCurrentTag = () => {
nextTick(() => {
for (const [i, tag] of visitedViews.value.entries()) { ... tagsRef.value[i] ... }
})
}
```
- 每次 `route.fullPath` 变化都线性遍历全部已打开标签
- `onBeforeUpdate` 会清空 `tagsRef`,随后 Vue 重建 ref 数组
**建议**:
- 维护 `Map<path, HTMLElement>`,`moveToCurrentTag` 变成 O(1)
- 用函数式 `:ref="el => tagEls.set(tag.path, el)"` 替代数组 ref + 清空逻辑
**预期收益**:标签 20+ 时每次切页 **-3~10 ms**。
**风险**:低。
---
### P1 · `TopMenu` 渲染两份菜单 DOM
**位置**:`TopMenu.vue`
```vue
<el-menu class="top-menu">…真实菜单…</el-menu>
<div ref="measureRef" class="top-menu-measure">
<el-menu class="top-menu">…再渲染一份相同菜单…</el-menu>
</div>
```
测量层把**所有一级菜单再挂载一遍**(含 el-menu / el-sub-menu 全套组件实例),只为量取宽度。
**建议**:
1. 短中期:菜单结构(routes)不变时缓存测量结果,避免 `resize` / `locale` / `fonts.ready` 反复触发 `measureItems` 全量重测
2. 长期:直接用真实层的 `scrollWidth` 与 `clientWidth` 判断溢出,去掉测量层
3. 至少把测量层降级为**纯 DOM 文本宽度测量**(`canvas.measureText`),不挂载组件
**预期收益**:首屏挂载 **-20~40 ms**,内存减少一份菜单实例。
**风险**:中(收纳数量计算的准确性依赖测量结果)。
---
### P1 · `Sidebar` 一次性挂载全部菜单
**位置**:`Sidebar/SidebarItem.vue` 递归
当前 `web_pages` 有 89 条(含子项),全部一次性渲染成 `el-menu-item` / `el-sub-menu`。
**建议**:
- 折叠状态的子菜单**延迟渲染**:只有父级展开过(`is-opened`)才 `v-if` 渲染 children
- 菜单层级深的页面,首屏 DOM 节点数可减少 40%+
**预期收益**:首屏 DOM 挂载 **-30~60 ms**(取决于菜单量)。
**风险**:中低(需处理“展开瞬间”的首次渲染)。
---
### P2 · `document.title` 每次导航写两次
**位置**:`main.ts`
```ts
watch([...frontBrandStore.loaded, siteTitle, router.currentRoute.value.path], () => applyDocumentTitle())
router.afterEach((to) => applyDocumentTitle(to))
```
`path` 变化时 `watch` 触发一次,`afterEach` 再触发一次,造成重复的 `tMenu` 翻译查找 + DOM 写入。
**建议**:只保留 `afterEach`(品牌加载完成的场景另加一次 watch 即可)。
**预期收益**:每次导航 **-1~2 ms**。
**风险**:低。
---
### P2 · 启动期同步初始化打印运行时
**位置**:`main.ts`
```ts
initPrinterRuntime()
usePrinterComponentStore(pinia).bindRuntimeEvents()
app.mount('#app')
```
在 `mount` 之前同步执行,会推迟首帧。
**建议**:移到 `mount` 之后,或用 `requestIdleCallback` 包裹,让首屏优先渲染。
**预期收益**:首屏 FCP **-10~30 ms**。
**风险**:低(注意事件绑定时序)。
---
### P2 · `keep-alive` 最大缓存 8 个页面
`pageCacheMax` 默认 8。缓存的页面实例持有完整 DOM、表格数据、定时器。
**建议**:
- 把默认值降到 4
- 对重页面(含大表格/视频/图表的)在路由 `meta` 上标 `noCache`
**预期收益**:内存占用下降,长时间使用后切换更稳。
**风险**:低(业务上会牺牲少量返回体验)。
---
### P3 · 首屏 CSS 未拆分/未压缩到极致
当前 `vendor-element-plus.css` 347.6 kB 是**全量样式**。按 P0 的按需引入解决后,这部分会降到约 80~100 kB。
另外建议确认部署侧已开启:
- gzip / brotli
- `Cache-Control: immutable`(vendor chunk 带哈希,可长期缓存)
- HTTP/2 或 CDN
---
## 三、建议实施顺序
| 阶段 | 内容 | 风险 | 预期收益 |
|---|---|---|---|
| **1** | 生产环境关闭路由树 `console.log` | 极低 | 首次进入 -50~150ms |
| **1** | `document.title` 去重 | 极低 | 每次导航 -1~2ms |
| **1** | `beforeEach` 打印连接加一次性标记 | 低 | 每次导航 -1~3ms |
| **2** | 切页动画去掉离开过渡 / 缩短时长 | 低 | 切页感知 -200~300ms |
| **2** | `TaskView` 标签定位改 Map | 低 | 每次切页 -3~10ms |
| **2** | 打印运行时移到 mount 之后 | 低 | FCP -10~30ms |
| **3** | `TopMenu` 测量结果缓存 / 去测量层 | 中 | 首屏 -20~40ms |
| **3** | `Sidebar` 子菜单延迟渲染 | 中 | 首屏 -30~60ms |
| **3** | `keep-alive` max 降到 4 + 重页面 noCache | 低 | 内存下降 |
| **4** | **Element Plus 按需引入** | 中 | 首屏 JS **-350~450kB**、CSS **-250kB** |
> 阶段 1、2 几乎零风险,可以先做,**不改任何业务逻辑**。
> 阶段 4 收益最大但需要全量回归,建议单独排期。
---
## 四、可选:先加观测再优化
当前没有任何性能埋点,优化效果无法量化。建议先加最小埋点:
```ts
// 切页耗时
router.beforeEach(() => { performance.mark('route-start') })
router.afterEach((to) => {
performance.mark('route-end')
performance.measure(`route:${String(to.name)}`, 'route-start', 'route-end')
})
```
配合 Chrome Performance 面板,可以直接确认「切页慢」到底是:
- 路由守卫耗时(P0-2 / P0-3)
- 组件渲染耗时(P1-1 / P1-3)
- 还是首屏资源太大(P0-1)
---
## 五、结论
- **首屏慢的主因是 Element Plus 全量引入**(1.66MB 首屏 JS 里占 809kB),这是唯一能带来「量级变化」的优化点
- **切页慢的主因是 200ms 的 `out-in` 过渡动画 + 每次导航的重复守卫逻辑**,这两项改动小、收益直接
- 菜单相关的渲染开销(TopMenu 双份 DOM、Sidebar 全量挂载)属于「菜单条目多时才会显现」的次要因素,可作为第三阶段
如果只能做三件事:**关掉路由树日志 → 去掉离开过渡动画 → Element Plus 按需引入**。

View File

@ -0,0 +1,184 @@
# 标签排序与默认页签:统一方案(已落地)
- 日期:2026-11-07
- 状态:**已实现**(P0–P4 全部完成)
- 目标:把原先散落在页面里的 4 份标签排序逻辑收敛为「1 注册表 + 1 组合式 + 1 渲染组件」,并新增「默认页签」与「全项目统一管理面板」
- 取代文档:`docs/用户偏好配置-浏览器本地保存方案.md` 中关于「标签排序」的章节(该文档的存储/接口设计已不再适用)
---
## 1. 整体结构
```
src/config/tab-order-registry.ts 唯一注册表(页面 key / 标题 / 分组 / 默认标签 / 旧 scope)
src/utils/tab-order.ts 配置文档读写与归一化(纯函数 + store 适配)
src/composables/useTabOrder.ts 唯一读取/排序/默认页签/保存逻辑
src/components/TabArea/index.vue 唯一标签渲染组件(含排序入口 + 插槽)
src/components/SortSettingDialog.vue 单页排序弹窗(TabArea 内置入口调用)
src/components/TabOrderDragList.vue 拖拽列表(单页弹窗与全局面板共用)
src/components/TabOrderPanel.vue 全项目标签排序面板(设置中心 →导航→标签排序)
src/components/settings/SettingsDialog.vue 设置中心外壳(左导航 + 右内容)
src/components/UpperTable/index.vue 字段设置工具栏入口 + 全局配置导出/导入 + 故障修复
```
```mermaid
flowchart LR
R[tab-order-registry] --> H[useTabOrder]
S[(userPreference 用户级 scope tabOrder)] --> H
H --> T[TabArea]
H --> P[页面 activeTab / 单页模式默认标签]
T --> D1[SortSettingDialog]
D1 --> H
F[TabOrderPanel] --> S
U[UpperTable 字段设置] --> F
S --> G[全局配置 导出/导入]
```
---
## 2. 配置存储
**位置**:`userPreference` 的「用户级」scope(key = `user_prefs_{userId}`,**不分仓库**)。
```jsonc
{
"tabOrder": {
"value": {
"version": 1,
"orders": {
"order.management": ["pendingOrder", "reviewOrder", "..."]
},
"defaults": {
"order.management": "pendingOrder"
}
},
"updated_at": 1762500000000
}
}
```
- `orders[pageKey]`:标签 name 顺序;**不存在该键 = 使用默认顺序**
- `defaults[pageKey]`:默认打开的标签;不存在 = 用页面兜底默认
- 一个 scope 存全项目,导出/导入/清理都只处理这一处
### store 变更(`stores/modules/userPreference.ts`)
| 新增/调整 | 说明 |
|---|---|
| `globalMap` | 用户级层(读 `user_prefs_{userId}`),与仓库级 `map` 分离 |
| `getGlobal / setGlobal / resetGlobal` | 用户级 scope 读写;`getGlobal` 会回退 `map`(兼容历史上写进仓库 key 的数据) |
| `load()` 迁移调整 | 旧 key → 仓库 key 的迁移**排除** `USER_GLOBAL_SCOPES`(当前为 `tabOrder`),避免产生陈旧副本 |
| `persist / persistGlobal` | 无仓库上下文(两个 key 相同)时合并写入,避免互相覆盖 |
---
## 3. 读取与优先级
### 顺序配置
1. `tabOrder.orders[pageKey]`
2. 旧 scope(`legacyScopes`,命中后**一次性迁移**进新文档,旧 key 保留)
3. 页面传入的默认顺序
### 初始激活标签
```
URL ?tab=(合法) > 用户默认(defaults) > 页面兜底默认 > 排序后第一项
```
- **排序不影响默认**:显式设置过默认就一直用它
- 默认标签失效(权限/页面改版)时静默回退,不报错
- 单页模式(`ORDER_PAGE_CONFIG.singlePage` / `WAVE_PAGE_CONFIG.singlePage`)同样使用该默认
---
## 4. 注册表
`src/config/tab-order-registry.ts`:新增页面只需加一条。
| 字段 | 作用 |
|---|---|
| `key` | 稳定主键,同时是配置键 |
| `title` / `group` | 全局面板展示与分组 |
| `loadTabs` | 懒加载默认标签(动态 `import()`,不进入主包) |
| `legacyScopes` | 旧配置 key(兼容读取) |
| `matchPaths` | 全局面板高亮当前页的兜底匹配 |
| `enabled` | `false` 时面板内只展示、不可编辑 |
已注册:订单管理、波次管理、缺货补货、商品管理、库存盘点、通用报表、售后类型、运单管理、退回记录(未接入)、订单汇总、页面模板示例、基础设置、编码管理、工作台管理、打印电脑管理、摄像头管理、录像机管理。
### pageKey 与旧 scope 对照
| pageKey | 旧 scope |
|---|---|
| `order.management` | `order.tabs.order` |
| `order.wave` | `order.wave.tabs.order` |
| `stock.management` | `stock.tabs.order` |
| `setting.basicManagement` | `setting.basicManagement.tabs.order` |
| 其余 TabArea 页面 | `tab-order:{当时的路由 path}`(动态兼容) |
---
## 5. 页面接入方式
```ts
const { orderedTabs, defaultTabName, resolveInitialTab, saveOrder, setDefault, reset } =
useTabOrder('order.management', () => tabs.value, { legacyScopes: ['order.tabs.order'] })
```
- `TabArea` 只需传 `page-key`(排序/入口/弹窗全部内置)
- 页面自己维护 `activeTab`,初始值用 `resolveInitialTab(route.query.tab)`
- 单页模式默认组件用 `defaultTabName` 对应的标签
已收敛页面:订单管理、波次管理、商品管理、基础设置(newview)、编码管理,以及全部 TabArea 页面(显式 `page-key`)。
---
## 6. 标签排序面板
- 入口:`设置`(Navbar 头像下拉)或列表页工具栏「字段设置」→ 设置中心 → 左侧「导航 → 标签排序」
- 左侧:注册表中**标签数 ≥ 2** 的页面(打开时并行懒加载标签数量,加载完成前显示「加载中…」,避免单标签页面闪入闪出);按分组 + 搜索 + 已自定义标记,当前页面用蓝点标记
- 右侧:拖拽排序 + 圆点设为默认;标题栏常驻显示「默认:XXX」(**用户未设置时也展示页面兜底默认**,便于确认当前生效值);默认行带「默认」标签
- 保存:一次写入 `tabOrder` 文档;`useTabOrder` 为响应式读取,**保存后页面立即生效**
- 「全部恢复默认」= 清空整个 `tabOrder` 文档(保存时生效)
- 未显式设置默认时不写入 `defaults`,继续跟随页面兜底默认(如订单管理 = 待处理订单)
### 页面兜底默认
注册表 `defaultTabName` 声明,缺省用默认顺序的第一个标签:
| 页面 | 兜底默认 |
|---|---|
| 订单管理 | `pendingOrder`(待处理订单) |
| 商品管理 | `stockDetail`(另有 combo 路径推断,优先于用户默认) |
| 其他 | 默认顺序第一个 |
---
## 7. 统一配置文件与故障修复
- 配置文件已升级为 **`tbyc-config.json`**(分区结构,见 `docs/统一配置文件-tbyc-config.md`)
- 分区:`fieldColumns`(字段设置)、`tabOrder`(标签排序/默认页签)、`display`(界面显示)、`shortcuts`(快捷键)
- 导入策略:**覆盖同名项、保留文件中未涉及的配置**;兼容旧版字段配置导出文件
- 「故障修复」:清除字段配置、显示设置、快捷键,**以及标签排序/默认页签**
---
## 8. 未纳入改造
| 页面 | 原因 |
|---|---|
| `data/returnrecord`(退回记录,6 个标签) | 存在「未保存离开」拦截(`before-leave`),切换需确认,暂不改为 TabArea;注册表中标记 `enabled: false` |
| 各页面内「明细面板」二级标签 | 属于记录明细,不是页面级标签 |
---
## 9. 验证清单
1. 老用户(已有 `order.tabs.order` 等配置)进入订单管理/波次/商品/基础设置:顺序保持,且配置被迁移进 `tabOrder`
2. 字段设置 → 标签排序:只列出**可排序(标签 ≥ 2)**的页面;标题栏显示当前默认标签;修改顺序/默认后保存,当前页面**无需刷新**即生效
3. 单页模式(`ORDER_PAGE_CONFIG.singlePage = true`)渲染的是用户设置的默认标签;未设置时渲染 `pendingOrder`
4. 排序后刷新页面:默认标签不变(排序不影响默认)
5. 导出全局配置 → 清空标签排序 → 导入:顺序与默认恢复
6. 故障修复:标签排序一并清除
7. 视觉回归:订单/波次/商品/基础设置/编码的标签栏与改造前一致(34px 标签、激活态圆点、右侧角标/chip 位置)

View File

@ -0,0 +1,691 @@
# 标签页性能 · 测量结论与执行清单
> 测量对象:`http://localhost:5174/order/orderManagement`(dev server,硬刷新)
> 测量工具:浏览器工具 + `PerformanceObserver(longtask/LCP/CLS)` + CDP `Performance.getMetrics` + CDP `Profiler`
> 测量日期:2026-11-06
> **本文档只做结论与清单,未改动任何代码。**
---
## 0. 口径说明(先读)
| 项 | 说明 |
|---|---|
| 环境 | Vite **dev server**(ESM 按模块加载,未打包) |
| 是否限速 | 否(无 CPU/网络节流) |
| "切 tab 耗时"口径 | 从点击到 `.main-container` **连续 350–400ms 无 DOM 变更**。因此数值里**包含约 350–400ms 的静默判定窗口**,绝对值偏高,**只看相对差异** |
| 生产环境差异 | dev 下 246 个 script 请求 / 14.17MB 解码体积,生产打包后会大幅下降;**但"8 个 tab 页被静态 import 进同一路由块"这个结构性问题在生产同样存在** |
---
## 1. 首屏测量结果
### 1.1 关键时间点
| 指标 | 数值 | 说明 |
|---|---|---|
| TTFB | **314 ms** | 后端首字节 |
| FCP | **576 ms** | 首次内容绘制 |
| DOMContentLoaded | **748 ms** | |
| load | **750 ms** | |
| **LCP** | **3392 ms** | 列表内容出现晚 |
| CLS | 0.029 | 轻微布局抖动 |
| **最长任务** | **1857 ms**(起始 1272 ms) | 主线程被独占近 2 秒 |
| **TBT(总阻塞时间)** | **2333 ms** | 远高于 300ms 良好线 |
| 其它长任务 | 358ms@3317、135ms@3131、90ms@658、63ms@3676 | |
> 时间线:576ms 首屏骨架 → 1272ms 起一个 1.86s 长任务(页面"卡住")→ 3129ms 结束 → 3392ms 才画出列表内容。**用户体感的"打开慢"就是这一段。**
### 1.2 资源与 DOM
| 指标 | 数值 |
|---|---|
| 请求总数 | **250**(script 246 / css 1 / xhr 3) |
| 脚本解码体积 | **14.17 MB**(transfer 仅 0.09MB,本地 dev) |
| `views/order/orderManagement/` 下的模块 | **69 个**(一次性全部加载) |
| DOM 元素(`querySelectorAll('*')`) | **7537** |
| CDP `Nodes` | **22260** |
| 首屏表格实际行数 | 20 |
**关键事实**:打开 orderManagement 时,**8 个 tab 页(review/pending/exception/outbound/entrust/delivery/deliveryException/archive)及其依赖的 api 模块被一次性加载**(`index.vue:104-113` 全是静态 import + `markRaw`)。这是 1.86s 长任务的主要来源。
### 1.3 CPU 采样归因(7 秒窗口)
| 分类 | 耗时 |
|---|---|
| idle(空闲) | 3077 ms |
| **program(解析/编译/样式/布局/绘制等浏览器内部)** | **1336 ms** |
| garbage collector | 156 ms |
| 最高的单个 JS 帧 | `update2 @ element-plus` 91 ms |
| 其次 | `track`(响应式) 67ms、`getBoundingClientRect` 59ms、`createReactiveObject` 54ms |
**结论**:长任务**不是某一段业务 JS 卡住**,而是"大量模块解析 + 大 DOM 样式/布局"的累计。因此优化方向是**减少首屏要加载/渲染的量**,而不是找某个函数优化。
### 1.4 首屏的其它噪声
- 8 个 WebSocket 连接失败:`ws://127.0.0.1:13888 / 5000 / 16888 / 10818 / 9113 / 12705 / 13528 / 8000` 全部 `ERR_CONNECTION_REFUSED`(打印组件、摄像头等本地服务)。
- 它们在 load 之后异步触发,**不直接阻塞首屏**,但会刷错误、占用连接池、增加控制台噪声。
---
## 2. 切 tab 测量结果(核心证据)
### 2.1 依次访问 5 个 tab(`tabCacheMax = 3`,共 8 个 tab)
| 顺序 | tab | 耗时 | 期间长任务 |
|---|---|---|---|
| 1 | 待处理异常订单(首次) | **2006 ms** | 938ms |
| 2 | 待出库订单(首次) | **1628 ms** | 879ms |
| 3 | 委托外仓订单(首次) | **1313 ms** | 630ms |
| 4 | 配送订单(首次) | **2088 ms** | 1083ms |
| 5 | **回到**待处理异常订单 | **3075 ms** | 1199 + 763 + 636ms |
> 第 5 次比第 1 次**还慢 1 秒**。这就是 `KeepAlive :max="3"` 小于 8 个 tab 带来的 **LRU 抖动**:第 1 个 tab 早已被淘汰,回来时要重新挂载;同时缓存里还占着 3 个旧组件,内存压力更大。
### 2.2 两个 tab 之间往返(都在缓存内)
| 顺序 | tab | 耗时 |
|---|---|---|
| A1 | 待出库订单(首次挂载) | 1696 ms |
| B1 | 委托外仓订单(首次挂载) | 1548 ms |
| **A2** | 待出库订单(**缓存命中**) | **649 ms** |
| **B2** | 委托外仓订单(**缓存命中**) | **642 ms** |
| **A3** | 待出库订单(**缓存命中**) | **691 ms** |
**结论:缓存命中确实有效(1.6s → 0.65s,约 2.5 倍)**,但:
- 0.65s 里包含 350–400ms 的静默判定窗口;
- 而 **CSS 过渡本身固定占约 400ms**(`mode="out-in"` + 0.2s 淡出 + 0.2s 淡入)。
也就是说:**缓存命中时,"CSS 动画时长"已经成了主要成本**,与数据加载无关。
### 2.3 内存
访问多个 tab 后:`performance.memory.usedJSHeapSize ≈ 216 MB`,DOM 仍 7105 元素。
(对照:刚首屏时 CDP `JSHeapUsedSize` 约 68 MB)
> 这解释了为什么第 5 次切回会触发 3 个长任务:**重建 + GC**。
---
## 3. 结论:慢在哪
| # | 原因 | 证据 | 影响面 |
|---|---|---|---|
| **C1** | 8 个 tab 页被静态 import,打开即加载 69 个模块 | 250 请求 / 14.17MB / 长任务 1857ms | 首屏 |
| **C2** | 首屏 DOM 2.2 万节点、样式与布局耗时 1336ms | `program` 1336ms、DOM 7537 | 首屏 |
| **C3** | `tabCacheMax=3` < tab 数(8 / 5)→ LRU 抖动 | 第 5 次切回 3075ms > 首次 2006ms | 切 tab |
| **C4** | 过渡动画固定 400ms | 缓存命中仍 0.65s | 切 tab(缓存命中时是主成本) |
| **C5** | 提高缓存后缺少"释放/刷新"配套(见代码) | 各 tab 只在 `onBeforeUnmount` 清理;无 `onActivated` | 提高缓存后暴露 |
| **C6** | 8 个本地 WebSocket 连接失败 | 控制台 8 条 ERR_CONNECTION_REFUSED | 噪声/次要 |
---
## 4. 执行清单
> 每项都标了**为什么做(对应哪条证据)**、改动位置、验收标准。
> 建议按批次执行,批次 1+2 必须成对上线。
### 批次 1 · 修缓存策略(P0)
| # | 事项 | 位置 | 依据 |
|---|---|---|---|
| 1.1 | `tabCacheMax` 默认值 3 → **8**(或按页面 tab 数取最大) | `src/stores/modules/experimental.ts`(`DEFAULT_TAB_CACHE_MAX`) | C3 |
| 1.2 | 支持按页面覆盖缓存上限:`ORDER_PAGE_CONFIG.tabCacheMax`、`WAVE_PAGE_CONFIG.tabCacheMax` | `orderManagement/config/order-common-config.ts`、`waveOrder/config/wave-config.ts` + 两个 `index.vue` | C3(8 tab / 5 tab 需求不同) |
| 1.3 | KeepAlive 内 `:key` 统一为 `:key="activeTab"` | `orderManagement/index.vue:56-59`(当前**没有** key)、`waveOrder/index.vue:74-80` | 避免不同 tab 复用同组件类型时串数据 |
| 1.4 | 单页模式 `<keep-alive>` 补 `:max` | `waveOrder/index.vue:93-99` | 与多页模式策略一致 |
**验收**:`A→B→A` 往返时第二次耗时 ≤ 首次的 50%(当前 1.6s → 0.65s 已达标,改后应同样稳定);8 个 tab 依次访问后回到第 1 个,耗时不再高于首次。
---
### 批次 2 · 缓存的"配套"(P0,必须与批次 1 同批)
| # | 事项 | 位置 | 依据 |
|---|---|---|---|
| 2.1 | 切走的 tab 释放大列表:`useOrderListPageCleanup` 从 `onBeforeUnmount` 扩展到 `onDeactivated` | `orderManagement/utils/use-order-list-page-cleanup.ts` + 3 个列表 tab | C5(否则 8 份大列表常驻,实测 216MB) |
| 2.2 | 建单成功回调总线防放大:只让**当前激活 tab** 立刻 `loadData`,其它 tab 打 `dirty` 标记 | `pendingOrder.vue:574`、`exceptionOrder.vue:655`、`reviewOrder.vue:283`(`registerCreateOrderSuccess`) | C5(8 个 tab 全部注册在册 → 一次建单触发 8 次请求) |
| 2.3 | 补 `onActivated` 刷新策略:`dirty` 优先,其次 `lastLoadedAt + 阈值` | 同上 3 个列表 tab | C5(当前缓存后切回永远是旧数据) |
| 2.4 | 交付时明确"全局开关仍是总闸" | `experimental.ts` | 保留回滚能力 |
**验收**:
- 建单成功 → Network 里**只有 1 个** list 请求;
- 在别的菜单改数据后切回 → 最终一致;
- 访问 5 个 tab 后内存增量 ≤ 100MB(当前 216MB)。
---
### 批次 3 · 首屏模块拆分(P0)
| # | 事项 | 位置 | 依据 |
|---|---|---|---|
| 3.1 | 8 个 tab 组件改为**按需加载**:`defineAsyncComponent(() => import('./pendingOrder.vue'))` | `orderManagement/index.vue:104-113` | C1(首屏一次性拉 69 个模块) |
| 3.2 | 首屏默认 tab 保持同步或预加载(避免首屏多一次 chunk 等待) | 同上 | 平衡 |
| 3.3 | `waveOrder` 同样处理 | `waveOrder/index.vue` 顶部 import | C1 |
| 3.4 | 校验分包产物:路由 chunk 体积下降、各 tab 独立 chunk | `npm run build` 输出 | C1 |
**预期**:首屏加载的 `orderManagement` 模块 69 → 约 10(仅激活 tab 及其依赖),长任务显著下降。
**验收**:首屏 LCP 下降;首次切到未访问 tab 允许有一次 chunk 等待(≤200ms 内网)。
> ⚠️ 3.1 会让"首次切某个 tab"多一次网络请求。**必须与批次 1 一起评估**:有缓存上限后,每个 tab 只会懒加载一次。
---
### 批次 4 · 过渡动画(P1)
| # | 事项 | 位置 | 依据 |
|---|---|---|---|
| 4.1 | `tab-fade` 从 `0.2s` 降到 `0.12s`(或缓存命中时跳过 `out-in`) | 各容器 `<style>` 内 `.tab-fade-enter-active/leave-active` | C4(缓存命中时动画是主成本) |
| 4.2 | 四个容器统一同一套时长,避免"有的快有的慢" | `mode` / `newview` / `orderManagement` / `waveOrder` | 观感一致 |
**验收**:缓存命中切换目视无"等一下";不出现闪白。
---
### 批次 5 · 首屏渲染量(P1)
| # | 事项 | 位置 | 依据 |
|---|---|---|---|
| 5.1 | 先确认长任务主要来自"模块解析"还是"表格渲染":批次 3 完成后复测一次 | — | C1 vs C2 |
| 5.2 | 若仍是渲染:检查首屏默认列数、`enableColumnConfig` 默认值、是否开启虚拟滚动 | `UpperTable`、各 tab 的 columns 配置 | C2 |
| 5.3 | ScanBox 首屏只渲染已展开分组,其余折叠 | `components/ScanBox` | C2(首屏左侧约 30 个筛选项) |
| 5.4 | 表格容器加 `contain: layout paint` / 固定高度,减少布局传播 | `list-page.scss`、`UpperTable` | C2 |
---
### 批次 6 · 壳层对齐(P2,只动标签栏)
| # | 事项 | 位置 | 注意 |
|---|---|---|---|
| 6.1 | `el-tabs` → `TabArea` | `orderManagement/index.vue:19-41`、`waveOrder/index.vue:55-70` | TabArea 视觉基准就是这两个页面 |
| 6.2 | 给 `TabArea` 增加 **角标插槽** `#label-{name}` | `components/TabArea/index.vue` | orderManagement 有 `el-badge` |
| 6.3 | 增加 **右侧操作区插槽** `#header-action` | 同上 | "刷新角标"按钮 |
| 6.4 | **删除页面内重复的排序入口** | `orderManagement/index.vue:5-12`、`waveOrder` 同位置、`newview/index.vue:33-40` | TabArea 自带 `showSortEntry`,否则出现两个排序按钮 |
| 6.5 | `sortScope` 显式传入(保留 `order.tabs.order` / `order.wave.tabs.order`) | 同上 | 否则默认 scope 变 `tab-order:{path}`,老配置丢失 |
| 6.6 | 清理 `newview` 上未被声明的 `header-left-inset` | `newview/index.vue:50` | TabArea 无此 prop |
---
### 批次 7 · 噪声清理(P2)
| # | 事项 | 说明 |
|---|---|---|
| 7.1 | 8 个本地服务 WS 连接改为**懒连接**(进对应页面/点连接按钮再连)或统一超时 | 首屏固定刷 8 条 `ERR_CONNECTION_REFUSED` |
| 7.2 | 修掉 `Vue Router warn: No match found for location with path "/order/orderManagement"` | 该路径未在 `router/map.ts` 注册,靠动态路由兜底 |
| 7.3 | 修掉 `Component data/reviewingflow/index not found in componentMap` | 数据库组件与前端 map 不一致 |
---
## 5. 明确不做
| 不做 | 理由(基于本次测量) |
|---|---|
| ❌ 把 8 个 tab 改写成 `mode` 的 `template-config.ts` 结构 | 长任务归因是"模块量 + DOM 量",不是"结构老旧";重写 1.5 万行收益不成比例 |
| ❌ 先做大而全的"配置中心"再优化性能 | 两者无强耦合,配置统一可独立推进 |
| ❌ 调 `el-table` 内部实现 | 需先由批次 3/5 确认瓶颈是否在表格 |
| ❌ 提高缓存上限但不做批次 2 | 会立刻引入"内存 216MB+ / 建单触发 8 次请求 / 数据变旧" |
---
## 6. 风险
| 风险 | 触发批次 | 说明 | 对策 |
|---|---|---|---|
| 内存上涨 | 1 | 8 个 tab 常驻(实测已 216MB) | 批次 2.1 释放列表 |
| 请求放大 | 1 | 建单成功触发多 tab 刷新 | 批次 2.2 |
| 数据变旧 | 1 | 缓存后无 `onActivated` 刷新 | 批次 2.3 |
| 监听泄漏 | 1 | 现有清理只在 `onUnmounted` | 一并改 `onDeactivated` |
| 懒加载首切变慢 | 3 | 首次切 tab 多一次 chunk 请求 | 内网可接受;可对默认 tab 预取 |
| 排序配置丢失 | 6 | `TabArea` 默认 scope 与现有一致性 | 6.5 显式传 scope |
---
## 7. 建议执行顺序与预期
```
批次 1 + 2(成对) → 切 tab 稳定在 0.65s 以内,不再出现 3s 卡顿
批次 3 → 首屏长任务 1857ms 大幅下降
批次 4 → 缓存命中切换再减约 200ms(动画)
批次 5 → 视复测结果决定是否继续
批次 6、7 → 观感与噪声
```
**量化目标(生产环境)**
| 指标 | 当前(dev) | 目标 |
|---|---|---|
| 首屏 LCP | 3392ms | ≤ 1500ms |
| 首屏 TBT | 2333ms | ≤ 500ms |
| 切 tab(缓存命中) | 649ms | ≤ 350ms |
| 切 tab(首次) | 1.3–2.1s | ≤ 900ms |
| 访问 5 个 tab 后堆内存 | 216MB | ≤ 120MB |
---
## 8. 附录 · 复测方法
在浏览器工具中执行以下脚本即可复现(同一页面、同一登录态):
```js
// 首屏:硬刷新 + LongTask/LCP/资源统计
await page.addInitScript(() => {
window.__perf = { longtasks: [], lcp: null, cls: 0 }
new PerformanceObserver((l) => {
for (const e of l.getEntries()) window.__perf.longtasks.push({ s: Math.round(e.startTime), d: Math.round(e.duration) })
}).observe({ type: 'longtask', buffered: true })
new PerformanceObserver((l) => {
for (const e of l.getEntries()) if (!e.hadRecentInput) window.__perf.cls += e.value
}).observe({ type: 'layout-shift', buffered: true })
})
await page.goto('http://localhost:5174/order/orderManagement', { waitUntil: 'load' })
await page.waitForTimeout(7000)
console.log(await page.evaluate(() => ({
longTasks: window.__perf.longtasks.sort((a, b) => b.d - a.d).slice(0, 8),
tbt: window.__perf.longtasks.filter((x) => x.d > 50).reduce((s, x) => s + x.d - 50, 0),
requests: performance.getEntriesByType('resource').length,
dom: document.querySelectorAll('*').length
})))
// 切 tab:点击 → 等 DOM 静默 350ms
async function measureTab(name) {
await page.getByRole('tab', { name: new RegExp(name) }).click()
return page.evaluate(() => new Promise((resolve) => {
const t = document.querySelector('.main-container')
let last = performance.now(), start = performance.now()
const o = new MutationObserver(() => { last = performance.now() })
o.observe(t, { childList: true, subtree: true, characterData: true, attributes: true })
const iv = setInterval(() => {
if (performance.now() - last > 350) { clearInterval(iv); o.disconnect(); resolve(Math.round(last - start)) }
}, 60)
}))
}
```
**判定口径**:同一会话内比较(dev 与 prod 不可混比);切 tab 数值包含 350ms 静默窗口,仅用于相对比较。
---
## 9. 执行记录(2026-11-06 · 批次 1~4 已实施)
### 9.1 已完成的改动
| 项 | 文件 | 说明 |
|---|---|---|
| 1.1 | `stores/modules/experimental.ts` | `DEFAULT_TAB_CACHE_MAX` 3 → **8** |
| 1.2 | `orderManagement/config/order-common-config.ts`、`waveOrder/config/wave-config.ts` + 两个 `index.vue` | 新增 `ORDER_PAGE_CONFIG.tabCacheMax = 8`、`WAVE_PAGE_CONFIG.tabCacheMax = 5`;容器取「页面配置 ?? 全局配置」 |
| 1.4 | `waveOrder/index.vue` | 单页模式 `<keep-alive>` 补 `:max="tabCacheMax"` |
| 2.2 | `pendingOrder.vue`、`exceptionOrder.vue`、`reviewOrder.vue` | 建单成功回调改为 `handleCreateOrderSuccess`:**激活页签立即刷新,非激活只打 dirty** |
| 2.3 | 同上 | 新增 `onActivated`(dirty 优先,其次 60s stale 阈值)与 `onDeactivated`(标记非激活) |
| 3.1/3.3 | `orderManagement/index.vue`、`waveOrder/index.vue` | 除默认页签外,其余 tab 组件改为 `defineAsyncComponent` 按需加载 |
| 4.1/4.2 | 四个容器 | `tab-fade` 过渡 0.2s → **0.12s**,四处统一 |
### 9.2 与原计划的偏差(含原因)
| 原项 | 处理 | 原因 |
|---|---|---|
| 1.3 给 `<component>` 加 `:key="activeTab"` | **未采用** | 8 个 tab 是**不同组件类型**,KeepAlive 按类型缓存已足够;加 key 反而让外层 `<transition>` 介入 leave 流程,在页面不可见(rAF 被节流)时会把旧节点卡在 `leave-active`。保留原行为更稳 |
| 2.1 切走时释放列表(`onDeactivated` 清空) | **未采用** | 清空后每次切回都必须重新请求(用户会看到空表+loading);实测单页仅 20 行,列表数组不是内存主因。改为 2.2/2.3 的 dirty + stale 策略 |
| 2.4 全局开关语义 | 保留 | `tabCacheEnabled` 仍是总闸,页面配置只覆盖 `max` |
### 9.3 改后复测(dev,同一会话)
| 指标 | 改前 | 改后 |
|---|---|---|
| 首屏 `orderManagement` 目录模块数 | 69 | **47**(懒加载生效) |
| 切 tab 期间最长长任务 | 630–1199 ms | **≤ 292 ms**(多数 60–290ms) |
| 访问多 tab 后堆内存 | 216 MB | 168 MB(会话内多次切换后) |
| 功能 | — | 8 个 tab 切换正常,无 Vue 错误,`npm run build` 通过 |
> 说明:改前/改后的「切 tab 耗时」用了不同判定方式(改前是 DOM 静默窗口,改后是组件身份切换 + 长任务采样),绝对值不可直接对比,**长任务与模块数是可比的硬指标**。
### 9.4 测量环境注意(踩坑记录)
- 浏览器工具打开的页面可能在**后台标签页**(`document.visibilityState === 'hidden'`)。此时 `requestAnimationFrame` 被节流,`<transition mode="out-in">` 会**永远停在 leave 阶段**,表现为"点 tab 内容不变",属于**测量假象**。
- 解决办法:CDP `Emulation.setFocusEmulationEnabled` + `Page.setWebLifecycleState('active')`,确认 `visibilityState === 'visible'` 后再测。
- 同一页面多次执行 `addInitScript` 会叠加多个 `PerformanceObserver`,导致长任务/TBT 重复计数(曾出现 TBT 7000+ 的假数据)。测长任务时应改用 `observe({ buffered: true })` 的临时观察器,不要依赖全局注入。
### 9.5 待人工验证(浏览器可见状态下)
- [ ] 8 个 tab 依次切换:内容确实变化、滚动/选中态保持
- [ ] 首次切到未访问过的 tab:允许有一次 chunk 加载(内网应 ≤200ms)
- [ ] 建单成功后:Network 中**只有 1 个** list 请求(当前激活 tab)
- [ ] 在其它菜单改数据 → 超过 60s 后切回订单页:数据自动刷新
- [ ] 切 tab 后条码扫描/快捷键不串、无重复请求
- [ ] `waveOrder` 5 个 tab 同样验证(尤其打印相关面板)
---
## 10. 第二轮优化:默认页签内联依赖瘦身(2026-11-06)
### 10.1 问题
批次 3 只把「非默认页签」改成了按需加载,但**默认页签 `pendingOrder.vue` 自己还有 41 条静态 import**,实测首屏加载了:
- `views/order/orderManagement/` 下 47 个模块
- `views/order/shared/form|component/` 下 **14 个**弹窗/面板模块
- `xlsx`(850KB)——由 `pendingOrder → order-page-export → export.ts` 链路静态带入
这些弹窗(分配快递、分配储位、录入运单号、同步订单 ID、批量复核、修改地址/留言、克隆订单…)**只有点按钮时才会用到**。
### 10.2 改动
| # | 内容 | 文件 |
|---|---|---|
| 10.1 | 15 个弹窗/明细面板改 `defineAsyncComponent`(分配快递/储位、修改平台/地址/留言、克隆、录入运单号、同步订单、批量复核、批量异步任务、分配子单号、导出进度/列选择、波次打印预览 ×2、任务进度、详情/明细/归档/日志/运单面板) | `orderManagement/pendingOrder.vue` |
| 10.2 | 上述弹窗在模板上加 `v-if="<对应 visible>"`,**关闭时卸载**,首次打开才加载对应 chunk | 同上 |
| 10.3 | `xlsx` 改为 `await import('xlsx')`(仅在真正导出时加载) | `utils/export.ts`、`utils/order-page-export.ts` |
> 安全性依据:这些组件在模板中**没有任何 `ref` 调用**(已核对 `ref="..."` 仅用于 ScanBox / splitStack / UpperTable),全部是 `v-model` + 事件,因此 `v-if` 懒挂载不会出现「拿不到实例」的问题。
### 10.3 复测对比(dev,硬刷新)
| 指标 | 第一轮后 | 第二轮后 |
|---|---|---|
| `orderManagement/` 模块数 | 47 | **19** |
| `order/shared/form|component` 模块数 | 14 | **0** |
| script 请求数 | 241 | **174** |
| 脚本解码体积 | 14.2 MB | **11.7 MB** |
| 首屏是否加载 xlsx | 是(850KB) | **否** |
| LCP | 3452 ms | **2956 ms** |
| 最长长任务 | 1895 ms | 1729 ms |
| DOM 元素 | 7525 | 7464 |
> 说明:dev 下「首屏 JS」中约 3MB 是 **vue-devtools overlay / devtools-kit**(生产不存在),element-plus 约 2.4MB。因此 dev 的 LCP 已接近该环境的可优化下限,**真实收益需以生产构建衡量**。
### 10.4 仍未处理(按性价比排序)
| # | 项 | 规模 | 说明 |
|---|---|---|---|
| A | ~~`wave-config.ts` 被订单页静态引入~~ | ~~211 KB~~ | ✅ **已完成**,见 §11 |
| B | `order-common-config.ts` | **351 KB** | 订单业务字典(工具栏按钮/筛选字段/导出列);split 属于 P6「业务配置归位」,改动面大 |
| C | `ScanBox` / `UpperTable` | 335 / 272 KB | 首屏必需组件,只能靠内部拆分或虚拟化 |
| D | 生产构建实测 | — | 建议 `npm run build` + `vite preview` 测一次,排除 dev 工具干扰 |
### 10.5 功能校验
- 首屏正常渲染 20 行,工具栏 28 个按钮齐备,无 Vue 报错
- 首次切到未访问过的 tab:dev 下约 1.2s 完成(含 chunk 加载 + 挂载),之后走缓存
- `npm run build` 通过
---
## 11. 第三轮:`wave-config` 首屏依赖切断
### 11.1 根因
`orderManagement` 首屏加载了 211KB 的 `views/order/waveOrder/config/wave-config.ts`,原因只有一条运行期依赖边:
```
pendingOrder.vue
├─ utils/use-order-batch-print.ts ─┐
├─ utils/use-sub-waybill-print.ts ─┤ import { unwrapWavePlatformPrintPayload }
├─ utils/use-delivery-sub-waybill-print.ts┤ ↓
└─ exceptionOrder.vue ─┘ wave-config.ts(整套波次业务配置)
```
`unwrapWavePlatformPrintPayload` 是个**纯函数**(约 120 行,无外部依赖),却和「工具栏按钮 / 状态字典 / 筛选项 / 策略参数」等 200KB 配置放在同一个文件里。
### 11.2 改动
| 文件 | 动作 |
|---|---|
| `views/order/shared/wavePrintPayload.ts` | **新增**,容纳 `unwrapWavePlatformPrintPayload` 及其 3 个内部 helper |
| `views/order/waveOrder/config/wave-config.ts` | 删除实现,改为 `export { unwrapWavePlatformPrintPayload } from '@/views/order/shared/wavePrintPayload'`(兼容历史引用);顺带移除已无用的 `WavePlatformPrintDataPayload` 类型导入 |
| `orderManagement/utils/use-order-batch-print.ts` 等 3 个打印工具 + `exceptionOrder.vue` | import 改指向新模块 |
| `orderreview/index.vue` | 同上(复核页也不再为这一个函数拖入整套波次配置) |
类型 `WavePlatformPrintDataPayload` 本来就定义在 `@/api/order.print/orderprint`,无需搬移。
### 11.3 验证
静态依赖图遍历(只跟随静态 `import` / `export from`,动态 `import()` 属懒加载不计):
| 入口 | 结果 |
|---|---|
| `src/views/order/orderManagement/pendingOrder.vue` | 82 个运行期模块,**不含** `wave-config` ✅ |
| `src/views/order/orderManagement/index.vue` | 89 个运行期模块,**不含** `wave-config` ✅ |
| `src/main.ts` | 55 个运行期模块,**不含** `wave-config` ✅ |
`npm run build` 通过(1m19s)。`waveOrder` 路由本身仍懒加载 `wave-config`,符合预期(只有进波次页才需要)。
> 顺带确认:`router/map.ts` 中所有页面组件都是 `() => import(...)`,路由级懒加载本来就是正确的,之前 `/order/orderManagement` 的 `No match found` 警告与性能无关。
---
## 12. 全站加载优化第一轮(P1 + P5,2026-11-07)
### 12.1 背景:全站摸底结论
- 生产产物最大 chunk:`vendor-echarts` 1093KB、`vendor-element-plus.js` 791KB + `vendor-element-plus.css` 348KB、`vendor-xlsx` 419KB、`vendor-china-division` 134KB
- 源码静态闭包最重的页面:`order/waveOrder` 1555KB/107 模块、`storage/receiving` 1204KB/95、`basicManagement/newview` 1058KB/83、`stock/stockManagement` 1053KB/100
- `order-common-config.ts`(源码 119KB,生产独立 chunk **54KB**)被 91 个文件引用,是覆盖面最广的一笔重复账
### 12.2 P1:切断页面 → `order-common-config` 的运行期依赖
**问题**:storage / store / stock / inbox / express 等页面只是想用一个 `getStatusTextClass()`,却整包引入了订单业务字典(工具栏配置、筛选字段、导出列定义…)。
**改动**:
| 动作 | 影响文件 |
|---|---|
| 把 `getStatusTextClass`、`SCAN_BASIC_INFO_GROUP/scanBasicField/scanWorkflowField`、`ORDER_BULK_SEARCH_OPERATORS`、`stockQueryScanField`、`extractStoreListFromResponse` 等选项映射的 import 改指向 `@/utils/statusText`、`@/utils/scanFields`、`@/utils/storeScanOptions` | 66 个 |
| 把 `ToolbarButtonConfig` / `ToolbarApiActionConfig` 的**纯类型** import 指向 `@/components/ToolbarButtonGroup/types`(类型真实所在) | 66 个 |
| `ORDER_BULK_SEARCH_OPERATORS` / `stockQueryScanField` 定义迁到 `@/utils/scanFields.ts`,`order-common-config` 转发 | 2 个 |
**结果**:引用 `order-common-config` 的源文件 **91 → 4**(只剩真正需要业务字典的:`orderreview/recheck-config.ts`、`order/shared/toolbarActions.ts`、`waveOrder/component/PendingOrderListPanel.vue`、`waveOrder/config/wave-config.ts`);生产产物中引用该 chunk 的文件 31 个(含订单页自身)。
代表性页面源码闭包变化:
| 页面 | 之前 | 之后 |
|---|---|---|
| `storage/receiving` | 1204KB / 95 模块 | **1083KB / 93** |
| `store/stores` | 861KB / 75 | **739KB / 72** |
| `storage/stockout` | 854KB / 74 | **731KB / 71** |
| `stock/stockManagement` | 1053KB / 100 | **935KB / 99** |
| `warehouses` | 752KB / 71 | **630KB / 68** |
### 12.3 P5:清理
| 项 | 动作 |
|---|---|
| `three` | 全项目无人引用(`threeScene.js`/`threeUtils.js`/`overlookControls.js` 只互相引用)。删除 3 个死文件 + `npm uninstall three @types/three`,移除 `vite.config` 里已无用的 `vendor-three` 分包规则 |
| `vue-devtools` | 加环境开关:`VITE_VUE_DEVTOOLS=off` 启动即可关闭(dev 下该插件会注入约 3MB 模块,影响性能基线;生产本来就不包含) |
`npm run build` 通过(1m25s),产物中已无 `vendor-three`。
### 12.4 下一轮(P0)待评估项
Element Plus 全量注册 → 按需引入(见 §13 执行记录)。
---
## 13. P0:Element Plus 按需引入 + 分包策略修正(2026-11-07)
### 13.1 改了什么
| # | 改动 | 文件 |
|---|---|---|
| 13.1 | 接入 `unplugin-vue-components` + `ElementPlusResolver`,模板里的 `<el-xxx>` 与 `v-loading` 等指令自动按需 import | `vite.config.ts` |
| 13.2 | 移除 `main.ts` 的 `import ElementPlus from 'element-plus'` + `app.use(ElementPlus)` 全量注册(**这是 791KB 的根源**) | `src/main.ts` |
| 13.3 | 移除 `manualChunks` 里的 `element-plus → vendor-element-plus` 规则:按需引入后若仍强制合并成一个 chunk,等于没做 | `vite.config.ts` |
| 13.4 | 移除 `manualChunks` 的 `return 'vendor'` catch-all:它把「只有某个懒加载页才用到」的库也塞进首屏 | `vite.config.ts` |
> 样式仍走 `element-plus/dist/index.css` 全量引入(`importStyle: false`),**没有做 CSS 按需** —— 全量 CSS 348KB(gzip 约 50KB),而代码里有一百多处显式 `import { ElMessage } from 'element-plus'`,切到按需样式需要额外补 message / message-box / notification / loading 的样式入口,回归面大、收益小,暂不处理。
### 13.2 效果(生产产物,首屏沿静态 import 递归统计)
| 阶段 | 首屏必载 JS | 说明 |
|---|---|---|
| 全量注册(改前基线) | **1608 KB** | `element-plus` 独立 chunk 791KB + vendor 389 + index 223 + vendor-vue 206 |
| 仅按需引入(保留 EP 独立分包) | 1373 KB | EP chunk 791→556 |
| 再去掉 EP 独立分包 | 1375 KB | EP 并进 `vendor`,收益被 catch-all 抵消 |
| **再去掉 vendor catch-all** | **768 KB** | index 449 + vendor-vue 319 |
**首屏 JS 从 1608KB 降到 768KB(−840KB,−52%)**;产物总量 6635KB → 6748KB(+113KB,+1.7% 的重复代码),用极小的总体积代价换首屏减半。
**权衡**:第三方依赖不再集中在一个哈希稳定的 `vendor` chunk,改应用代码会连带改变含第三方代码的 chunk 哈希,发版后重复下载会略增;强烈重缓存场景可以反过来保留 catch-all,但那会让首屏回到 1.3MB 以上。
### 13.3 两个必须知道的点
1. **`dts: false`**:开启组件类型声明会给 `<el-*>` 带上严格 props 类型,实测会暴露 **113 处**历史宽松写法(如 `:type="某字符串变量"`、`el-button` 上用已废弃的 `type="link"`)。这些是既有问题、与本次优化无关,因此先关闭类型生成(等于回到改动前的宽松状态,运行期按需引入不受影响)。后续清理完这 113 处可再打开。
2. **`type="link"` 在 Element Plus 2.13 已不合法**(应改用 `link` 属性),登录页等位置控制台一直有该 prop 校验告警,属于同一批历史遗留。
### 13.4 验证
| 项 | 结果 |
|---|---|
| `npm run build` | 通过(1m48s) |
| 页面渲染抽查 | `/order/orderManagement`(20 行/40 按钮/40 选择器/7 个弹窗)、`/order/waveOrder`(18 个弹窗)、`/storage/stockout`、`/storage/receiving`、`/warehouse/warehouse` 均正常 |
| 组件解析 | 全程无 `Failed to resolve component` 告警 |
| `v-loading` 指令 | 各页 `.el-loading-mask` 正常存在 |
| 控制台 | 仅剩既有噪声(本地未启动的打印/摄像头 WebSocket、`data/reviewingflow/index` 缺失) |
### 13.5 仍可继续的项
- CSS 按需(需补 message/message-box/notification/loading 样式入口 + 全站视觉回归)
- ~~dashboard 的 echarts 按需~~ → 见 §14
- 剩余 5 处 xlsx 静态 import(`vendor-xlsx` 419KB)
---
## 14. dashboard:ECharts 按需引入(2026-11-07)
### 14.1 问题
`OrderTrend.vue` / `PlatformDistribution.vue` / `ExpressRatio.vue` 三个组件都是 `import * as echarts from 'echarts'`,产物里 `vendor-echarts` 达 **1094KB**。虽然三个组件是 `defineAsyncComponent`,但 dashboard 一挂载就全部渲染,等于首屏整包拉取。
实际只用到了:折线图、饼图、grid、tooltip(含 axisPointer cross)、legend。
### 14.2 改动
| 文件 | 动作 |
|---|---|
| `src/utils/echarts.ts` | **新增**:`echarts/core` + `LineChart/PieChart` + `Grid/Tooltip/Legend/AxisPointer` + `LabelLayout` + `CanvasRenderer`,统一 `echarts.use([...])`,并导出 `echarts` 与 `ECharts` 类型 |
| 上述 3 个组件 | `import * as echarts from 'echarts'` → `import { echarts, type ECharts } from '@/utils/echarts'`;`echarts.ECharts` → `ECharts` |
| `vite.config.ts` | `optimizeDeps.include` 预构建 echarts 5 个子路径,避免首次访问 dashboard 触发「504 Outdated Optimize Dep」整页刷新 |
> 以后新增图表类型(如柱状图、dataZoom)只需在 `src/utils/echarts.ts` 的 `use([...])` 里补一行。
### 14.3 效果
| 指标 | 之前 | 之后 |
|---|---|---|
| `vendor-echarts` chunk | **1094 KB** | **522 KB**(−52%) |
| dashboard 图表渲染 | 3 个 canvas | 3 个 canvas,均有实际绘制内容(非空白像素占比 3.7% / 5.7% / 8.7%) |
| 控制台 | — | 无 echarts 相关报错 |
### 14.4 验证
- `npm run build` 通过(1m28s)
- `/dashboard` 加载后 3 个图表实例全部 `[_echarts_instance_]` 就位、canvas 有绘制内容
- 折线图 tooltip 的 axisPointer 已注册,无需额外依赖
---
## 15. 剩余 xlsx 静态引入全部改为按需(2026-11-07)
### 15.1 问题
`vendor-xlsx` 是 **419KB** 的独立 chunk。虽然订单导出处早已改动态加载,但仍有 8 个文件是 `import * as XLSX from 'xlsx'`,把它们所在的页面/chunk 一起拖上这 419KB:
| 文件 | 所在页面 |
|---|---|
| `storage/receiving/component/Product.vue` | 收货单(130KB 大组件) |
| `storage/stockout/index.vue` | 出库单 |
| `storage/validityperiod/index.vue` | 有效期商品 |
| `storage/entry/utils/direct-inbound-xlsx-import.ts` | 收货入库 |
| `stock/stock/component/ImportDialog.vue` | 库存管理 |
| `warehouse/components/RackBulkModifyDialog.vue` | 库位管理 |
| `material/packageMaterial/component/BatchImportDialog.vue` | 包材管理 |
| `order/shared/createOrderSession/CreatePendingOrderDialog.vue` | 建单弹窗 |
### 15.2 改动
- 删除全部 `import * as XLSX from 'xlsx'`,改为在**用到的那几个函数里** `const XLSX = await import('xlsx')`
- 相应把「下载导入模板」这类原本同步的函数改成 `async`(Vue 模板里 `@click` 直接绑函数,忽略返回的 Promise,行为不变)
- `downloadDirectInboundImportTemplate` 导出函数签名改为 `async`,唯一调用方 `DirectInboundImportDialog.vue` 无需改动
### 15.3 效果与验证
| 项 | 结果 |
|---|---|
| 源码中 `from 'xlsx'` 静态引用 | **0** |
| 产物中 `vendor-xlsx` chunk 的**静态** import 引用数 | **0** |
| 产物中 `vendor-xlsx` chunk 的**动态** import 引用数 | 9(都是点击导入/导出时才触发) |
| `npm run build` | 通过(1m20s) |
> 行为差异:导入/导出首次点击时会多一次 chunk 下载(419KB,内网可忽略),之后浏览器缓存复用。
---
## 16. waveOrder:省市区字典与修改地址弹窗改为按需(2026-11-07)
### 16.1 摸底结论(先测再改)
| 检查项 | 结果 |
|---|---|
| `order/waveOrder` 首屏脚本数 | 190 个 / 解码 11846KB(dev) |
| 切页签过渡时长 | **已经是 0.12s**(与 orderManagement 一致),无需再调 |
| `<component :key="activeTab">` | 与 orderManagement 不同,但 5 个页签是**不同组件类型**,keep-alive 本就按类型缓存,去掉 key 无实际收益 → 保留 |
| 默认页签 chunk 是否静态引用 `china-division` | **是** → 打开波次页就下载 134KB 省市区字典 |
真正的问题只有一个:**省市区字典(134KB JSON)在模块顶层被静态引入并立即解析**,而它只服务于「抓取团购单 / 波次策略」弹窗里的省份选择。
### 16.2 改动
| 文件 | 动作 |
|---|---|
| `waveOrder/GroupWaveBatchListPanel.vue` | 删除 `import pcasCodeData from 'china-division/dist/pca-code.json'`,改为 `ensureProvinceOptionsFromDict()`:首次需要时才 `import(...)`,加载完成后自动重算一次省份选项 |
| `waveOrder/WaveStrategyListPanel.vue` | 同上 |
| `orderManagement/exceptionOrder.vue` | 「修改地址」弹窗改 `defineAsyncComponent` + 模板加 `v-if="updateAddressDialogVisible"`(该弹窗会连带拉入省市区字典 + 整套快递接口配置) |
> `refreshWaveStrategyProvinceOptions()` 仍保持同步语义:先用手上已有的省份(字典未就绪时来自表单/列表数据)构建一次,字典加载完再补全,调用点无需改成 `await`。
### 16.3 效果与验证
| 项 | 结果 |
|---|---|
| 波次页打开时是否请求 `pca-code.json` | **否**(改前:是) |
| 产物中 `vendor-china-division` 静态引用者 | 仅剩 `express-interface-config-*.js`(快递接口页自身确实需要) |
| 产物中 `vendor-china-division` 动态引用 | 2 处(两个波次面板) |
| `/order/waveOrder` 渲染 | 20 行、85 个按钮正常 |
| `npm run build` | 通过(1m52s) |
### 16.4 未采纳
- 把 `GroupWaveBatchListPanel`(172KB 源 / 83KB chunk)改成 async:它是**默认页签**,进页面就要渲染,异步化只会多一次往返,没有收益。
- 去掉 `:key="activeTab"`:页签均为不同组件类型,keep-alive 按类型缓存,去掉无收益(避免无谓改动)。
---
## 17. 大组件按页签/弹窗按需(2026-11-07)
### 17.1 改动
| 页面 | 改动 | 省掉的静态体积 |
|---|---|---|
| `storage/receiving/index.vue` | 详情页签 `Storage` / `Logs` / `Product` 改 `defineAsyncComponent`(默认「收货明细」保持同步);`batch-receiving-print-dialog` 加 `v-if="printDialogVisible"` | `Product.vue` 130KB + `BatchReceivingPrintDialog` 46KB(含 jsbarcode/qrcode) |
| `basicManagement/newview/config/template-config.ts` | `MiniProgramConfigForm` / `FrontConfigForm` / `WarehouseSettingsForm` 改 `defineAsyncComponent`(都在 `COMPONENT_REGISTRY` 里,只被 `<component :is>` 使用) | 140 + 51 + 36 = **227KB** |
| `stock/stock/index.vue` | 详情页签 `erpStock` / `storage` / `barcode` / `log` 改 `defineAsyncComponent`(默认「信息」保持同步) | 数十 KB |
### 17.2 验证
| 项 | 结果 |
|---|---|
| `/storage/receiving` | 20 行正常;选中行后切「商品明细」才请求 `Product.vue`,明细表格正常渲染 |
| `/setting/basicManagement` | 7 个页签正常;切「微信小程序」才请求 `MiniProgramConfigForm.vue`,内容正常渲染 |
| `/stock/stock` | 页面正常(该环境无库存数据,未做页签切换验证;改动与上面同一模式) |
| 控制台 | 无 `Failed to resolve component` / 组件解析错误 |
| `npm run build` | 通过(1m42s) |
---
## 18. 到此为止:评估后**不做**的项
| 项 | 评估结论 |
|---|---|
| Element Plus CSS 按需 | 全量 CSS 348KB ≈ **gzip 50KB**;代码里一百多处显式 `import { ElMessage } from 'element-plus'`,切按需必须额外补 message / message-box / notification / loading 的样式入口,且需要全站视觉回归。**收益小、风险大,不做** |
| `order-common-config` 进一步拆分为业务配置模块(P6) | 属于结构调整(要动导出列/工具栏/筛选项的归属),影响面覆盖订单全部页签,与性能收益不成比例。**留作独立重构任务** |
| `print.ts`(91KB)拆分 | 里面是打印数据转换 + 模板配置的混合,拆开能省的量有限,且改动会影响波次打印主流程。**暂不做** |
| 去掉 `<component :key="activeTab">` | 页签类型各不相同,keep-alive 按类型缓存,去掉无收益 |
| `GroupWaveBatchListPanel` 改 async | 默认页签,进页面就要渲染,异步化只多一次往返 |

View File

@ -1,5 +1,9 @@
# 用户偏好配置:每账号每页面自定义配置(浏览器本地保存方案)
> ⚠️ **本文档关于「标签排序」的章节已过期(2026-11-07)**:
> 标签排序与默认页签已统一为注册表 + `useTabOrder` + `TabArea`,配置写入 `userPreference` 用户级 scope `tabOrder`,
> 并可在「字段设置 → 标签排序」中统一管理。请以 **`docs/标签排序与默认页签-统一方案.md`** 为准。
- 状态:**已决策(正式方案)**
- 日期:2026-09-01
- 版本:v1.1

View File

@ -0,0 +1,100 @@
# 统一配置文件:tbyc-config.json
- 日期:2026-11-07
- 入口:`设置 → 导入 / 导出与维护`(Navbar 头像下拉「设置」,或列表页工具栏「字段设置」打开设置中心)
- 目标:配置文件不再局限于「字段设置」,而是一个可扩展的分区容器,后续功能只需注册分区即可接入
---
## 1. 文件结构
```jsonc
{
"format": "tbyc-config",
"version": 1,
"exportedAt": 1762500000000,
"user": { "userId": "zhangsan", "roleId": 3 },
"sections": {
"fieldColumns": [ /* 字段设置:表格列配置档案数组 */ ],
"tabOrder": {
"version": 1,
"orders": { "order.management": ["pendingOrder", "reviewOrder"] },
"defaults": { "order.management": "pendingOrder" }
},
"display": {
"showSettings": true,
"tagsView": true,
"fixedHeader": true,
"sidebarLogo": true,
"shortcutExpanded": false,
"layoutMode": "top-bottom",
"toolbarMode": "tile",
"scanBoxMode": "compact"
},
"shortcuts": [{ "title": "订单管理", "path": "/order/orderManagement" }]
}
}
```
- `format` 固定为 `tbyc-config`,`version` 为文件结构版本
- `sections` 内每个 key 对应一个「配置分区」,互不影响
- 空分区(无数据)不会被写入文件
- 导入时**未知分区只忽略并提示**,不会阻断其它配置导入
---
## 2. 已支持的分区
| key | 名称 | 数据来源 | 存储位置 |
|---|---|---|---|
| `fieldColumns` | 字段设置 | UpperTable 列配置 | `upper_table_columns_{user}_{role}_{tableId}` |
| `tabOrder` | 标签排序 / 默认页签 | 标签排序面板 | `user_prefs_{userId}` → scope `tabOrder` |
| `display` | 界面显示 | settings store | `settings_{user}_{role}` |
| `experimental` | 表格与缓存 | experimental store | `experimental_{user}_{role}` |
| `printer` | 设备与打印 | userPreference | `user_prefs_{user}_{warehouse}` → scope `printer.autoReconnect` |
| `shortcuts` | 快捷键 | shortcuts store | `shortcuts_{user}_{role}` |
---
## 3. 新增一类配置(扩展方式)
1. 在 `src/config/tbyc-config-sections.ts` 里定义分区对象:
```ts
const mySection: TbycConfigSection = {
key: 'myFeature',
title: '我的功能',
collect: () => {
// 返回要导出的数据;返回 undefined/null 表示本次不导出该分区
},
apply: (data) => {
// 校验并写入,返回成功应用的条数(0 表示无变化)
return 0
}
}
```
2. 加入 `TBYC_CONFIG_SECTIONS` 数组。
无需修改 `src/utils/tbyc-config.ts` 或 `UpperTable`。
---
## 4. 兼容策略
| 文件来源 | 处理 |
|---|---|
| `tbyc-config` 新格式 | 按 `sections` 逐个分区应用 |
| 旧「全局字段配置」(`format: 'upper-table-global-columns'`,含 `tables` + `tabOrders`) | 映射为 `fieldColumns` + `tabOrder` 两个分区 |
| 更早的单表导出文件(`tableId` + `columns`) | 映射为 `fieldColumns`(单条档案) |
导入策略:**覆盖同名项,保留文件中未涉及的配置**(不做整包清空)。
---
## 5. 注意事项
- `fieldColumns` / `display` / `shortcuts` 仍是「用户 + 角色」维度;`tabOrder` 是「仅用户」维度(不分仓库、不分角色)
- 导入 `display` 时通过 `settingsStore.changeSetting` 逐项应用并持久化,无需刷新页面
- 导入 `shortcuts` 时直接赋值 store(store 内部 `watch(deep)` 自动持久化)
- 导入 `fieldColumns` 后会调用 `rebuildColumnConfig()` 让当前表格立即刷新

View File

@ -0,0 +1,216 @@
# 自定义过滤条件:设计与实施
- 日期:2026-11-09
- 状态:**已实现(P1–P3)**
- 定位:给 ScanBox「过滤」页签增加**用户自定义条件**,与后端下发的系统预设并存
- 相关文档:`docs/设置中心-设计与实施.md`、`docs/统一配置文件-tbyc-config.md`、`docs/用户偏好配置-浏览器本地保存方案.md`
---
## 1. 目标
| 目标 | 说明 |
|---|---|
| 任意列表页可自定义常用过滤条件 | 不依赖后端新增配置 |
| 一键使用 | 点「过滤」页签里的条目即查询,与系统预设体验一致 |
| 可管理 | 「设置 → 筛选与查询 → 自定义过滤条件」查看 / 新增 / 编辑 / 启停 / 排序 / 复制 / 删除 / 恢复默认 |
| 可备份 | 随 `tbyc-config.json` 导入导出 |
| 本地优先 | 条件只存本机浏览器,按账号隔离,不经过服务端 |
非目标:跨设备同步(需后端接口)、OR / 嵌套条件组、按角色差异化。
---
## 2. 数据分层
```
第 1 层:系统预设(只读)
后端 index.fastWhereTree(type) → presetTree prop → 「系统」分组
第 2 层:我的预设(本地,可增删改)
user_prefs_{userId} → scope "scanFilterPresets"
第 3 层:导出文件
tbyc-config.json → sections.scanFilterPresets(只导出第 2 层)
第 4 层:页面元数据(本机,不导出)
localStorage "scan_box_pages_{userId}"(页面 → 可筛选字段快照)
```
---
## 3. 存储与作用域
| 数据 | 位置 | 作用域 | 是否导出 |
|---|---|---|---|
| 自定义条件 | `user_prefs_{userId}` → scope `scanFilterPresets` | 账号(`setGlobal`,不分仓库/角色) | ✅ |
| 页面元数据(可筛选字段) | `localStorage.scan_box_pages_{userId}` | 账号 + 本机 | ❌ |
- `scanFilterPresets` 已加入 `USER_GLOBAL_SCOPES`(`src/stores/modules/userPreference.ts`),
避免仓库级 key 迁移时产生副本。
- 读取/写入统一走 `useUserPreferenceStore().getGlobal / setGlobal`,localStorage 不可用时静默降级。
### 文档结构
```jsonc
// user_prefs_{userId} → "scanFilterPresets".value
{
"version": 1,
"presets": [
{
"id": "sp_1760000000000_ab12",
"pageKey": "stock-management-warehouse", // ScanBox cache-key
"name": "零库存商品",
"enabled": true,
"order": 0,
"conditions": {
"quantity": { "operator": "le", "value": 0, "type": "number" },
"is_images": { "operator": "eq", "value": "N", "type": "boolean" }
},
"createdAt": 1760000000000,
"updatedAt": 1760000000000
}
]
}
```
**条件必须是扁平结构** `{ 字段: { operator, value, type } }`:
- 与「筛选」页签的产出一致,页面侧 `buildXxxQuery` / `normalizeToWhere` 不需要区分来源;
- `stock/stock` 的 `buildStockQuery` 只认扁平结构(已顺带兼容 `{ conditions: {...} }` 信封,见 §7)。
---
## 4. 页面标识与页面登记
### 4.1 pageKey
取 `ScanBox` 的 **`cache-key`**(全项目基本都有且唯一),缺省回退 `route.path`。
- 同一页面多块 ScanBox(如波次面板、订单管理各页签)天然分开;
- 与 ScanBox 筛选快照的隔离键一致,符合既有习惯。
### 4.2 自动登记(设置中心需要“页面 → 字段”映射)
`ScanBox` 挂载时把 `availableFields` 精简后写入 `scan_box_pages_{userId}`:
```ts
{ pageKey, title, path, fields: [{ value, label, type, operators, defaultOperator, group, options }], updatedAt }
```
- 字段来源是 `props.availableFields`,**跳过 ScanBox 自动合并的时间伪字段**(`autoMergedTimeRange`),
保留页面原始时间字段(如 `create_at` / `update_at`);
- `select / multiple` 的选项做快照(上限 200 条),供设置中心渲染下拉;
异步选项(货主、违禁品、库存单位)加载后通过轻量签名 watch 补登记(800ms 防抖);
- 与「所有表格字段」一致:**页面打开一次后才会出现在设置中心**。
---
## 5. ScanBox 交互
| 场景 | 行为 |
|---|---|
| 只有系统条件 | 平铺展示(与改造前一致) |
| 只有自定义条件 | 平铺展示 |
| 两者都有 | 分组:`系统` / `我的`(默认展开) |
| 点击叶子 | `activeCondition = data.value` → `emit('condition-change')`,页面立即查询 |
| 选中后继续追加 | 预设置条件**回填到「筛选」表单**;切到「筛选」可继续增删条件,点「确定」按「预设 + 追加」合并提交 |
| 存为过滤条件 | 底部按钮打开 task-panel 表单弹窗(名称 + 条件预览),保存后立即应用并切到「过滤」页签 |
| 更新预设 | 选中的是**本地自定义条件**时,底部按钮变为「更新过滤条件」:点一下就把当前条件写回该预设并重新查询(系统预设只读,仍为「存为过滤条件」) |
| 筛选页签底部 | 显示「过滤条件:xxx」+「存为过滤条件」;表单无法表达的条件(如预设里的特殊字段)在提交时按基线自动补回 |
| 取消应用 | 过滤面板**底部**显示「已应用:<条件名>」+「取消应用」(与「筛选」底部条同一位置与样式),点一下清除条件并重查(预设本身保留) |
| 搜索 | 仍然按 `label` 过滤;数据变化后自动重放关键字 |
| 停用的条件 | 不进入过滤树(设置里保留) |
| 紧凑模式 | 上一轮修复后,切「过滤」复用同一棵预设树 |
| 存为过滤条件 | 「筛选」页签有值时,底部出现入口:命名 → 保存 → 自动切到「过滤」并应用 |
系统节点结构保持后端原样(`{ id, label, icon, count, value, children }`);
自定义节点为 `{ id: 'custom:<presetId>', label: name, value: 扁平conditions }`。
> ⚠️ 不要把 `type: 'preset'` 等标记塞进 `value`:`stock/stock` 的 `buildStockQuery`
> 会把未知键当字段。选中态由 el-tree 的 `highlight-current` 维护,无需写进条件。
---
## 6. 设置中心分区
路径:**设置 → 筛选与查询 → 自定义过滤条件**(`components/settings/registry.ts`)
```
┌────────────────┬────────────────────────────────────────────┐
│ 页面(自动登记)│ 页面标题 / pageKey [恢复默认] │
│ ▸ 商品明细 3 │ ┌ 零库存商品 [开关] ↑ ↓ 编辑 复制 删除 │
│ ▸ 待处理订单 │ │ 库存数量 小于等于 0 且 无图 │
│ ▸ … │ └ … │
└────────────────┴────────────────────────────────────────────┘
```
- 保存即时生效(无全局保存/取消),与设置中心其它分区一致;
- 删除 / 恢复默认使用 **task-panel 确认弹窗**(标题 + 说明 + 条件/范围预览 + 警示提示 + 取消/确认),确认按钮按危险等级显示为 `danger`;
- 条件编辑器:字段(按 group 分组、已选字段禁选)→ 操作符(按字段 `operators` / 类型默认)→ 值控件;
- 支持的字段类型:`text / number / select / multiple / boolean / date / daterange / datetimerange`;
- 值控件:文本、数字、数字区间、日期、日期区间、单选、多选、是/否;`isnull / isnotnull` 无需填值;
- 校验:名称(必填 / ≤20 字 / 同页唯一)、至少 1 个条件、必填值、区间上下限;
- `type` 归一:`boolean→boolean`、`number→number`、`date→date`、`daterange→daterange`、其它 → `text`
(避免 `multiple` 被部分页面误判成 `daterange`)。
---
## 7. 与页面查询的兼容
- 自定义条件输出扁平结构,页面原有 `buildXxxQuery` 直接可用;
- `buildStockQuery` 增加兜底:`{ conditions: {...} }` 信封先展开,并跳过 `type` / `preset` 元数据键——
顺带修好了「系统过滤条件点了没反应」的隐患;
- 导出:`buildExportPayload()` 使用 `currentConditions`,自定义条件自动带入导出。
---
## 8. 导入 / 导出(tbyc-config)
`src/config/tbyc-config-sections.ts` 新增分区:
| 项 | 值 |
|---|---|
| key | `scanFilterPresets` |
| title | 自定义过滤条件 |
| collect | 有数据时输出 `{ version, presets }` |
| apply | 同 `id` 覆盖;同页面同名覆盖(保留本地 id/顺序);其余追加 |
导入结果提示形如:`自定义过滤条件 3 项`。未知分区仍只忽略并提示。
---
## 9. 容错与边界
| 场景 | 处理 |
|---|---|
| 页面从未打开 | 设置中心提示“打开任意列表页后再回来”,不报错 |
| 字段被删除/改名 | 预设保留;编辑时字段选项不可选,摘要显示原字段名 |
| 下拉选项已变化 | 摘要按保存时的选项快照显示,查询以实际值为准 |
| 名称重复 | 编辑/复制时拦下并提示 |
| localStorage 不可用 | 内存态运行,不阻塞页面 |
| 导入异常数据 | `normalizePresetsDoc` 丢弃非法项(缺 pageKey/name/conditions 等) |
| 故障修复 | 一并清除自定义条件与页面登记,提示中列出条数 |
---
## 10. 已落地文件
| 文件 | 说明 |
|---|---|
| `src/utils/scan-filter-presets.ts` | 类型 / 归一化 / 页面登记 / 摘要 / 校验 |
| `src/stores/modules/scanFilterPresets.ts` | Pinia store(条件 + 页面元数据,ScanBox 与设置共用) |
| `src/components/ScanBox/index.vue` | 过滤树合并、页面登记、「存为过滤条件」 |
| `src/components/settings/sections/FilterPresetsSection.vue` | 设置分区 UI + 条件编辑器 |
| `src/components/settings/registry.ts` | 新增分组「筛选与查询」与分区条目 |
| `src/config/tbyc-config-sections.ts` | 新增 `scanFilterPresets` 分区 |
| `src/stores/modules/userPreference.ts` | `scanFilterPresets` 加入用户级 scope |
| `src/utils/stockQueryBuilder.ts` | 兼容 `{ conditions }` 信封 |
| `src/components/settings/sections/DataSection.vue` | 故障修复一并清理 |
---
## 11. 后续可扩展
1. **跨设备同步**:需要后端保存接口,本地结构可直接作为 payload;
2. **内置默认条件**:新增 `src/config/scan-filter-presets.default.ts`,作为只读第三分组「内置」;
3. **OR / 条件组**:`conditions` 升级为 `{ logic: 'and'|'or', groups: [...] }`,读取时做版本迁移;
4. **上次使用高亮**:记录 `pageKey → presetId`,页面重进时恢复高亮(不自动应用);
5. **从 URL 分享条件**:序列化预设为链接参数(注意敏感字段)。

View File

@ -0,0 +1,302 @@
# 菜单图标体系 · 实施方案
> 范围:web 端左侧菜单 / 顶部菜单的图标(`wms_permission.meta_icon`)
> 状态:**方案稿,未改代码**
> 目标:命名统一、可维护、失效可见、存量可迁移
---
## 一、图标库选型
### 1.1 现状
| 环节 | 实现 |
|---|---|
| 构建 | `vite-plugin-svg-icons`,扫描 `src/icons/svg/*.svg`,生成 sprite,id = `icon-{文件名}` |
| 注册 | `main.ts` → `virtual:svg-icons-register` + `app.component('svg-icon', SvgIcon)` |
| 渲染 | `<svg-icon icon-class="xxx" />` → `<use xlink:href="#icon-xxx" />` |
| 尺寸/颜色 | `1em × 1em`,`fill: currentColor` |
| 现有图标 | 16 个通用图标(dashboard / form / table / user …),**无业务图标** |
另一套:`@element-plus/icons-vue`(`ArrowDown`、`ChatDotRound` 等),以 **Vue 组件**形式零散使用,不参与菜单图标。
### 1.2 候选方案对比
| 方案 | 优点 | 缺点 | 结论 |
|---|---|---|---|
| **A. 沿用 svg sprite + 自建业务图标集** | 零新增依赖;渲染链路不变;40+ 现有使用点无需改动;体积可控(按需打包);`fill: currentColor` 天然适配主题色 | 需要人工沉淀图标文件 | ✅ **推荐** |
| B. `@element-plus/icons-vue` 作为菜单图标源 | 依赖已存在,约 290 个通用图标 | 组件形式,无法用 `meta_icon` 字符串直接驱动;**缺少订单/库存/仓储类业务语义图标** | ❌ 不作为菜单图标源,继续用于按钮内图标 |
| C. Iconify 离线集合(`@iconify/vue`) | 图标海量(20 万+),字符串直用,可离线 | 新增运行时依赖;命名带集合前缀;需改造 `SvgIcon`;首屏体积需额外控制 | ⚠️ 进阶可选 |
| D. iconfont 字体/symbol | 设计可维护,可自定义 | 依赖外部项目与更新流程;字体图标单色 | ⚠️ 团队有设计资源时可选 |
### 1.3 结论
**继续使用现有的 `vite-plugin-svg-icons` + `svg-icon` 机制**,只补齐「业务图标资源 + 命名规范 + 兜底校验」。
图标素材来源建议使用 MIT 协议的开源集合(可直接商用、可落地成 svg 文件):
- **Tabler Icons**(MIT,线条风格,与当前 UI 风格接近)
- **Material Design Icons**(Apache-2.0)
- **Carbon Icons**(Apache-2.0)
> 落地方式:下载为 `.svg` 放入 `src/icons/svg/`,文件名即 `meta_icon` 的值,**不引入任何新依赖**。
命名规范:
```
全小写 kebab-case,语义优先,不带前缀
✔ order、goods、storage、express-truck、after-sale
✘ el-icon-s-goods、Icon_Order、orderIcon
```
---
## 二、图标清单
### 2.1 需要新增的 svg 文件(19 个)
| # | 文件名 | 语义 | 建议来源 |
|---|---|---|---|
| 1 | `order.svg` | 订单 | 单据/清单 |
| 2 | `goods.svg` | 商品 | 包裹/盒子 |
| 3 | `storage.svg` | 库存 | 货架/箱子堆叠 |
| 4 | `material.svg` | 物料 | 耗材/组件 |
| 5 | `warehouse-grid.svg` | 仓位 | 网格/库位 |
| 6 | `warehouse.svg` | 仓库 | 仓库/厂房 |
| 7 | `data-chart.svg` | 数据 | 柱状/折线图 |
| 8 | `store-owner.svg` | 货主 | 商户/店铺 |
| 9 | `express-truck.svg` | 物流 | 货车 |
| 10 | `finance.svg` | 财务 | 钱币/钱包 |
| 11 | `video-camera.svg` | 视频监控 | 摄像头 |
| 12 | `settings.svg` | 设置 | 齿轮 |
| 13 | `system.svg` | 系统 | 服务器/终端 |
| 14 | `after-sale.svg` | 售后 | 客服/售后 |
| 15 | `inbox-message.svg` | 消息 | 收件箱/消息 |
| 16 | `user-check.svg` | 成员加入审核 | 用户+对勾 |
| 17 | `permission.svg` | 权限管理 | 盾牌/钥匙 |
| 18 | `role.svg` | 角色管理 | 用户组 |
| 19 | `material-info.svg` | 物料资料 | 文档+信息 |
已存在、无需新增:`user.svg`(账号管理沿用)
### 2.2 菜单 → 图标映射表
| id | path | 菜单标题 | 现 meta_icon | 新 meta_icon |
|---|---|---|---|---|
| 1 | `/order` | 订单 | `''` | `order` |
| 13 | `/stock` | 商品 | `el-icon-s-goods` | `goods` |
| 18 | `/storage` | 库存 | `el-icon-s-data` | `storage` |
| 15 | `/material` | 物料 | `el-icon-s-cooperation` | `material` |
| 14 | `/warehouse` | 仓位 | `el-icon-s-grid` | `warehouse-grid` |
| 16 | `/data` | 数据 | `el-icon-s-marketing` | `data-chart` |
| 17 | `/store` | 货主 | `el-icon-s-custom` | `store-owner` |
| 393 | `/warehouses` | 仓库 | `el-icon-s-custom` | `warehouse` |
| 19 | `/express` | 物流 | `el-icon-truck` | `express-truck` |
| 28 | `/finance` | 财务 | `el-icon-s-finance` | `finance` |
| 47 | `video` | 视频监控 | `el-icon-video-camera-solid` | `video-camera` |
| 4 | `/setting` | 设置 | `el-icon-s-tools` | `settings` |
| 73 | `/system` | 系统 | `el-icon-s-tools` | `system` |
| 519 | `afterSale` | 售后 | `null` | `after-sale` |
| 492 | `/inbox` | 消息 | `null` | `inbox-message` |
| 50 | `/auth/approve` | 成员加入审核 | `null` | `user-check` |
| 6 | `account` | 账号管理 | `user` | `user`(不变) |
| 5 | `permission` | 权限管理 | `setting` | `permission` |
| 7 | `role` | 角色管理 | `role` | `role`(补文件) |
| 29 | `materialInfo` | 物料资料 | `el-icon-info` | `material-info` |
> `720` 行之外的其他 `web_pages` 子菜单当前无图标,可按需逐步补充,不影响本方案实施。
---
## 三、迁移 SQL
### 3.1 前置检查
```sql
-- 迁移前快照(便于回滚比对)
SELECT id, path, meta_title, meta_icon
FROM wms_permission
WHERE type = 'web_pages' AND meta_icon IS NOT NULL AND meta_icon <> ''
ORDER BY id;
```
### 3.2 正向迁移
```sql
UPDATE wms_permission SET meta_icon = 'order' WHERE id = 1 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = 'goods' WHERE id = 13 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = 'storage' WHERE id = 18 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = 'material' WHERE id = 15 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = 'warehouse-grid' WHERE id = 14 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = 'data-chart' WHERE id = 16 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = 'store-owner' WHERE id = 17 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = 'warehouse' WHERE id = 393 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = 'express-truck' WHERE id = 19 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = 'finance' WHERE id = 28 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = 'video-camera' WHERE id = 47 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = 'settings' WHERE id = 4 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = 'system' WHERE id = 73 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = 'after-sale' WHERE id = 519 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = 'inbox-message' WHERE id = 492 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = 'user-check' WHERE id = 50 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = 'permission' WHERE id = 5 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = 'role' WHERE id = 7 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = 'material-info' WHERE id = 29 AND type = 'web_pages';
-- 账号管理 id = 6 保持 'user' 不变
```
> 全部带 `id + type` 双重条件,避免误伤其他端(`pda_pages` / `miniprogram_pages`)。
### 3.3 回滚
```sql
UPDATE wms_permission SET meta_icon = '' WHERE id = 1 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = 'el-icon-s-goods' WHERE id = 13 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = 'el-icon-s-data' WHERE id = 18 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = 'el-icon-s-cooperation' WHERE id = 15 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = 'el-icon-s-grid' WHERE id = 14 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = 'el-icon-s-marketing' WHERE id = 16 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = 'el-icon-s-custom' WHERE id = 17 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = 'el-icon-s-custom' WHERE id = 393 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = 'el-icon-truck' WHERE id = 19 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = 'el-icon-s-finance' WHERE id = 28 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = 'el-icon-video-camera-solid' WHERE id = 47 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = 'el-icon-s-tools' WHERE id = 4 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = 'el-icon-s-tools' WHERE id = 73 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = NULL WHERE id = 519 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = NULL WHERE id = 492 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = NULL WHERE id = 50 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = 'setting' WHERE id = 5 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = 'role' WHERE id = 7 AND type = 'web_pages';
UPDATE wms_permission SET meta_icon = 'el-icon-info' WHERE id = 29 AND type = 'web_pages';
```
### 3.4 迁移后校验
```sql
-- 应无 el-icon-* 残留(web_pages)
SELECT id, path, meta_icon FROM wms_permission
WHERE type = 'web_pages' AND meta_icon LIKE 'el-icon-%';
-- 列出所有在用的图标名,逐个核对 svg 文件是否齐全
SELECT meta_icon, COUNT(*) AS used_by
FROM wms_permission
WHERE type = 'web_pages' AND meta_icon IS NOT NULL AND meta_icon <> ''
GROUP BY meta_icon ORDER BY meta_icon;
```
---
## 四、组件改造方案
### 4.1 `SvgIcon` 增加兜底与告警
`src/components/SvgIcon/index.vue`
现状:icon 不存在时静默渲染空白,**无法发现问题**。
改造要点:
| 项 | 做法 |
|---|---|
| 兜底图标 | 新增 `fallback` prop,默认 `unknown`;symbol 不存在时显示它 |
| 存在性检测 | 检测 `#icon-{name}` 是否存在于 sprite(结果按名字缓存,避免重复查询 DOM) |
| 开发期告警 | `import.meta.env.DEV` 下 `console.warn('[svg-icon] 图标不存在: xxx')` |
| 保持兼容 | `iconClass` 为空或外部链接时行为不变 |
伪代码:
```ts
const iconExists = computed(() => {
if (!props.iconClass || isExternal.value) return true
if (cache.has(props.iconClass)) return cache.get(props.iconClass)!
const ok = !!document.getElementById(`icon-${props.iconClass}`)
cache.set(props.iconClass, ok)
if (!ok && import.meta.env.DEV) console.warn(`[svg-icon] 图标不存在: ${props.iconClass}`)
return ok
})
const finalIcon = computed(() => (iconExists.value ? props.iconClass : props.fallback))
```
> 注意:缓存要在 sprite 注册完成后才有意义,首次调用前需确保 `virtual:svg-icons-register` 已执行(入口已保证)。
### 4.2 权限页图标列表改为动态生成
`src/views/system/setting/permission/index.vue`
现状:`iconList` 硬编码 16 个字符串,其中 `shopping-cart`、`skill`、`star`、`zip` **文件不存在**,`user` 重复两次。
改造:
```ts
const svgModules = import.meta.glob('@/icons/svg/*.svg')
const iconList = Object.keys(svgModules)
.map((p) => p.split('/').pop()!.replace(/\.svg$/, ''))
.sort()
```
收益:
- 新增图标文件后**自动出现在下拉里**,无需改代码
- 彻底消除「列表与实际资源漂移」
- 重复项自动去重
### 4.3 图标选择器开放到 `web_pages`
现状:`meta_icon` 输入块被 `v-if="tempCreate.type === 'pda_pages'"` 限制,**web 菜单在界面上无法配置图标**。
改造:条件放宽为
```vue
v-if="tempCreate.type === 'web_pages' || tempCreate.type === 'pda_pages'"
```
同步修改编辑弹窗(`tempUpdate`)中的同一处。
### 4.4 可选:抽 `IconPicker` 组件
如果后续多个页面都要选图标,把「下拉 + 预览 + 搜索」抽成 `src/components/IconPicker/index.vue`:
| prop | 说明 |
|---|---|
| `modelValue` | 图标名 |
| `clearable` | 是否可清空 |
| `placeholder` | 占位文案 |
内部复用动态生成的 `iconList`,下拉项左侧渲染 `svg-icon` 预览。
---
## 五、实施步骤
| 步骤 | 内容 | 影响面 | 可独立上线 |
|---|---|---|---|
| 1 | 落地 19 个 svg 文件到 `src/icons/svg/` | 仅新增资源 | ✅ |
| 2 | `SvgIcon` 加兜底 + DEV 告警 | 全局组件 | ✅ |
| 3 | `iconList` 改为 `import.meta.glob` 动态生成 | 权限页 | ✅ |
| 4 | 图标选择器开放 `web_pages` | 权限页 | ✅ |
| 5 | 执行迁移 SQL | 数据 | ✅(建议与 1 同批) |
| 6 | 校验:菜单逐项检查 + 无 `el-icon-*` 残留 | — | — |
> 步骤 1 与 5 必须同批发布,否则会出现「数据改了但图标文件没有」的空白期。
---
## 六、风险与注意事项
| 风险 | 说明 | 应对 |
|---|---|---|
| 图标文件缺失 | 数据先改、文件未发 → 菜单空白 | 步骤 1 先于 5,或同批 |
| 首页首屏体积 | 每个 svg 会被打进 sprite(内联) | 单个 svg 控制在 2KB 内,统一 `viewBox="0 0 24 24"` |
| 颜色失效 | 图标自带 `fill` 会覆盖 `currentColor` | svg 内**不要写死 `fill`**,统一用 `fill="currentColor"` 或不写 |
| 线宽不一致 | 不同来源图标混用视觉杂乱 | 统一同一图标集(建议全用 Tabler 或全用 MDI) |
| 其他端受影响 | `pda_pages` / `miniprogram_pages` 同字段 | 迁移 SQL 全部限定 `type='web_pages'` |
| 权限数据多环境 | 各环境 `id` 可能不同 | 优先按 `id + path` 双条件,或按 `path` 匹配后再核对 |
---
## 七、待确认
1. 图标风格选哪套?(建议全量统一 Tabler,线条风格与现有 UI 最协调)
2. 是否需要我一并生成 19 个 svg 文件?
3. `pda_pages` / `miniprogram_pages` 的图标是否也纳入统一命名(本次只动 web)?

View File

@ -0,0 +1,159 @@
# 设置中心:设计与实施
- 日期:2026-11-08
- 状态:**已实现(P1–P5)**
- 定位:项目内**所有"本机可修改配置"的唯一入口**,取代原「字段设置」弹窗
---
## 1. 入口
| 入口 | 位置 | 行为 |
|---|---|---|
| 全局 | Navbar 头像下拉 →「设置」 | 打开设置中心;无表格上下文,隐藏「当前页面 → 列表字段」 |
| 页面 | 列表页工具栏「字段设置」 | 打开同一弹窗,定位到「列表字段」,行为与改造前一致 |
---
## 2. 分区结构
```
设置(左导航 + 右内容,1280px)
├─ 字段与列
│ ├─ 列表字段 当前表格列显隐 / 顺序 / 固定(由 UpperTable 通过插槽注入)
│ ├─ 所有表格字段 跨页面管理全部已登记表格(搜索 / 显隐 / 顺序 / 固定 / 恢复默认)
│ └─ 导出字段 订单管理各页「导出(不含明细)」的导出字段勾选(账号 + 角色)
├─ 系统设置
│ ├─ 界面显示 布局模式 / 固定头部 / 侧栏 Logo / Scan-box / 工具栏 / 快捷键区域
│ └─ 基础设置 表格工作模式 + 页面缓存 + 标签缓存(原「性能」两项合并)
├─ 设备与打印
│ └─ 设备与打印 打印组件连接状态、失败自动重连、逐组件开关(账号 + 仓库)
├─ 导航与入口
│ ├─ 标签排序 全项目页面标签顺序 + 默认页签
│ └─ 快捷入口 侧边栏收藏的快捷入口集中管理
└─ 数据与维护
└─ 导入 / 导出与维护 导出/导入 tbyc-config.json、恢复全部默认、故障修复、诊断信息
```
分类原则:按**配置对象**分组(字段与列 / 系统设置 / 设备与打印 / 导航 / 数据),不再按“功能模块”拆散。
单条目且条目名与分组名相同时(如「设备与打印」)左导航省略分组标题,避免重复。
作用域提示直接显示在导航项右侧:`当前表格 / 账号 + 角色 / 账号 / 本机`,避免用户误以为会同步到服务端。
---
## 3. 代码结构
```
components/settings/
SettingsDialog.vue 外壳(左导航 / 搜索 / 右侧动态分区 / 底部提示)
registry.ts 分区元数据(key/title/group/scope/slot/component 懒加载)
sections/
DisplaySection.vue 界面显示(含布局 / 固定头部 / 侧栏 Logo)
DeviceSection.vue 设备与打印(复用 PrinterComponentConnectionPanel)
BasicSettingsSection.vue 基础设置(表格工作模式 + 页面/标签缓存,resetToDefaults 统一恢复)
TabOrderSection.vue → 复用 components/TabOrderPanel.vue
ShortcutsSection.vue 快捷入口集中管理
AllTablesSection.vue 所有表格字段(跨页面列配置管理)
ExportColumnsSection.vue 导出字段(订单管理各页 · 导出全部不含明细)
DataSection.vue 导入导出 / 恢复默认 / 故障修复 / 诊断
shared.scss 分区通用样式
```
### 所有表格字段(跨页面)
| 项 | 说明 |
|---|---|
| 数据来源 | `upper_table_columns_{user}_{role}_{tableId}`(页面打开一次后由 UpperTable 自动登记) |
| 列表能力 | 按名称/tableId 搜索、仅看已自定义、显示已自定义标记 |
| 编辑能力 | 显隐、上移/下移、左/右固定与取消固定、恢复默认 |
| 即时生效 | 修改写入 localStorage + `tableColumnConfig.touch(tableId)`;已打开的表格监听版本号并重建列 |
| 恢复默认 | 依赖配置中的 `defaultColumns` 快照(首次生成配置时记录);旧配置在下一次打开页面时补齐 |
| 公共代码 | `utils/table-column-config.ts`(类型 / 读写 / 分区与归一化 / 自定义判定) |
- 表级「列表字段」不放进 registry 组件,由 `UpperTable` 通过 `#field-section` 插槽注入(列配置逻辑与表格渲染强耦合,不搬动逻辑)
- 分区组件全部 `defineAsyncComponent`,打开设置中心不会一次性加载所有分区
### 导出字段(订单管理 · 导出全部不含明细)
| 项 | 说明 |
|---|---|
| 数据来源 | `order_export_columns_{user}_{role}_{scopeKey}_{mode}`(与 `OrderExportColumnsDialog` 同一 key) |
| 页面范围 | `ORDER_TAB_LIST` ∩ `ORDER_INDEX_EXPORT_SCOPES`:待审核/待处理/待处理异常/待出库/委托外仓/配送/配送异常/归档 |
| 本期模式 | 仅 `waybill`(导出全部 · 不含明细);`item`(含明细)存储已在配置分区中兼容 |
| 字段来源 | `getOrderExportColumnGroupsByMode('waybill')`,与导出弹窗同一套中文表头分组 |
| 默认值 | 未配置(无 localStorage key)= 全选 |
| 即时生效 | 勾选即写 localStorage,下次打开导出弹窗读取;弹窗打开时不再回退为全选 |
| 恢复默认 | 删除该页 key(回到未配置 = 全选) |
- 语义修正:`OrderExportColumnsDialog.loadSavedColumns()` 改为 `string[] \| null`,**空数组视为「显式清空」**而不是「未配置」,避免清空后在下次打开时被静默重置为全选
---
## 4. 交互约定
| 项 | 约定 |
|---|---|
| 保存 | **即时生效**(各分区直写对应 store),无全局"保存/取消" |
| 重置 | 分区内「恢复默认」;「数据与维护」内提供「恢复全部默认」(二次确认) |
| 危险操作 | 故障修复保留双重确认,并列出被清除的配置种类 |
| 弹窗嵌套 | 已消除:标签排序从"二级弹窗"改为"设置中心内嵌分区" |
| 底部提示 | `修改即时保存 · 仅保存在当前浏览器` |
---
## 5. 事件与数据流
```
UpperTable ──(openColumnConfig)──▶ SettingsDialog(initialSection='field')
▲ │
└──── @columns-changed ◀───────────────┘
(DataSection 导入 / 恢复默认 / 故障修复 后需要重建列配置)
DataSection ──▶ TBYC_CONFIG_SECTIONS(fieldColumns / tabOrder / display / experimental / printer / shortcuts / orderExportColumns)
```
- Navbar 入口没有 `#field-section`,`DataSection` 的 `columns-changed` 无人监听:配置仍已写入 localStorage,表格下次挂载时自然生效
---
## 6. 与统一配置文件的关系
- 设置中心的分区 = `tbyc-config.json` 的 sections(可编辑项与可导出项保持一致)
- `printer`(设备与打印)目前**仅参与导出/导入**,UI 后续补齐
- `orderExportColumns`(订单导出字段):数据形如 `{ [scopeKey]: { waybill: string[], item: string[] } }`;导入时按 `ORDER_INDEX_EXPORT_SCOPES` 白名单过滤 scopeKey、按模式字段白名单过滤字段
- 新增设置项:`registry.ts` 加一条 + `sections/` 新建组件(如需导出,再在 `tbyc-config-sections.ts` 加分区)
---
## 7. 已删除
| 文件 | 替代 |
|---|---|
| `components/UpperTable/MoreSettingsDialog.vue` | 「界面显示」「基础设置」分区 |
| `components/TabOrderSettingsDialog.vue` | 「标签排序」分区(`TabOrderPanel`) |
| `sections/PerformanceSection.vue` + `sections/CacheSection.vue` | 合并为 `sections/BasicSettingsSection.vue`(「基础设置」) |
---
## 9. 后续计划(未实现)
统一「列表字段」入口:像列表页「字段设置」一样,设置中心里点「列表字段」直接打开**目标表格**的字段表单(先选表 / 带入当前表),
届时删除「所有表格字段」这个独立分区(`AllTablesSection.vue`),避免两套列表字段编辑 UI。
当前保留两者共存,待改造完成后再移除。
---
## 8. 验证清单
1. 列表页「字段设置」→ 停在「列表字段」,列显隐/排序/固定/恢复默认均正常
2. Navbar「设置」→ 无「列表字段」,默认停在「所有表格字段」
3. 「所有表格字段」:搜索、仅看已自定义、修改后当前页面表格即时刷新、恢复默认生效
4. 基础设置:表格工作模式 / 页面缓存 / 标签缓存即时生效,单「恢复默认」一次性回滚三项
5. 界面显示:布局模式/固定头部/侧栏 Logo/Scan-box/工具栏/快捷键区域 即时生效,刷新后保持
6. 设备与打印:连接状态、主开关、逐组件开关、全部重连
7. 快捷入口:列表与侧边栏星标一致,移除/清空生效
8. 标签排序:只列多标签页面;默认标签展示与保存正常;保存后当前页即时生效
9. 导出 → 重置 → 导入:字段、标签、显示、缓存、快捷键全部恢复
10. 故障修复:二次确认后清除并给出恢复项摘要
11. 诊断信息:账号/角色/仓库、配置版本、占用体积、存储 key 正确

View File

@ -0,0 +1,485 @@
# 页面模板抽离 · 细化实施方案
> 配套文档:`docs/页面模板抽离-现状分析.md`
> 目标:把当前"寄生在 `views/order/orderManagement/` 里的公共模板资产"搬到公共层,使 `views/mode/` 新结构页面可以独立复用,并让后续"旧页面 → 新结构"替换不再需要改 import。
> 本方案分 7 个阶段,**每个阶段可独立编译、独立提交、独立回滚**。
---
## 0. 总体原则
| 原则 | 说明 |
|---|---|
| **先样式、后组件、再配置** | 样式与组件改动是纯路径替换,风险最低;配置拆分涉及语义判断,放后面 |
| **不可行才用兼容层** | SCSS 的 `@use` 没有转发能力 → 样式必须一次性全量替换;TS 可以用 `export type {...} from` 做 shim → 配置可分步迁移 |
| **类名不急着改** | `.order-sub-container` 被 53 个模板硬编码,改名会把 diff 放大到模板层。改为"新增别名、不动旧名" |
| **不引入新依赖** | 不新增打包插件,全部用现有 `@` 别名 |
| **每阶段结束必须 `npm run build` 通过** | 项目是 `vue-tsc` 类型检查 + Vite 构建,路径错误会被构建拦住 |
---
## 1. 最终目标结构
```
src/
├── styles/
│ ├── list-page.scss ← 新增:列表页骨架布局(原 .order-sub-container)
│ └── status-text.scss ← 新增:状态文本(原 .ut-status-text*)
├── components/
│ └── ToolbarButtonGroup/ ← 新增:通用工具栏按钮组
│ ├── index.vue ← 原 OrderToolbarButtonGroup.vue
│ └── types.ts ← ToolbarButtonConfig / ToolbarApiActionConfig
├── utils/
│ ├── statusText.ts ← getStatusTextClass(含 class 映射缓存)
│ ├── scanFields.ts ← scanBasicField / scanWorkflowField
│ └── storeScanOptions.ts ← 货主 / 快递公司选项解析与注入
└── views/order/
├── config/
│ └── order-business-config.ts ← 订单专属字典(原 order-common-config 剩余部分)
├── shared/
│ ├── orderListExport.ts ← 原 utils/order-index-helpers.ts
│ └── createOrderSession/ ← 原 composables/useCreateOrderSession + FloatWidget + Dialog
└── orderManagement/ ← 只保留订单管理页面自身
```
> 命名遵循现有约定:`src/styles` 用 kebab-case,`src/utils` 用 camelCase,`src/components` 用 PascalCase。
---
## 2. 分阶段实施步骤
### 阶段依赖关系
```mermaid
graph LR
P1["P1 样式抽离<br/>108 处 @use"] --> P4
P2["P2 工具栏组件 + 类型"] --> P3
P2 --> P4
P3["P3 通用工具函数"] --> P6
P4["P4 mode 模板自洽"] --> P7
P5["P5 次级资产归位"] --> P6
P6["P6 清理 shim / 业务配置归位"] --> P7["P7 副本组件合并(可选)"]
```
---
## P1 · 样式抽离(先做,风险最低)
### P1.1 拆分并新建文件
| 新文件 | 内容来源 | 行范围 |
|---|---|---|
| `src/styles/list-page.scss` | 原 `order-sub.scss` 第 1–238 行 | `.order-sub-container { ... }` 整块 |
| `src/styles/status-text.scss` | 原 `order-sub.scss` 第 239–249 行 | `.ut-status-text` + 5 个修饰类 |
`list-page.scss` 建议直接改选择器为双名(**保留旧名 + 新增新名**,避免改 53 个模板):
```scss
.order-sub-container,
.list-page-container {
/* 原内容原样保留,含所有 :deep() 嵌套 */
}
```
> ⚠️ 选择器列表里含 `:deep()` 需要编译验证一次(见 P1.4 验收)。若不通过,退化为只保留 `.order-sub-container`,新类名留到"页面替换阶段"再加。
### P1.2 替换 `@use`(共 108 处,必须一次性完成)
| 场景 | 文件数 | 原写法 | 新写法 |
|---|---|---|---|
| 外部,需要布局 + 状态 | 39 | `@use "../../order/orderManagement/styles/order-sub.scss";` | 两条 `@use`(见下) |
| 外部,只用布局 | 14 | 同上 | `@use "@/styles/list-page.scss";` |
| 外部,只用状态 | 48 | 同上 | `@use "@/styles/status-text.scss";` |
| orderManagement 内部 | 9 | `@use "./styles/order-sub.scss";` / `"../styles/order-sub.scss"` | 按需同上 |
需要两个文件时的写法(`@use` 必须相邻且位于 `<style>` 最前):
```scss
@use "@/styles/list-page.scss";
@use "@/styles/status-text.scss";
```
**判定规则(不要只看字面类名)**:
- 需要 `list-page.scss` ⟺ 模板里出现 `class="...order-sub-container..."`(或用 `:class` 拼出该名)
- 需要 `status-text.scss` ⟺ 模板/代码里出现 `ut-status-text` **或** `getStatusTextClass(`(该函数运行时才拼出 `ut-status-text`,纯 grep 类名会漏)
> 统计口径修正:存在 `:class="getStatusTextClass(...)"` 的页面,即使没有字面量 `ut-status-text` 也必须引 `status-text.scss`。
### P1.3 保留原文件(可选,建议 1 个版本周期)
把 `views/order/orderManagement/styles/order-sub.scss` 内容改为:
```scss
@forward "@/styles/list-page.scss";
@forward "@/styles/status-text.scss";
```
> `@forward` 只是兜底,正常不应再有引用方;若 1 个版本后 grep 无命中即可删除。
### P1.4 验收
- [x] `npm run build` 通过(SCSS 编译 + 类型检查)
- [x] `grep -r "orderManagement/styles/order-sub" src/` 仅剩 `@forward` 兜底文件
- [ ] 抽查 3 类页面视觉无差异:① 带左侧 ScanBox 的列表页(如 `stock/stock`)② 仅状态文本的(如 `storage/stockcheck/config/components/LogPanel.vue`)③ 新结构页(`mode`、`system/setting/role`)
### P1.5 回滚
单次提交,`git revert` 即可;不涉及逻辑。
### P1.6 执行记录(2026-11-06 已完成)
| 项 | 结果 |
|---|---|
| 新增 `src/styles/list-page.scss` | `.order-sub-container, .list-page-container` 双选择器(含全部 `:deep()` 嵌套),编译验证通过 |
| 新增 `src/styles/status-text.scss` | `.ut-status-text` + 5 个颜色修饰类 |
| `@use` 替换 | 108 个文件 → 155 条 `@use`(`list-page` 61 个文件 / `status-text` 94 个文件 / 两者都引 47 个文件) |
| 旧文件处理 | `views/order/orderManagement/styles/order-sub.scss` 改为 12 行 `@forward` 兜底 |
| 注释同步 | 40 处提及 `order-sub.scss` 的注释已更新为新路径 |
| 产物校验 | `dist/**/*.css` 同时包含 `.order-sub-container`、`.list-page-container`、`.ut-status-text--success` |
| 残留检查 | `grep "order-sub.scss" src/` = 0 |
---
## P2 · 工具栏组件 + 类型抽离
### P2.1 新建类型文件
`src/components/ToolbarButtonGroup/types.ts`:
| 从 `order-common-config.ts` 迁出 | 行范围 |
|---|---|
| `ToolbarButtonConfig`(interface) | 296–317 |
| `ToolbarApiActionConfig`(interface) | 318–327 |
> `PendingBatchAsyncTaskType/Config`(328–345)是订单批量任务专属,**不要迁**。
### P2.2 新建组件
| 操作 | 说明 |
|---|---|
| `OrderToolbarButtonGroup.vue` → `src/components/ToolbarButtonGroup/index.vue` | 内容整体搬运 |
| 改第 101 行 | `import type { ToolbarButtonConfig } from '../config/order-common-config'` → `from './types'` |
| 检查模板/样式中是否有 `order-` 前缀的私有类名 | 有则保留(属组件内部样式,不影响外部) |
### P2.3 `order-common-config.ts` 加类型转发(保证 78 处 import 不破)
```ts
export type { ToolbarButtonConfig, ToolbarApiActionConfig } from '@/components/ToolbarButtonGroup/types'
```
同时文件内部使用这两个类型的地方,改为从新位置 `import type`。
### P2.4 替换组件 import(58 处)
| 原路径 | 新路径 |
|---|---|
| `@/views/order/orderManagement/component/OrderToolbarButtonGroup.vue` | `@/components/ToolbarButtonGroup/index.vue` |
> 另有 **32 个文件**仅在注释里提到 `OrderToolbarButtonGroup`(如 `ConfirmWavePrintDialog.vue`、`role/config/template-config.ts` 等),**不要动**;它们不是引用。
### P2.5 验收
- [x] `npm run build` 通过
- [x] `grep -r "component/OrderToolbarButtonGroup.vue" src/` = 0
- [ ] 抽查工具栏按钮组正常:展开/收起、下拉按钮、tile 模式、禁用/loading 态
- [x] **类型环已断**:`order-common-config.ts` 不再定义 `ToolbarButtonConfig`,改为转发公共层类型
### P2.6 执行记录(2026-11-06 已完成)
| 项 | 结果 |
|---|---|
| 新增 `src/components/ToolbarButtonGroup/types.ts` | `ToolbarButtonConfig` / `ToolbarApiActionConfig`(含注释) |
| 新增 `src/components/ToolbarButtonGroup/index.vue` | 原组件 414 行整体搬运,类型 import 改为 `./types` |
| `order-common-config.ts` | 删除 2 个 interface(32 行),改为 `import type` + `export type` 转发 |
| 组件 import 替换 | **66 处**(58 处 `@/views/...` + 8 处 `./component/...`) |
| 类型 import | 78 处仍走 `order-common-config` 转发(与业务符号混在同一 import 语句,留到 P3/P6 处理) |
| 遗留死代码 | `views/order/orderManagement/component/OrderToolbarButtonGroup.vue` → P6 删除 |
| 构建 | `npm run build` 通过(1m22s) |
---
## P3 · 通用工具函数抽离(配置瘦身第一刀)
### P3.1 迁移映射表(精确到符号)
| 新文件 | 迁出符号 | 原行号 | 依赖 |
|---|---|---|---|
| `src/utils/statusText.ts` | `STATUS_TEXT_CLASS_MAP`(762–770)、`STATUS_TEXT_CLASS_CACHE`(771)、`getStatusTextClass`(773–781) | 762–781 | 无(纯字符串映射) |
| `src/utils/storeScanOptions.ts` | `resolveStoreOptionLabel`(1641)、`mapStoreListToSelectOptions`(1657)、`extractStoreListFromResponse`(1673)、`fillStoreScanFieldOptions`(1677) | 1641–1681 | 无 |
| `src/utils/storeScanOptions.ts` | `mapExpressListToCompanySelectOptions`(1616)、`fillExpressCompanyScanFieldOptions`(1635) | 1616–1640 | 无(建议同文件,二者共用"选项注入"语义) |
| `src/utils/scanFields.ts` | `scanBasicField`(1254)、`scanWorkflowField`(1259) | 1254–1263 | 无 |
> 迁移后原文件用 re-export shim 保持 129 个引用方不变:
> ```ts
> export { getStatusTextClass } from '@/utils/statusText'
> export { extractStoreListFromResponse, mapStoreListToSelectOptions, fillStoreScanFieldOptions, fillExpressCompanyScanFieldOptions } from '@/utils/storeScanOptions'
> export { scanBasicField, scanWorkflowField } from '@/utils/scanFields'
> ```
### P3.2 明确**留在** `order-common-config.ts` 的内容
| 符号 | 原因 |
|---|---|
| `getTagType` | 依赖 `COMMON_TAG_TYPES` 订单状态字典与 3 个 normalizer,业务属性强 |
| `translateOrderField` / `translateInterceptStatus` / `getInterceptStatusTagType` | 订单字段语义 |
| `COMMON_TRANSLATIONS` / `COMMON_TAG_TYPES` | 订单状态字典(如后续确认可通用,再单独评估迁出) |
| `ORDER_PAGE_CONFIG` / `ORDER_TAB_LIST` / `ORDER_TOOLBAR_BUTTONS` / `pickToolbarButtons` | 订单专属 |
| `ORDER_EXPORT_ALL_COLUMNS` 及导出列工具 | 订单专属 |
| `orderDetailFullSections` / `orderItem*Columns` | 订单专属 |
| 全部 `*ScanField` / `*FilterOptions` / `*AvailableFields` / `*Columns` / `*Detail` / `*buttonList` / `*toolbarButtons` | 订单专属 |
### P3.3 迁移引用(可选分批)
- 第一批(改动小、语义清晰):`statusText` 相关 **84 处** → `@/utils/statusText`
- 第二批:`storeScanOptions` 相关 **26 处**(12+7+7) → `@/utils/storeScanOptions`
- 第三批:`scanFields` 相关 **3 处** → `@/utils/scanFields`
> 也可完全不迁移(靠 shim 长期存活),但**不推荐**——新页面模板不应再从订单模块取通用工具。
### P3.4 验收
- [x] `npm run build` 通过
- [x] `views/mode/`、`views/system/setting/role/` 等新结构页面的 import 全部指向公共层(仅剩 7 条“对齐 xxx 体验”的注释提及)
- [x] `order-common-config.ts` 行数 2696 → **2585**(累计减去 P2 的 32 行 + P3 的 84 行)
- [ ] 抽查状态文本颜色正确(`success` 绿 / `warning` 橙 / `danger` 红)
### P3.6 执行记录(2026-11-06 已完成)
| 项 | 结果 |
|---|---|
| 新增 `src/utils/statusText.ts` | `getStatusTextClass` + 映射表/缓存 |
| 新增 `src/utils/storeScanOptions.ts` | 快递公司、货主选项解析与注入(6 个函数) |
| 新增 `src/utils/scanFields.ts` | `SCAN_BASIC_INFO_GROUP` / `scanBasicField` / `scanWorkflowField` |
| `order-common-config.ts` | 删除 3 段实现(共 ~124 行),改为 `import` + `export ... from` 转发 |
| 新结构页面迁移 | **36 处** import(26 处 `getStatusTextClass` + 10 处 `ToolbarButtonConfig`) |
| 里程碑 | 10 个新结构页面已**无 orderManagement 代码依赖**(仅余 7 条历史视觉对齐注释) |
| 存量 | 117 个文件仍引用 `order-common-config`(70 个用 `getStatusTextClass`),均属旧结构页面,随页面替换自然消失;P6 统一收口 |
| 构建 | `npm run build` 通过(1m34s) |
---
## P4 · `mode` 模板自洽(关键里程碑)
> 目的:让 `views/mode/` 及 10 个新结构页面**完全不依赖** `orderManagement` 目录,成为可独立复制的模板。
### P4.1 改动点(4 个文件 + 3 个 config/panel)
| 文件 | 改动 |
|---|---|
| `views/mode/index.vue` | ① `@use "../order/orderManagement/styles/order-sub.scss"` → 两条新 `@use`(或 `@use "@/styles/list-page.scss"` 单条,视是否用状态文本)② `OrderToolbarButtonGroup` → `@/components/ToolbarButtonGroup/index.vue` ③ `ToolbarButtonConfig` → `@/components/ToolbarButtonGroup/types` |
| `views/mode/components/ColumnCellRenderer.vue` | `@use` → `@/styles/status-text.scss`;`getStatusTextClass` → `@/utils/statusText` |
| `views/mode/config/components/DetailPanel.vue` | 同上 |
| `views/mode/config/components/LogPanel.vue` | 同上 |
### P4.2 同步处理其余 9 个新结构页面
`afterSale/typelist`、`data/ordersummary`、`express/waybill`、`storage/generalreport`、`storage/stockcheck`、`system/setting/{basicManagement/newview, printcomputer, role, workbench2}`
> 每个页面固定 3 类文件:`index.vue` + `components/ColumnCellRenderer.vue` + `config/components/{DetailPanel,LogPanel}.vue`,改法与 `mode` 完全一致。
### P4.3 验收
- [ ] `grep -r "orderManagement" src/views/mode/` = 0
- [ ] 10 个新结构页面 `grep -r "orderManagement"` 仅剩"业务数据配置"引用(如 `ORDER_TAB_LIST` 等,属 P6 处理范围)
- [ ] 模板复制演练:新建 `views/mode-copy/` 复制 `mode` 全部文件 → 不改任何 import 即可编译通过(验证后可删除)
---
## P5 · 次级资产归位(订单域内部整理)
> 这批资产**只在订单域内被复用**,不需要进 `src/utils`,只需离开 `orderManagement` 目录。
| 原路径 | 新路径 | 外部使用方 |
|---|---|---|
| `orderManagement/utils/order-index-helpers.ts` | `views/order/shared/orderListExport.ts` | 6(`waveOrder`×2、`orderreview`、`orderWeighing`×2、`returnUnpackwork`) |
| `orderManagement/utils/stock-picker-helpers.ts` | `views/stock/utils/stockPickerHelpers.ts` | 5(`combo_stock`×2、`returnUnpack`、`returnUnpackwork`、`storage/receiving`) |
| `orderManagement/utils/toolbar-actions.ts` | `views/order/shared/toolbarActions.ts` | 1(`waveOrder/PendingOrderListPanel`) |
| `orderManagement/form/ManualWaybillForm.vue` | `views/order/shared/form/ManualWaybillForm.vue` | 2 |
| `orderManagement/form/SyncOrderIdsForm.vue` | `views/order/shared/form/SyncOrderIdsForm.vue` | 2(含 `views/test`) |
| `orderManagement/form/StorageAllocateForm.vue` | `views/order/shared/form/StorageAllocateForm.vue` | 2 |
| `orderManagement/form/BatchAsyncTaskForm.vue` | `views/order/shared/form/BatchAsyncTaskForm.vue` | 1 |
| `orderManagement/form/AllocateExpressForm.vue` | `views/order/shared/form/AllocateExpressForm.vue` | 1 |
| `orderManagement/component/OrderExportProgressDialog.vue` | `views/order/shared/component/OrderExportProgressDialog.vue` | 1(`views/test`) |
### P5.1 布局层解耦
| 原路径 | 新路径 |
|---|---|
| `orderManagement/composables/useCreateOrderSession.ts` | `views/order/shared/createOrderSession/useCreateOrderSession.ts` |
| `orderManagement/component/CreateOrderFloatWidget.vue` | `views/order/shared/createOrderSession/CreateOrderFloatWidget.vue` |
| `orderManagement/component/CreatePendingOrderDialog.vue` | `views/order/shared/createOrderSession/CreatePendingOrderDialog.vue` |
→ `layout/component/CreateOrderSessionHost.vue` 的 3 处 import 改为新路径。
> 这是唯一的**布局层**依赖,改动后 `layout/` 不再指向任何具体页面目录。
### P5.2 验收
- [x] `npm run build` 通过
- [ ] 全局建单悬浮窗仍可正常拉起(登录 → 任意页面 → 新建订单 → 关闭)
- [x] `grep -r "orderManagement/utils\|orderManagement/form\|orderManagement/composables" src/` = **0**
### P5.3 执行记录(2026-11-06 已完成)
> 搬迁方式:用 `git mv` 做纯路径移动(保留 git 历史),内部 import 与引用方改用编辑工具修正。涉及文件合计 ≈7000 行(含 `CreatePendingOrderDialog.vue` 2905 行),不做逐行复制。
**实际搬迁 15 个文件(比原计划多 3 个,均为内聚依赖)**
| 原路径 | 新路径 |
|---|---|
| `orderManagement/utils/order-index-helpers.ts` | `views/order/shared/orderListExport.ts` |
| `orderManagement/utils/order-meta-cache.ts` | `views/order/shared/orderMetaCache.ts` ←新增(CreatePendingOrderDialog 依赖) |
| `orderManagement/utils/toolbar-actions.ts` | `views/order/shared/toolbarActions.ts` |
| `orderManagement/utils/stock-picker-helpers.ts` | `views/stock/utils/stockPickerHelpers.ts` |
| `orderManagement/composables/useCreateOrderSession.ts` | `views/order/shared/createOrderSession/useCreateOrderSession.ts` |
| `orderManagement/component/CreateOrderFloatWidget.vue` | `views/order/shared/createOrderSession/CreateOrderFloatWidget.vue` |
| `orderManagement/component/CreatePendingOrderDialog.vue` | `views/order/shared/createOrderSession/CreatePendingOrderDialog.vue` |
| `orderManagement/component/OrderExportProgressDialog.vue` | `views/order/shared/component/OrderExportProgressDialog.vue` |
| `orderManagement/component/SelectProductDialog.vue` | `views/order/shared/component/SelectProductDialog.vue` ←新增 |
| `orderManagement/form/ManualWaybillForm.vue` | `views/order/shared/form/ManualWaybillForm.vue` |
| `orderManagement/form/SyncOrderIdsForm.vue` | `views/order/shared/form/SyncOrderIdsForm.vue` |
| `orderManagement/form/StorageAllocateForm.vue` | `views/order/shared/form/StorageAllocateForm.vue` |
| `orderManagement/form/BatchAsyncTaskForm.vue` | `views/order/shared/form/BatchAsyncTaskForm.vue` |
| `orderManagement/form/AllocateExpressForm.vue` | `views/order/shared/form/AllocateExpressForm.vue` |
| `orderManagement/form/UpdateAddressForm.vue` | `views/order/shared/form/UpdateAddressForm.vue` ←新增(toolbar-actions 依赖其类型) |
**引用改写**:约 90 处(`orderListExport` 25 / `stockPickerHelpers` 7 / `toolbarActions` 9 / `orderMetaCache` 9 / `useCreateOrderSession` 6 / 表单组件 19 / 导出弹窗 9 / 建单会话 3 / 其余 3)
**结果**:`orderManagement` 目录文件数 55 → **40**,且 `utils/` `form/` `composables/` 已无外部引用。
**布局层**:`layout/component/CreateOrderSessionHost.vue` 的 3 处 import 已全部指向 `views/order/shared/createOrderSession/`,`layout/` 不再指向任何具体页面目录。
---
## P6 · 清理 shim / 业务配置归位
| 步骤 | 动作 |
|---|---|
| 6.1 | 全量检查残留:`grep -r "orderManagement/config/order-common-config" src/` |
| 6.2 | 订单域内引用(约 20 处内部 + `waveOrder`/`orderreview`/`orderWeighing` 等)改为 `@/views/order/config/order-business-config` |
| 6.3 | 文件改名:`orderManagement/config/order-common-config.ts` → `views/order/config/order-business-config.ts` |
| 6.4 | 删除 P2/P3 加的 re-export shim |
| 6.5 | 删除 `orderManagement/styles/order-sub.scss` 兜底文件(P1.3) |
| 6.6 | 删除死代码 `orderManagement/component/OrderToolbarButtonGroup.vue`(P2 已迁移) |
**验收**:
- [ ] `grep -r "order-common-config" src/` = 0
- [ ] `npm run build` 通过
- [ ] `views/order/orderManagement/` 目录内只剩订单页面自身(预期文件数从 55 降至 ≈ 30)
---
## P7 · 副本组件合并(可选,建议与"页面替换"合并做)
现状:
| 副本 | 数量 | 完全一致的组数 |
|---|---|---|
| `ColumnCellRenderer.vue` | 13 | 2 对(printcomputer ↔ workbench2) |
| `DetailPanel.vue` | 11 | 1 对(printcomputer ↔ workbench2) |
| `LogPanel.vue` | 11 | 3 组(printcomputer ↔ workbench2、afterSale/typelist ↔ storage/generalreport、express/waybill ↔ video/newcamara ↔ video/newcamaraserver) |
建议做法:
1. 先以 `views/mode/components/` 为基线,抽出 `src/components/ListPageParts/{ColumnCellRenderer,DetailPanel,LogPanel}.vue`(props 化列配置/字段配置)。
2. 逐页面替换并删除副本——**每个页面替换时同步完成**,不单独排期。
3. 完全一致的 3 组优先合并(改 6 个文件,零风险)。
---
## 3. 批量替换规则表
> 供 IDE 全局替换或脚本批量执行使用。**建议按顺序执行,每批后立即 build**。
| # | 查找(精确) | 替换为 | 作用域 | 次数 |
|---|---|---|---|---|
| 1 | `@/views/order/orderManagement/component/OrderToolbarButtonGroup.vue` | `@/components/ToolbarButtonGroup/index.vue` | `src/` | 58 |
| 2 | `../config/order-common-config` **仅** `import type { ToolbarButtonConfig` 行 | `@/components/ToolbarButtonGroup/types` | `orderManagement/` 等 | 1 |
| 3 | `@/views/order/orderManagement/config/order-common-config`(限 `getStatusTextClass` 所在 import 语句) | `@/utils/statusText` | `src/views` | 84 |
| 4 | `@/views/order/orderManagement/config/order-common-config`(限货主/快递选项符号) | `@/utils/storeScanOptions` | `src/views` | 26 |
| 5 | `@/views/order/orderManagement/config/order-common-config`(限 `scanBasicField` / `scanWorkflowField`) | `@/utils/scanFields` | `src/views` | 3 |
| 6 | `orderManagement/styles/order-sub.scss`(`@use` 行) | 按 §P1.2 三分类 | `src/` | 108 |
| 7 | `@/views/order/orderManagement/utils/order-index-helpers` | `@/views/order/shared/orderListExport` | `src/views` | 6 |
| 8 | `@/views/order/orderManagement/utils/stock-picker-helpers` | `@/views/stock/utils/stockPickerHelpers` | `src/views` | 5 |
| 9 | `@/views/order/orderManagement/utils/toolbar-actions` | `@/views/order/shared/toolbarActions` | `src/views` | 1 |
| 10 | `@/views/order/orderManagement/form/` | `@/views/order/shared/form/` | `src/views` | 8 |
| 11 | `@/views/order/orderManagement/component/OrderExportProgressDialog.vue` | `@/views/order/shared/component/OrderExportProgressDialog.vue` | `src/views` | 1 |
| 12 | `orderManagement/composables/useCreateOrderSession` | `@/views/order/shared/createOrderSession/useCreateOrderSession` | `layout/` + 内部 | 2 |
| 13 | `orderManagement/component/CreateOrderFloatWidget.vue` / `CreatePendingOrderDialog.vue` | `@/views/order/shared/createOrderSession/...` | `layout/` + 内部 | 4 |
| 14 | `orderManagement/config/order-common-config` | `@/views/order/config/order-business-config` | 剩余 | ≈ 24 |
> 规则 2–5 属于"同一路径、不同符号",**不能盲目全文替换**,必须按 import 语句中的符号名匹配。
---
## 4. 校验清单(每阶段通用)
```text
必过项
□ npm run build 成功(vue-tsc + vite)
□ 目标路径 grep 结果为 0(见各阶段验收)
□ 根目录无新增 untracked 的临时脚本/备份文件
抽查项(按阶段选择)
□ 页面视觉:布局、状态文本颜色、工具栏按钮组交互
□ 新结构页(mode / role / stockcheck)功能:筛选、分页、明细面板、日志面板
□ 布局层:全局建单悬浮窗
□ 移动端/低分辨率:无横向滚动异常(列表页骨架改动易影响)
```
---
## 5. 风险与对策
| 风险 | 触发阶段 | 表现 | 对策 |
|---|---|---|---|
| `:deep()` 在双选择器下编译异常 | P1 | 布局错乱 | 退化为仅保留 `.order-sub-container`;新类名延后 |
| `@use` 位置错误 | P1 | Sass 报 `@use rules must be written before any other rules` | 两条 `@use` 必须置于 `<style>` 最前且相邻 |
| 漏引 `status-text.scss` | P1 | 状态文字变黑/无色(因为类名是运行时拼的) | 用 `getStatusTextClass(` 作为判定条件,而非仅 grep 类名 |
| 误改注释中的组件名 | P2 | 无运行时影响,但污染 diff | 只替换 `import ... from '...OrderToolbarButtonGroup.vue'` 形式 |
| ESLint 规则收紧 | P2/P3/P5 | 新公共目录文件触发 `no-explicit-any` 等告警/错误 | 二选一:① 在 `eslint.config.js` 为新目录补同样的例外块 ② 迁移前先清理该文件告警 |
| 类型环未断 | P2 | `combo_stock` 与订单模块互相依赖 | P2.1 必须先完成类型迁出 |
| 配置误迁业务字典 | P3 | 公共层出现订单字段(后续难维护) | 严格按 §P3.2 "留在原文件"清单执行 |
| 一次改太多难回滚 | 全局 | 出问题定位困难 | 每阶段独立提交;P1 与 P2 之间至少间隔一次完整构建验证 |
---
## 6. 工作量估算
| 阶段 | 涉及文件 | 需改写语句 | 风险 | 建议提交粒度 |
|---|---|---|---|---|
| P1 样式 | 108(外 99 + 内 9)+ 3 新建 | 108 处 `@use` | 低 | 1 次提交 |
| P2 组件 + 类型 | 58 + 2 新建 | 58 处 `import` | 低 | 1 次提交 |
| P3 通用工具 | ≈ 113 | ≈ 113 处 `import` | 中 | 可分 3 次(按符号) |
| P4 mode 自洽 | 10 页面 × 3–4 文件(与 P1–P3 重叠) | 同上已覆盖 | 低 | 1 次提交(验证里程碑) |
| P5 次级资产 | 9 | 13 处 `import` | 中 | 1–2 次提交 |
| P6 清理/改名 | ≈ 24 | 24 处 `import` | 中 | 1 次提交 |
| P7 副本合并 | 35(可选) | — | 中高 | 随页面替换逐步 |
| **合计(P1–P6)** | **≈ 180 个文件** | **≈ 316 处语句** | — | **约 7–9 次提交** |
---
## 7. 建议的提交信息(供参考,提交由你手动执行)
```
refactor(styles): 抽离列表页骨架与状态文本样式到 src/styles
refactor(component): 抽离 OrderToolbarButtonGroup 到 src/components/ToolbarButtonGroup
refactor(config): 抽离通用状态文本/筛选字段/货主选项工具到 src/utils
refactor(mode): 新结构模板完全脱离 orderManagement 依赖
refactor(order): 次级资产归位到 views/order/shared 与 views/stock/utils
refactor(order): order-common-config 更名为 order-business-config 并清理兼容层
```
---
## 8. 待确认决策点
| # | 决策 | 选项 | 推荐 |
|---|---|---|---|
| 1 | 样式类名是否立刻改名 | A. 保持 `.order-sub-container`;B. 双名并存;C. 全量改名 | **B**(新页面用 `.list-page-container`,旧模板零改动) |
| 2 | 配置是否加 re-export shim | A. 不加,一次性改完;B. 加 shim 分步迁移 | **B** |
| 3 | `COMMON_TRANSLATIONS` / `COMMON_TAG_TYPES` 归属 | A. 留在订单业务配置;B. 抽成通用状态字典 | **A**(当前内容全为订单字段,无外部通用需求) |
| 4 | 是否保留 `order-sub.scss` 兜底 `@forward` | A. 保留 1 个版本;B. 不保留 | **A** |
| 5 | ESLint 例外规则 | A. 新目录补例外;B. 清理告警 | **A**(先不阻塞抽离,后续单独清) |

View File

@ -0,0 +1,489 @@
# 页面模板抽离 · 现状分析(order/orderManagement 耦合面)
> 目标:在把旧页面批量替换为 `views/mode/` 新结构之前,先摸清"旧页面引用了哪些 orderManagement 的模板资产",为后续抽离到公共层做准备。
> **本文档只做分析,不含任何代码改动。**
---
## 1. 结论速览
1. **耦合面极大**:`src/views` 下共 **133 个文件**(占 views 下页面/组件相当比例)直接引用 `views/order/orderManagement/` 的 3 个核心资产,涉及 **14 个业务模块**、**50 个页面级 `index.vue`**。
2. **已迁移到新结构的页面同样被绑住**:10 个已使用 `config/template-config.ts`(新结构)的页面,**全部**仍在引用 orderManagement 的样式/组件/配置。也就是说新模板目前不是"独立可用的模板",而是"寄生在旧模块里的模板"。
3. **真正被复用的只有 3 项 + 少量工具**:`order-common-config.ts`(129 文件)、`order-sub.scss`(99 文件)、`OrderToolbarButtonGroup.vue`(58 文件)三者覆盖了几乎全部引用。
4. **配置文件的复用是"假性"的**:2696 行的 `order-common-config.ts` 里,外部实际只用到约 20 个导出符号,其中 5 个(`getStatusTextClass` / `ToolbarButtonConfig` / `extractStoreListFromResponse` / `fillStoreScanFieldOptions` / `mapStoreListToSelectOptions`)占 **188 / 203 处**引用,其余全是订单业务字典(导出列、订单工具栏、订单详情分区、订单筛选字段)。
5. **存在反向依赖**:`orderManagement/utils/stock-picker-helpers.ts` → `stock/combo_stock/combo-stock-config.ts` → `orderManagement/config/order-common-config.ts`(类型环),抽离时需要顺带解掉。
6. **改动量**:仅这 3 个核心资产,需改写 **307 处 `import` / `@use` 语句**。
---
## 2. 被外部引用的资产清单(按复用度排序)
| # | 资产 | 外部引用文件数 | 规模 | 性质 |
|---|---|---|---|---|
| 1 | `config/order-common-config.ts` | **129**(150 处 import) | 2696 行 / 123 KB | 通用 UI 工具 + 订单业务字典 **混杂** |
| 2 | `styles/order-sub.scss` | **99**(@use) | 249 行 / 5.7 KB | 纯布局 + 状态文本样式,**完全通用** |
| 3 | `component/OrderToolbarButtonGroup.vue` | **58**(显式 import) | 通用工具栏按钮组 | 仅依赖 1 个类型,**完全通用** |
| — | (以上三者去重合计) | **133 个 views 文件** | — | — |
### 2.1 次级资产(少量但跨模块)
| 资产 | 外部使用方数量 | 使用方 |
|---|---|---|
| `utils/order-index-helpers.ts` | 6 | `order/waveOrder/{config,PendingOrderListPanel}`、`order/orderreview`、`order/orderWeighing/{index,ExpressWeighingForm}`、`express/returnUnpackwork` |
| `utils/stock-picker-helpers.ts` | 5 | `express/returnUnpack/StockPickerDialog`、`express/returnUnpackwork`、`stock/combo_stock/{ComboGoodsFormDialog,ComboStockPickerDialog}`、`storage/receiving/Product` |
| `form/ManualWaybillForm.vue` | 2 | `order/waveOrder/PendingOrderListPanel`、`stock/stock/StockBatchEditDialog` |
| `form/SyncOrderIdsForm.vue` | 2 | `order/waveOrder/PendingOrderListPanel`、`views/test` |
| `form/StorageAllocateForm.vue` | 2 | `order/waveOrder/PendingOrderListPanel`、`views/test` |
| `form/BatchAsyncTaskForm.vue` | 1 | `views/test` |
| `form/AllocateExpressForm.vue` | 1 | `order/waveOrder/PendingOrderListPanel` |
| `utils/toolbar-actions.ts` | 1 | `order/waveOrder/PendingOrderListPanel` |
| `component/OrderExportProgressDialog.vue` | 1 | `views/test` |
### 2.2 非 views 层的引用(最需要注意)
| 文件 | 引用内容 | 说明 |
|---|---|---|
| `layout/component/CreateOrderSessionHost.vue` | `CreateOrderFloatWidget.vue`、`composables/useCreateOrderSession`、`CreatePendingOrderDialog.vue` | **布局层**依赖订单模块 → 抽离后这里必须跟着改,且属于全局常驻组件 |
| `router/map.ts` | 路由 → `orderManagement/index.vue` | 仅路由,不属于模板耦合 |
| `api/order.index/orderindex.ts`、`styles/tab-area.scss` | 仅注释提及 | 无需处理 |
---
## 3. 影响面分布
### 3.1 按业务模块(views 子目录)
| 模块 | 受影响文件数 |
|---|---|
| `storage` | 30 |
| `system` | 27 |
| `express` | 14 |
| `order` | 12 |
| `stock` | 9 |
| `data` | 9 |
| `video` | 8 |
| `inbox` | 5 |
| `afterSale` | 5 |
| `material` | 4 |
| `mode` | 4 |
| `store` | 3 |
| `message` | 2 |
| `warehouses` | 1 |
### 3.2 新旧结构分布(页面级 `index.vue`)
**已有新结构(含 `config/template-config.ts`)但仍依赖 orderManagement —— 10 个**
```
mode ← 模板本身!
afterSale/typelist
data/ordersummary
express/waybill
storage/generalreport
storage/stockcheck
system/setting/basicManagement/newview
system/setting/printcomputer
system/setting/role
system/setting/workbench2
```
**旧结构且依赖 orderManagement —— 40 个**
```
afterSale/list data/packingflow
express/returnReceived express/returnUnpack
express/returnwaybill inbox/autoReply
inbox/group inbox/message
message order/orderreview
order/orderWeighing stock/combo_stock
stock/external_stock stock/pickingShortage
stock/stock storage/entry
storage/entry_owner storage/inventory
storage/log storage/management/replenishmentDemand
storage/productflow storage/productflow/store
storage/receiving storage/receiving_owner
storage/report storage/stockout
store/shipperSigning store/stores
system/setting/account system/setting/expressinterface
system/setting/permission system/setting/pickcart
system/setting/printStation system/setting/shops
system/setting/storeExpressBindingPolicy
video/newcamara video/newcamaraserver
warehouses
```
> 结论:**抽离是"替换旧页面"的前置条件**——否则每替换一个页面,都还要再改一次 import。
---
## 4. `order-common-config.ts` 外部符号使用分布
按 import 语句统计(含多行 import,已解析):
| 符号 | 引用次数 | 归类 |
|---|---|---|
| `getStatusTextClass` | 84 | ✅ 通用(返回 `ut-status-text` class 名) |
| `ToolbarButtonConfig`(type) | 78 | ✅ 通用 |
| `extractStoreListFromResponse` | 12 | ✅ 通用(货主列表解析) |
| `fillStoreScanFieldOptions` | 7 | ✅ 通用(向 ScanBox 字段注入货主选项) |
| `mapStoreListToSelectOptions` | 7 | ✅ 通用 |
| `getTagType` | 2 | ⚠️ 依赖 `COMMON_TAG_TYPES` 业务字典 |
| `scanWorkflowField` | 2 | ✅ 通用工厂 |
| `translateOrderField` | 2 | ❌ 订单业务 |
| `pickToolbarButtons` | 1 | ⚠️ 依赖 `ORDER_TOOLBAR_BUTTONS` 订单字典 |
| `scanBasicField` | 1 | ✅ 通用工厂 |
| `buyerMessageHasFilterOptions` | 1 | ❌ 订单业务 |
| `pickStatusFilterOptions` | 1 | ❌ 订单业务 |
| `recheckStatusFilterOptions` | 1 | ❌ 订单业务 |
| `stockQueryScanField` | 1 | ❌ 订单业务 |
| `translateInterceptStatus` | 1 | ❌ 订单业务 |
| `getInterceptStatusTagType` | 1 | ❌ 订单业务 |
| `pendingAvailableFields` | 1 | ❌ 订单业务 |
| `buildPendingStyleColumns` | 1 | ❌ 订单业务 |
| `fillExpressCompanyScanFieldOptions` | 1 | ✅ 通用(快递公司选项注入) |
**关键判断**:前 5 个符号覆盖 188 处引用,且**全部是"列表页通用 UI 工具"**,与订单业务无关。`order-common-config.ts` 之所以成为"万能垃圾桶",是因为这些工具没有独立归属。
### 4.1 文件内部分层(按行号)
| 行范围 | 内容 | 归属建议 |
|---|---|---|
| 1–10 | `ORDER_PAGE_CONFIG` | 订单业务(留在原地) |
| 11–295 | `COMMON_TRANSLATIONS` / `COMMON_TAG_TYPES` | ⚠️ 半通用(状态字典),可独立成 `status-dictionary.ts` |
| 296–345 | `ToolbarButtonConfig` / `ToolbarApiActionConfig` | ✅ 通用 → 按钮组组件同目录 `types.ts` |
| 346–462 | 订单导出列 `ORDER_EXPORT_ALL_COLUMNS` 等 | 订单业务 |
| 463–609 | `ORDER_TOOLBAR_BUTTONS` / `pickToolbarButtons` | 订单业务(`pickToolbarButtons` 可转为通用工具函数) |
| 610–772 | 各类订单工具栏 API 动作 | 订单业务 |
| 773–870 | `getStatusTextClass` / `getTagType` / `translateOrderField` | `getStatusTextClass` 通用,其余业务 |
| 868–1232 | 订单详情分区 / 明细列配置 | 订单业务 |
| 1233–1427 | 各类筛选项常量 | 混合(部分通用) |
| 1428–1620 | ScanBox 字段工厂 `scanBasicField` / `scanWorkflowField` + 大量 `*ScanField` | 工厂通用,字段业务 |
| 1616–1680 | 货主 / 快递公司选项映射工具 | ✅ 通用 |
---
## 5. `order-sub.scss` 使用细分
99 个引用文件中:
| 用途 | 文件数 | 说明 |
|---|---|---|
| 使用 `.order-sub-container` 布局(左 ScanBox + 右表格/分栏) | 53 | 需要完整文件 |
| 仅使用 `.ut-status-text--*` 状态文本类 | 46 | 只需 6 行状态样式,却引入了整个容器布局 |
> `.ut-status-text` / `.ut-status-text--primary|success|warning|info|danger` 是唯一被"非布局页面"用到的部分,与 `getStatusTextClass` 强绑定,应作为一个整体抽成 `status-text.scss`。
文件本身内容极简(249 行,只有 2 个顶层选择器族):
- `.order-sub-container`(含 `:deep()` 对 `ScanBox` 内部的改写)
- `.ut-status-text` + 5 个修饰类
---
## 6. 依赖关系图
```mermaid
graph LR
subgraph 公共层["理想公共层(尚不存在)"]
S["样式: order-sub.scss"]
T["组件: OrderToolbarButtonGroup"]
C["配置: order-common-config.ts"]
end
subgraph 旧模块["views/order/orderManagement"]
S
T
C
U1["utils/order-index-helpers"]
U2["utils/stock-picker-helpers"]
F["form/ManualWaybillForm 等"]
W["component/CreateOrderFloatWidget 等"]
D["组件副本: ColumnCellRenderer / DetailPanel / LogPanel"]
end
P1["133 个外部 views 文件"] --> S
P1 --> T
P1 --> C
L["layout/CreateOrderSessionHost"] --> W
U2 -.反向依赖.-> ST["stock/combo_stock/combo-stock-config"]
ST --> C
D --> S
D --> C
```
> 图中"公共层"框内文件当前物理位置仍在 orderManagement 目录下,这是本次要解决的问题。
---
## 7. 风险点与约束
| # | 风险 | 说明 | 应对建议 |
|---|---|---|---|
| 1 | **组件与配置互相绑定** | `OrderToolbarButtonGroup.vue` 第 101 行 `import type { ToolbarButtonConfig } from '../config/order-common-config'`,只移组件不移类型会留下悬空依赖 | 类型随组件一起抽离到 `components/ToolbarButtonGroup/types.ts` |
| 2 | **反向依赖 / 类型环** | `orderManagement/utils/stock-picker-helpers` → `stock/combo_stock/combo-stock-config` → `orderManagement/config`(type-only) | 把 `ToolbarButtonConfig` 移出后,环自动断开 |
| 3 | **ESLint 规则收紧** | `eslint.config.js` 对 `src/views/order/orderManagement/**` 单独关闭了 `no-explicit-any`、`no-unused-vars`、`vue/attributes-order` 等 10+ 条规则;文件移到公共目录后会按全局规则校验,可能一次性冒出大量告警 | 抽离要么同步迁移规则配置(按新目录再放宽),要么先跑 lint 清账 |
| 4 | **命名语义** | `order-sub.scss` / `OrderToolbarButtonGroup` / `order-common-config` 名字都带订单语义,但使用方遍及仓储、系统设置、视频等模块 | 抽离时同步改名(`list-page.scss` / `ToolbarButtonGroup` / `toolbar.ts`),避免"为什么仓储页面引用订单组件"的困惑 |
| 5 | **配置整体搬迁会把业务带进公共层** | `order-common-config.ts` 有 2600+ 行是订单专属字典 | 按第 4.1 节分层拆分,业务字典留在 `views/order/` 下 |
| 6 | **`order-sub.scss` 使用 `:deep()`** | 它要求父级是 `scoped` 样式块,抽取位置变化不影响行为,但要保持文件内容原样 | 直接搬运,不改写嵌套 |
| 7 | **布局层常驻组件** | `layout/component/CreateOrderSessionHost.vue` 依赖订单建单悬浮窗(模块级单例 composable),这是全站常驻逻辑,不能简单当页面模板处理 | 单独作为"订单建单会话"能力评估,不并入本次通用模板抽离 |
| 8 | **副本组件高度分散** | `ColumnCellRenderer.vue` 有 13 份(仅 2 对完全相同)、`DetailPanel.vue` 11 份(1 对相同)、`LogPanel.vue` 11 份(3 组相同),且每份都各自 `@use order-sub.scss` + 引 `getStatusTextClass` | 本次先抽"底层依赖",副本合并建议放到"页面替换"阶段一并处理 |
---
## 8. 建议的抽离方案(分层,供后续决策)
### 8.1 目标目录结构(建议)
```
src/
├── styles/
│ ├── list-page.scss ← 原 order-sub.scss 的 .order-sub-container(改名)
│ └── status-text.scss ← 原 .ut-status-text*(6 行)
├── components/
│ └── ToolbarButtonGroup/
│ ├── index.vue ← 原 OrderToolbarButtonGroup.vue
│ └── types.ts ← ToolbarButtonConfig / ToolbarApiActionConfig
├── utils/
│ ├── store-options.ts ← extractStoreListFromResponse / mapStoreListToSelectOptions / fillStoreScanFieldOptions
│ ├── status-text.ts ← getStatusTextClass(配套 status-text.scss)
│ └── scan-fields.ts ← scanBasicField / scanWorkflowField / fillExpressCompanyScanFieldOptions
└── views/order/
├── config/order-business-config.ts ← 订单专属字典(原 order-common-config 的主体)
└── orderManagement/ ← 只保留订单页面自身
```
> 兼容做法:抽离时在原路径保留 `export * from '...'` 的转发文件(re-export shim),可让 307 处 import 分批迁移、随时可回滚。**但注意**:`@use`(SCSS)没有等价转发能力,样式文件必须一次性全量替换。
### 8.2 建议执行顺序
1. **样式先行(无逻辑风险)**:`order-sub.scss` → `src/styles/`,一次性替换 99 处 `@use`(含内部 12 处)。
- 顺手按 46/53 的分布拆成 `list-page.scss` + `status-text.scss`。
2. **组件 + 类型**:`OrderToolbarButtonGroup.vue` → `src/components/ToolbarButtonGroup/`,`ToolbarButtonConfig` 一并抽出,58 处 import 替换。
3. **通用工具函数**:`getStatusTextClass`、货主/快递选项映射、`scanBasicField/scanWorkflowField` 抽到 `src/utils/`,约 110 处引用改为新路径;`order-common-config.ts` 用 re-export 保持向后兼容。
4. **业务字典归位**:把订单专属内容整理为 `views/order/config/order-business-config.ts`,`order-common-config.ts` 逐步削薄。
5. **次级资产**(可选,视页面替换节奏):`order-index-helpers`、`stock-picker-helpers`、`form/ManualWaybillForm` 等,建议在替换对应页面时"就近迁移",不必提前集中。
6. **最后**:删掉 re-export shim,`views/order/orderManagement` 回归纯业务页面。
### 8.3 工作量估算
| 阶段 | 需改动文件 | 需改写语句 | 风险 |
|---|---|---|---|
| ① 样式 | 99(外)+ 12(内) | 111 处 `@use` | 低(纯路径替换,可编译验证) |
| ② 组件 + 类型 | 58 | 58 处 `import` | 低 |
| ③ 通用工具 | ~110 | ~110 处 `import` | 中(涉及 re-export 与 ESLint 规则) |
| ④ 业务字典归位 | 内部 ~20 | — | 中(需逐个甄别业务/通用) |
| 合计(①②③) | ≈180 个文件 | ≈307 处语句 | — |
---
## 9. 需要特别确认的问题(留给后续)
1. `COMMON_TRANSLATIONS` / `COMMON_TAG_TYPES` 算"通用状态字典"还是"订单业务字典"?它被 `getTagType` 依赖,但内容明显是订单字段。
2. `mode` 模板本身依赖 `orderManagement`,抽离后**是否同步更新 `mode`**(推荐是)?否则新复制出来的页面仍然指向旧模块。
3. 抽离的同时是否要"改名去 Order 化"(`order-sub.scss` → `list-page.scss`、`OrderToolbarButtonGroup` → `ToolbarButtonGroup`)?改名会让 diff 变大,但能一次性解决语义错位。
4. 是否保留 re-export 兼容层?保留则分批安全,但公共层会短暂存在两套入口。
---
## 附录 A:133 个受影响文件完整清单(按目录)
> 判定标准:文件内出现以下任一引用
> `orderManagement/config/order-common-config` · `orderManagement/styles/order-sub.scss` · `orderManagement/component/OrderToolbarButtonGroup.vue`
### afterSale(5)
```
views/afterSale/list/afterSale-config.ts
views/afterSale/list/index.vue
views/afterSale/typelist/components/ColumnCellRenderer.vue
views/afterSale/typelist/config/components/DetailPanel.vue
views/afterSale/typelist/index.vue
```
### data(9)
```
views/data/ordersummary/components/ColumnCellRenderer.vue
views/data/ordersummary/config/components/DetailPanel.vue
views/data/ordersummary/config/components/LogPanel.vue
views/data/ordersummary/index.vue
views/data/packingflow/index.vue
views/data/packingflow/packingflow-config.ts
views/data/returnrecord/components/ReceiveRegisterPanel.vue
views/data/returnrecord/components/ReturnReceivedTaskPanel.vue
views/data/returnrecord/returnReceivedTask-config.ts
```
### express(14)
```
views/express/returnReceived/index.vue
views/express/returnReceived/returnReceived-config.ts
views/express/returnUnpack/components/ExportDialog.vue
views/express/returnUnpack/components/UnpackDetailTable.vue
views/express/returnUnpack/components/VideoListDialog.vue
views/express/returnUnpack/index.vue
views/express/returnUnpack/returnUnpack-config.ts
views/express/returnwaybill/index.vue
views/express/returnwaybill/returnwaybill-config.ts
views/express/waybill/components/ColumnCellRenderer.vue
views/express/waybill/components/TransferByWaybillsDialog.vue
views/express/waybill/config/components/DetailPanel.vue
views/express/waybill/config/components/LogPanel.vue
views/express/waybill/index.vue
```
### inbox / message / material / store / warehouses(13)
```
views/inbox/autoReply/index.vue
views/inbox/group/group-config.ts
views/inbox/group/index.vue
views/inbox/message/index.vue
views/inbox/message/message-config.ts
views/message/components/CreateAfterSaleDialog.vue
views/message/index.vue
views/material/packageMaterial/index.vue
views/material/packageMaterial/package-material-config.ts
views/material/packageSupplier/index.vue
views/material/packageSupplier/package-supplier-config.ts
views/store/shipperSigning/index.vue
views/store/stores/index.vue
views/store/stores/store-config.ts
views/warehouses/index.vue
```
### mode(4,模板自身)
```
views/mode/components/ColumnCellRenderer.vue
views/mode/config/components/DetailPanel.vue
views/mode/config/components/LogPanel.vue
views/mode/index.vue
```
### order(12,旧订单页)
```
views/order/orderreview/index.vue
views/order/orderreview/recheck-config.ts
views/order/orderWeighing/config/weighing-config.ts
views/order/orderWeighing/index.vue
views/order/waveOrder/component/PendingOrderListPanel.vue
views/order/waveOrder/component/WaveBatchDetailPanel.vue
views/order/waveOrder/config/wave-config.ts
views/order/waveOrder/FallbackOrderListPanel.vue
views/order/waveOrder/GroupWaveBatchListPanel.vue
views/order/waveOrder/SandanWaveBatchListPanel.vue
views/order/waveOrder/WavePickTaskListPanel.vue
views/order/waveOrder/WaveStrategyListPanel.vue
```
### stock(9)
```
views/stock/combo_stock/combo-stock-config.ts
views/stock/combo_stock/component/ComboGoodsFormDialog.vue
views/stock/combo_stock/component/ComboGoodsSearchDialog.vue
views/stock/combo_stock/index.vue
views/stock/external_stock/index.vue
views/stock/pickingShortage/components/ColumnCellRenderer.vue
views/stock/pickingShortage/index.vue
views/stock/stock/index.vue
views/stock/stock/stock-config.ts
```
### storage(30)
```
views/storage/entry/component/EntryBindingRelations.vue
views/storage/entry/component/entrydetail.vue
views/storage/entry/entry-config.ts
views/storage/entry/index.vue
views/storage/entry_owner/index.vue
views/storage/generalreport/index.vue
views/storage/inventory/index.vue
views/storage/inventory/inventory-config.ts
views/storage/log/component/TransactionDetail.vue
views/storage/log/index.vue
views/storage/log/log-config.ts
views/storage/management/replenishmentDemand/index.vue
views/storage/productflow/component/ProductflowDetail.vue
views/storage/productflow/index.vue
views/storage/productflow/productflow-config.ts
views/storage/productflow/store/index.vue
views/storage/receiving/component/Product.vue
views/storage/receiving/index.vue
views/storage/receiving/receiving-config.ts
views/storage/receiving_owner/index.vue
views/storage/report/index.vue
views/storage/report/store.vue
views/storage/stockcheck/components/ColumnCellRenderer.vue
views/storage/stockcheck/config/components/CheckItemsPanel.vue
views/storage/stockcheck/config/components/CheckRecordsPanel.vue
views/storage/stockcheck/config/components/DetailPanel.vue
views/storage/stockcheck/config/components/LogPanel.vue
views/storage/stockcheck/index.vue
views/storage/stockout/index.vue
views/storage/stockout/stockout-config.ts
```
### system(27)
```
views/system/setting/account/index.vue
views/system/setting/basicManagement/newview/components/ColumnCellRenderer.vue
views/system/setting/basicManagement/newview/config/components/DetailPanel.vue
views/system/setting/basicManagement/newview/config/components/LogPanel.vue
views/system/setting/basicManagement/newview/index.vue
views/system/setting/encoding/components/CourierCodeManagement.vue
views/system/setting/encoding/components/PlatformCodeManagement.vue
views/system/setting/expressinterface/index.vue
views/system/setting/permission/index.vue
views/system/setting/pickcart/components/InfoPanel.vue
views/system/setting/pickcart/index.vue
views/system/setting/printcomputer/components/ColumnCellRenderer.vue
views/system/setting/printcomputer/config/components/DetailPanel.vue
views/system/setting/printcomputer/config/components/LogPanel.vue
views/system/setting/printcomputer/index.vue
views/system/setting/printStation/components/printComputer.vue
views/system/setting/printStation/components/Printer.vue
views/system/setting/printStation/index.vue
views/system/setting/role/components/ColumnCellRenderer.vue
views/system/setting/role/index.vue
views/system/setting/role/pages/RolePermissionDialog.vue
views/system/setting/shops/index.vue
views/system/setting/storeExpressBindingPolicy/index.vue
views/system/setting/workbench2/components/ColumnCellRenderer.vue
views/system/setting/workbench2/config/components/DetailPanel.vue
views/system/setting/workbench2/config/components/LogPanel.vue
views/system/setting/workbench2/index.vue
```
### video(8)
```
views/video/newcamara/components/ColumnCellRenderer.vue
views/video/newcamara/config/components/DetailPanel.vue
views/video/newcamara/config/components/LogPanel.vue
views/video/newcamara/index.vue
views/video/newcamaraserver/components/ColumnCellRenderer.vue
views/video/newcamaraserver/config/components/DetailPanel.vue
views/video/newcamaraserver/config/components/LogPanel.vue
views/video/newcamaraserver/index.vue
```
---
## 附录 B:`orderManagement` 内部需同步改写的引用
| 项 | 数量 |
|---|---|
| 目录内文件总数 | 55 |
| 内部引用 `styles/order-sub.scss` | 12 |
| 内部引用 `config/order-common-config` | 20 |
引用 `order-sub.scss` 的内部文件:
```
component/CreatePendingOrderDialog.vue
component/PendingOrderDetailPanel.vue
component/TransferByOrdersDialog.vue
form/BatchQuickRecheckForm.vue
archiveOrder.vue
deliveryException.vue
deliveryOrder.vue
entrustWarehouse.vue
exceptionOrder.vue
outboundOrder.vue
pendingOrder.vue
reviewOrder.vue
```

View File

@ -0,0 +1,407 @@
# 顶部区域结构分析与优化方案
> 状态:**仅分析,未改代码**
> 范围:`layout`(框架层)+ 各业务页面的「顶部标签区 / 页面容器高度」
> 目标:**不改变最终视觉**,优化结构、提升响应速度、消除样式遗留问题
---
## 一、现状结构
### 1.1 渲染层级
```
layout/index.vue (.app-wrapper)
├─ Sidebar
└─ .main-container
├─ .fixed-header ← position: fixed,高度由内容撑开
│ └─ TaskView/index.vue
│ ├─ .navbar-wrapper Navbar.vue
│ ├─ .shortcut-panel 快捷入口(仅展开时渲染)
│ │ ├─ .shortcut-toggle--expanded 20×10 浮层按钮
│ │ └─ .shortcut-key 入口按钮行
│ ├─ .shortcut-toggle--collapsed 收起态小条
│ ├─ ScrollPane .tags-view-wrapper 已打开页面标签
│ └─ .contextmenu
├─ .fixed-header-spacer ← 高度 = 实测 headerHeight
└─ .main-box
├─ AppMain.vue ← padding: 20px
│ └─ .app-main__body → router-view + keep-alive
└─ .ai-container
```
### 1.2 三种「标签」必须区分清楚
这是大量沟通成本和样式冲突的根源:
| 概念 | 所在层 | 实现 | 驱动 |
|---|---|---|---|
| **A. 已打开页面标签** | 框架层(全局) | TaskView 的 `.tags-view-wrapper` | route / tagsView store |
| **B. 快捷入口** | 框架层(全局) | TaskView 的 `.shortcut-key` | shortcuts store |
| **C. 页面内业务标签** | 页面层 | 各页 `el-tabs.tab-container` | 页面本地状态 |
「页面标签和底下页面之间有条细线」中的「页面标签」实际指 **C**(页内标签),
而「打开页面的标签」是 **A**。两者样式相近但归属完全不同,改动时极易混淆。
### 1.3 高度链路(当前)
```
真实高度 = Navbar(≈45) + 快捷区(0 或 ≈36) + 标签行(≈38)
= 收起 ≈93 / 展开 ≈119
app-main 可用高度 = 100vh - headerHeight - 40 (上下 padding 20×2)
= 100vh - 133(收起) / 100vh - 159(展开)
```
而业务页面里普遍写的是:
```ts
const containerHeight = computed(() =>
shortcutExpanded.value ? 'calc(100vh - 150px)' : 'calc(100vh - 100px)'
)
```
**差值为 33px / 9px**,这组魔法数已经与真实布局脱节。
---
## 二、已定位的问题清单
### P0-1 · `containerHeight` 在 30+ 页面重复硬编码
出现位置(部分):
```
order/waveOrder、order/orderManagement、warehouses、afterSale/list、
afterSale/typelist、express/waybill、data/returnrecord、data/ordersummary、
message、mode、material/packageSupplier、material/packageMaterial、
storage/inventory、storage/stockout、storage/entry、storage/log、
storage/receiving、storage/receiving_owner、storage/report、
storage/report/store、storage/generalreport、storage/stockcheck、
storage/productflow、storage/productflow/store、
system/setting/workbench2、system/setting/miniprogram、
system/setting/storeExpressBindingPolicy、video/newcamara、
video/newcamaraserver …
```
影响:
- **一改顶部,30+ 页面全部错位**。本轮快捷区高度从 46px → 36px,这批页面的可用高度就全错了 10px。
- 数值本身不统一,且与真实布局不符。
- 每个页面都依赖 `settingsStore.shortcutExpanded`,展开/收起会触发所有已挂载页面(含 keep-alive 缓存页)重新计算与重渲染。
### P0-2 · dashboard 高度声明自相矛盾
`src/views/dashboard/index.vue`
```css
.dashboard-container {
padding: 20px;
background-color: #f5f7fa;
min-height: calc(100vh - 84px);
height: 100px; /* ← 遗留:与 min-height / flex: 1 冲突 */
flex: 1;
overflow-y: auto;
}
```
`height: 100px` 与 `min-height: calc(100vh - 84px)`、`flex: 1` 三者互相打架。
其中 `84px` 也是旧版 header 高度(当前为 ≈93),属于同一批遗留魔法数。
### P0-3 · `TabArea` 组件被复制 8 份
已存在同名组件副本:
```
views/afterSale/typelist/components/TabArea.vue
views/express/waybill/components/TabArea.vue
views/mode/components/TabArea.vue
views/data/ordersummary/components/TabArea.vue
views/storage/generalreport/components/TabArea.vue
views/storage/stockcheck/components/TabArea.vue
views/video/newcamaraserver/components/TabArea.vue
views/system/setting/workbench2/components/TabArea.vue
```
每份都带一套 `.tab-container` 的 `:deep()` 覆盖样式。
改一次样式要改 8 处,且已经出现版本漂移风险。
### P0-4 · `type="border-card"` 自带外壳
所有页内 `el-tabs` 都用了 `type="border-card"`,Element Plus 默认为它加上:
```css
.el-tabs--border-card {
border: 1px solid var(--el-border-color-light);
box-shadow: 0 2px 4px 0 rgba(0,0,0,.12), 0 0 6px 0 rgba(0,0,0,.04);
background: #fff;
}
```
而外层 `.tab-section` **自己也画了 border + box-shadow**。
两层外壳叠加 → 标签区下方投影出一条淡灰色细线。
(控制台页面没有 `el-tabs`,所以看不到该现象。)
### P1-5 · 「标签↔内容」分隔线来源不唯一
同一条视觉分界线,可能来自四处的任意组合:
1. `.tab-section` 的 `border`
2. `.el-tabs--border-card` 的 `border` / `box-shadow`
3. `.el-tabs__header.is-top` 的 `border-bottom`
4. `.main-container` 的 `border-top`
**没有唯一定义方**,所以每修一次都可能从别处冒出第二条线。
### P1-6 · `.tab-section` / `.main-container` 样式重复定义
除 `TabArea.vue` 外,页面主文件里还有多份 `.tab-section` 定义
(waveOrder、orderManagement、afterSale/typelist、data/returnrecord、mode、
data/ordersummary、video/newcamara、video/newcamaraserver、storage/generalreport、
storage/stockcheck、system/setting/workbench2 …),且细节不完全一致。
### P1-7 · tags-view 每次路由变化全量重建
`TaskView/index.vue`:
- `v-for="tag in visitedViews"`,`:key="tag.path"`
- `onBeforeUpdate` 清空 `tagsRef`
- `moveToCurrentTag()` 在 `nextTick` 中遍历全部标签定位
标签较多时(20+),每次切页都走一遍全量 diff + 全量遍历。
另外 `visitedViews` 是普通数组,任一标签增删都会让整个列表重新求值。
### P2-8 · 顶部高度曾有硬编码(本轮已修)
已改为 `ResizeObserver` 实测 + `--app-header-height` CSS 变量,
不再是 `134 / 97`。但**消费端尚未跟进**(见 P0-1)。
---
## 三、优化方案(不改最终视觉)
### 方案 A · 顶部高度单一事实源(根本解,优先级最高)
已具备条件:`layout/index.vue` 已把实测高度写入:
```css
:root { --app-header-height: 93px; } /* 由 ResizeObserver 实时更新 */
```
两条落地路径,任选其一:
**A-1(推荐)· 页面不再算高度**
让 `app-main` 用 flex 撑满,页面根容器写 `height: 100%`:
```css
.app-main__body :deep(.app-router-page) { flex: 1; min-height: 0; }
```
页面根容器删掉 `:style="{ height: containerHeight }"`,改 `height: 100%`。
好处:**页面不再需要知道顶部多高**,顶部怎么改都不影响业务页。
**A-2 · 保留显式高度,但统一口径**
提供 composable:
```ts
// src/composables/usePageHeight.ts
export function usePageHeight(bottomPadding = 40) {
return computed(() => `calc(100vh - var(--app-header-height) - ${bottomPadding}px)`)
}
```
30+ 页面逐个替换为 `usePageHeight()`。
> A-1 更彻底(去掉契约),A-2 改动更小(保留契约)。
> 建议先做 A-1 的公共容器改造,再逐步删页面里的 `containerHeight`。
### 方案 B · `TabArea` 收敛为全局组件
目标:`src/components/TabArea/index.vue`,props:
| prop | 说明 |
|---|---|
| `tabs` | `{ name, label }[]` |
| `defaultActive` | 初始标签 |
| `sortable` | 是否显示排序入口 |
| `actions` | 右侧操作区插槽 |
内置正确的样式(不依赖 `border-card` 自带外壳),8 份副本删除,页面改为引用。
### 方案 C · 分隔线职责唯一化
立约定,只保留一处:
- `.tab-section` → **只负责左右和顶部边框 + 圆角**
- `.el-tabs--border-card` → `border: none; box-shadow: none; background: transparent`
- `.el-tabs__header.is-top` → **唯一负责** `border-bottom`(标签与内容的分界线)
- `.main-container` → `border-top: none`
激活标签通过 `box-shadow: 0 1px 0 #fff` 遮住这条线,实现「标签与内容连通」。
### 方案 D · tags-view 渲染优化(收益中等)
1. 把单个标签抽成 `TagItem` 子组件,配 `v-memo="[tag.path, isActive]"`,避免无关标签重渲染。
2. `moveToCurrentTag` 只在 `route.path` 变化时执行(现在 `watch(route)` 是全量对象)。
3. `visitedViews` 增删用 `findIndex` 替代 `some + push` 的两次遍历(次要)。
### 方案 E · 清理遗留魔法数
- `dashboard`:删 `height: 100px`,`min-height` 改用 `var(--app-header-height)` 或直接交给 flex。
- 其余页面里的 `84 / 97 / 100 / 134 / 150` 一并纳入 A 方案统一处理。
---
## 四、建议实施顺序
| 阶段 | 内容 | 风险 | 预期收益 |
|---|---|---|---|
| 1 | 方案 C(分隔线唯一化)+ P0-4 | 低 | 消除细线类问题 |
| 2 | 方案 B(TabArea 收敛) | 中 | 8 处样式→1 处 |
| 3 | 方案 A-1(app-main 撑满,页面 `height: 100%`) | 中高 | 根除高度错位 |
| 4 | 方案 A-2 兜底(`usePageHeight`)+ 清理 30+ 处 | 中 | 兼容暂不改造的页面 |
| 5 | 方案 D(tags-view 渲染优化) | 低 | 切页更顺 |
| 6 | 方案 E(遗留魔法数清理) | 低 | 减少技术债 |
> 阶段 1 可以立刻做,改动小、视觉无变化、直接解决当前细线问题。
---
## 五、需要确认的决策点
1. **页面高度契约**:选 A-1(页面 `height: 100%`,去掉 vh 计算)还是 A-2(统一 `usePageHeight`)?
2. **TabArea 是否统一带排序入口**?当前只有 order / waveOrder 有,其余页面没有。
3. **`type="border-card"` 是否保留**?保留则需要全局覆盖其外壳;去掉则要确认视觉无变化。
4. **是否接受 `app-main` 的 `padding: 20px` 改为可选**(dashboard 需要灰底铺满,其他页面需要留白)?
---
# 六、实施记录(已完成)
> 结论先行:**页面高度不再由页面自己算,标签视觉统一到 order 卡片式,8+ 份重复组件收敛为 1 份。**
## 6.1 顶部表头高度:从「猜」改为「测」
**`src/layout/index.vue`**
| 改动 | 说明 |
|---|---|
| 新增 `headerRef` + `ResizeObserver` | 实测 `.fixed-header` 的 `offsetHeight` |
| `headerHeight` 由 `ref` 提供 | 删除原来的 `134 / 97` 两个魔法数 |
| `.fixed-header-spacer` 高度 = 实测值 | 占位块永远等于真实表头高度 |
| `.ai-container` 的 `top` / `height` = 实测值 | AI 浮层不再自己猜顶部高度 |
| 写入 `--app-header-height` | 实测值同步到 `document.documentElement`,供任意页面复用 |
| 删除未使用的 `shortcutExpanded` | 布局层不再需要知道快捷区状态 |
效果:快捷区展开/收起、切换语言导致导航换行、调整导航高度,占位与浮层都自动跟随,**不会再出现缝隙或遮挡**。
**`src/layout/component/AppMain.vue`**
- 删除 `.fixed-header + .app-main { padding-top: 90px }`
(中间隔着 spacer,该选择器从未命中,属于历史死规则)
## 6.2 快捷入口区结构
**`src/layout/component/TaskView/index.vue`**
展开态:
```
.shortcut-panel
├─ .shortcut-toggle--expanded ← 20×10 浮层按钮(absolute)
└─ .shortcut-key ← 入口按钮行
```
收起态:`.shortcut-toggle--collapsed`(缩进小条,视觉不变)
| 改动 | 说明 |
|---|---|
| 展开按钮改为 `position: absolute; top: 0; left: 50%` | **不参与布局**,不撑高容器 |
| 按钮尺寸固定 20×10 | 不再铺满整条 |
| 删除重复的一份 `.shortcut-toggle` / `.shortcut-key` 定义 | 原来有两套样式同时存在 |
| `shortcut-panel` 的 padding 改为 `10px 12px 6px` | 上方 10px 正好容纳按钮,按钮下沿与入口行上沿相接 |
## 6.3 页面内标签:分隔线唯一化 + 视觉统一
**新增 `src/styles/tab-area.scss`**,在 `src/styles/index.scss` 引入。
职责约定(解决「一条线四个来源」的问题):
| 元素 | 职责 |
|---|---|
| `.tab-section` | 只负责左右 + 顶部边框、圆角 |
| `.el-tabs--border-card` | **不画**边框、阴影、背景 |
| `.el-tabs__header.is-top` | **唯一**负责 `border-bottom` |
| `.main-container` | 不再重复画 `border-top` |
| 激活标签 | `box-shadow: 0 1px 0 #fff` 盖住分隔线,实现「标签与内容连通」 |
同时把「下划线式」统一为 order 卡片式:
| 属性 | 统一前 | 统一后 |
|---|---|---|
| 标签高度 | 38px | **34px** |
| 标签字号 | 14px | **13px** |
| 左右内边距 | 20px | **16px** |
| 标签圆角 | 6px | **8px** |
| 标签底色/边框 | 透明边框 | **`#edf3fb` + `#e6edf8`** |
| 激活色 | `#409eff` | **`#2f80ed`** |
| 激活态 | 白色 2px 下边 + 上移 | **白底卡片 + 8px 圆点** |
| 底部活动条 | 2px 蓝条 | **隐藏** |
> 不覆盖 `padding-left`:各页面按「是否显示排序入口」自行保留 12px / 46px 左留白。
## 6.4 TabArea 组件收敛
**新增 `src/components/TabArea/index.vue`**
- 视觉基准 = `order/orderManagement`、`order/waveOrder`
- 排序入口:`v-if="tabs.length > 1"`,**单页签页面不显示**
- 排序结果按账号存本地,**组件内部自行重排**,父组件无需感知顺序
- scope 未传时按 `tab-order:${route.path}` 自动生成,避免页面间串数据
**收敛结果**
| 项 | 数量 |
|---|---|
| 删除的本地 `TabArea.vue` 副本 | **11 份** |
| 改指向全局组件的页面 | **11 个** |
| 顺带修复 | `express/waybill` 用了 `<TabArea>` 却从未 import(该页标签区此前渲染不出来) |
## 6.5 页面高度契约改造
| 原写法 | 处理 | 数量 |
|---|---|---|
| `containerHeight = calc(100vh - 150px/100px)` | 改为 `'100%'`,由布局层提供高度 | **43 处** |
| `height: calc(100vh - 130px)` | 改为 `height: 100%` | 2 处 |
| `min-height: calc(100vh - 84px)` | 改为 `min-height: 0` | 1 处 |
| `height: calc(100vh - 84px)` | 改为 `height: 100%` | 1 处 |
| dashboard `height: 100px` + `min-height: calc(...)` | 删除,改为 `flex: 1; min-height: 0` | 1 处 |
| 已无用的 `shortcutExpanded` 声明 | 删除 | 43 处 |
> 过程中批量正则误伤了 `TaskView` 里仍在使用的 `shortcutExpanded`,已恢复并重新构建验证。
## 6.6 打开页面的标签(tags-view)渲染优化
- 每个标签加 `v-memo="[tag.path, tag.fullPath, isActive(tag)]"`,无关标签跳过重渲染
- `watch(route)` 收窄为 `watch(() => route.fullPath)`,减少无谓触发
- `ScrollPane` 隐藏横向滚动条(`el-scrollbar__bar` + 原生滚动条)
## 6.7 验证
| 检查 | 结果 |
|---|---|
| `npm run build` | 通过,退出码 0 |
| `get_errors` 全量 | 无错误 |
| `calc(100vh - 150/100/130/84px)` 残留 | 0(仅剩注释) |
| 本地 `TabArea.vue` 副本 | 0 |
## 6.8 遗留事项
| 项 | 状态 | 说明 |
|---|---|---|
| `storage/generalreport` | 待定 | 有页面文件与 router 映射,但后台无菜单;确认不用可整体删除 |
| `data/returnrecord` / `stock/stockManagement` / `system/setting/encoding` | 未迁移 | 仍内联 `el-tabs`(有 `before-leave`、自定义排序 scope 等差异),目前靠全局样式统一外观 |
| 各页面 scoped 里的重复 tab 样式 | 未删除 | 已被全局规则覆盖,可后续清理 |
| 未使用的 `useSettingsStore` import | 未清理 | 构建无影响,属 lint 级冗余 |

398
package-lock.json generated
View File

@ -26,7 +26,6 @@
"qrcode": "^1.5.4",
"sortablejs": "^1.15.7",
"spark-md5": "^3.0.2",
"three": "^0.183.2",
"uuid": "^13.0.0",
"vue": "^3.5.29",
"vue-draggable-plus": "^0.6.1",
@ -44,7 +43,6 @@
"@types/qrcode": "^1.5.6",
"@types/sortablejs": "^1.15.9",
"@types/spark-md5": "^3.0.5",
"@types/three": "^0.183.1",
"@vitejs/plugin-vue": "^6.0.4",
"@vue/tsconfig": "^0.8.1",
"eslint": "^10.2.0",
@ -56,6 +54,8 @@
"sass": "^1.97.3",
"typescript": "~5.9.3",
"typescript-eslint": "^8.58.2",
"unplugin-auto-import": "^21.1.0",
"unplugin-vue-components": "^32.1.0",
"vite": "^7.3.1",
"vite-plugin-svg-icons": "^2.0.1",
"vite-plugin-vue-devtools": "^8.0.6",
@ -530,13 +530,6 @@
"node": ">=10"
}
},
"node_modules/@dimforge/rapier3d-compat": {
"version": "0.12.0",
"resolved": "https://registry.npmjs.org/@dimforge/rapier3d-compat/-/rapier3d-compat-0.12.0.tgz",
"integrity": "sha512-uekIGetywIgopfD97oDL5PfeezkFpNhwlzlaEYNOA0N6ghdsOvh/HYjSMek5Q2O1PYvRSDFcqFVJl4r4ZBwOow==",
"dev": true,
"license": "Apache-2.0"
},
"node_modules/@element-plus/icons-vue": {
"version": "2.3.2",
"resolved": "https://registry.npmjs.org/@element-plus/icons-vue/-/icons-vue-2.3.2.tgz",
@ -1267,9 +1260,9 @@
}
},
"node_modules/@jridgewell/sourcemap-codec": {
"version": "1.5.5",
"resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz",
"integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==",
"version": "1.6.0",
"resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.6.0.tgz",
"integrity": "sha512-T7jf+5zgsZHwNJ4lvQ7/aezbyk0nNX+zJVWpmHA7VYsEx7a7qr5Rg5IbtJFqkgze5Y2sruq1RUY8Q837Od7iFw==",
"license": "MIT"
},
"node_modules/@jridgewell/trace-mapping": {
@ -2022,13 +2015,6 @@
"dev": true,
"license": "MIT"
},
"node_modules/@tweenjs/tween.js": {
"version": "23.1.3",
"resolved": "https://registry.npmjs.org/@tweenjs/tween.js/-/tween.js-23.1.3.tgz",
"integrity": "sha512-vJmvvwFxYuGnF2axRtPYocag6Clbb5YS7kLL+SO/TeVFzHqDIWrNKYtcsPMibjDx9O+bu+psAy9NKfWklassUA==",
"dev": true,
"license": "MIT"
},
"node_modules/@types/esrecurse": {
"version": "4.3.1",
"resolved": "https://registry.npmjs.org/@types/esrecurse/-/esrecurse-4.3.1.tgz",
@ -2040,7 +2026,7 @@
"version": "1.0.8",
"resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz",
"integrity": "sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==",
"dev": true,
"devOptional": true,
"license": "MIT"
},
"node_modules/@types/js-cookie": {
@ -2119,13 +2105,6 @@
"dev": true,
"license": "MIT"
},
"node_modules/@types/stats.js": {
"version": "0.17.4",
"resolved": "https://registry.npmjs.org/@types/stats.js/-/stats.js-0.17.4.tgz",
"integrity": "sha512-jIBvWWShCvlBqBNIZt0KAshWpvSjhkwkEu4ZUcASoAvhmrgAUI2t1dXrjSL4xXVLB4FznPrIsX3nKXFl/Dt4vA==",
"dev": true,
"license": "MIT"
},
"node_modules/@types/svgo": {
"version": "2.6.4",
"resolved": "https://registry.npmjs.org/@types/svgo/-/svgo-2.6.4.tgz",
@ -2136,35 +2115,12 @@
"@types/node": "*"
}
},
"node_modules/@types/three": {
"version": "0.183.1",
"resolved": "https://registry.npmjs.org/@types/three/-/three-0.183.1.tgz",
"integrity": "sha512-f2Pu5Hrepfgavttdye3PsH5RWyY/AvdZQwIVhrc4uNtvF7nOWJacQKcoVJn0S4f0yYbmAE6AR+ve7xDcuYtMGw==",
"dev": true,
"license": "MIT",
"dependencies": {
"@dimforge/rapier3d-compat": "~0.12.0",
"@tweenjs/tween.js": "~23.1.3",
"@types/stats.js": "*",
"@types/webxr": ">=0.5.17",
"@webgpu/types": "*",
"fflate": "~0.8.2",
"meshoptimizer": "~1.0.1"
}
},
"node_modules/@types/web-bluetooth": {
"version": "0.0.21",
"resolved": "https://registry.npmjs.org/@types/web-bluetooth/-/web-bluetooth-0.0.21.tgz",
"integrity": "sha512-oIQLCGWtcFZy2JW77j9k8nHzAOpqMHLQejDA48XXMWH6tjCQHz5RCFz1bzsmROyL6PUm+LLnUiI4BCn221inxA==",
"license": "MIT"
},
"node_modules/@types/webxr": {
"version": "0.5.24",
"resolved": "https://registry.npmjs.org/@types/webxr/-/webxr-0.5.24.tgz",
"integrity": "sha512-h8fgEd/DpoS9CBrjEQXR+dIDraopAEfu4wYVNY2tEPwk60stPWhvZMf4Foo5FakuQ7HFZoa8WceaWFervK2Ovg==",
"dev": true,
"license": "MIT"
},
"node_modules/@typescript-eslint/eslint-plugin": {
"version": "8.58.2",
"resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.58.2.tgz",
@ -2749,6 +2705,7 @@
"resolved": "https://registry.npmjs.org/@vueuse/core/-/core-14.2.1.tgz",
"integrity": "sha512-3vwDzV+GDUNpdegRY6kzpLm4Igptq+GA0QkJ3W61Iv27YWwW/ufSlOfgQIpN6FZRMG0mkaz4gglJRtq5SeJyIQ==",
"license": "MIT",
"peer": true,
"dependencies": {
"@types/web-bluetooth": "^0.0.21",
"@vueuse/metadata": "14.2.1",
@ -2782,17 +2739,10 @@
"vue": "^3.5.0"
}
},
"node_modules/@webgpu/types": {
"version": "0.1.69",
"resolved": "https://registry.npmjs.org/@webgpu/types/-/types-0.1.69.tgz",
"integrity": "sha512-RPmm6kgRbI8e98zSD3RVACvnuktIja5+yLgDAkTmxLr90BEwdTXRQWNLF3ETTTyH/8mKhznZuN5AveXYFEsMGQ==",
"dev": true,
"license": "BSD-3-Clause"
},
"node_modules/acorn": {
"version": "8.16.0",
"resolved": "https://registry.npmjs.org/acorn/-/acorn-8.16.0.tgz",
"integrity": "sha512-UVJyE9MttOsBQIDKw1skb9nAwQuR5wuGD3+82K6JgJlm/Y+KI92oNsMNGZCYdDsVtRHSak0pcV5Dno5+4jh9sw==",
"version": "8.19.0",
"resolved": "https://registry.npmjs.org/acorn/-/acorn-8.19.0.tgz",
"integrity": "sha512-oJlA3XiRm7Cyk6qFD2Jn8ak9B7jSy0qy00ADO3+8dpT0LSjFihQYv4C02LFCSYJV3Q37xYwwRy5m+IpIiUzqWw==",
"license": "MIT",
"peer": true,
"bin": {
@ -3573,9 +3523,9 @@
}
},
"node_modules/confbox": {
"version": "0.2.4",
"resolved": "https://registry.npmjs.org/confbox/-/confbox-0.2.4.tgz",
"integrity": "sha512-ysOGlgTFbN2/Y6Cg3Iye8YKulHw+R2fNXHrgSmXISQdMnomY6eNDprVdW9R5xBguEqI954+S6709UyiO7B+6OQ==",
"version": "0.3.2",
"resolved": "https://registry.npmjs.org/confbox/-/confbox-0.3.2.tgz",
"integrity": "sha512-ZUAKhKlkCOrIGKc8cj7zek9s9z1mveHif/25nUshI2BzCRzF7KH7KHa+Lnh2ubq+e1tIlaFuP763mzW4qVoehg==",
"license": "MIT"
},
"node_modules/convert-source-map": {
@ -4431,9 +4381,10 @@
"version": "0.27.3",
"resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.27.3.tgz",
"integrity": "sha512-8VwMnyGCONIs6cWue2IdpHxHnAjzxnw2Zr7MkVxB2vjmQ2ivqGFb4LEG3SMnv0Gb2F/G/2yA8zUaiL1gywDCCg==",
"dev": true,
"devOptional": true,
"hasInstallScript": true,
"license": "MIT",
"peer": true,
"bin": {
"esbuild": "bin/esbuild"
},
@ -4809,9 +4760,9 @@
"license": "MIT"
},
"node_modules/exsolve": {
"version": "1.0.8",
"resolved": "https://registry.npmjs.org/exsolve/-/exsolve-1.0.8.tgz",
"integrity": "sha512-LmDxfWXwcTArk8fUEnOfSZpHOJ6zOMUJKOtFLFqJLoKJetuQG874Uc7/Kki7zFLzYybmZhp1M7+98pfMqeX8yA==",
"version": "1.2.0",
"resolved": "https://registry.npmjs.org/exsolve/-/exsolve-1.2.0.tgz",
"integrity": "sha512-h1pQPR9XoeSMdntRNCjyTznaume4UpfXrULBnlkZ2CUM/G5eSa+pBByGldO5uR8dxbPC+OuJXsPPNf+JZ81ADg==",
"license": "MIT"
},
"node_modules/extend-shallow": {
@ -4912,13 +4863,6 @@
}
}
},
"node_modules/fflate": {
"version": "0.8.2",
"resolved": "https://registry.npmjs.org/fflate/-/fflate-0.8.2.tgz",
"integrity": "sha512-cPJU47OaAoCbg0pBvzsgpTPhmhqI5eJjh/JIu8tPj5q+T7iLvW/JAYUqmE7KOB4R1ZyEhzBaIQpQpardBF5z8A==",
"dev": true,
"license": "MIT"
},
"node_modules/file-entry-cache": {
"version": "8.0.0",
"resolved": "https://registry.npmjs.org/file-entry-cache/-/file-entry-cache-8.0.0.tgz",
@ -6313,9 +6257,9 @@
}
},
"node_modules/local-pkg": {
"version": "1.1.2",
"resolved": "https://registry.npmjs.org/local-pkg/-/local-pkg-1.1.2.tgz",
"integrity": "sha512-arhlxbFRmoQHl33a0Zkle/YWlmNwoyt6QNZEIJcqNbdrsix5Lvc4HyyI3EnwxTYlZYc32EbYrQ8SzEZ7dqgg9A==",
"version": "1.2.1",
"resolved": "https://registry.npmjs.org/local-pkg/-/local-pkg-1.2.1.tgz",
"integrity": "sha512-++gUqRDEvcnN6Zhqrr+y/CkVEHhlrR96vZn3nZZPYzMcBUyBtTKzB9NadClFIsIVSsu+3i9tfk/erqy9kAmt7Q==",
"license": "MIT",
"dependencies": {
"mlly": "^1.7.4",
@ -6481,13 +6425,6 @@
"node": ">= 8"
}
},
"node_modules/meshoptimizer": {
"version": "1.0.1",
"resolved": "https://registry.npmjs.org/meshoptimizer/-/meshoptimizer-1.0.1.tgz",
"integrity": "sha512-Vix+QlA1YYT3FwmBBZ+49cE5y/b+pRrcXKqGpS5ouh33d3lSp2PoTpCw19E0cKDFWalembrHnIaZetf27a+W2g==",
"dev": true,
"license": "MIT"
},
"node_modules/micromatch": {
"version": "4.0.8",
"resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz",
@ -6596,15 +6533,15 @@
}
},
"node_modules/mlly": {
"version": "1.8.0",
"resolved": "https://registry.npmjs.org/mlly/-/mlly-1.8.0.tgz",
"integrity": "sha512-l8D9ODSRWLe2KHJSifWGwBqpTZXIXTeo8mlKjY+E2HAakaTeNpqAyBZ8GSqLzHgw4XmHmC8whvpjJNMbFZN7/g==",
"version": "1.8.2",
"resolved": "https://registry.npmjs.org/mlly/-/mlly-1.8.2.tgz",
"integrity": "sha512-d+ObxMQFmbt10sretNDytwt85VrbkhhUA/JBGm1MPaWJ65Cl4wOgLaB1NYvJSZ0Ef03MMEU/0xpPMXUIQ29UfA==",
"license": "MIT",
"dependencies": {
"acorn": "^8.15.0",
"acorn": "^8.16.0",
"pathe": "^2.0.3",
"pkg-types": "^1.3.1",
"ufo": "^1.6.1"
"ufo": "^1.6.3"
}
},
"node_modules/mlly/node_modules/confbox": {
@ -6988,6 +6925,20 @@
"node": ">=0.10.0"
}
},
"node_modules/obug": {
"version": "2.2.1",
"resolved": "https://registry.npmjs.org/obug/-/obug-2.2.1.tgz",
"integrity": "sha512-XrsrhT5sybtKI6wakr2SPOlGZWWYbUXZ7a0jT8/QOeAPau+1X/bSegNe5YR75oJmEZQbKningirmGOEJCIk61Q==",
"dev": true,
"funding": [
"https://github.com/sponsors/sxzz",
"https://opencollective.com/debug"
],
"license": "MIT",
"engines": {
"node": ">=12.20.0"
}
},
"node_modules/ohash": {
"version": "2.0.11",
"resolved": "https://registry.npmjs.org/ohash/-/ohash-2.0.11.tgz",
@ -7155,9 +7106,9 @@
"license": "ISC"
},
"node_modules/picomatch": {
"version": "4.0.3",
"resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.3.tgz",
"integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==",
"version": "4.0.7",
"resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.7.tgz",
"integrity": "sha512-qcJu88Q2IWqJsDD529JKMdwGm/dvInW4HvQnRwiH9JtihJvzGOscDtHE3x1pBKeUOTysQ8kVmLnJ2kJu7yhcGA==",
"license": "MIT",
"engines": {
"node": ">=12"
@ -7202,13 +7153,13 @@
}
},
"node_modules/pkg-types": {
"version": "2.3.0",
"resolved": "https://registry.npmjs.org/pkg-types/-/pkg-types-2.3.0.tgz",
"integrity": "sha512-SIqCzDRg0s9npO5XQ3tNZioRY1uK06lA41ynBC1YmFTmnY6FjUjVt6s4LoADmwoig1qqD0oK8h1p/8mlMx8Oig==",
"version": "2.4.0",
"resolved": "https://registry.npmjs.org/pkg-types/-/pkg-types-2.4.0.tgz",
"integrity": "sha512-07Fys7iVx0X6TcviMOgogM1Lk33ZyqOezMnU79S+kffWqwolG/5W9V8EgQSeYCIfFTYVgssRbnH630Oa2+soBA==",
"license": "MIT",
"dependencies": {
"confbox": "^0.2.2",
"exsolve": "^1.0.7",
"confbox": "^0.3.1",
"exsolve": "^1.1.3",
"pathe": "^2.0.3"
}
},
@ -7663,8 +7614,9 @@
"version": "4.59.0",
"resolved": "https://registry.npmjs.org/rollup/-/rollup-4.59.0.tgz",
"integrity": "sha512-2oMpl67a3zCH9H79LeMcbDhXW/UmWG/y2zuqnF2jQq5uq9TbM9TVyXvA4+t+ne2IIkBdrLpAaRQAvo7YI/Yyeg==",
"dev": true,
"devOptional": true,
"license": "MIT",
"peer": true,
"dependencies": {
"@types/estree": "1.0.8"
},
@ -8536,6 +8488,26 @@
"node": ">=0.10.0"
}
},
"node_modules/strip-literal": {
"version": "4.0.0",
"resolved": "https://registry.npmjs.org/strip-literal/-/strip-literal-4.0.0.tgz",
"integrity": "sha512-PaqAvfUZKBwc/SLmNZtHmzK+v19Z4O4eS3cKPeGvbIv/U3pnyEq4Tuw3/4v/FwfM8VQaEawsyCcOQ0P+kpwWWw==",
"dev": true,
"license": "MIT",
"dependencies": {
"js-tokens": "^10.0.0"
},
"funding": {
"url": "https://github.com/sponsors/antfu"
}
},
"node_modules/strip-literal/node_modules/js-tokens": {
"version": "10.0.0",
"resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-10.0.0.tgz",
"integrity": "sha512-lM/UBzQmfJRo9ABXbPWemivdCW8V2G8FHaHdypQaIy523snUjog0W71ayWXTjiR+ixeMyVHN2XcpnTd/liPg/Q==",
"dev": true,
"license": "MIT"
},
"node_modules/superjson": {
"version": "2.2.6",
"resolved": "https://registry.npmjs.org/superjson/-/superjson-2.2.6.tgz",
@ -8744,20 +8716,14 @@
"node": ">=10.13.0"
}
},
"node_modules/three": {
"version": "0.183.2",
"resolved": "https://registry.npmjs.org/three/-/three-0.183.2.tgz",
"integrity": "sha512-di3BsL2FEQ1PA7Hcvn4fyJOlxRRgFYBpMTcyOgkwJIaDOdJMebEFPA+t98EvjuljDx4hNulAGwF6KIjtwI5jgQ==",
"license": "MIT"
},
"node_modules/tinyglobby": {
"version": "0.2.15",
"resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.15.tgz",
"integrity": "sha512-j2Zq4NyQYG5XMST4cbs02Ak8iJUdxRM0XI5QyxXuZOzKOINmWurp3smXu3y5wDcJrptwpSjgXHzIQxR0omXljQ==",
"version": "0.2.17",
"resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.17.tgz",
"integrity": "sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==",
"license": "MIT",
"dependencies": {
"fdir": "^6.5.0",
"picomatch": "^4.0.3"
"picomatch": "^4.0.4"
},
"engines": {
"node": ">=12.0.0"
@ -9104,6 +9070,77 @@
"dev": true,
"license": "MIT"
},
"node_modules/unimport": {
"version": "6.5.0",
"resolved": "https://registry.npmjs.org/unimport/-/unimport-6.5.0.tgz",
"integrity": "sha512-t0KLJLRbebz3f7NrQe+vy2ObeugVeM1XqI2oeYnauddmHSglYj3U6bxOJ65IbXmOFkcAGFJK2OyGH7aqHPM6Ug==",
"dev": true,
"license": "MIT",
"dependencies": {
"acorn": "^8.18.0",
"escape-string-regexp": "^5.0.0",
"estree-walker": "^3.0.3",
"local-pkg": "^1.2.1",
"magic-string": "^1.2.3",
"mlly": "^1.8.2",
"pathe": "^2.0.3",
"picomatch": "^4.0.7",
"pkg-types": "^2.3.3",
"scule": "^1.3.0",
"strip-literal": "^4.0.0",
"tinyglobby": "^0.2.17",
"unplugin": "^3.3.0",
"unplugin-utils": "^0.3.2"
},
"engines": {
"node": ">=18.12.0"
},
"peerDependencies": {
"oxc-parser": "*",
"rolldown": "^1.0.0"
},
"peerDependenciesMeta": {
"oxc-parser": {
"optional": true
},
"rolldown": {
"optional": true
}
}
},
"node_modules/unimport/node_modules/escape-string-regexp": {
"version": "5.0.0",
"resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-5.0.0.tgz",
"integrity": "sha512-/veY75JbMK4j1yjvuUxuVsiS/hr/4iHs9FTT6cgTexxdE0Ly/glccBAkloH/DofkjRbZU3bnoj38mOmhkZ0lHw==",
"dev": true,
"license": "MIT",
"engines": {
"node": ">=12"
},
"funding": {
"url": "https://github.com/sponsors/sindresorhus"
}
},
"node_modules/unimport/node_modules/estree-walker": {
"version": "3.0.3",
"resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-3.0.3.tgz",
"integrity": "sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==",
"dev": true,
"license": "MIT",
"dependencies": {
"@types/estree": "^1.0.0"
}
},
"node_modules/unimport/node_modules/magic-string": {
"version": "1.4.5",
"resolved": "https://registry.npmjs.org/magic-string/-/magic-string-1.4.5.tgz",
"integrity": "sha512-oLLC2+YvQUfAa+vxoufE/yc1icb87M9iXIRqAoR/2EhE/8cb3SF/+Gi0c2By1B+5Vz2e2vQtUvHiu1+63Znh+w==",
"dev": true,
"license": "MIT",
"dependencies": {
"@jridgewell/sourcemap-codec": "^1.6.0"
}
},
"node_modules/union-value": {
"version": "1.0.1",
"resolved": "https://registry.npmjs.org/union-value/-/union-value-1.0.1.tgz",
@ -9131,27 +9168,115 @@
}
},
"node_modules/unplugin": {
"version": "3.0.0",
"resolved": "https://registry.npmjs.org/unplugin/-/unplugin-3.0.0.tgz",
"integrity": "sha512-0Mqk3AT2TZCXWKdcoaufeXNukv2mTrEZExeXlHIOZXdqYoHHr4n51pymnwV8x2BOVxwXbK2HLlI7usrqMpycdg==",
"version": "3.7.0",
"resolved": "https://registry.npmjs.org/unplugin/-/unplugin-3.7.0.tgz",
"integrity": "sha512-GrM2uq3DQo3hvLU2FjeYhooJ8BY9N6j1Fbzgx7Pta3VVJevsD3VP4dPjZkZOS0mLvN8w9zzr9OlP+31bSMyuLw==",
"license": "MIT",
"dependencies": {
"@jridgewell/remapping": "^2.3.5",
"picomatch": "^4.0.3",
"@rolldown/pluginutils": "^1.0.1",
"picomatch": "^4.0.7",
"webpack-virtual-modules": "^0.6.2"
},
"engines": {
"node": "^20.19.0 || >=22.12.0"
},
"peerDependencies": {
"@farmfe/core": "*",
"@rsbuild/core": "*",
"@rspack/core": "*",
"bun-types-no-globals": "*",
"esbuild": "*",
"rolldown": "*",
"rollup": "*",
"unloader": "*",
"vite": "*",
"webpack": "*"
},
"peerDependenciesMeta": {
"@farmfe/core": {
"optional": true
},
"@rsbuild/core": {
"optional": true
},
"@rspack/core": {
"optional": true
},
"bun-types-no-globals": {
"optional": true
},
"esbuild": {
"optional": true
},
"rolldown": {
"optional": true
},
"rollup": {
"optional": true
},
"unloader": {
"optional": true
},
"vite": {
"optional": true
},
"webpack": {
"optional": true
}
}
},
"node_modules/unplugin-auto-import": {
"version": "21.1.0",
"resolved": "https://registry.npmjs.org/unplugin-auto-import/-/unplugin-auto-import-21.1.0.tgz",
"integrity": "sha512-EzrSqWIBulEqCuP7idADXH+tVKYrbwKlR5+r/lOWik0o+Ksny1kitmtryHGNSv7puzzORlcIwT/x2JStiszlHA==",
"dev": true,
"license": "MIT",
"dependencies": {
"local-pkg": "^1.2.1",
"magic-string": "^1.1.0",
"picomatch": "^4.0.5",
"unimport": "^6.4.0",
"unplugin": "^3.3.0",
"unplugin-utils": "^0.3.2"
},
"engines": {
"node": ">=20.19.0"
},
"funding": {
"url": "https://github.com/sponsors/antfu"
},
"peerDependencies": {
"@nuxt/kit": "^4.0.0",
"@vueuse/core": "*"
},
"peerDependenciesMeta": {
"@nuxt/kit": {
"optional": true
},
"@vueuse/core": {
"optional": true
}
}
},
"node_modules/unplugin-auto-import/node_modules/magic-string": {
"version": "1.4.5",
"resolved": "https://registry.npmjs.org/magic-string/-/magic-string-1.4.5.tgz",
"integrity": "sha512-oLLC2+YvQUfAa+vxoufE/yc1icb87M9iXIRqAoR/2EhE/8cb3SF/+Gi0c2By1B+5Vz2e2vQtUvHiu1+63Znh+w==",
"dev": true,
"license": "MIT",
"dependencies": {
"@jridgewell/sourcemap-codec": "^1.6.0"
}
},
"node_modules/unplugin-utils": {
"version": "0.3.1",
"resolved": "https://registry.npmjs.org/unplugin-utils/-/unplugin-utils-0.3.1.tgz",
"integrity": "sha512-5lWVjgi6vuHhJ526bI4nlCOmkCIF3nnfXkCMDeMJrtdvxTs6ZFCM8oNufGTsDbKv/tJ/xj8RpvXjRuPBZJuJog==",
"version": "0.3.2",
"resolved": "https://registry.npmjs.org/unplugin-utils/-/unplugin-utils-0.3.2.tgz",
"integrity": "sha512-xVToRh2CTmLk2HnEG7ac4rl1MJTT3RFkpS8B++/SnB0kXvuaavD+n3m/vrzyWQOdJNSZQACnbz01pnppbwV5BA==",
"license": "MIT",
"dependencies": {
"pathe": "^2.0.3",
"picomatch": "^4.0.3"
"picomatch": "^4.0.4"
},
"engines": {
"node": ">=20.19.0"
@ -9160,6 +9285,45 @@
"url": "https://github.com/sponsors/sxzz"
}
},
"node_modules/unplugin-vue-components": {
"version": "32.1.0",
"resolved": "https://registry.npmjs.org/unplugin-vue-components/-/unplugin-vue-components-32.1.0.tgz",
"integrity": "sha512-YiUkSxuRjab18XFOrX5VsIxXzccrfmHVGsGeJgSgklb829DQmCy9E4vvDUE4tuvZZdxyFJZX0Oc4TPnnxiiMyg==",
"dev": true,
"license": "MIT",
"dependencies": {
"chokidar": "^5.0.0",
"local-pkg": "^1.2.0",
"magic-string": "^0.30.21",
"mlly": "^1.8.2",
"obug": "^2.1.1",
"picomatch": "^4.0.4",
"tinyglobby": "^0.2.16",
"unplugin": "^3.0.0",
"unplugin-utils": "^0.3.1"
},
"engines": {
"node": ">=20.19.0"
},
"funding": {
"url": "https://github.com/sponsors/antfu"
},
"peerDependencies": {
"@nuxt/kit": "^3.2.2 || ^4.0.0",
"vue": "^3.0.0"
},
"peerDependenciesMeta": {
"@nuxt/kit": {
"optional": true
}
}
},
"node_modules/unplugin/node_modules/@rolldown/pluginutils": {
"version": "1.0.1",
"resolved": "https://registry.npmjs.org/@rolldown/pluginutils/-/pluginutils-1.0.1.tgz",
"integrity": "sha512-2j9bGt5Jh8hj+vPtgzPtl72j0yRxHAyumoo6TNfAjsLB04UtpSvPbPcDcBMxz7n+9CYB0c1GxQFxYRg2jimqGw==",
"license": "MIT"
},
"node_modules/unset-value": {
"version": "1.0.0",
"resolved": "https://registry.npmjs.org/unset-value/-/unset-value-1.0.0.tgz",
@ -9315,7 +9479,7 @@
"version": "7.3.1",
"resolved": "https://registry.npmjs.org/vite/-/vite-7.3.1.tgz",
"integrity": "sha512-w+N7Hifpc3gRjZ63vYBXA56dvvRlNWRczTdmCBBa+CotUzAPf5b7YMdMR/8CQoeYE5LX3W4wj6RYTgonm1b9DA==",
"dev": true,
"devOptional": true,
"license": "MIT",
"peer": true,
"dependencies": {

View File

@ -46,7 +46,6 @@
"qrcode": "^1.5.4",
"sortablejs": "^1.15.7",
"spark-md5": "^3.0.2",
"three": "^0.183.2",
"uuid": "^13.0.0",
"vue": "^3.5.29",
"vue-draggable-plus": "^0.6.1",
@ -64,7 +63,6 @@
"@types/qrcode": "^1.5.6",
"@types/sortablejs": "^1.15.9",
"@types/spark-md5": "^3.0.5",
"@types/three": "^0.183.1",
"@vitejs/plugin-vue": "^6.0.4",
"@vue/tsconfig": "^0.8.1",
"eslint": "^10.2.0",
@ -76,6 +74,8 @@
"sass": "^1.97.3",
"typescript": "~5.9.3",
"typescript-eslint": "^8.58.2",
"unplugin-auto-import": "^21.1.0",
"unplugin-vue-components": "^32.1.0",
"vite": "^7.3.1",
"vite-plugin-svg-icons": "^2.0.1",
"vite-plugin-vue-devtools": "^8.0.6",

File diff suppressed because it is too large Load Diff

View File

@ -1,21 +1,22 @@
<!--
SortSettingDialog — 标签排序弹窗(通用)
作用:调整页面顶部多标签页的显示顺序(如把「待处理订单」拖到「待审核订单」前面)
存储:localStorage(key=user_prefs_{userId},scope 由调用方传入,value=tab.name 数组)
设计文档:docs/用户偏好配置-浏览器本地保存方案.md
SortSettingDialog — 单页「标签排序」弹窗(由 TabArea 内置入口调用)
作用:调整当前页面顶部标签的显示顺序,并选择默认打开的标签
存储:由调用方通过 useTabOrder 写入 userPreference 用户级 scope `tabOrder`(按账号,不分仓库)
设计文档:docs/标签排序与默认页签-统一方案.md
用法:
<SortSettingDialog
v-model:visible="visible"
:tabs="DEFAULT_TAB_OPTIONS" // { name, label }[],顺序即默认顺序
:scope="'order.tabs.order'" // 存储 scope,按页面区分
@saved="handleSortSaved" // (order: string[])
:tabs="tabs" // { name, label }[],顺序即默认顺序
:page-key="'order.management'" // 注册表 key(配置键)
@saved="handleSortSaved" // (order: string[], defaultName: string)
/>
-->
<template>
<el-dialog
:model-value="visible"
title="标签排序"
width="520px"
width="560px"
align-center
destroy-on-close
:close-on-click-modal="false"
@ -24,24 +25,14 @@
@closed="handleClosed"
>
<div class="tab-order-tip">
拖动左侧把手调整标签页显示顺序,保存后刷新/重新登录仍生效(按当前账号保存在浏览器本地)。
拖动左侧把手调整标签页显示顺序;右侧圆点选择默认打开的页签。保存后刷新/重新登录仍生效(按当前账号保存在浏览器本地)。
</div>
<VueDraggable
<TabOrderDragList
v-model="orderList"
:animation="180"
handle=".tab-order-handle"
ghost-class="tab-order-ghost"
class="tab-order-list"
>
<div v-for="(tab, idx) in orderList" :key="tab.name" class="tab-order-row">
<span class="tab-order-handle">
<el-icon><Rank /></el-icon>
</span>
<span class="tab-order-index">{{ idx + 1 }}</span>
<span class="tab-order-label">{{ tab.label }}</span>
</div>
</VueDraggable>
v-model:default-name="defaultName"
:can-set-default="orderList.length > 1"
/>
<template #footer>
<el-button size="small" @click="handleClosed">取消</el-button>
@ -53,64 +44,96 @@
<script setup lang="ts">
import { ref, watch } from 'vue'
import { Rank } from '@element-plus/icons-vue'
import { VueDraggable } from 'vue-draggable-plus'
import TabOrderDragList from '@/components/TabOrderDragList.vue'
import { useUserPreferenceStore } from '@/stores/modules/userPreference'
import {
applyTabOrder,
isValidTabName,
normalizeTabOrder,
readTabOrderDoc,
type TabOption
} from '@/utils/tab-order'
defineOptions({ name: 'SortSettingDialog' })
export interface TabOrderOption {
name: string
label: string
}
/** 兼容旧命名 */
export type TabOrderOption = TabOption
const props = defineProps<{
visible: boolean
/** 该页面全部 tab(name + 中文 label),顺序即默认顺序 */
tabs: TabOrderOption[]
/** 存储 scope(如 order.tabs.order / stock.tabs.order) */
scope: string
}>()
const props = withDefaults(
defineProps<{
visible: boolean
/** 该页面全部标签(name + 中文 label),顺序即默认顺序 */
tabs: TabOption[]
/** 排序配置主键(注册表 key,如 order.management) */
pageKey?: string
/** 旧存储 scope(兼容读取,优先从 pageKey 读新文档) */
scope?: string
}>(),
{
pageKey: '',
scope: ''
}
)
const emit = defineEmits<{
(e: 'update:visible', v: boolean): void
(e: 'saved', order: string[]): void
/** 保存:顺序 + 默认标签(持久化由调用方完成,保证单一写入口) */
(e: 'saved', order: string[], defaultName: string): void
}>()
const pref = useUserPreferenceStore()
const orderList = ref<TabOrderOption[]>([])
const orderList = ref<TabOption[]>([])
const defaultName = ref('')
watch(
() => props.visible,
(v) => {
if (!v) return
orderList.value = buildOrderList()
buildOrderList()
}
)
/** 读取已保存顺序;非法项剔除,缺失的 tab 按 props.tabs 补在末尾(防新增 tab 丢项) */
function buildOrderList(): TabOrderOption[] {
const byName = new Map(props.tabs.map((t) => [t.name, t]))
const saved = pref.get(props.scope)
const names = Array.isArray(saved)
? saved.filter((n: unknown) => typeof n === 'string' && byName.has(n))
: []
const result = Array.from(new Set(names)).map((n) => byName.get(n)!)
for (const t of props.tabs) {
if (!result.some((r) => r.name === t.name)) result.push({ ...t })
/** 读取已保存顺序;非法项剔除,缺失的标签按 props.tabs 补在末尾(防新增标签丢项) */
function buildOrderList() {
const doc = readTabOrderDoc()
const key = props.pageKey
let savedOrder: string[] = []
let savedDefault = ''
if (key) {
if (Array.isArray(doc.orders[key]) && doc.orders[key].length) {
savedOrder = doc.orders[key]
}
savedDefault = doc.defaults[key] || ''
}
return result
// 兼容旧 scope(新文档无配置时)
if (!savedOrder.length) {
const scopes = [props.scope].filter(Boolean) as string[]
for (const scope of scopes) {
const value = pref.get(scope) ?? pref.getGlobal(scope)
if (Array.isArray(value) && value.length) {
savedOrder = value as string[]
break
}
}
}
orderList.value = savedOrder.length
? applyTabOrder(savedOrder, props.tabs)
: props.tabs.map((tab) => ({ ...tab }))
defaultName.value = isValidTabName(savedDefault, props.tabs) ? savedDefault : ''
}
function resetOrder() {
orderList.value = props.tabs.map((t) => ({ ...t }))
orderList.value = props.tabs.map((tab) => ({ ...tab }))
defaultName.value = ''
}
function handleSave() {
const names = orderList.value.map((t) => t.name)
pref.set(props.scope, names)
emit('saved', names)
const names = normalizeTabOrder(orderList.value.map((tab) => tab.name), props.tabs)
emit('saved', names, defaultName.value)
handleClosed()
}
@ -126,47 +149,4 @@ function handleClosed() {
margin-bottom: 12px;
line-height: 1.6;
}
.tab-order-list {
max-height: 320px;
overflow: auto;
}
.tab-order-row {
display: flex;
align-items: center;
gap: 10px;
padding: 9px 12px;
margin-bottom: 8px;
border: 1px solid #e8eef7;
border-radius: 6px;
background: #fafbfe;
.tab-order-handle {
cursor: grab;
color: #909399;
display: inline-flex;
&:active {
cursor: grabbing;
}
}
.tab-order-index {
width: 20px;
text-align: center;
font-size: 12px;
color: #909399;
font-weight: 600;
}
.tab-order-label {
font-size: 13px;
color: #303133;
}
}
.tab-order-ghost {
opacity: 0.4;
border-style: dashed;
}
</style>

View File

@ -0,0 +1,293 @@
<!--
TabArea — 页面内多标签页(全局统一组件)
视觉基准:order/orderManagement、order/waveOrder 的卡片式标签
· header 渐变底 #f7fafd → #eef4fb,底部 1px 分隔线
· 标签 34px / 13px / 圆角 8px / 淡蓝卡片底
· 激活态白底 + #2f80ed + 左侧 8px 圆点,并用 1px 白色阴影盖住 header 分隔线
约定:
· 边框/阴影的清除由 src/styles/tab-area.scss 统一负责(border-card 自带外壳)
· 排序入口只在「页签数量 > 1」时渲染,单页签页面不显示
· 排序结果按账号保存在浏览器本地(useUserPreferenceStore),组件内部自行重排,
父组件无需感知顺序变化(用 name 映射内容组件,顺序无关)
用法:
<div class="tab-section">
<TabArea :tabs="tabs" :default-active="activeTab" @tab-change="handleTabChange" />
</div>
-->
<template>
<div
class="tab-area-wrapper"
:class="{ 'has-sort': showSortEntry, 'has-header-action': hasHeaderAction }"
>
<div v-if="showSortEntry" class="tab-sort-entry">
<el-tooltip content="标签排序" placement="bottom">
<el-button class="sort-entry-btn" size="small" link @click="sortDialogVisible = true">
<el-icon><Sort /></el-icon>
</el-button>
</el-tooltip>
</div>
<!-- 右侧操作区(可选):如「刷新角标」按钮、状态 chip -->
<div v-if="hasHeaderAction" class="tab-header-action">
<slot name="header-action" />
</div>
<el-tabs
v-model="activeTab"
tab-position="top"
type="border-card"
class="tab-container"
@tab-change="handleTabChange"
>
<el-tab-pane
v-for="tab in orderedTabs"
:key="tab.name"
:name="tab.name"
:lazy="false"
>
<template #label>
<span class="custom-tab-label">
<!-- 标签内容插槽:优先 label-{name},其次通用 label,最后纯文本 -->
<slot :name="`label-${tab.name}`" :tab="tab">
<slot name="label" :tab="tab">{{ tab.label }}</slot>
</slot>
</span>
</template>
</el-tab-pane>
</el-tabs>
<SortSettingDialog
v-if="showSortEntry"
v-model:visible="sortDialogVisible"
:tabs="props.tabs"
:page-key="pageKeyValue"
@saved="handleSortSaved"
/>
</div>
</template>
<script setup lang="ts">
import { computed, ref, useSlots, watch } from 'vue'
import { useRoute } from 'vue-router'
import { Sort } from '@element-plus/icons-vue'
import SortSettingDialog from '@/components/SortSettingDialog.vue'
import { useTabOrder } from '@/composables/useTabOrder'
import type { TabOption } from '@/utils/tab-order'
defineOptions({ name: 'TabArea' })
export interface TabAreaItem {
name: string
label: string
/** 允许页面携带额外字段(如角标 count),排序只依赖 name */
[key: string]: any
}
const props = withDefaults(
defineProps<{
tabs?: TabAreaItem[]
defaultActive?: string
/** 排序配置主键(注册表 key,如 order.management);缺省时按路由路径生成兜底 key */
pageKey?: string
/** 旧排序 scope(兼容旧调用,作为 legacyScopes 首项读取) */
sortScope?: string
/** 是否显示排序入口(默认显示;单标签页面始终不显示) */
showSort?: boolean
}>(),
{
tabs: () => [],
defaultActive: '',
pageKey: '',
sortScope: '',
showSort: true
}
)
const emit = defineEmits<{
(e: 'tab-change', tabName: string): void
}>()
const slots = useSlots()
const route = useRoute()
/** 右侧操作区插槽是否存在 */
const hasHeaderAction = computed(() => !!slots['header-action'])
/** 排序入口:多标签 + 未显式关闭 */
const showSortEntry = computed(() => props.showSort && props.tabs.length > 1)
/** 排序配置主键:未显式传入时按路由路径兜底(仅用于兼容) */
const pageKeyValue = computed(() => props.pageKey || `route:${route.path}`)
const { orderedTabs, defaultTabName, saveOrder, setDefault, seedLegacyIfNeeded } = useTabOrder(
pageKeyValue,
() => props.tabs as TabOption[],
{
// 兼容:旧 TabArea 用 tab-order:{path},旧内联页面用各自 scope
legacyScopes: () => [props.sortScope, `tab-order:${route.path}`].filter(Boolean) as string[],
// TabArea 不是 UpperTable 的祖先,pageKey 由页面自己 provide
provideKey: false
}
)
const sortDialogVisible = ref(false)
const activeTab = ref(props.defaultActive || defaultTabName.value || props.tabs[0]?.name || '')
function handleTabChange(name: string | number) {
const next = String(name)
if (activeTab.value !== next) activeTab.value = next
emit('tab-change', next)
}
/** 弹窗保存:写顺序 + 默认标签(store 更新后 orderedTabs 立即重排) */
function handleSortSaved(order: string[], defaultName: string) {
saveOrder(order)
setDefault(defaultName)
}
/** 标签集合变化(如权限变化)时补一次旧配置迁移 */
watch(
() => props.tabs.map((t) => t.name).join(','),
() => seedLegacyIfNeeded()
)
</script>
<style lang="scss" scoped>
.tab-area-wrapper {
position: relative;
flex-shrink: 0;
}
/* 标签排序入口(tab 区域左侧) */
.tab-sort-entry {
position: absolute;
top: 4px;
left: 12px;
height: 38px;
display: flex;
align-items: center;
z-index: 2;
.sort-entry-btn {
color: #606266;
font-size: 15px;
padding: 4px 6px;
border-radius: 4px;
transition: all 0.2s;
&:hover {
color: #409eff;
background-color: rgba(64, 158, 255, 0.08);
}
}
}
/* 右侧操作区(可选):与排序入口同一高度,绝对定位覆盖在标签栏右侧 */
.tab-header-action {
position: absolute;
top: 4px;
right: 16px;
height: 38px;
display: flex;
align-items: center;
gap: 8px;
z-index: 2;
}
.tab-container {
display: flex;
flex-direction: column;
/* border-card 自带外壳的清除统一由 src/styles/tab-area.scss 负责 */
:deep(.el-tabs__header) {
margin-bottom: 0;
flex-shrink: 0;
}
:deep(.el-tabs__header.is-top) {
padding: 8px 12px 0;
background: linear-gradient(180deg, #f7fafd 0%, #eef4fb 100%);
border-bottom: 1px solid #e8eef7;
margin: 0;
}
:deep(.el-tabs__nav-wrap::after) {
display: none;
}
:deep(.el-tabs__item.is-top) {
height: 34px;
line-height: 34px;
padding: 0 16px;
border-radius: 8px 8px 0 0;
color: #606266;
font-size: 13px;
font-weight: 500;
transition: all 0.25s cubic-bezier(0.645, 0.045, 0.355, 1);
border: 1px solid #e6edf8;
border-bottom: none;
background: #edf3fb;
margin-right: 6px;
box-shadow: inset 0 -1px 0 rgba(15, 23, 42, 0.03);
}
:deep(.el-tabs__item.is-top:hover) {
color: #409eff;
background-color: rgba(64, 158, 255, 0.06);
border-color: rgba(64, 158, 255, 0.12);
}
:deep(.el-tabs__item.is-top.is-active) {
color: #2f80ed;
font-weight: 600;
background: #ffffff;
border-color: #e8eef7;
/*
第二层阴影向下 1px 纯白,盖住 header 底部的 1px 分隔线,
让激活标签与下方内容区连通(box-shadow 不受标签 overflow:hidden 裁剪)。
*/
box-shadow: 0 -1px 8px rgba(47, 128, 237, 0.08), 0 1px 0 0 #ffffff;
z-index: 1;
position: relative;
&::before {
content: "";
display: inline-block;
width: 8px;
height: 8px;
border-radius: 50%;
background: #2f80ed;
margin-right: 6px;
vertical-align: middle;
flex-shrink: 0;
}
}
:deep(.el-tabs__active-bar) {
display: none;
}
/* 仅展示标签头,内容由页面自己渲染 */
:deep(.el-tabs__content) {
display: none;
}
}
/* 有排序入口时,标签从排序按钮右侧开始 */
.tab-area-wrapper.has-sort {
:deep(.el-tabs__header.is-top) {
padding-left: 46px;
}
}
.custom-tab-label {
display: inline-flex;
align-items: center;
gap: 6px;
}
</style>

View File

@ -0,0 +1,146 @@
<!--
TabOrderDragList — 标签顺序拖拽列表(页面弹窗与「字段设置 → 标签排序」全局面板共用)
用法:
<TabOrderDragList v-model="list" v-model:default-name="defaultName" />
- v-model:标签数组,数组顺序即显示顺序
- v-model:default-name:默认打开的标签 name(单标签页面禁用设置)
-->
<template>
<VueDraggable
v-model="list"
:animation="180"
handle=".tab-order-handle"
ghost-class="tab-order-ghost"
class="tab-order-list"
>
<div
v-for="(tab, idx) in list"
:key="tab.name"
class="tab-order-row"
:class="{ 'is-default': defaultName === tab.name }"
>
<span class="tab-order-handle">
<el-icon><Rank /></el-icon>
</span>
<span class="tab-order-index">{{ idx + 1 }}</span>
<span class="tab-order-label">{{ tab.label }}</span>
<el-tag
v-if="defaultName === tab.name"
size="small"
effect="plain"
class="tab-order-default-tag"
>默认</el-tag>
<el-tooltip
:content="defaultName === tab.name ? '已设为默认打开页签' : '设为默认打开页签'"
placement="left"
>
<el-radio
class="tab-order-default-radio"
:model-value="defaultName"
:value="tab.name"
:disabled="!canSetDefault"
:aria-label="`设为默认页签:${tab.label}`"
@change="handleDefaultChange(tab.name)"
@update:model-value="handleDefaultChange(tab.name)"
/>
</el-tooltip>
</div>
</VueDraggable>
</template>
<script setup lang="ts">
import { computed } from 'vue'
import { Rank } from '@element-plus/icons-vue'
import { VueDraggable } from 'vue-draggable-plus'
import type { TabOption } from '@/utils/tab-order'
defineOptions({ name: 'TabOrderDragList' })
const props = withDefaults(
defineProps<{
modelValue: TabOption[]
defaultName?: string
/** 是否允许设置默认标签(单标签页面禁用) */
canSetDefault?: boolean
}>(),
{
defaultName: '',
canSetDefault: true
}
)
const emit = defineEmits<{
(e: 'update:modelValue', value: TabOption[]): void
(e: 'update:defaultName', value: string): void
}>()
const list = computed<TabOption[]>({
get: () => props.modelValue,
set: (value) => emit('update:modelValue', value)
})
function handleDefaultChange(name: string) {
emit('update:defaultName', name)
}
</script>
<style lang="scss" scoped>
.tab-order-list {
max-height: 380px;
overflow: auto;
}
.tab-order-row {
display: flex;
align-items: center;
gap: 10px;
padding: 9px 12px;
margin-bottom: 8px;
border: 1px solid #e8eef7;
border-radius: 6px;
background: #fafbfe;
&.is-default {
border-color: #c6ddfb;
background: #f2f8ff;
}
.tab-order-handle {
cursor: grab;
color: #909399;
display: inline-flex;
&:active {
cursor: grabbing;
}
}
.tab-order-index {
width: 20px;
text-align: center;
font-size: 12px;
color: #909399;
font-weight: 600;
}
.tab-order-label {
flex: 1;
font-size: 13px;
color: #303133;
}
.tab-order-default-tag {
flex-shrink: 0;
}
.tab-order-default-radio {
margin-right: 0;
}
}
.tab-order-ghost {
opacity: 0.4;
border-style: dashed;
}
</style>

View File

@ -0,0 +1,527 @@
<!--
TabOrderPanel — 全项目标签排序 / 默认页签管理面板(不含弹窗外壳)
用法:
- 设置中心 →「导航 → 标签排序」分区(推荐)
- 需要独立弹窗时可自行包一层 el-dialog
说明:
- 左侧只列出「标签数 ≥ 2」的页面(打开时并行懒加载标签数量)
- 右侧拖拽排序 + 圆点设为默认;标题栏常驻展示当前生效的默认标签
- 保存写入 userPreference 用户级 scope `tabOrder`,页面即时生效
-->
<template>
<div class="tab-order-panel-wrapper">
<div class="tab-order-panel">
<!-- 左侧:页面列表 -->
<div class="panel-left">
<el-input
v-model="keyword"
size="small"
placeholder="搜索页面名称"
clearable
class="panel-search"
/>
<div class="page-groups">
<div v-if="!itemsReady" class="panel-loading">加载中…</div>
<template v-else>
<div v-for="group in filteredGroups" :key="group.name" class="group">
<div class="group-title">{{ group.name }}</div>
<div
v-for="item in group.items"
:key="item.key"
class="page-item"
:class="{
'is-active': item.key === selectedKey,
'is-disabled': item.enabled === false,
'is-current': item.key === effectiveCurrentKey
}"
@click="selectPage(item)"
>
<span class="page-title">
{{ item.title }}
<span v-if="item.key === effectiveCurrentKey" class="current-dot" title="当前页面" />
</span>
<el-tag v-if="item.enabled === false" size="small" type="info" effect="plain">未接入</el-tag>
<el-tag v-else-if="isCustomized(item.key)" size="small" effect="plain">已自定义</el-tag>
</div>
</div>
<el-empty v-if="!filteredGroups.length" description="没有可排序的页面" :image-size="60" />
</template>
</div>
</div>
<!-- 右侧:当前页面的排序/默认设置 -->
<div class="panel-right">
<template v-if="currentItem">
<div class="panel-head">
<div class="panel-head-main">
<span class="current-title">{{ currentItem.title }}</span>
<span class="current-sub">{{ currentTabs.length }} 个标签</span>
</div>
<div class="panel-head-actions">
<span class="current-default">默认:{{ effectiveDefaultLabel }}</span>
<el-button size="small" link @click="resetCurrent">恢复本页默认</el-button>
</div>
</div>
<div v-if="loading" class="panel-loading">加载中…</div>
<template v-else-if="currentTabs.length > 1">
<div class="panel-tip">
拖动左侧把手调整标签顺序,右侧圆点选择打开页面时默认展示的标签。
</div>
<TabOrderDragList
v-model="currentOrder"
v-model:default-name="currentDefault"
:can-set-default="true"
/>
</template>
<div v-else class="panel-loading">
该页面当前只有 1 个标签,暂无需排序。
</div>
</template>
<el-empty v-else description="请从左侧选择一个页面" />
</div>
</div>
<div class="tab-order-actions">
<el-button size="small" @click="resetAll">全部恢复默认</el-button>
<el-button size="small" type="primary" :disabled="!isDirty" @click="handleSave">
保存
</el-button>
</div>
</div>
</template>
<script setup lang="ts">
import { computed, onMounted, reactive, ref } from 'vue'
import { useRoute } from 'vue-router'
import { ElMessage } from 'element-plus'
import TabOrderDragList from '@/components/TabOrderDragList.vue'
import {
TAB_ORDER_GROUPS,
TAB_ORDER_REGISTRY,
matchTabOrderPageKey,
type TabOrderRegistryItem
} from '@/config/tab-order-registry'
import {
applyTabOrder,
isValidTabName,
normalizeTabOrder,
readTabOrderDoc,
writeTabOrderDoc,
type TabOption
} from '@/utils/tab-order'
defineOptions({ name: 'TabOrderPanel' })
const props = withDefaults(
defineProps<{
/** 当前所在页面的注册表 key(用于高亮,可空) */
currentPageKey?: string
}>(),
{ currentPageKey: '' }
)
const keyword = ref('')
const selectedKey = ref('')
const loading = ref(false)
/** 标签数量预加载完成(未完成前不渲染页面列表,避免单标签页面闪入闪出) */
const itemsReady = ref(false)
const route = useRoute()
/** 当前页面 key:优先外部传入,其次按路由路径兜底匹配 */
const effectiveCurrentKey = computed(
() => props.currentPageKey || matchTabOrderPageKey(route.path)
)
/** 页面 key → 已加载的默认标签 */
const tabsCache = reactive<Record<string, TabOption[]>>({})
/** 页面 key → 草稿(顺序 + 默认标签) */
const drafts = reactive<Record<string, { order: TabOption[]; defaultName: string }>>({})
/** 「全部恢复默认」标记:保存时清空整个文档 */
const clearAll = ref(false)
const doc = computed(() => readTabOrderDoc())
const filteredGroups = computed(() => {
const kw = keyword.value.trim().toLowerCase()
return TAB_ORDER_GROUPS.map((name) => ({
name,
items: TAB_ORDER_REGISTRY.filter((item) => {
if (item.group !== name) return false
// 只有 1 个标签的页面无需排序,不展示
const tabs = tabsCache[item.key]
if (!tabs || tabs.length < 2) return false
if (!kw) return true
return item.title.toLowerCase().includes(kw) || item.key.toLowerCase().includes(kw)
})
})).filter((group) => group.items.length > 0)
})
const currentItem = computed(() =>
TAB_ORDER_REGISTRY.find((item) => item.key === selectedKey.value)
)
const currentTabs = computed<TabOption[]>(() => tabsCache[selectedKey.value] || [])
const currentOrder = computed<TabOption[]>({
get: () => drafts[selectedKey.value]?.order || [],
set: (value) => {
const draft = drafts[selectedKey.value]
if (draft) draft.order = value
clearAll.value = false
}
})
/** 页面兜底默认标签:注册表声明 > 默认顺序首个 */
function fallbackDefaultName(key: string): string {
const item = TAB_ORDER_REGISTRY.find((entry) => entry.key === key)
const tabs = tabsCache[key] || []
if (item?.defaultTabName && tabs.some((tab) => tab.name === item.defaultTabName)) {
return item.defaultTabName
}
return tabs[0]?.name || ''
}
/** 当前生效的默认标签:用户已设置 > 页面兜底(便于未设置时也能看出默认是哪个) */
const effectiveDefaultName = computed(() => {
const key = selectedKey.value
if (!key) return ''
return drafts[key]?.defaultName || fallbackDefaultName(key)
})
const effectiveDefaultLabel = computed(() => {
const name = effectiveDefaultName.value
return currentTabs.value.find((tab) => tab.name === name)?.label || '—'
})
const currentDefault = computed<string>({
get: () => effectiveDefaultName.value,
set: (value) => {
const draft = drafts[selectedKey.value]
if (draft) draft.defaultName = value || ''
clearAll.value = false
}
})
/** 是否已有自定义配置(用于列表标注) */
function isCustomized(key: string): boolean {
return !!doc.value.orders[key]?.length || !!doc.value.defaults[key]
}
function sameOrder(a: string[], b: string[]): boolean {
return a.length === b.length && a.every((name, index) => name === b[index])
}
function isPageDirty(key: string): boolean {
const draft = drafts[key]
const tabs = tabsCache[key]
if (!draft || !tabs) return false
const names = draft.order.map((tab) => tab.name)
const savedNames = normalizeTabOrder(doc.value.orders[key], tabs)
return (
!sameOrder(names, savedNames) || draft.defaultName !== (doc.value.defaults[key] || '')
)
}
const isDirty = computed(
() => clearAll.value || Object.keys(drafts).some((key) => isPageDirty(key))
)
function initDraft(item: TabOrderRegistryItem, tabs: TabOption[]) {
const savedOrder = doc.value.orders[item.key]
const order = savedOrder?.length ? applyTabOrder(savedOrder, tabs) : tabs.map((tab) => ({ ...tab }))
const savedDefault = doc.value.defaults[item.key] || ''
drafts[item.key] = {
order,
defaultName: isValidTabName(savedDefault, tabs) ? savedDefault : ''
}
}
async function ensureTabs(item: TabOrderRegistryItem) {
if (tabsCache[item.key]) return tabsCache[item.key]
loading.value = true
try {
const tabs = await item.loadTabs()
tabsCache[item.key] = tabs
initDraft(item, tabs)
return tabs
} catch (error) {
console.error('[TabOrderPanel] loadTabs failed:', item.key, error)
tabsCache[item.key] = []
drafts[item.key] = { order: [], defaultName: '' }
return []
} finally {
loading.value = false
}
}
async function loadAllTabs() {
await Promise.all(
TAB_ORDER_REGISTRY.map(async (item) => {
if (tabsCache[item.key]) return
try {
const tabs = await item.loadTabs()
tabsCache[item.key] = tabs
initDraft(item, tabs)
} catch (error) {
console.error('[TabOrderPanel] loadTabs failed:', item.key, error)
tabsCache[item.key] = []
}
})
)
}
async function selectPage(item: TabOrderRegistryItem) {
if (item.enabled === false) return
selectedKey.value = item.key
await ensureTabs(item)
}
function resetCurrent() {
const item = currentItem.value
const tabs = tabsCache[selectedKey.value]
if (!item || !tabs) return
drafts[item.key] = {
order: tabs.map((tab) => ({ ...tab })),
defaultName: ''
}
clearAll.value = false
}
function resetAll() {
Object.keys(drafts).forEach((key) => {
const tabs = tabsCache[key]
drafts[key] = {
order: (tabs || []).map((tab) => ({ ...tab })),
defaultName: ''
}
})
clearAll.value = true
}
async function initialize() {
keyword.value = ''
clearAll.value = false
itemsReady.value = false
Object.keys(drafts).forEach((key) => delete drafts[key])
Object.keys(tabsCache).forEach((key) => delete tabsCache[key])
await loadAllTabs()
itemsReady.value = true
const isSortable = (item: TabOrderRegistryItem) =>
item.enabled !== false && (tabsCache[item.key]?.length || 0) > 1
const preferred = TAB_ORDER_REGISTRY.find(
(item) => item.key === effectiveCurrentKey.value && isSortable(item)
)
const fallback = TAB_ORDER_REGISTRY.find(isSortable)
const target = preferred || fallback
if (target) {
await selectPage(target)
} else {
selectedKey.value = ''
}
}
function handleSave() {
const base = readTabOrderDoc()
const orders: Record<string, string[]> = clearAll.value ? {} : { ...base.orders }
const defaults: Record<string, string> = clearAll.value ? {} : { ...base.defaults }
Object.keys(drafts).forEach((key) => {
const draft = drafts[key]
const tabs = tabsCache[key]
if (!draft || !tabs || !tabs.length) return
const names = draft.order.map((tab) => tab.name)
const defaultNames = tabs.map((tab) => tab.name)
if (sameOrder(names, defaultNames)) {
delete orders[key]
} else {
orders[key] = normalizeTabOrder(names, tabs)
}
if (draft.defaultName) {
defaults[key] = draft.defaultName
} else {
delete defaults[key]
}
})
writeTabOrderDoc({ version: 1, orders, defaults })
ElMessage.success('标签排序已保存,页面已即时生效')
clearAll.value = false
// 保存后以最新文档刷新草稿基线,避免「保存」按钮持续可用
Object.keys(tabsCache).forEach((key) => {
const item = TAB_ORDER_REGISTRY.find((entry) => entry.key === key)
if (item && tabsCache[key]?.length) initDraft(item, tabsCache[key]!)
})
}
onMounted(() => {
void initialize()
})
</script>
<style lang="scss" scoped>
.tab-order-panel-wrapper {
display: flex;
flex-direction: column;
height: 100%;
min-height: 0;
}
.tab-order-panel {
display: flex;
gap: 16px;
flex: 1;
min-height: 0;
}
.panel-left {
width: 260px;
flex-shrink: 0;
display: flex;
flex-direction: column;
border-right: 1px solid #e8eef7;
padding-right: 12px;
}
.panel-search {
margin-bottom: 8px;
}
.page-groups {
flex: 1;
overflow: auto;
}
.group + .group {
margin-top: 10px;
}
.group-title {
font-size: 12px;
color: #909399;
padding: 4px 8px;
font-weight: 600;
}
.page-item {
display: flex;
align-items: center;
justify-content: space-between;
gap: 8px;
min-height: 32px;
padding: 0 10px;
border-radius: 4px;
font-size: 13px;
color: #606266;
cursor: pointer;
transition: background-color 0.2s, color 0.2s;
&:hover {
background: #f5f7fa;
}
&.is-active {
background: #ecf5ff;
color: #409eff;
font-weight: 600;
}
&.is-disabled {
color: #c0c4cc;
cursor: not-allowed;
&:hover {
background: transparent;
}
}
.page-title {
display: inline-flex;
align-items: center;
gap: 6px;
min-width: 0;
}
.current-dot {
width: 6px;
height: 6px;
border-radius: 50%;
background: #2f80ed;
flex-shrink: 0;
}
}
.panel-right {
flex: 1;
min-width: 0;
display: flex;
flex-direction: column;
}
.panel-head {
display: flex;
align-items: center;
justify-content: space-between;
margin-bottom: 8px;
.panel-head-main {
display: flex;
align-items: baseline;
gap: 8px;
}
.current-title {
font-size: 14px;
font-weight: 600;
color: #303133;
}
.current-sub {
font-size: 12px;
color: #909399;
}
.panel-head-actions {
display: flex;
align-items: center;
gap: 10px;
}
.current-default {
font-size: 12px;
color: #2f80ed;
background: rgba(47, 128, 237, 0.08);
border-radius: 10px;
padding: 2px 10px;
line-height: 18px;
}
}
.panel-tip {
font-size: 12px;
color: #909399;
line-height: 1.6;
margin-bottom: 10px;
}
.panel-loading {
padding: 40px 0;
text-align: center;
font-size: 13px;
color: #909399;
}
.tab-order-actions {
display: flex;
justify-content: flex-end;
gap: 8px;
padding-top: 12px;
margin-top: 8px;
border-top: 1px solid #e8eef7;
}
</style>

View File

@ -0,0 +1,414 @@
<template>
<div ref="containerRef" class="order-toolbar-button-group" :class="{ 'order-toolbar-button-group--tile': isTileMode }">
<div ref="mainRef" class="order-toolbar-button-group__main">
<template v-for="button in displayButtons" :key="button.key">
<el-dropdown
v-if="button.buttonType === 'dropdown' && button.dropdownOptions?.length"
trigger="click"
split-button
:size="button.size || 'small'"
:type="resolveButtonStyle(button).type"
:plain="resolveButtonStyle(button).plain"
:disabled="resolveDisabled(button.disabledKey) || resolveLoading(button.loadingKey)"
@click="emitAction(button.action)"
@command="emitAction"
>
{{ resolveLabel(button.label, button.dynamicLabelKey) }}
<template #dropdown>
<el-dropdown-menu>
<el-dropdown-item
v-for="option in button.dropdownOptions"
:key="option.action"
:command="option.action"
:divided="option.divided"
>
{{ option.label }}
</el-dropdown-item>
</el-dropdown-menu>
</template>
</el-dropdown>
<el-button
v-else
:size="button.size || 'small'"
:type="resolveButtonStyle(button).type"
:plain="resolveButtonStyle(button).plain"
:disabled="resolveDisabled(button.disabledKey)"
:loading="resolveLoading(button.loadingKey)"
@click="emitAction(button.action)"
>
{{ resolveLabel(button.label, button.dynamicLabelKey) }}
</el-button>
</template>
<el-popover
v-if="!isTileMode && overflowButtons.length"
v-model:visible="expandVisible"
placement="bottom-start"
:width="172"
trigger="click"
popper-class="order-toolbar-button-group__popover"
>
<template #reference>
<el-button size="small" :type="expandVisible ? 'primary' : 'default'" plain>
展开{{ overflowButtons.length ? `(${overflowButtons.length})` : '' }}
</el-button>
</template>
<div class="order-toolbar-button-group__overflow-list">
<template v-for="button in overflowButtons" :key="`overflow-${button.key}`">
<template v-if="button.buttonType === 'dropdown' && button.dropdownOptions?.length">
<el-button
v-for="option in button.dropdownOptions"
:key="`overflow-${button.key}-${option.action}`"
:size="button.size || 'small'"
:type="resolveButtonStyle(button).type"
:plain="resolveButtonStyle(button).plain"
:disabled="resolveDisabled(button.disabledKey)"
:loading="resolveLoading(button.loadingKey)"
class="order-toolbar-button-group__overflow-item"
@click="handleOverflowClick(option.action)"
>
{{ resolveLabel(button.label, button.dynamicLabelKey) }} · {{ option.label }}
</el-button>
</template>
<el-button
v-else
:size="button.size || 'small'"
:type="resolveButtonStyle(button).type"
:plain="resolveButtonStyle(button).plain"
:disabled="resolveDisabled(button.disabledKey)"
:loading="resolveLoading(button.loadingKey)"
class="order-toolbar-button-group__overflow-item"
@click="handleOverflowClick(button.action)"
>
{{ resolveLabel(button.label, button.dynamicLabelKey) }}
</el-button>
</template>
</div>
</el-popover>
</div>
<div class="order-toolbar-button-group__mode-toggle" @click="toggleToolbarMode">
<el-tooltip :content="isTileMode ? '切换到折叠模式' : '切换到平铺模式'" placement="bottom">
<el-icon :size="14"><Grid v-if="isTileMode" /><Fold v-else /></el-icon>
</el-tooltip>
</div>
</div>
</template>
<script setup lang="ts">
import { computed, nextTick, onBeforeUnmount, onMounted, ref, watch } from 'vue'
import type { ToolbarButtonConfig } from './types'
import { useSettingsStore } from '@/stores/modules/settings'
import { Grid, Fold } from '@element-plus/icons-vue'
const props = defineProps<{
buttons: ToolbarButtonConfig[]
resolveDisabled: (disabledKey?: string) => boolean
resolveLoading: (loadingKey?: string) => boolean
resolveLabel: (defaultLabel: string, dynamicLabelKey?: string) => string
layoutKey?: string | number
}>()
const emit = defineEmits<{
(e: 'action', action: ToolbarButtonConfig['action']): void
}>()
const settingsStore = useSettingsStore()
const isTileMode = computed(() => settingsStore.toolbarMode !== 'collapse')
const displayButtons = computed(() => isTileMode.value ? props.buttons : visibleButtons.value)
const toggleToolbarMode = () => {
settingsStore.changeSetting({
key: 'toolbarMode',
value: isTileMode.value ? 'collapse' : 'tile'
})
}
const containerRef = ref<HTMLElement | null>(null)
const mainRef = ref<HTMLElement | null>(null)
const visibleButtons = ref<ToolbarButtonConfig[]>([])
const overflowButtons = ref<ToolbarButtonConfig[]>([])
const expandVisible = ref(false)
let resizeObserver: ResizeObserver | null = null
let layoutFrame = 0
function emitAction(action: ToolbarButtonConfig['action']) {
emit('action', action)
}
/** 按钮 key → 强制样式覆盖,仅用于跨视图统一特定按钮样式 */
const BUTTON_STYLE_OVERRIDE: Record<string, { type: string; plain: boolean }> = {
// 各视图通过 category + type 自行控制样式
}
/** 根据 category 或 type/plain 解析按钮样式 */
function resolveButtonStyle(button: ToolbarButtonConfig): { type: string; plain: boolean } {
// 优先检查强制覆盖
const override = BUTTON_STYLE_OVERRIDE[button.key]
if (override) return override
switch (button.category) {
case 'refresh': return { type: 'primary', plain: false }
case 'setting': return { type: 'default', plain: false }
case 'action':
if (button.type) return { type: button.type, plain: false }
return { type: 'primary', plain: true }
case 'cancel': return { type: 'danger', plain: true }
default: return { type: button.type || 'default', plain: !!button.plain }
}
}
function handleOverflowClick(action: ToolbarButtonConfig['action']) {
expandVisible.value = false
emitAction(action)
}
function isMainOverflowing() {
const mainEl = mainRef.value
if (!mainEl) return false
return mainEl.scrollWidth > mainEl.clientWidth + 1
}
async function trimVisibleUntilFits() {
const buttons = props.buttons
if (!buttons.length) {
visibleButtons.value = []
overflowButtons.value = []
return
}
visibleButtons.value = [...buttons]
overflowButtons.value = []
await nextTick()
let guard = 0
while (isMainOverflowing() && visibleButtons.value.length > 0 && guard < buttons.length + 1) {
guard += 1
const removed = visibleButtons.value.pop()
if (!removed) break
overflowButtons.value.unshift(removed)
await nextTick()
}
if (!visibleButtons.value.length && overflowButtons.value.length) {
const first = overflowButtons.value[0]
if (!first) return
visibleButtons.value = [first]
overflowButtons.value = overflowButtons.value.slice(1)
await nextTick()
while (isMainOverflowing() && visibleButtons.value.length > 0 && overflowButtons.value.length > 0 && guard < buttons.length + 2) {
guard += 1
const removed = visibleButtons.value.pop()
if (!removed) break
overflowButtons.value.unshift(removed)
await nextTick()
}
}
}
async function scheduleLayout() {
// 平铺模式不需要溢出检测
if (isTileMode.value) return
const frame = ++layoutFrame
await nextTick()
if (frame !== layoutFrame) return
await trimVisibleUntilFits()
}
function setupResizeObserver() {
resizeObserver?.disconnect()
resizeObserver = new ResizeObserver(() => {
void scheduleLayout()
})
const parent = containerRef.value?.parentElement
if (parent) resizeObserver.observe(parent)
if (containerRef.value) resizeObserver.observe(containerRef.value)
if (mainRef.value) resizeObserver.observe(mainRef.value)
}
onMounted(() => {
visibleButtons.value = [...props.buttons]
setupResizeObserver()
void scheduleLayout()
})
onBeforeUnmount(() => {
resizeObserver?.disconnect()
resizeObserver = null
})
watch(
() => [props.buttons, props.layoutKey],
() => {
void scheduleLayout()
},
{ deep: true }
)
// 模式切换时重新布局
watch(isTileMode, () => {
if (!isTileMode.value) {
visibleButtons.value = [...props.buttons]
void scheduleLayout()
}
})
</script>
<style scoped lang="scss">
.order-toolbar-button-group {
position: relative;
display: flex;
align-items: flex-start;
flex: 1;
width: 100%;
max-width: 100%;
min-width: 0;
overflow: hidden;
gap: 6px;
}
.order-toolbar-button-group--tile {
overflow: visible;
}
.order-toolbar-button-group__main {
display: flex;
align-items: center;
gap: 6px;
width: 100%;
max-width: 100%;
min-width: 0;
overflow: hidden;
flex-wrap: nowrap;
}
.order-toolbar-button-group--tile .order-toolbar-button-group__main {
overflow: visible;
flex-wrap: wrap;
align-items: flex-start;
align-content: flex-start;
padding-right: 30px;
}
/* 平铺模式下切换按钮绝对定位到右上角,不参与按钮流 */
.order-toolbar-button-group--tile .order-toolbar-button-group__mode-toggle {
position: absolute;
top: 0;
right: 0;
margin-left: 0;
}
.order-toolbar-button-group__main :deep(.el-dropdown) {
flex-shrink: 0;
}
/* 清除 Element Plus 默认 .el-button + .el-button 左边距,
换行时每行首个按钮不会多出间隙,统一由 gap 控制等间距 */
.order-toolbar-button-group__main :deep(.el-button),
.order-toolbar-button-group__main :deep(.el-dropdown) {
margin-left: 0;
margin-right: 0;
}
.order-toolbar-button-group__overflow-list {
display: flex;
flex-direction: column;
gap: 8px;
}
.order-toolbar-button-group__overflow-item {
width: 100%;
margin: 0;
justify-content: flex-start;
}
.order-toolbar-button-group__mode-toggle {
display: flex;
align-items: center;
justify-content: center;
width: 24px;
min-width: 24px;
height: 24px;
border-radius: 4px;
background: #e8e8e8;
cursor: pointer;
color: #909399;
transition: all 0.3s;
flex-shrink: 0;
margin-left: auto;
&:hover {
background: #d0d0d0;
color: #409EFF;
}
}
/* 禁用按钮样式优化:保持字体颜色可读,背景极浅区分状态 */
.order-toolbar-button-group__main :deep(.el-button.is-disabled),
.order-toolbar-button-group__main :deep(.el-button.is-disabled:hover),
.order-toolbar-button-group__main :deep(.el-button.is-disabled:focus),
.order-toolbar-button-group__main :deep(.el-button.is-disabled:active) {
color: #606266;
background-color: #fafbfc;
border-color: #ebeef5;
}
/* primary 禁用:保持蓝字可见,极浅蓝背景 */
.order-toolbar-button-group__main :deep(.el-button--primary.is-disabled),
.order-toolbar-button-group__main :deep(.el-button--primary.is-disabled:hover),
.order-toolbar-button-group__main :deep(.el-button--primary.is-disabled:focus),
.order-toolbar-button-group__main :deep(.el-button--primary.is-disabled:active) {
color: #409eff;
background-color: #f5faff;
border-color: #e4efff;
}
/* primary + plain 禁用:白底蓝字 */
.order-toolbar-button-group__main :deep(.el-button--primary.is-plain.is-disabled),
.order-toolbar-button-group__main :deep(.el-button--primary.is-plain.is-disabled:hover),
.order-toolbar-button-group__main :deep(.el-button--primary.is-plain.is-disabled:focus),
.order-toolbar-button-group__main :deep(.el-button--primary.is-plain.is-disabled:active) {
color: #409eff;
background-color: #fff;
border-color: #409eff;
}
/* danger 禁用:白底红字 */
.order-toolbar-button-group__main :deep(.el-button--danger.is-disabled),
.order-toolbar-button-group__main :deep(.el-button--danger.is-disabled:hover),
.order-toolbar-button-group__main :deep(.el-button--danger.is-disabled:focus),
.order-toolbar-button-group__main :deep(.el-button--danger.is-disabled:active) {
color: #f56c6c;
background-color: #fff;
border-color: #f56c6c;
}
/* 溢出列表中的 disabled 按钮同样适用 */
.order-toolbar-button-group__overflow-list :deep(.el-button--primary.is-plain.is-disabled),
.order-toolbar-button-group__overflow-list :deep(.el-button--primary.is-plain.is-disabled:hover),
.order-toolbar-button-group__overflow-list :deep(.el-button--primary.is-plain.is-disabled:focus),
.order-toolbar-button-group__overflow-list :deep(.el-button--primary.is-plain.is-disabled:active) {
color: #409eff;
background-color: #fff;
border-color: #409eff;
}
.order-toolbar-button-group__overflow-list :deep(.el-button--danger.is-disabled),
.order-toolbar-button-group__overflow-list :deep(.el-button--danger.is-disabled:hover),
.order-toolbar-button-group__overflow-list :deep(.el-button--danger.is-disabled:focus),
.order-toolbar-button-group__overflow-list :deep(.el-button--danger.is-disabled:active) {
color: #f56c6c;
background-color: #fff;
border-color: #f56c6c;
}
</style>
<style lang="scss">
.order-toolbar-button-group__popover {
padding: 10px !important;
}
</style>

View File

@ -0,0 +1,38 @@
/**
* 工具栏按钮组配置类型
*
* 从 `views/order/orderManagement/config/order-common-config.ts` 抽离,
* 供 `@/components/ToolbarButtonGroup` 与各页面 `*-config.ts` 共用。
*/
export interface ToolbarButtonConfig {
key: string
label: string
dynamicLabelKey?: string
size?: '' | 'default' | 'small' | 'large'
type?: '' | 'primary' | 'success' | 'warning' | 'info' | 'danger'
plain?: boolean
loadingKey?: string
disabledKey?: string
action: string
/** 按钮样式分类(优先级高于 type/plain):
* 'refresh' - 蓝底白字(primary)
* 'setting' - 白底黑字(default)
* 'action' - 白底蓝边框蓝字(primary + plain)
* 'cancel' - 红底白字(danger)
* 不设置则沿用 type/plain */
category?: 'refresh' | 'setting' | 'action' | 'cancel'
/** 下拉按钮:主按钮点击 action,菜单项使用 dropdownOptions[].action */
buttonType?: 'default' | 'dropdown'
dropdownOptions?: Array<{ label: string; action: string; divided?: boolean }>
}
export interface ToolbarApiActionConfig {
action: string
apiMethod: string
payloadKey?: string
confirmText?: string
confirmType?: 'warning' | 'error' | 'info' | 'success'
successText: string
failText: string
}

View File

@ -1,293 +0,0 @@
<!--
更多设置表单
- 由 UpperTable「字段设置」中的「更多设置」按钮打开
- 表格工作模式(原字段设置工具栏内嵌的 radio,迁移至此)
- 界面显示(浏览器 localStorage 持久化选项:Scan-box 模式 / 工具栏按钮模式 / 快捷键区域)
- 页面缓存 / tab 缓存分类(开关 / 最大缓存数量)
- 存储:experimental_{userId}_{roleId}(experimental store)、settings_{userId}_{roleId}(settings store)
-->
<template>
<el-dialog
v-model="dialogVisible"
title="更多设置"
width="600px"
align-center
append-to-body
class="more-settings-dialog"
>
<!-- ===== 表格工作模式 ===== -->
<div class="more-section">
<div class="more-section-title">表格工作模式</div>
<div class="more-section-desc">调整大列表表格的渲染调度策略</div>
<div class="more-setting-row">
<el-radio-group v-model="tableMode" size="small" @change="handleTableModeChange">
<el-radio-button value="resource">低占用(默认)</el-radio-button>
<el-radio-button value="performance">高性能</el-radio-button>
</el-radio-group>
</div>
</div>
<el-divider />
<!-- ===== 界面显示(浏览器持久化选项) ===== -->
<div class="more-section">
<div class="more-section-title">界面显示</div>
<div class="more-section-desc">
以下选项保存在当前浏览器,仅影响本机显示,换电脑需重新设置
</div>
<div class="more-setting-row">
<span class="setting-label">Scan-box 显示模式</span>
<el-radio-group v-model="scanBoxMode" size="small">
<el-radio-button value="compact">紧凑(默认)</el-radio-button>
<el-radio-button value="standard">标准</el-radio-button>
</el-radio-group>
<span class="setting-hint">紧凑模式行高更小,一屏显示更多筛选条件</span>
</div>
<div class="more-setting-row">
<span class="setting-label">工具栏按钮模式</span>
<el-radio-group v-model="toolbarMode" size="small">
<el-radio-button value="tile">平铺(默认)</el-radio-button>
<el-radio-button value="collapse">折叠</el-radio-button>
</el-radio-group>
<span class="setting-hint">订单工具栏按钮组的排列方式</span>
</div>
<div class="more-setting-row">
<span class="setting-label">快捷键区域</span>
<el-switch v-model="shortcutExpanded" />
<span class="setting-hint">展开顶部快捷键面板(默认收起)</span>
</div>
</div>
<el-divider />
<!-- ===== 页面缓存分类 ===== -->
<div class="more-section">
<div class="more-section-title">页面缓存</div>
<div class="more-section-desc">控制通过顶部导航栏 / 页面 tab 切换的路由页面缓存策略</div>
<div class="more-setting-row">
<span class="setting-label">页面缓存</span>
<el-switch v-model="pageCacheEnabled" @change="handlePageCacheEnabledChange" />
</div>
<div class="more-setting-row">
<span class="setting-label">最大缓存页面数量</span>
<el-input-number
:model-value="pageCacheMax"
:min="1"
:max="50"
size="small"
:disabled="!pageCacheEnabled"
@change="handlePageCacheMaxChange"
/>
<span class="setting-hint">超出后淘汰最久未使用的页面</span>
</div>
</div>
<el-divider />
<!-- ===== tab 缓存分类 ===== -->
<div class="more-section">
<div class="more-section-title">tab 缓存</div>
<div class="more-section-desc">控制含 tab 标签页切换功能页面的 KeepAlive 缓存策略</div>
<div class="more-setting-row">
<span class="setting-label">tab 缓存</span>
<el-switch v-model="tabCacheEnabled" @change="handleTabCacheEnabledChange" />
</div>
<div class="more-setting-row">
<span class="setting-label">最大缓存 tab 数量</span>
<el-input-number
:model-value="tabCacheMax"
:min="1"
:max="20"
size="small"
:disabled="!tabCacheEnabled"
@change="handleTabCacheMaxChange"
/>
<span class="setting-hint">超出后淘汰最久未使用的 tab</span>
</div>
</div>
<template #footer>
<el-button size="small" type="danger" plain @click="handleResetDefaults">恢复默认</el-button>
<el-button size="small" @click="dialogVisible = false">关闭</el-button>
</template>
</el-dialog>
</template>
<script setup lang="ts">
import { computed } from 'vue'
import { ElMessage, ElMessageBox } from 'element-plus'
import { useExperimentalStore } from '@/stores/modules/experimental'
import { useSettingsStore } from '@/stores/modules/settings'
const visible = defineModel<boolean>('visible', { default: false })
const dialogVisible = computed({
get: () => visible.value,
set: (val: boolean) => {
visible.value = val
}
})
const experimentalStore = useExperimentalStore()
const settingsStore = useSettingsStore()
const tableMode = computed({
get: () => experimentalStore.tableMode,
set: (mode: 'performance' | 'resource') => {
experimentalStore.setTableMode(mode)
}
})
/* ===== 界面显示(浏览器持久化:settings store → localStorage settings_{userId}_{roleId}) ===== */
/** Scan-box 显示模式:standard=标准 / compact=紧凑 */
const scanBoxMode = computed({
get: () => settingsStore.scanBoxMode,
set: (mode: 'standard' | 'compact') => {
settingsStore.changeSetting({ key: 'scanBoxMode', value: mode })
}
})
/** 工具栏按钮组显示模式:tile=平铺 / collapse=折叠 */
const toolbarMode = computed({
get: () => settingsStore.toolbarMode,
set: (mode: 'tile' | 'collapse') => {
settingsStore.changeSetting({ key: 'toolbarMode', value: mode })
}
})
/** 顶部快捷键区域是否展开 */
const shortcutExpanded = computed({
get: () => settingsStore.shortcutExpanded,
set: (expanded: boolean) => {
settingsStore.changeSetting({ key: 'shortcutExpanded', value: expanded })
}
})
const tabCacheEnabled = computed({
get: () => experimentalStore.tabCacheEnabled,
set: (val: boolean) => {
experimentalStore.setTabCacheEnabled(val)
}
})
const tabCacheMax = computed({
get: () => experimentalStore.tabCacheMax,
set: (val: number | undefined) => {
experimentalStore.setTabCacheMax(Number(val ?? 1))
}
})
const pageCacheEnabled = computed({
get: () => experimentalStore.pageCacheEnabled,
set: (val: boolean) => {
experimentalStore.setPageCacheEnabled(val)
}
})
const pageCacheMax = computed({
get: () => experimentalStore.pageCacheMax,
set: (val: number | undefined) => {
experimentalStore.setPageCacheMax(Number(val ?? 1))
}
})
function handleTableModeChange(mode: 'performance' | 'resource') {
experimentalStore.setTableMode(mode)
}
function handleTabCacheEnabledChange(val: boolean | string | number) {
experimentalStore.setTabCacheEnabled(Boolean(val))
}
function handleTabCacheMaxChange(val: number | undefined) {
experimentalStore.setTabCacheMax(Number(val ?? 1))
}
function handlePageCacheEnabledChange(val: boolean | string | number) {
experimentalStore.setPageCacheEnabled(Boolean(val))
}
function handlePageCacheMaxChange(val: number | undefined) {
experimentalStore.setPageCacheMax(Number(val ?? 1))
}
/** 恢复全部设置为默认配置(表格工作模式 / 界面显示 / 页面缓存 / tab 缓存) */
function handleResetDefaults() {
ElMessageBox.confirm(
'确定恢复全部设置为默认配置吗?表格工作模式、界面显示(Scan-box 模式 / 工具栏按钮模式 / 快捷键区域)、页面缓存、tab 缓存都将恢复默认。',
'恢复默认',
{
type: 'warning',
confirmButtonText: '恢复',
cancelButtonText: '取消'
}
)
.then(() => {
experimentalStore.resetToDefaults()
settingsStore.resetDisplaySettings()
ElMessage.success('已恢复默认配置')
})
.catch(() => {})
}
</script>
<style scoped lang="scss">
.more-settings-dialog {
/* 固定高度 + 内部滚动:表单不随内容拉伸,超出部分滚动查看 */
:deep(.el-dialog__body) {
height: 400px;
max-height: 60vh;
overflow-y: auto;
overflow-x: hidden;
}
.more-section {
display: flex;
flex-direction: column;
gap: 8px;
.more-section-title {
font-size: 14px;
font-weight: 600;
color: #303133;
}
.more-section-desc {
font-size: 12px;
color: #909399;
margin-bottom: 4px;
}
}
.more-setting-row {
display: flex;
align-items: center;
gap: 12px;
min-height: 32px;
.setting-label {
flex-shrink: 0;
width: 128px;
font-size: 13px;
color: #606266;
}
.setting-hint {
font-size: 12px;
color: #909399;
}
}
:deep(.el-divider--horizontal) {
margin: 16px 0;
}
}
</style>

File diff suppressed because it is too large Load Diff

View File

@ -0,0 +1,360 @@
<!--
SettingsDialog — 设置中心(项目内所有"本机可修改配置"的总入口)
入口:
1. 列表页工具栏「字段设置」→ initialSection = 'field'(由 UpperTable 通过 #field-section 注入内容)
2. Navbar 头像下拉「设置」→ 无表上下文,自动隐藏「当前页面」分组
约定:
· 所有分区即时生效(各自写对应 store),不提供全局保存/取消
· 分区元数据见 ./registry.ts;新增设置 = 注册一条 + 新建 section 组件
-->
<template>
<el-dialog
:model-value="visible"
class="settings-dialog"
width="1280px"
align-center
append-to-body
destroy-on-close
:show-close="false"
:close-on-click-modal="false"
@update:model-value="(v: boolean) => emit('update:visible', v)"
>
<div class="settings-shell">
<!-- 头部(对齐 task-panel:18px 标题 + 12px 说明 + 24px 关闭) -->
<header class="task-panel__head">
<div class="task-panel__titles">
<h2>设置</h2>
<p>当前账号 · 仅保存在本机浏览器</p>
</div>
<button class="task-panel__close" type="button" aria-label="关闭" @click="handleClose">
<svg viewBox="0 0 12 12" fill="none">
<path
d="M1 1L11 11M11 1L1 11"
stroke="currentColor"
stroke-width="1.4"
stroke-linecap="round"
/>
</svg>
</button>
</header>
<!-- 主体:左导航 + 右内容 -->
<div class="settings-body">
<aside class="settings-nav">
<el-input
v-model="keyword"
size="small"
placeholder="搜索设置项"
clearable
class="settings-search"
/>
<div class="settings-nav-list">
<template v-for="group in groups" :key="group.name">
<div v-if="group.items.length" class="settings-group">
<!-- 单条目且条目名与分组名相同(如「基础设置」)时不重复显示分组标题 -->
<div v-if="!isSingleSelfNamedGroup(group)" class="settings-group-title">
{{ group.name }}
</div>
<div
v-for="item in group.items"
:key="item.key"
class="settings-nav-item"
:class="{ 'is-active': item.key === currentKey }"
@click="currentKey = item.key"
>
<span class="settings-nav-title">{{ item.title }}</span>
<span v-if="item.scopeLabel" class="settings-nav-scope">{{ item.scopeLabel }}</span>
</div>
</div>
</template>
<el-empty v-if="!groups.length" description="没有匹配的设置项" :image-size="60" />
</div>
</aside>
<section class="settings-content">
<template v-if="currentSection">
<component
:is="currentSection.component"
v-if="currentSection.component"
@columns-changed="emit('columns-changed')"
/>
<slot v-else name="field-section" />
</template>
<el-empty v-else description="请选择左侧设置项" />
</section>
</div>
<!-- 底部 -->
<footer class="settings-footer">
<span class="settings-footer-tip">修改即时保存 · 仅保存在当前浏览器</span>
<div class="settings-footer-actions">
<el-button size="small" @click="handleClose">关闭</el-button>
</div>
</footer>
</div>
</el-dialog>
</template>
<script setup lang="ts">
import { computed, ref, useSlots, watch } from 'vue'
import {
SETTINGS_GROUPS,
SETTINGS_SECTIONS,
type SettingsSectionMeta
} from './registry'
defineOptions({ name: 'SettingsDialog' })
const props = withDefaults(
defineProps<{
visible: boolean
/** 打开时定位的分区 key(非法/不可见时回落到第一个) */
initialSection?: string
}>(),
{ initialSection: '' }
)
const emit = defineEmits<{
(e: 'update:visible', v: boolean): void
/** 字段配置发生变化(导入/重置/故障修复),由宿主重建列配置 */
(e: 'columns-changed'): void
}>()
const slots = useSlots()
const keyword = ref('')
const currentKey = ref('')
const hasFieldSlot = computed(() => !!slots['field-section'])
/** 当前入口下可见的分区(无插槽时隐藏表级「列表字段」) */
const availableSections = computed<SettingsSectionMeta[]>(() =>
SETTINGS_SECTIONS.filter((section) => !section.slot || hasFieldSlot.value)
)
const groups = computed(() => {
const kw = keyword.value.trim().toLowerCase()
return SETTINGS_GROUPS.map((name) => ({
name,
items: availableSections.value.filter((section) => {
if (section.group !== name) return false
if (!kw) return true
return (
section.title.toLowerCase().includes(kw) || section.key.toLowerCase().includes(kw)
)
})
})).filter((group) => group.items.length > 0)
})
const currentSection = computed(() =>
availableSections.value.find((section) => section.key === currentKey.value)
)
/** 单条目且条目名 = 分组名时省略分组标题(避免「基础设置 / 基础设置」重复) */
function isSingleSelfNamedGroup(group: { name: string; items: SettingsSectionMeta[] }): boolean {
return group.items.length === 1 && group.items[0]?.title === group.name
}
watch(
() => props.visible,
(visible) => {
if (!visible) return
keyword.value = ''
const preferred = availableSections.value.find((section) => section.key === props.initialSection)
currentKey.value = preferred?.key || availableSections.value[0]?.key || ''
},
{ immediate: true }
)
function handleClose() {
emit('update:visible', false)
}
</script>
<style lang="scss" scoped>
.settings-shell {
display: flex;
flex-direction: column;
background: #fff;
}
/* ===== 头部(对齐 task-panel) ===== */
.task-panel__head {
display: flex;
align-items: flex-start;
gap: 12px;
padding: 16px;
}
.task-panel__titles {
flex: 1;
min-width: 0;
h2 {
margin: 0;
font-size: 18px;
line-height: 24px;
font-weight: 400;
color: #303133;
}
p {
margin: 4px 0 0;
font-size: 12px;
line-height: 18px;
color: #909399;
}
}
.task-panel__close {
width: 24px;
height: 24px;
flex: none;
display: inline-flex;
align-items: center;
justify-content: center;
border: none;
border-radius: 4px;
background: transparent;
color: #909399;
cursor: pointer;
transition: color 0.2s;
svg {
width: 12px;
height: 12px;
}
&:hover {
color: #409eff;
}
}
/* ===== 主体 ===== */
.settings-body {
display: flex;
height: min(560px, calc(100vh - 220px));
min-height: 380px;
padding: 4px 16px 0;
}
.settings-nav {
width: 208px;
flex-shrink: 0;
display: flex;
flex-direction: column;
padding-right: 12px;
border-right: 1px solid #ebeef5;
}
.settings-search {
margin-bottom: 8px;
}
.settings-nav-list {
flex: 1;
overflow: auto;
padding-right: 2px;
}
.settings-group + .settings-group {
margin-top: 10px;
}
.settings-group-title {
font-size: 12px;
line-height: 20px;
color: #909399;
font-weight: 600;
padding: 4px 2px;
}
.settings-nav-item {
display: flex;
align-items: center;
justify-content: space-between;
gap: 8px;
min-height: 32px;
padding: 0 10px;
border-radius: 4px;
font-size: 13px;
color: #606266;
cursor: pointer;
transition: background-color 0.2s, color 0.2s;
&:hover {
background: #f5f7fa;
}
&.is-active {
background: #ecf5ff;
color: #409eff;
font-weight: 600;
}
}
.settings-nav-title {
min-width: 0;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
.settings-nav-scope {
font-size: 11px;
color: #c0c4cc;
flex-shrink: 0;
}
.settings-content {
flex: 1;
min-width: 0;
overflow: auto;
padding: 4px 0 0 16px;
}
/* ===== 底部(对齐 task-panel__foot) ===== */
.settings-footer {
display: flex;
align-items: center;
justify-content: space-between;
gap: 12px;
padding: 16px;
}
.settings-footer-tip {
font-size: 12px;
color: #909399;
}
.settings-footer-actions {
display: flex;
align-items: center;
gap: 6px;
}
</style>
<style lang="scss">
/*
el-dialog 会被 append 到 body,scoped 选择器命中不到;
沿用项目内统一做法:全局块 + 自定义头部(隐藏默认头部)
*/
.el-dialog.settings-dialog {
padding: 0;
overflow: hidden;
border-radius: 4px;
.el-dialog__header {
display: none;
}
.el-dialog__body {
padding: 0;
}
.el-dialog__footer {
padding: 0;
}
}
</style>

View File

@ -0,0 +1,98 @@
/**
* 设置中心分区注册表
*
* - 新增一个设置分区 = 加一条 + 在 sections/ 下新建组件
* - `slot: true` 的分区不在此渲染组件,由宿主(UpperTable)通过 #field-section 插槽注入
* - 组件全部懒加载,避免设置弹窗拖慢首屏
*/
import { defineAsyncComponent, type Component } from 'vue'
export interface SettingsSectionMeta {
key: string
title: string
group: string
/** 作用域提示(右侧小字),帮助用户理解"这条配置影响谁" */
scopeLabel?: string
/** 由宿主通过插槽提供内容(如表格列配置依赖当前表实例) */
slot?: boolean
component?: Component
}
export const SETTINGS_GROUPS = ['字段与列', '筛选与查询', '系统设置', '设备与打印', '导航与入口', '数据与维护'] as const
export const SETTINGS_SECTIONS: SettingsSectionMeta[] = [
{
key: 'field',
title: '列表字段',
group: '字段与列',
scopeLabel: '当前表格',
slot: true
},
{
key: 'tables',
title: '所有表格字段',
group: '字段与列',
scopeLabel: '账号 + 角色',
component: defineAsyncComponent(() => import('./sections/AllTablesSection.vue'))
},
{
key: 'exportColumns',
title: '导出字段',
group: '字段与列',
scopeLabel: '账号 + 角色',
component: defineAsyncComponent(() => import('./sections/ExportColumnsSection.vue'))
},
{
key: 'filterPresets',
title: '自定义过滤条件',
group: '筛选与查询',
scopeLabel: '账号',
component: defineAsyncComponent(() => import('./sections/FilterPresetsSection.vue'))
},
{
key: 'display',
title: '界面显示',
group: '系统设置',
scopeLabel: '账号 + 角色',
component: defineAsyncComponent(() => import('./sections/DisplaySection.vue'))
},
{
key: 'basic',
title: '基础设置',
group: '系统设置',
scopeLabel: '账号 + 角色',
component: defineAsyncComponent(() => import('./sections/BasicSettingsSection.vue'))
},
{
key: 'device',
title: '设备与打印',
group: '设备与打印',
scopeLabel: '账号 + 仓库',
component: defineAsyncComponent(() => import('./sections/DeviceSection.vue'))
},
{
key: 'tabOrder',
title: '标签排序',
group: '导航与入口',
scopeLabel: '账号',
component: defineAsyncComponent(() => import('./sections/TabOrderSection.vue'))
},
{
key: 'shortcuts',
title: '快捷入口',
group: '导航与入口',
scopeLabel: '账号 + 角色',
component: defineAsyncComponent(() => import('./sections/ShortcutsSection.vue'))
},
{
key: 'data',
title: '导入 / 导出与维护',
group: '数据与维护',
scopeLabel: '本机',
component: defineAsyncComponent(() => import('./sections/DataSection.vue'))
}
]
export function getSettingsSection(key: string): SettingsSectionMeta | undefined {
return SETTINGS_SECTIONS.find((section) => section.key === key)
}

View File

@ -0,0 +1,418 @@
<!--
表格 → 所有表格字段
跨页面管理本机已登记的所有表格字段配置(显隐 / 顺序 / 固定 / 恢复默认)。
- 数据来源:localStorage `upper_table_columns_{user}_{role}_{tableId}`(页面打开一次后由 UpperTable 自动登记)
- 修改即时写入,并通过 tableColumnConfig store 通知当前已打开的表格重建列配置
-->
<template>
<div class="settings-section tables-section">
<div class="section-header">
<div>
<div class="section-title">所有表格字段</div>
<div class="section-desc">
管理本机已登记的全部表格字段(显隐 / 顺序 / 固定)。页面打开一次后会自动登记到此处。
</div>
</div>
<el-button size="small" @click="reload">刷新列表</el-button>
</div>
<div class="tables-body">
<aside class="tables-nav">
<el-input
v-model="keyword"
size="small"
placeholder="搜索表格名称 / tableId"
clearable
class="tables-search"
/>
<div class="tables-filter">
<el-checkbox v-model="onlyCustomized" size="small">仅看已自定义</el-checkbox>
<span class="tables-count">{{ filteredProfiles.length }} 张</span>
</div>
<div class="tables-list">
<div
v-for="item in filteredProfiles"
:key="item.tableId"
class="table-item"
:class="{ 'is-active': item.tableId === selectedId }"
@click="selectedId = item.tableId"
>
<span class="table-title">{{ item.title || item.tableId }}</span>
<el-tag v-if="isColumnCustomized(item)" size="small" effect="plain">已自定义</el-tag>
</div>
<el-empty v-if="!filteredProfiles.length" description="暂无表格配置" :image-size="60" />
</div>
</aside>
<section class="tables-content">
<template v-if="current">
<div class="tables-head">
<div class="tables-head-main">
<div class="table-current-title">{{ current.title || current.tableId }}</div>
<div class="table-current-id">{{ current.tableId }}</div>
</div>
<el-tooltip
:disabled="hasDefaults"
content="该表格尚未记录默认布局,打开一次对应页面后再试"
placement="top"
>
<span>
<el-button size="small" :disabled="!hasDefaults" @click="resetCurrent">
恢复默认
</el-button>
</span>
</el-tooltip>
</div>
<div v-if="!current.columns.length" class="tables-empty">该表格没有可配置的字段</div>
<div
v-for="section in columnSections"
v-else
:key="section.key"
class="column-section"
>
<div class="column-section-title">{{ section.title }}</div>
<div
v-for="(col, idx) in section.items"
:key="col.prop"
class="column-item"
>
<el-checkbox
:model-value="col.visible"
@change="(val: any) => toggleVisible(col.prop, !!val)"
>
{{ col.label || col.prop }}
</el-checkbox>
<span class="column-prop">{{ col.prop }}</span>
<div class="column-actions">
<el-button
v-if="section.key === 'scroll'"
text
size="small"
title="固定到左侧"
@click="setFixed(col.prop, 'left')"
>←</el-button>
<el-button
v-if="section.key === 'scroll'"
text
size="small"
title="固定到右侧"
@click="setFixed(col.prop, 'right')"
>→</el-button>
<el-button
v-if="section.key === 'fixed-left'"
text
size="small"
title="取消左固定"
@click="setFixed(col.prop, false)"
>→</el-button>
<el-button
v-if="section.key === 'fixed-right'"
text
size="small"
title="取消右固定"
@click="setFixed(col.prop, false)"
>←</el-button>
<el-button
text
size="small"
:disabled="idx === 0"
title="上移"
@click="moveColumn(col.prop, -1)"
>↑</el-button>
<el-button
text
size="small"
:disabled="idx === section.items.length - 1"
title="下移"
@click="moveColumn(col.prop, 1)"
>↓</el-button>
</div>
</div>
</div>
</template>
<el-empty v-else description="请从左侧选择一个表格" />
</section>
</div>
</div>
</template>
<script setup lang="ts">
import { computed, onMounted, ref } from 'vue'
import { ElMessage } from 'element-plus'
import { useUserStore } from '@/stores/modules/user'
import { useTableColumnConfigStore } from '@/stores/modules/tableColumnConfig'
import {
cloneColumns,
isColumnCustomized,
normalizeConfigOrders,
partitionConfigColumns,
readColumnProfiles,
writeColumnProfile,
type TableColumnProfile
} from '@/utils/table-column-config'
defineOptions({ name: 'SettingsAllTablesSection' })
const userStore = useUserStore()
const tableColumnConfigStore = useTableColumnConfigStore()
const profiles = ref<TableColumnProfile[]>([])
const keyword = ref('')
const onlyCustomized = ref(false)
const selectedId = ref('')
const current = computed(
() => profiles.value.find((item) => item.tableId === selectedId.value) || null
)
const hasDefaults = computed(() => !!current.value?.defaultColumns?.length)
const filteredProfiles = computed(() => {
const kw = keyword.value.trim().toLowerCase()
return profiles.value.filter((item) => {
if (onlyCustomized.value && !isColumnCustomized(item)) return false
if (!kw) return true
const title = (item.title || '').toLowerCase()
return title.includes(kw) || item.tableId.toLowerCase().includes(kw)
})
})
const columnSections = computed(() => {
const columns = current.value?.columns || []
const { left, mid, right } = partitionConfigColumns(columns)
return [
{ key: 'fixed-left', title: '左侧固定', items: left },
{ key: 'scroll', title: '不固定列', items: mid },
{ key: 'fixed-right', title: '右侧固定', items: right }
].filter((section) => section.items.length > 0)
})
function reload() {
const userId = String(userStore.user?.username || userStore.user?.id || 'unknown')
const roleId = userStore.roleId || 'default'
profiles.value = readColumnProfiles(userId, roleId)
if (!profiles.value.some((item) => item.tableId === selectedId.value)) {
// 优先选中当前页面所在的表格,其次第一张
selectedId.value = profiles.value[0]?.tableId || ''
}
}
/** 写回当前表格配置,并通知已打开的表格重建 */
function persist() {
const profile = current.value
if (!profile) return
profile.columns = normalizeConfigOrders(profile.columns)
profile.updatedAt = Date.now()
writeColumnProfile(profile)
tableColumnConfigStore.touch(profile.tableId)
}
function toggleVisible(prop: string, visible: boolean) {
const col = current.value?.columns.find((item) => item.prop === prop)
if (!col) return
col.visible = visible
persist()
}
function moveColumn(prop: string, step: -1 | 1) {
const profile = current.value
if (!profile) return
const { left, mid, right } = partitionConfigColumns(profile.columns)
const fixed = profile.columns.find((item) => item.prop === prop)?.fixed
const section = fixed === 'left' ? left : fixed === 'right' ? right : mid
const sectionIndex = section.findIndex((item) => item.prop === prop)
if (sectionIndex < 0) return
const swapIndex = sectionIndex + step
if (swapIndex < 0 || swapIndex >= section.length) return
const a = section[sectionIndex]!
const b = section[swapIndex]!
const aOrder = a.order
a.order = b.order
b.order = aOrder
persist()
}
function setFixed(prop: string, position: 'left' | 'right' | false) {
const profile = current.value
if (!profile) return
const col = profile.columns.find((item) => item.prop === prop)
if (!col) return
col.fixed = position === false ? false : position
// 移到目标分区末尾
const maxOrder = profile.columns.reduce((max, item) => Math.max(max, item.order), -1)
col.order = maxOrder + 1
persist()
}
function resetCurrent() {
const profile = current.value
if (!profile?.defaultColumns?.length) return
profile.columns = cloneColumns(profile.defaultColumns)
profile.updatedAt = Date.now()
writeColumnProfile(profile)
tableColumnConfigStore.touch(profile.tableId)
ElMessage.success('已恢复该表格的默认字段配置')
}
onMounted(reload)
</script>
<style lang="scss" scoped>
@use './shared.scss';
.tables-section {
height: 100%;
}
.tables-body {
display: flex;
gap: 16px;
flex: 1;
min-height: 0;
}
.tables-nav {
width: 260px;
flex-shrink: 0;
display: flex;
flex-direction: column;
border-right: 1px solid #e8eef7;
padding-right: 12px;
}
.tables-search {
margin-bottom: 6px;
}
.tables-filter {
display: flex;
align-items: center;
justify-content: space-between;
padding: 0 2px 6px;
border-bottom: 1px dashed #eef2f8;
margin-bottom: 6px;
}
.tables-count {
font-size: 12px;
color: #909399;
}
.tables-list {
flex: 1;
overflow: auto;
}
.table-item {
display: flex;
align-items: center;
justify-content: space-between;
gap: 8px;
min-height: 32px;
padding: 0 10px;
border-radius: 4px;
font-size: 13px;
color: #606266;
cursor: pointer;
transition: background-color 0.2s, color 0.2s;
&:hover {
background: #f5f7fa;
}
&.is-active {
background: #ecf5ff;
color: #409eff;
font-weight: 600;
}
}
.table-title {
min-width: 0;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
.tables-content {
flex: 1;
min-width: 0;
overflow: auto;
padding-right: 4px;
}
.tables-head {
display: flex;
align-items: flex-start;
justify-content: space-between;
gap: 12px;
margin-bottom: 10px;
}
.table-current-title {
font-size: 14px;
font-weight: 600;
color: #303133;
}
.table-current-id {
margin-top: 2px;
font-size: 12px;
color: #909399;
}
.column-section + .column-section {
margin-top: 12px;
}
.column-section-title {
font-size: 12px;
color: #909399;
font-weight: 600;
padding: 4px 0;
}
.column-item {
display: flex;
align-items: center;
gap: 16px;
min-height: 40px;
padding: 4px 0 0 12px;
border-bottom: 1px solid #f7f8fa;
&:last-child {
border-bottom: none;
}
:deep(.el-checkbox) {
flex: 1;
min-width: 0;
}
}
.column-prop {
font-size: 12px;
color: #c0c4cc;
white-space: nowrap;
}
.column-actions {
display: flex;
align-items: center;
gap: 2px;
flex-shrink: 0;
}
.tables-empty {
padding: 32px 0;
text-align: center;
font-size: 13px;
color: #909399;
}
</style>

View File

@ -0,0 +1,132 @@
<!--
基础设置(合并原「表格与性能」+「页面与标签缓存」两个分区)
数据源:experimental store(localStorage: experimental_{user}_{role})
-->
<template>
<div class="settings-section">
<div class="section-header">
<div>
<div class="section-title">基础设置</div>
<div class="section-desc">表格渲染策略与页面 / 标签缓存(仅影响本机)。</div>
</div>
<el-button size="small" @click="handleReset">恢复默认</el-button>
</div>
<div class="section-block">
<div class="block-title">表格渲染</div>
<div class="block-desc">调整大列表表格的渲染调度策略</div>
<div class="settings-card">
<div class="setting-row">
<span class="setting-label">表格工作模式</span>
<el-radio-group v-model="tableMode" size="small">
<el-radio value="resource">低占用(默认)</el-radio>
<el-radio value="performance">高性能</el-radio>
</el-radio-group>
<span class="setting-hint">低占用优先减少资源开销;高性能优先滚动与渲染流畅度</span>
</div>
</div>
</div>
<div class="section-block">
<div class="block-title">页面缓存</div>
<div class="block-desc">通过顶部导航栏 / 页面标签切换的路由页面缓存策略</div>
<div class="settings-card">
<div class="setting-row">
<span class="setting-label">页面缓存</span>
<el-switch v-model="pageCacheEnabled" />
<span class="setting-hint">关闭后切换页面会重新加载</span>
</div>
<div class="setting-row">
<span class="setting-label">最大缓存页面数量</span>
<el-input-number
:model-value="pageCacheMax"
:min="1"
:max="50"
size="small"
:disabled="!pageCacheEnabled"
@change="handlePageCacheMaxChange"
/>
<span class="setting-hint">超出后淘汰最久未使用的页面</span>
</div>
</div>
</div>
<div class="section-block">
<div class="block-title">标签缓存</div>
<div class="block-desc">含标签页切换功能页面的 KeepAlive 缓存策略</div>
<div class="settings-card">
<div class="setting-row">
<span class="setting-label">标签缓存</span>
<el-switch v-model="tabCacheEnabled" />
</div>
<div class="setting-row">
<span class="setting-label">最大缓存标签数量</span>
<el-input-number
:model-value="tabCacheMax"
:min="1"
:max="20"
size="small"
:disabled="!tabCacheEnabled"
@change="handleTabCacheMaxChange"
/>
<span class="setting-hint">超出后淘汰最久未使用的标签</span>
</div>
</div>
</div>
</div>
</template>
<script setup lang="ts">
import { computed } from 'vue'
import { ElMessage } from 'element-plus'
import { useExperimentalStore, type TableMode } from '@/stores/modules/experimental'
defineOptions({ name: 'SettingsBasicSection' })
const experimentalStore = useExperimentalStore()
const tableMode = computed({
get: () => experimentalStore.tableMode,
set: (mode: TableMode) => {
experimentalStore.setTableMode(mode)
}
})
const pageCacheEnabled = computed({
get: () => experimentalStore.pageCacheEnabled,
set: (val: boolean) => {
experimentalStore.setPageCacheEnabled(val)
}
})
const pageCacheMax = computed(() => experimentalStore.pageCacheMax)
const tabCacheEnabled = computed({
get: () => experimentalStore.tabCacheEnabled,
set: (val: boolean) => {
experimentalStore.setTabCacheEnabled(val)
}
})
const tabCacheMax = computed(() => experimentalStore.tabCacheMax)
function handlePageCacheMaxChange(val: number | undefined) {
experimentalStore.setPageCacheMax(Number(val ?? 1))
}
function handleTabCacheMaxChange(val: number | undefined) {
experimentalStore.setTabCacheMax(Number(val ?? 1))
}
function handleReset() {
experimentalStore.resetToDefaults()
ElMessage.success('已恢复基础设置默认值')
}
</script>
<style lang="scss" scoped>
@use './shared.scss';
</style>

View File

@ -0,0 +1,408 @@
<!--
数据与维护:配置文件导出/导入、恢复默认、故障修复、诊断信息
- 文件:tbyc-config.json(分区结构,见 docs/统一配置文件-tbyc-config.md)
- 导入会覆盖同名配置,保留文件中未涉及的配置项
- 字段配置发生变化时向父级发出 columns-changed,由表格重建列配置
-->
<template>
<div class="settings-section">
<!-- 配置文件 -->
<div class="section-block">
<div class="block-title">配置文件</div>
<div class="block-desc">
导出/导入当前账号在本机的全部可配置项(字段设置、标签排序、界面显示、缓存、快捷键等)。
文件名:<code>tbyc-config.json</code>。
</div>
<div class="block-actions">
<el-button size="small" type="primary" @click="handleExport">导出配置</el-button>
<el-upload
accept=".json"
:show-file-list="false"
:auto-upload="false"
:on-change="handleImport"
>
<el-button size="small">导入配置</el-button>
</el-upload>
</div>
<div class="block-desc" style="margin-top: 8px; margin-bottom: 0;">
导入会覆盖同名配置,不会清空文件中未涉及的项;旧版字段配置文件仍可导入。
</div>
</div>
<!-- 恢复默认 -->
<div class="section-block">
<div class="block-title">恢复默认</div>
<div class="block-desc">
恢复字段设置、界面显示、表格与缓存、标签排序为本机默认值(不影响快捷入口)。
</div>
<div class="block-actions">
<el-button size="small" @click="handleResetAll">恢复全部默认</el-button>
</div>
</div>
<!-- 故障修复 -->
<div class="section-block">
<div class="block-title">故障修复</div>
<div class="block-desc">
清除当前电脑中此账号的全部字段配置、标签排序、显示设置、表格与缓存设置及快捷键,并恢复默认配置(不可撤销)。
</div>
<div class="block-actions">
<el-button size="small" type="danger" plain @click="handleRepair">故障修复</el-button>
</div>
</div>
<!-- 诊断信息 -->
<div class="section-block">
<div class="block-title">诊断信息</div>
<div class="block-desc">反馈问题时可提供以下信息(均为本机浏览器存储,不会上传)。</div>
<el-descriptions :column="2" size="small" border>
<el-descriptions-item label="账号">{{ identity.userId }}</el-descriptions-item>
<el-descriptions-item label="角色">{{ identity.roleId }}</el-descriptions-item>
<el-descriptions-item label="仓库">{{ identity.warehouseId || '—' }}</el-descriptions-item>
<el-descriptions-item label="配置版本">tbyc-config v{{ TBYC_CONFIG_VERSION }}</el-descriptions-item>
<el-descriptions-item label="本机配置占用">{{ storageSizeText }}</el-descriptions-item>
<el-descriptions-item label="字段配置">{{ columnProfileCount }} 张表</el-descriptions-item>
</el-descriptions>
<div class="storage-keys">
<div v-for="item in storageKeys" :key="item.label" class="storage-key-row">
<span class="storage-key-label">{{ item.label }}</span>
<code class="storage-key-code">{{ item.key }}</code>
</div>
</div>
</div>
</div>
</template>
<script setup lang="ts">
import { computed } from 'vue'
import { ElMessage, ElMessageBox } from 'element-plus'
import type { UploadFile } from 'element-plus'
import defaultSettings from '@/settings'
import { useUserStore } from '@/stores/modules/user'
import { useSettingsStore } from '@/stores/modules/settings'
import { useShortcutsStore } from '@/stores/modules/shortcuts'
import { useExperimentalStore } from '@/stores/modules/experimental'
import { useUserPreferenceStore } from '@/stores/modules/userPreference'
import { TAB_ORDER_SCOPE } from '@/utils/tab-order'
import {
TBYC_CONFIG_FILENAME,
TBYC_CONFIG_VERSION,
buildTbycConfig,
downloadJsonFile,
isTbycConfig
} from '@/utils/tbyc-config'
import { TBYC_CONFIG_SECTIONS, getTbycConfigSection } from '@/config/tbyc-config-sections'
import { useScanFilterPresetsStore } from '@/stores/modules/scanFilterPresets'
import { clearScanBoxPages } from '@/utils/scan-filter-presets'
defineOptions({ name: 'SettingsDataSection' })
const emit = defineEmits<{
/** 字段配置(列配置)发生变化,需要表格重建列 */
(e: 'columns-changed'): void
}>()
const userStore = useUserStore()
const settingsStore = useSettingsStore()
const shortcutsStore = useShortcutsStore()
const experimentalStore = useExperimentalStore()
const preferenceStore = useUserPreferenceStore()
/** 当前身份(与各处存储 key 规则保持一致) */
const identity = computed(() => {
const user = userStore.user || {}
const userId = String(user.username || user.id || 'unknown')
const roleId = String(userStore.roleId || 'default')
const warehouseId = String(user.warehouse_id ?? user.store_id ?? '')
return { userId, roleId, warehouseId }
})
const columnPrefix = computed(
() => `upper_table_columns_${identity.value.userId}_${identity.value.roleId}_`
)
const settingsKey = computed(() => `settings_${identity.value.userId}_${identity.value.roleId}`)
const experimentalKey = computed(
() => `experimental_${identity.value.userId}_${identity.value.roleId}`
)
const shortcutsKey = computed(() => `shortcuts_${identity.value.userId}_${identity.value.roleId}`)
const preferenceKey = computed(() =>
identity.value.warehouseId
? `user_prefs_${identity.value.userId}_${identity.value.warehouseId}`
: `user_prefs_${identity.value.userId}`
)
const storageKeys = computed(() => [
{ label: '字段配置', key: `${columnPrefix.value}*` },
{ label: '显示设置', key: settingsKey.value },
{ label: '表格与缓存', key: experimentalKey.value },
{ label: '快捷键', key: shortcutsKey.value },
{ label: '用户偏好(标签排序/打印)', key: preferenceKey.value }
])
/** 当前身份下占用的 localStorage 体积(字节) */
const storageSize = computed(() => {
let bytes = 0
try {
Object.keys(localStorage).forEach((key) => {
if (!storageKeys.value.some((item) => key.startsWith(item.key.replace(/\*$/, '')))) return
bytes += (localStorage.getItem(key) || '').length
})
} catch {
// 忽略存储不可用
}
return bytes
})
const storageSizeText = computed(() => {
const kb = storageSize.value / 1024
return kb >= 1 ? `${kb.toFixed(1)} KB` : `${storageSize.value} B`
})
const columnProfileCount = computed(() => {
let count = 0
try {
Object.keys(localStorage).forEach((key) => {
if (key.startsWith(columnPrefix.value)) count += 1
})
} catch {
// 忽略
}
return count
})
/* ==================== 导出 ==================== */
function collectSections(): Record<string, unknown> {
const sections: Record<string, unknown> = {}
TBYC_CONFIG_SECTIONS.forEach((section) => {
try {
const data = section.collect()
if (data === undefined || data === null) return
sections[section.key] = data
} catch (error) {
console.error(`[tbyc-config] collect ${section.key} failed:`, error)
}
})
return sections
}
function handleExport() {
const sections = collectSections()
if (!Object.keys(sections).length) {
ElMessage.warning('当前没有可导出的配置')
return
}
downloadJsonFile(
TBYC_CONFIG_FILENAME,
buildTbycConfig(
{ userId: identity.value.userId, roleId: identity.value.roleId },
sections
)
)
ElMessage.success('配置文件已导出')
}
/* ==================== 导入 ==================== */
/**
* 解析导入文件 → 分区数据
* - 新格式:{ format: 'tbyc-config', sections: { ... } }
* - 旧格式:{ tables | tableId/columns } + { tabOrders }(兼容旧版「全局字段配置」导出文件)
*/
function resolveConfigSections(parsed: any): Record<string, unknown> {
if (!parsed || typeof parsed !== 'object') return {}
if (isTbycConfig(parsed) || (parsed.sections && typeof parsed.sections === 'object')) {
return parsed.sections || {}
}
const sections: Record<string, unknown> = {}
if (Array.isArray(parsed.tables)) {
sections.fieldColumns = parsed.tables
} else if (parsed.tableId && Array.isArray(parsed.columns)) {
sections.fieldColumns = [
{ tableId: parsed.tableId, columns: parsed.columns, schemaVersion: parsed.schemaVersion }
]
}
if (parsed.tabOrders) sections.tabOrder = parsed.tabOrders
return sections
}
function applySections(sections: Record<string, unknown>): string[] {
const applied: string[] = []
let columnsChanged = false
TBYC_CONFIG_SECTIONS.forEach((section) => {
if (!(section.key in sections)) return
try {
const count = section.apply(sections[section.key])
if (count > 0) {
applied.push(`${section.title} ${count} 项`)
if (section.key === 'fieldColumns') columnsChanged = true
}
} catch (error) {
console.error(`[tbyc-config] apply ${section.key} failed:`, error)
}
})
if (columnsChanged) emit('columns-changed')
return applied
}
function handleImport(file: UploadFile) {
if (!file.raw) return
const reader = new FileReader()
reader.onload = () => {
try {
const parsed = JSON.parse(String(reader.result || '{}'))
const sections = resolveConfigSections(parsed)
const sectionKeys = Object.keys(sections)
if (!sectionKeys.length) {
ElMessage.error('未找到可导入的配置')
return
}
const applied = applySections(sections)
// 来自更新版本的未知分区:只提示,不阻断其它配置导入
const unknownCount = sectionKeys.filter((key) => !getTbycConfigSection(key)).length
if (!applied.length) {
ElMessage.error(unknownCount ? '配置文件中的配置项当前版本不支持' : '未找到可导入的配置')
return
}
const suffix = unknownCount ? `(${unknownCount} 个未知配置项已忽略)` : ''
ElMessage.success(`配置导入成功:${applied.join('、')}${suffix}`)
} catch {
ElMessage.error('配置文件解析失败')
}
}
reader.readAsText(file.raw)
}
/* ==================== 恢复默认 / 故障修复 ==================== */
function removeKeysByPrefix(prefix: string): number {
const removeKeys: string[] = []
Object.keys(localStorage).forEach((key) => {
if (key.startsWith(prefix)) removeKeys.push(key)
})
removeKeys.forEach((key) => localStorage.removeItem(key))
return removeKeys.length
}
async function handleResetAll() {
try {
await ElMessageBox.confirm(
'将恢复字段设置、界面显示、表格与缓存、标签排序为本机默认值(快捷入口不受影响)。是否继续?',
'恢复全部默认',
{ type: 'warning', buttonSize: 'small', confirmButtonText: '恢复', cancelButtonText: '取消' }
)
} catch {
return
}
removeKeysByPrefix(columnPrefix.value)
settingsStore.resetDisplaySettings()
experimentalStore.resetToDefaults()
preferenceStore.resetGlobal(TAB_ORDER_SCOPE)
emit('columns-changed')
ElMessage.success('已恢复全部默认配置')
}
async function handleRepair() {
try {
await ElMessageBox.confirm(
'故障修复会清除当前电脑中此账号的全部字段配置、标签排序、显示设置、表格与缓存设置、自定义过滤条件及快捷键,并恢复所有默认配置。是否继续?',
'确认故障修复',
{ type: 'warning', buttonSize: 'small', confirmButtonText: '确认清除', cancelButtonText: '取消' }
)
await ElMessageBox.confirm(
'请再次确认:该操作不可撤销,确定清除所有配置吗?',
'二次确认',
{ type: 'warning', buttonSize: 'small', confirmButtonText: '确定', cancelButtonText: '返回' }
)
} catch {
return
}
// 1. 字段配置
const columnCount = removeKeysByPrefix(columnPrefix.value)
// 2. 显示设置
const hadSettings = localStorage.getItem(settingsKey.value) !== null
localStorage.removeItem(settingsKey.value)
settingsStore.changeSetting({ key: 'showSettings', value: defaultSettings.showSettings })
settingsStore.changeSetting({ key: 'tagsView', value: defaultSettings.tagsView })
settingsStore.changeSetting({ key: 'fixedHeader', value: defaultSettings.fixedHeader })
settingsStore.changeSetting({ key: 'sidebarLogo', value: defaultSettings.sidebarLogo })
settingsStore.changeSetting({ key: 'layoutMode', value: 'top-bottom' })
settingsStore.changeSetting({ key: 'shortcutExpanded', value: defaultSettings.shortcutExpanded })
settingsStore.changeSetting({ key: 'toolbarMode', value: defaultSettings.toolbarMode })
settingsStore.changeSetting({ key: 'scanBoxMode', value: defaultSettings.scanBoxMode })
// 3. 表格与缓存
const hadExperimental = localStorage.getItem(experimentalKey.value) !== null
experimentalStore.resetToDefaults()
// 4. 快捷键
const hadShortcuts = localStorage.getItem(shortcutsKey.value) !== null
localStorage.removeItem(shortcutsKey.value)
shortcutsStore.shortcuts = []
// 5. 标签排序 / 默认页签(用户级)
const hadTabOrder = !!preferenceStore.getGlobal(TAB_ORDER_SCOPE)
if (hadTabOrder) preferenceStore.resetGlobal(TAB_ORDER_SCOPE)
// 6. 自定义过滤条件(用户级)+ 页面字段登记(本机元数据)
const filterPresetStore = useScanFilterPresetsStore()
filterPresetStore.ensureLoaded()
const presetCount = filterPresetStore.presets.length
if (presetCount) filterPresetStore.clearAll()
clearScanBoxPages()
emit('columns-changed')
const parts: string[] = []
if (columnCount > 0) parts.push(`${columnCount} 个字段配置`)
if (hadSettings) parts.push('显示设置')
if (hadExperimental) parts.push('表格与缓存')
if (hadShortcuts) parts.push('快捷键')
if (hadTabOrder) parts.push('标签排序')
if (presetCount > 0) parts.push(`${presetCount} 条自定义过滤条件`)
ElMessage.success(`故障修复完成${parts.length ? ',已恢复 ' + parts.join('、') : ''}`)
}
</script>
<style lang="scss" scoped>
@use './shared.scss';
.storage-keys {
margin-top: 10px;
display: flex;
flex-direction: column;
gap: 4px;
}
.storage-key-row {
display: flex;
align-items: center;
gap: 8px;
font-size: 12px;
}
.storage-key-label {
width: 160px;
flex-shrink: 0;
color: #909399;
}
.storage-key-code {
font-size: 12px;
color: #606266;
background: #f5f7fa;
border-radius: 4px;
padding: 1px 6px;
word-break: break-all;
}
</style>

View File

@ -0,0 +1,30 @@
<!--
显示与交互 → 设备与打印
打印组件连接状态与失败自动重连配置(用户 + 仓库维度)。
复用业务侧已有的连接面板,避免两套逻辑。
-->
<template>
<div class="settings-section">
<div class="section-header">
<div>
<div class="section-title">设备与打印</div>
<div class="section-desc">
打印组件连接状态与失败自动重连策略(按账号 + 仓库保存)。修改即时生效,不会断开已连接组件。
</div>
</div>
</div>
<PrinterComponentConnectionPanel />
</div>
</template>
<script setup lang="ts">
import PrinterComponentConnectionPanel from '@/views/order/waveOrder/component/PrinterComponentConnectionPanel.vue'
defineOptions({ name: 'SettingsDeviceSection' })
</script>
<style lang="scss" scoped>
@use './shared.scss';
</style>

View File

@ -0,0 +1,134 @@
<!--
显示与交互 → 界面显示
数据源:settings store(localStorage: settings_{user}_{role})
-->
<template>
<div class="settings-section">
<div class="section-header">
<div>
<div class="section-title">界面显示</div>
<div class="section-desc">以下选项保存在当前浏览器,仅影响本机显示,换电脑需重新设置。</div>
</div>
<el-button size="small" @click="handleReset">恢复默认</el-button>
</div>
<div class="settings-card">
<div class="setting-row">
<span class="setting-label">布局模式</span>
<el-radio-group v-model="layoutMode" size="small">
<el-radio value="top-bottom">顶部导航(默认)</el-radio>
<el-radio value="sidebar">侧边栏</el-radio>
</el-radio-group>
<span class="setting-hint">切换后立即生效</span>
</div>
<div class="setting-row">
<span class="setting-label">固定头部</span>
<el-switch v-model="fixedHeader" />
<span class="setting-hint">滚动时导航栏保持可见</span>
</div>
<div class="setting-row">
<span class="setting-label">侧栏 Logo</span>
<el-switch v-model="sidebarLogo" />
<span class="setting-hint">侧边栏模式下是否显示 Logo</span>
</div>
<div class="setting-row">
<span class="setting-label">Scan-box 显示模式</span>
<el-radio-group v-model="scanBoxMode" size="small">
<el-radio value="compact">紧凑(默认)</el-radio>
<el-radio value="standard">标准</el-radio>
</el-radio-group>
<span class="setting-hint">紧凑模式行高更小,一屏显示更多筛选条件</span>
</div>
<div class="setting-row">
<span class="setting-label">工具栏按钮模式</span>
<el-radio-group v-model="toolbarMode" size="small">
<el-radio value="tile">平铺(默认)</el-radio>
<el-radio value="collapse">折叠</el-radio>
</el-radio-group>
<span class="setting-hint">工具栏按钮组的排列方式</span>
</div>
<div class="setting-row">
<span class="setting-label">快捷键区域</span>
<el-switch v-model="shortcutExpanded" />
<span class="setting-hint">展开顶部快捷键面板(默认收起)</span>
</div>
</div>
</div>
</template>
<script setup lang="ts">
import { computed } from 'vue'
import { ElMessage, ElMessageBox } from 'element-plus'
import { useSettingsStore } from '@/stores/modules/settings'
import defaultSettings from '@/settings'
defineOptions({ name: 'SettingsDisplaySection' })
const settingsStore = useSettingsStore()
const layoutMode = computed({
get: () => settingsStore.layoutMode,
set: (mode: 'sidebar' | 'top-bottom') => {
settingsStore.changeSetting({ key: 'layoutMode', value: mode })
}
})
const fixedHeader = computed({
get: () => settingsStore.fixedHeader,
set: (value: boolean) => {
settingsStore.changeSetting({ key: 'fixedHeader', value })
}
})
const sidebarLogo = computed({
get: () => settingsStore.sidebarLogo,
set: (value: boolean) => {
settingsStore.changeSetting({ key: 'sidebarLogo', value })
}
})
const scanBoxMode = computed({
get: () => settingsStore.scanBoxMode,
set: (mode: 'standard' | 'compact') => {
settingsStore.changeSetting({ key: 'scanBoxMode', value: mode })
}
})
const toolbarMode = computed({
get: () => settingsStore.toolbarMode,
set: (mode: 'tile' | 'collapse') => {
settingsStore.changeSetting({ key: 'toolbarMode', value: mode })
}
})
const shortcutExpanded = computed({
get: () => settingsStore.shortcutExpanded,
set: (expanded: boolean) => {
settingsStore.changeSetting({ key: 'shortcutExpanded', value: expanded })
}
})
function handleReset() {
ElMessageBox.confirm(
'将恢复界面显示为默认:顶部导航、固定头部开启、侧栏 Logo 开启、Scan-box 紧凑模式、工具栏平铺、快捷键区域收起。',
'恢复默认',
{ type: 'warning', confirmButtonText: '恢复', cancelButtonText: '取消' }
)
.then(() => {
settingsStore.resetDisplaySettings()
settingsStore.changeSetting({ key: 'fixedHeader', value: defaultSettings.fixedHeader })
settingsStore.changeSetting({ key: 'sidebarLogo', value: defaultSettings.sidebarLogo })
ElMessage.success('已恢复界面显示默认值')
})
.catch(() => {})
}
</script>
<style lang="scss" scoped>
@use './shared.scss';
</style>

View File

@ -0,0 +1,400 @@
<!--
数据与维护 → 导出字段
管理订单管理各子页「导出全部(不含明细)」使用的导出字段。
- 存储:localStorage `order_export_columns_{user}_{role}_{scopeKey}_waybill`
(与 OrderExportColumnsDialog 完全一致,导出弹窗打开时读取)
- 未配置时默认全选;「恢复默认」= 删除该页配置,回到全选
- 修改即时保存,下次打开导出弹窗生效
-->
<template>
<div class="settings-section export-section">
<div class="section-header">
<div>
<div class="section-title">导出字段</div>
<div class="section-desc">
订单管理各页「导出(不含明细)」的导出字段(导出全部 / 导出选中共用同一份配置);未配置时默认全选,修改即时保存,下次打开导出窗口生效。
</div>
</div>
</div>
<div class="export-body">
<aside class="export-nav">
<div class="export-nav-list">
<div
v-for="page in pageList"
:key="page.name"
class="page-item"
:class="{ 'is-active': page.name === selectedPage }"
@click="selectedPage = page.name"
>
<span class="page-title">{{ page.label }}</span>
<el-tag v-if="isConfigured(page.name)" size="small" effect="plain">已配置</el-tag>
</div>
</div>
</aside>
<section class="export-content">
<div class="export-toolbar">
<el-input
v-model="keyword"
placeholder="搜索字段"
clearable
size="small"
class="export-search"
>
<template #prefix>
<el-icon><Search /></el-icon>
</template>
</el-input>
<el-checkbox
:model-value="isAllSelected"
:indeterminate="isIndeterminate"
@change="handleToggleAll"
>
全选
</el-checkbox>
<el-button size="small" link type="primary" @click="handleReverse">反选</el-button>
<el-button size="small" link type="danger" @click="handleClear">清空</el-button>
<span class="export-count">已选 {{ selected.length }} / {{ allFields.length }}</span>
<el-button size="small" link @click="resetCurrent">恢复默认(全选)</el-button>
</div>
<div class="export-groups">
<div v-for="group in visibleGroups" :key="group.name" class="export-group">
<div class="export-group-head">
<span class="export-group-name">{{ group.name }}</span>
<el-checkbox
size="small"
:model-value="isGroupSelected(group.name)"
:indeterminate="isGroupIndeterminate(group.name)"
@change="(v: string | number | boolean) => handleToggleGroup(group.name, v)"
>
全选
</el-checkbox>
<span class="export-group-count">
{{ getGroupSelectedCount(group.name) }}/{{ group.fields.length }}
</span>
</div>
<div class="export-group-list">
<el-checkbox-group :model-value="selected" @update:model-value="handleSelectedChange">
<el-checkbox
v-for="field in group.fields"
:key="field"
:value="field"
class="export-field-item"
>
{{ field }}
</el-checkbox>
</el-checkbox-group>
</div>
</div>
<el-empty v-if="!visibleGroups.length" description="未找到匹配的字段" :image-size="60" />
</div>
</section>
</div>
</div>
</template>
<script setup lang="ts">
import { computed, ref, watch } from 'vue'
import { Search } from '@element-plus/icons-vue'
import { useUserStore } from '@/stores/modules/user'
import {
ORDER_TAB_LIST,
getOrderExportColumnGroupsByMode,
type OrderExportColumnMode
} from '@/views/order/orderManagement/config/order-common-config'
import { ORDER_INDEX_EXPORT_SCOPES } from '@/views/order/shared/orderListExport'
defineOptions({ name: 'SettingsExportColumnsSection' })
const userStore = useUserStore()
/** 本分区本期只覆盖「导出全部(不含明细)」= waybill 模式 */
const EXPORT_MODE: OrderExportColumnMode = 'waybill'
/** 可配置的订单子页(与导出弹窗的 scopeKey 一一对应) */
const pageList = ORDER_TAB_LIST.filter((page) => page.name in ORDER_INDEX_EXPORT_SCOPES)
const allFields = computed(() => {
const groups = getOrderExportColumnGroupsByMode(EXPORT_MODE)
return groups.flatMap((group) => group.fields)
})
const columnGroups = computed(() => getOrderExportColumnGroupsByMode(EXPORT_MODE))
const selectedPage = ref(pageList[0]?.name || '')
const selected = ref<string[]>([])
const keyword = ref('')
/** 触发 localStorage 重新读取(localStorage 本身不是响应式) */
const version = ref(0)
function storageKeyOf(pageName: string): string {
const userId = userStore.user?.username || userStore.user?.id || 'unknown'
const roleId = userStore.roleId || 'default'
return `order_export_columns_${userId}_${roleId}_${pageName}_${EXPORT_MODE}`
}
function isConfigured(pageName: string): boolean {
void version.value
try {
return localStorage.getItem(storageKeyOf(pageName)) !== null
} catch {
return false
}
}
function loadForPage(pageName: string) {
const valid = new Set(allFields.value)
let saved: string[] | null = null
let hasConfig = false
try {
const raw = localStorage.getItem(storageKeyOf(pageName))
if (raw !== null) {
hasConfig = true
const parsed = JSON.parse(raw)
if (Array.isArray(parsed)) {
saved = parsed.filter((field): field is string => typeof field === 'string' && valid.has(field))
}
}
} catch {
hasConfig = false
saved = null
}
// 未配置 → 默认全选;已配置(即使为空数组)→ 以配置为准
selected.value = hasConfig ? saved || [] : allFields.value.slice()
}
watch(
[selectedPage, version],
() => {
if (selectedPage.value) loadForPage(selectedPage.value)
},
{ immediate: true }
)
/** 任何勾选变化 → 立即写入该页配置 */
function persist(next: string[]) {
if (!selectedPage.value) return
const valid = new Set(allFields.value)
const fields = next.filter((field) => valid.has(field))
try {
localStorage.setItem(storageKeyOf(selectedPage.value), JSON.stringify(fields))
} catch {
// localStorage 不可用时静默失败
}
version.value += 1
}
function handleSelectedChange(value: string[] | string | number | boolean | undefined) {
const next = Array.isArray(value) ? value : []
selected.value = next
persist(next)
}
const visibleGroups = computed(() => {
const kw = keyword.value.trim().toLowerCase()
if (!kw) return columnGroups.value
return columnGroups.value
.map((group) => ({ ...group, fields: group.fields.filter((field) => field.toLowerCase().includes(kw)) }))
.filter((group) => group.fields.length > 0)
})
const isAllSelected = computed(
() => allFields.value.length > 0 && selected.value.length === allFields.value.length
)
const isIndeterminate = computed(() => selected.value.length > 0 && !isAllSelected.value)
function getGroupFields(groupName: string): string[] {
return columnGroups.value.find((group) => group.name === groupName)?.fields || []
}
function getGroupSelectedCount(groupName: string): number {
const fields = getGroupFields(groupName)
return selected.value.filter((field) => fields.includes(field)).length
}
function isGroupSelected(groupName: string): boolean {
const fields = getGroupFields(groupName)
return fields.length > 0 && fields.every((field) => selected.value.includes(field))
}
function isGroupIndeterminate(groupName: string): boolean {
const count = getGroupSelectedCount(groupName)
return count > 0 && !isGroupSelected(groupName)
}
function handleToggleGroup(groupName: string, value: string | number | boolean) {
const fields = getGroupFields(groupName)
const set = new Set(selected.value)
if (Boolean(value)) fields.forEach((field) => set.add(field))
else fields.forEach((field) => set.delete(field))
const next = allFields.value.filter((field) => set.has(field))
selected.value = next
persist(next)
}
function handleToggleAll() {
const next = isAllSelected.value ? [] : allFields.value.slice()
selected.value = next
persist(next)
}
function handleReverse() {
const current = new Set(selected.value)
const next = allFields.value.filter((field) => !current.has(field))
selected.value = next
persist(next)
}
function handleClear() {
selected.value = []
persist([])
}
/** 恢复默认:删除该页配置(导出弹窗默认全选) */
function resetCurrent() {
if (!selectedPage.value) return
try {
localStorage.removeItem(storageKeyOf(selectedPage.value))
} catch {
// 忽略
}
selected.value = allFields.value.slice()
version.value += 1
}
</script>
<style lang="scss" scoped>
@use './shared.scss';
.export-section {
height: 100%;
}
.export-body {
display: flex;
gap: 16px;
flex: 1;
min-height: 0;
}
.export-nav {
width: 208px;
flex-shrink: 0;
padding-right: 12px;
border-right: 1px solid #ebeef5;
overflow: auto;
}
.export-nav-list {
display: flex;
flex-direction: column;
gap: 2px;
}
.page-item {
display: flex;
align-items: center;
justify-content: space-between;
gap: 8px;
min-height: 32px;
padding: 0 10px;
border-radius: 4px;
font-size: 13px;
color: #606266;
cursor: pointer;
transition: background-color 0.2s, color 0.2s;
&:hover {
background: #f5f7fa;
}
&.is-active {
background: #ecf5ff;
color: #409eff;
font-weight: 600;
}
}
.page-title {
min-width: 0;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
.export-content {
flex: 1;
min-width: 0;
display: flex;
flex-direction: column;
min-height: 0;
}
.export-toolbar {
display: flex;
align-items: center;
gap: 12px;
flex-wrap: wrap;
padding: 0 0 8px 12px;
}
.export-search {
width: 200px;
}
.export-count {
font-size: 12px;
color: #909399;
}
.export-groups {
flex: 1;
min-height: 0;
overflow: auto;
padding: 0 0 8px 12px;
}
.export-group + .export-group {
margin-top: 10px;
}
.export-group-head {
display: flex;
align-items: center;
gap: 12px;
padding: 2px 0;
}
.export-group-name {
font-size: 13px;
font-weight: 600;
color: #303133;
}
.export-group-count {
font-size: 12px;
color: #909399;
}
.export-group-list {
:deep(.el-checkbox-group) {
display: grid;
grid-template-columns: repeat(3, minmax(0, 1fr));
column-gap: 12px;
row-gap: 2px;
margin-top: 2px;
}
:deep(.el-checkbox) {
margin-right: 0;
height: 30px;
}
}
.export-field-item {
font-size: 13px;
}
</style>

File diff suppressed because it is too large Load Diff

View File

@ -0,0 +1,104 @@
<!--
导航 → 快捷入口
集中管理侧边栏「快捷入口」(通过菜单星标添加/取消)。
数据源:shortcuts store(localStorage: shortcuts_{user}_{role})
-->
<template>
<div class="settings-section">
<div class="section-header">
<div>
<div class="section-title">快捷入口</div>
<div class="section-desc">
在侧边栏菜单项上点击 ★ 可添加/取消快捷入口;此处集中查看与移除(按账号 + 角色保存)。
</div>
</div>
<el-button size="small" :disabled="!list.length" @click="clearAll">清空全部</el-button>
</div>
<div v-if="list.length" class="shortcut-list">
<div v-for="item in list" :key="item.path" class="shortcut-item">
<div class="shortcut-main">
<span class="shortcut-title">{{ item.title }}</span>
<span class="shortcut-path">{{ item.path }}</span>
</div>
<el-button text size="small" @click="remove(item.path)">移除</el-button>
</div>
</div>
<el-empty v-else description="还没有快捷入口,可在侧边栏菜单上点击 ★ 添加" :image-size="60" />
</div>
</template>
<script setup lang="ts">
import { computed } from 'vue'
import { ElMessageBox } from 'element-plus'
import { useShortcutsStore } from '@/stores/modules/shortcuts'
defineOptions({ name: 'SettingsShortcutsSection' })
const shortcutsStore = useShortcutsStore()
const list = computed(() => shortcutsStore.shortcuts)
function remove(path: string) {
shortcutsStore.removeShortcut(path)
}
function clearAll() {
ElMessageBox.confirm('确定清空全部快捷入口吗?', '清空快捷入口', {
type: 'warning',
confirmButtonText: '清空',
cancelButtonText: '取消'
})
.then(() => {
// store 内部 watch(deep) 会自动持久化
shortcutsStore.shortcuts = []
})
.catch(() => {})
}
</script>
<style lang="scss" scoped>
@use './shared.scss';
.shortcut-list {
display: flex;
flex-direction: column;
gap: 6px;
}
.shortcut-item {
display: flex;
align-items: center;
justify-content: space-between;
gap: 12px;
min-height: 40px;
padding: 4px 0 0 12px;
border-bottom: 1px solid #f5f7fa;
&:last-child {
border-bottom: none;
}
}
.shortcut-main {
display: flex;
align-items: baseline;
gap: 10px;
min-width: 0;
}
.shortcut-title {
font-size: 13px;
color: #303133;
font-weight: 500;
}
.shortcut-path {
font-size: 12px;
color: #a8abb2;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
</style>

View File

@ -0,0 +1,16 @@
<!--
导航 → 标签排序(设置中心内嵌分区)
复用 TabOrderPanel;pageKey 由页面 useTabOrder provide(无则按路由兜底匹配)
-->
<template>
<TabOrderPanel :current-page-key="pageKey" />
</template>
<script setup lang="ts">
import TabOrderPanel from '@/components/TabOrderPanel.vue'
import { injectTabOrderPageKey } from '@/composables/useTabOrder'
defineOptions({ name: 'SettingsTabOrderSection' })
const pageKey = injectTabOrderPageKey()
</script>

View File

@ -0,0 +1,104 @@
/* 设置中心分区通用样式
视觉基准:task-panel(order/waveOrder 新建波次策略、basicManagement 新增投递计划)
—— 输入/选项行透明无容器,12px 标签 #606266,间距 16px */
.settings-section {
display: flex;
flex-direction: column;
gap: 8px;
}
/* ===== 分区标题区 ===== */
.section-header {
display: flex;
align-items: flex-start;
justify-content: space-between;
gap: 12px;
padding: 4px 0 0 12px;
}
.section-title {
font-size: 13px;
line-height: 20px;
font-weight: 600;
color: #303133;
}
.section-desc {
margin-top: 4px;
font-size: 12px;
line-height: 18px;
color: #909399;
}
/* ===== 分组容器:保持透明,不再使用灰色圆角背景 ===== */
.settings-card {
display: flex;
flex-direction: column;
padding: 0;
border: none;
border-radius: 0;
background: transparent;
}
/* ===== 设置行(对齐 task-panel__field--input) ===== */
.setting-row {
display: flex;
align-items: center;
gap: 16px;
min-height: 40px;
padding: 4px 0 0 12px;
}
.setting-label {
flex: 0 0 88px;
width: 88px;
font-size: 12px;
line-height: 20px;
color: #606266;
text-align: left;
}
.setting-hint {
font-size: 12px;
line-height: 18px;
color: #909399;
}
/* ===== 数据/维护类区块 ===== */
.section-block + .section-block {
margin-top: 12px;
}
.block-title {
font-size: 13px;
line-height: 20px;
font-weight: 600;
color: #303133;
padding-left: 2px;
}
.block-desc {
margin-top: 2px;
font-size: 12px;
line-height: 18px;
color: #909399;
padding-left: 2px;
}
.block-desc {
margin: 4px 0 8px;
padding-left: 2px;
font-size: 12px;
line-height: 18px;
color: #909399;
}
.block-actions {
display: flex;
align-items: center;
gap: 8px;
flex-wrap: wrap;
padding-left: 2px;
}

View File

@ -0,0 +1,181 @@
/**
* useTabOrder — 标签排序 / 默认页签的唯一实现
*
* 页面接入示例:
* const { orderedTabs, defaultTabName, resolveInitialTab, saveOrder, setDefault, reset } =
* useTabOrder('order.management', () => tabList.value, { legacyScopes: ['order.tabs.order'] })
*
* 读取优先级:
* 1. 新文档(userPreference 用户级 scope `tabOrder`)
* 2. 旧 scope(legacyScopes,命中后一次性迁移进新文档)
* 3. 传入的默认顺序(tabs 原顺序)
*
* 初始激活页签优先级:
* URL ?tab=(合法时) > 用户默认 > 页面兜底默认 > 排序后第一项
*/
import { computed, inject, onMounted, provide, watch, type ComputedRef, type InjectionKey } from 'vue'
import { useUserPreferenceStore } from '@/stores/modules/userPreference'
import {
applyTabOrder,
isValidTabName,
normalizeTabOrder,
readTabOrderDoc,
updateTabOrderDoc,
type TabOption
} from '@/utils/tab-order'
/** 页面 key 注入键:字段设置里的「标签排序」用它高亮当前页 */
export const TAB_ORDER_PAGE_KEY: InjectionKey<ComputedRef<string>> = Symbol('tabOrderPageKey')
export interface UseTabOrderOptions {
/** 旧配置 scope(按顺序尝试;命中的顺序会在挂载时迁移到新文档) */
legacyScopes?: string[] | (() => string[])
/** 页面级默认标签兜底(用户未设置默认时使用;返回空则用排序后第一项) */
fallbackTabName?: string | (() => string | undefined)
/** 是否把 pageKey provide 给后代(默认开启,供字段设置高亮当前页) */
provideKey?: boolean
}
type ValueOrGetter<T> = T | (() => T)
function resolveValue<T>(input: ValueOrGetter<T> | { value: T }): T {
const raw: any = input
if (typeof raw === 'function') return raw() as T
if (raw && typeof raw === 'object' && 'value' in raw) return raw.value as T
return raw as T
}
export function useTabOrder(
pageKey: ValueOrGetter<string> | ComputedRef<string>,
tabs: () => TabOption[],
options: UseTabOrderOptions = {}
) {
const pref = useUserPreferenceStore()
const key = computed(() => String(resolveValue(pageKey) || ''))
/** 响应式文档:store 变更后所有页面立即重排(字段设置里保存即生效) */
const doc = computed(() => readTabOrderDoc())
/** 旧配置顺序(兼容读取) */
const legacyOrder = computed<string[]>(() => {
const scopes = resolveValue<string[]>(options.legacyScopes ?? [])
if (!Array.isArray(scopes) || !scopes.length) return []
for (const scope of scopes) {
const value = pref.get(scope) ?? pref.getGlobal(scope)
if (Array.isArray(value) && value.length) {
return value.filter((name): name is string => typeof name === 'string' && !!name)
}
}
return []
})
/** 当前生效的 name 顺序(自定义 → 旧配置 → 空表示默认顺序) */
const savedOrder = computed<string[]>(() => {
const explicit = doc.value.orders[key.value]
if (Array.isArray(explicit) && explicit.length) return explicit
return legacyOrder.value
})
/** 排序后的标签(保留原始对象,页面自定义字段如 count 不丢) */
const orderedTabs = computed<TabOption[]>(() => {
const list = tabs()
if (!savedOrder.value.length) return list
return applyTabOrder(savedOrder.value, list)
})
/** 用户设置的默认标签(非法时返回空串) */
const userDefaultTab = computed(() => {
const name = doc.value.defaults[key.value]
return isValidTabName(name, tabs()) ? String(name) : ''
})
/** 页面兜底默认(未设置或已失效时使用) */
const fallbackTab = computed(() => {
const name = resolveValue<string | undefined>(options.fallbackTabName ?? '')
return isValidTabName(name, tabs()) ? String(name) : ''
})
/** 最终默认标签:用户默认 → 页面兜底 → 排序后第一项 */
const defaultTabName = computed(
() => userDefaultTab.value || fallbackTab.value || orderedTabs.value[0]?.name || ''
)
/** 是否被用户自定义过(顺序或默认) */
const isCustomized = computed(
() => !!doc.value.orders[key.value]?.length || !!doc.value.defaults[key.value]
)
/** 解析初始激活标签:合法 URL tab 优先,其次默认标签 */
function resolveInitialTab(urlTab?: string | null): string {
const raw = urlTab === undefined || urlTab === null ? '' : String(urlTab).trim()
if (raw && isValidTabName(raw, tabs())) return raw
return defaultTabName.value
}
/** 保存顺序(自动剔除非法项、补齐缺失项) */
function saveOrder(order: unknown): string[] {
const normalized = normalizeTabOrder(order, tabs())
updateTabOrderDoc((draft) => {
draft.orders[key.value] = normalized
})
return normalized
}
/** 设置默认标签;传空表示清除 */
function setDefault(name: string | null): void {
updateTabOrderDoc((draft) => {
if (!name || !isValidTabName(name, tabs())) {
delete draft.defaults[key.value]
return
}
draft.defaults[key.value] = name
})
}
/** 恢复默认(同时清除顺序与默认标签) */
function reset(): void {
updateTabOrderDoc((draft) => {
delete draft.orders[key.value]
delete draft.defaults[key.value]
})
}
/**
* 旧配置一次性迁移:新文档无该页配置、但旧 scope 有值时,写入新文档。
* 旧 key 不删除(便于回滚);迁移后「恢复默认」才会真正回到默认顺序。
*/
function seedLegacyIfNeeded() {
if (!key.value) return
if (doc.value.orders[key.value]?.length) return
if (!legacyOrder.value.length) return
updateTabOrderDoc((draft) => {
draft.orders[key.value] = normalizeTabOrder(legacyOrder.value, tabs())
})
}
if (options.provideKey !== false) provide(TAB_ORDER_PAGE_KEY, key)
onMounted(seedLegacyIfNeeded)
watch(key, () => seedLegacyIfNeeded())
return {
pageKey: key,
orderedTabs,
savedOrder,
defaultTabName,
userDefaultTab,
isCustomized,
resolveInitialTab,
saveOrder,
setDefault,
reset,
seedLegacyIfNeeded
}
}
/** 供 UpperTable 等后代组件读取当前页面 key(无注入时返回空串) */
export function injectTabOrderPageKey(): string {
const key = inject(TAB_ORDER_PAGE_KEY, null)
return key?.value || ''
}

View File

@ -0,0 +1,238 @@
/**
* 标签排序注册表(唯一事实来源)
*
* 新增一个支持「标签排序 / 默认页签」的页面 = 在这里加一条:
* { key, title, group, loadTabs, legacyScopes?, matchPaths }
*
* 约定:
* - key 全局唯一、稳定不变(配置以它为键),建议 `<模块>.<页面>` 全小写
* - loadTabs 用动态 import 拿默认标签,避免把各页面配置打进主包
* - legacyScopes 为历史配置 scope(旧代码写过的键),用于无缝兼容
* - matchPaths 仅用于全局面板「高亮当前页」的兜底匹配(菜单 path 由后端下发,可能不匹配)
*/
import type { TabOption } from '@/utils/tab-order'
export interface TabOrderRegistryItem {
/** 稳定主键,同时是配置键 */
key: string
/** 面板展示名称 */
title: string
/** 分组(面板左侧列表) */
group: string
/** 默认标签(顺序即默认顺序);懒加载 */
loadTabs: () => Promise<TabOption[]>
/** 页面兜底默认标签:用户未设置默认时使用(缺省则用第一个标签) */
defaultTabName?: string
/** 旧配置 scope(按优先级读取,命中后一次性迁移) */
legacyScopes?: string[]
/** 路由别名(后缀匹配,用于高亮当前页) */
matchPaths?: string[]
/** 是否已接入排序(false 时不参与保存,仅展示) */
enabled?: boolean
}
function fromTabPages(
loader: () => Promise<{ tabPages: { name: string; label: string }[] }>
): () => Promise<TabOption[]> {
return async () => {
const mod = await loader()
return (mod.tabPages || []).map((tab) => ({ name: tab.name, label: tab.label }))
}
}
export const TAB_ORDER_REGISTRY: TabOrderRegistryItem[] = [
// ==================== 订单 ====================
{
key: 'order.management',
title: '订单管理',
group: '订单',
legacyScopes: ['order.tabs.order'],
matchPaths: ['order', 'orderManagement'],
/** 页面默认打开「待处理订单」 */
defaultTabName: 'pendingOrder',
loadTabs: async () => {
const mod = await import('@/views/order/orderManagement/config/order-common-config')
return mod.ORDER_TAB_LIST.map((tab) => ({ name: tab.name, label: tab.label }))
}
},
{
key: 'order.wave',
title: '波次管理',
group: '订单',
legacyScopes: ['order.wave.tabs.order'],
matchPaths: ['wave', 'waveOrder'],
// name/label 与 views/order/waveOrder/index.vue 的 tabs 保持一致(name 为配置键,必须一致)
loadTabs: async () => [
{ name: 'groupWave', label: '团购波次' },
{ name: 'sandanWave', label: '散单波次' },
{ name: 'sandanFallbackOrders', label: '不符合波次策略订单列表' },
{ name: 'sandanWaveStrategy', label: '波次策略' },
{ name: 'pickTaskWave', label: '拣货中任务' }
]
},
{
key: 'order.pickingShortage',
title: '缺货补货',
group: '订单',
matchPaths: ['pickingShortage'],
loadTabs: fromTabPages(() => import('@/views/stock/pickingShortage/config/picking-shortage-config'))
},
// ==================== 仓储 ====================
{
key: 'stock.management',
title: '商品管理',
group: '仓储',
legacyScopes: ['stock.tabs.order'],
matchPaths: ['stockManagement', 'stock/index'],
loadTabs: async () => [
{ name: 'stockDetail', label: '商品明细' },
{ name: 'comboStock', label: '组合商品' }
]
},
{
key: 'storage.stockcheck',
title: '库存盘点',
group: '仓储',
matchPaths: ['stockcheck'],
loadTabs: fromTabPages(() => import('@/views/storage/stockcheck/config/template-config'))
},
{
key: 'storage.generalreport',
title: '通用报表',
group: '仓储',
matchPaths: ['generalreport'],
loadTabs: fromTabPages(() => import('@/views/storage/generalreport/config/template-config'))
},
// ==================== 售后 / 快递 ====================
{
key: 'afterSale.typelist',
title: '售后类型',
group: '售后',
matchPaths: ['typelist'],
loadTabs: fromTabPages(() => import('@/views/afterSale/typelist/config/template-config'))
},
{
key: 'express.waybill',
title: '运单管理',
group: '售后',
matchPaths: ['waybill', 'express/index'],
loadTabs: fromTabPages(() => import('@/views/express/waybill/config/template-config'))
},
{
key: 'data.returnrecord',
title: '退回记录',
group: '售后',
// 含「未保存离开」拦截,暂未接入 TabArea,先只做展示(不参与排序保存)
enabled: false,
matchPaths: ['returnrecord'],
loadTabs: async () => [
{ name: 'returnReceivedTask', label: '退回收件任务' },
{ name: 'returnReceived', label: '退回收件登记' },
{ name: 'returnUnpack', label: '退回拆包单' },
{ name: 'returnwaybill', label: '未退登记' },
{ name: 'receive', label: '收件' },
{ name: 'unpackwork', label: '退回拆包作业' }
]
},
// ==================== 数据 ====================
{
key: 'data.ordersummary',
title: '订单汇总',
group: '数据',
matchPaths: ['ordersummary'],
loadTabs: fromTabPages(() => import('@/views/data/ordersummary/config/template-config'))
},
{
key: 'mode',
title: '页面模板示例',
group: '数据',
matchPaths: ['mode'],
loadTabs: fromTabPages(() => import('@/views/mode/config/template-config'))
},
// ==================== 设置 ====================
{
key: 'setting.basicManagement',
title: '基础设置',
group: '设置',
legacyScopes: ['setting.basicManagement.tabs.order'],
matchPaths: ['basicManagement'],
loadTabs: fromTabPages(() => import('@/views/system/setting/basicManagement/newview/config/template-config'))
},
{
key: 'system.setting.encoding',
title: '编码管理',
group: '设置',
matchPaths: ['encoding'],
loadTabs: async () => [
{ name: 'courierCode', label: '快递编码管理' },
{ name: 'platformCode', label: '平台编码管理' }
]
},
{
key: 'system.setting.workbench',
title: '工作台管理',
group: '设置',
matchPaths: ['workbench'],
loadTabs: fromTabPages(() => import('@/views/system/setting/workbench2/config/template-config'))
},
{
key: 'system.setting.printcomputer',
title: '打印电脑管理',
group: '设置',
matchPaths: ['printcomputer'],
loadTabs: fromTabPages(() => import('@/views/system/setting/printcomputer/config/template-config'))
},
// ==================== 视频 ====================
{
key: 'video.camera',
title: '摄像头管理',
group: '视频',
matchPaths: ['camera/index', 'newcamara'],
loadTabs: fromTabPages(() => import('@/views/video/newcamara/config/camara-config'))
},
{
key: 'video.cameraServer',
title: '录像机管理',
group: '视频',
matchPaths: ['cameraServer', 'newcamaraserver'],
loadTabs: fromTabPages(() => import('@/views/video/newcamaraserver/config/camaraserver-config'))
}
]
/** 全部分组(保持注册表顺序) */
export const TAB_ORDER_GROUPS: string[] = Array.from(new Set(TAB_ORDER_REGISTRY.map((item) => item.group)))
/** 按 key 取注册项 */
export function getTabOrderRegistryItem(key: string): TabOrderRegistryItem | undefined {
return TAB_ORDER_REGISTRY.find((item) => item.key === key)
}
/** 全部可保存的页面 key(导出/导入/清理时使用) */
export function getTabOrderPageKeys(): string[] {
return TAB_ORDER_REGISTRY.map((item) => item.key)
}
/** 按路由 path 兜底匹配页面 key(仅用于高亮,匹配不到返回空串) */
export function matchTabOrderPageKey(path: string): string {
const normalized = String(path || '').toLowerCase()
if (!normalized) return ''
let best = ''
let bestScore = 0
TAB_ORDER_REGISTRY.forEach((item) => {
;(item.matchPaths || []).forEach((candidate) => {
const token = candidate.toLowerCase()
if (!token) return
if (!normalized.includes(token)) return
if (token.length > bestScore) {
bestScore = token.length
best = item.key
}
})
})
return best
}

View File

@ -0,0 +1,383 @@
/**
* tbyc-config.json 的配置分区注册表
*
* 每个分区提供两件事:
* collect() 导出时收集当前配置(返回 undefined/null 则本次不写入该分区)
* apply(data) 导入时应用配置,返回成功应用的条数(0 表示无变化)
*
* 新增一类可导入导出的配置:在此数组里加一项即可(无需改 UpperTable / 文件格式)。
*/
import { useUserStore } from '@/stores/modules/user'
import { useSettingsStore } from '@/stores/modules/settings'
import { useShortcutsStore } from '@/stores/modules/shortcuts'
import { useExperimentalStore } from '@/stores/modules/experimental'
import { useUserPreferenceStore } from '@/stores/modules/userPreference'
import { useScanFilterPresetsStore } from '@/stores/modules/scanFilterPresets'
import { PRINTER_AUTO_RECONNECT_SCOPE } from '@/stores/modules/printerComponent'
import { getTabOrderPageKeys } from '@/config/tab-order-registry'
import { ORDER_INDEX_EXPORT_SCOPES } from '@/views/order/shared/orderListExport'
import { getOrderExportColumnsByMode } from '@/views/order/orderManagement/config/order-common-config'
import {
normalizeTabOrderDoc,
readTabOrderDoc,
writeTabOrderDoc
} from '@/utils/tab-order'
/** 表格列配置项(与 UpperTable 内部结构保持一致) */
export interface TbycColumnConfigItem {
prop: string
label?: string
visible: boolean
order: number
width?: number | string
fixed?: 'left' | 'right' | false
}
/** 单张表的列配置档案(与 UpperTable 的 TableColumnProfile 保持一致) */
export interface TbycColumnProfile {
schemaVersion: number
tableId: string
userId: string
roleId: string | number
updatedAt: number
columns: TbycColumnConfigItem[]
}
export interface TbycConfigSection {
/** 分区 key(写入 sections[ key ]) */
key: string
/** 展示名称(导入结果提示用) */
title: string
collect: () => unknown
apply: (data: unknown) => number
}
const COLUMN_STORAGE_PREFIX = 'upper_table_columns_'
/** 当前身份(与 UpperTable 的字段配置 key 规则保持一致) */
function currentIdentity(): { userId: string; roleId: string | number } {
const userStore = useUserStore()
const userId = String(userStore.user?.username || userStore.user?.id || 'unknown')
const roleId = userStore.roleId || 'default'
return { userId, roleId }
}
function columnStoragePrefix(): string {
const { userId, roleId } = currentIdentity()
return `${COLUMN_STORAGE_PREFIX}${userId}_${roleId}_`
}
/** ============ 分区 1:字段设置(表格列配置) ============ */
const fieldColumnsSection: TbycConfigSection = {
key: 'fieldColumns',
title: '字段设置',
collect: () => {
const prefix = columnStoragePrefix()
const profiles: TbycColumnProfile[] = []
Object.keys(localStorage).forEach((key) => {
if (!key.startsWith(prefix)) return
try {
const parsed = JSON.parse(localStorage.getItem(key) || '{}') as TbycColumnProfile
if (parsed?.tableId && Array.isArray(parsed.columns)) profiles.push(parsed)
} catch {
// 忽略损坏的配置
}
})
return profiles.length ? profiles : undefined
},
apply: (data) => {
if (!Array.isArray(data)) return 0
const prefix = columnStoragePrefix()
const { userId, roleId } = currentIdentity()
let count = 0
data.forEach((profile: any) => {
if (!profile?.tableId || !Array.isArray(profile.columns)) return
const payload: TbycColumnProfile = {
schemaVersion: Number(profile.schemaVersion) || 1,
tableId: String(profile.tableId),
userId,
roleId,
updatedAt: Date.now(),
columns: profile.columns as TbycColumnConfigItem[]
}
try {
localStorage.setItem(`${prefix}${payload.tableId}`, JSON.stringify(payload))
count += 1
} catch {
// localStorage 不可用时跳过
}
})
return count
}
}
/** ============ 分区 2:标签排序 / 默认页签 ============ */
const tabOrderSection: TbycConfigSection = {
key: 'tabOrder',
title: '标签排序',
collect: () => {
const doc = readTabOrderDoc()
return Object.keys(doc.orders).length || Object.keys(doc.defaults).length ? doc : undefined
},
apply: (data) => {
const incoming = normalizeTabOrderDoc(data)
const known = new Set(getTabOrderPageKeys())
const current = readTabOrderDoc()
const orders = { ...current.orders }
const defaults = { ...current.defaults }
let orderCount = 0
let defaultCount = 0
Object.keys(incoming.orders).forEach((key) => {
if (!known.has(key)) return
const order = incoming.orders[key]
if (!order) return
orders[key] = order
orderCount += 1
})
Object.keys(incoming.defaults).forEach((key) => {
if (!known.has(key)) return
const defaultName = incoming.defaults[key]
if (!defaultName) return
defaults[key] = defaultName
defaultCount += 1
})
// 注意:用户可能只设置了“默认标签”而不调整顺序(orders 为空),
// 此时也必须写回,否则默认标签会丢失。
if (orderCount > 0 || defaultCount > 0) {
writeTabOrderDoc({ version: 1, orders, defaults })
}
return orderCount + defaultCount
}
}
/** ============ 分区 3:界面显示(settings store) ============ */
const DISPLAY_BOOLEAN_KEYS = [
'showSettings',
'tagsView',
'fixedHeader',
'sidebarLogo',
'shortcutExpanded'
] as const
const DISPLAY_ENUM_KEYS: Record<string, readonly string[]> = {
layoutMode: ['sidebar', 'top-bottom'],
toolbarMode: ['tile', 'collapse'],
scanBoxMode: ['standard', 'compact']
}
const displaySection: TbycConfigSection = {
key: 'display',
title: '界面显示',
collect: () => {
const settings = useSettingsStore()
return {
showSettings: settings.showSettings,
tagsView: settings.tagsView,
fixedHeader: settings.fixedHeader,
sidebarLogo: settings.sidebarLogo,
shortcutExpanded: settings.shortcutExpanded,
layoutMode: settings.layoutMode,
toolbarMode: settings.toolbarMode,
scanBoxMode: settings.scanBoxMode
}
},
apply: (data) => {
if (!data || typeof data !== 'object' || Array.isArray(data)) return 0
const source = data as Record<string, any>
const settings = useSettingsStore()
let count = 0
DISPLAY_BOOLEAN_KEYS.forEach((key) => {
const value = source[key]
if (typeof value !== 'boolean') return
settings.changeSetting({ key, value })
count += 1
})
Object.keys(DISPLAY_ENUM_KEYS).forEach((key) => {
const value = source[key]
if (typeof value !== 'string') return
if (!DISPLAY_ENUM_KEYS[key]!.includes(value)) return
settings.changeSetting({ key, value })
count += 1
})
return count
}
}
/** ============ 分区 4:表格与缓存(experimental store) ============ */
const experimentalSection: TbycConfigSection = {
key: 'experimental',
title: '表格与缓存',
collect: () => {
const store = useExperimentalStore()
return {
tableMode: store.tableMode,
tabCacheEnabled: store.tabCacheEnabled,
tabCacheMax: store.tabCacheMax,
pageCacheEnabled: store.pageCacheEnabled,
pageCacheMax: store.pageCacheMax
}
},
apply: (data) => {
if (!data || typeof data !== 'object' || Array.isArray(data)) return 0
const source = data as Record<string, any>
const store = useExperimentalStore()
let count = 0
if (source.tableMode === 'performance' || source.tableMode === 'resource') {
store.setTableMode(source.tableMode)
count += 1
}
if (typeof source.tabCacheEnabled === 'boolean') {
store.setTabCacheEnabled(source.tabCacheEnabled)
count += 1
}
if (Number.isInteger(source.tabCacheMax) && source.tabCacheMax > 0) {
store.setTabCacheMax(source.tabCacheMax)
count += 1
}
if (typeof source.pageCacheEnabled === 'boolean') {
store.setPageCacheEnabled(source.pageCacheEnabled)
count += 1
}
if (Number.isInteger(source.pageCacheMax) && source.pageCacheMax > 0) {
store.setPageCacheMax(source.pageCacheMax)
count += 1
}
return count
}
}
/**
* ============ 分区 5:设备与打印(暂无 UI,仅导出/导入) ============
* 数据源:userPreference 的仓库级 scope `printer.autoReconnect`
*/
const printerSection: TbycConfigSection = {
key: 'printer',
title: '设备与打印',
collect: () => {
const value = useUserPreferenceStore().get(PRINTER_AUTO_RECONNECT_SCOPE)
return value ?? undefined
},
apply: (data) => {
if (!data || typeof data !== 'object' || Array.isArray(data)) return 0
useUserPreferenceStore().set(PRINTER_AUTO_RECONNECT_SCOPE, data)
return 1
}
}
/** ============ 分区 6:快捷键 ============ */
const shortcutsSection: TbycConfigSection = {
key: 'shortcuts',
title: '快捷键',
collect: () => {
const shortcuts = useShortcutsStore().shortcuts
return shortcuts.length ? shortcuts : undefined
},
apply: (data) => {
if (!Array.isArray(data)) return 0
const items = data
.filter((item: any) => item && typeof item.path === 'string' && typeof item.title === 'string')
.map((item: any) => ({
title: String(item.title),
path: String(item.path),
...(typeof item.icon === 'string' ? { icon: item.icon } : {})
}))
if (!items.length) return 0
// store 内部 watch(deep) 会自动持久化
useShortcutsStore().shortcuts = items
return items.length
}
}
/** ============ 分区 7:订单导出字段(订单管理 · 导出弹窗的字段勾选) ============ */
const ORDER_EXPORT_MODES = ['waybill', 'item'] as const
const orderExportColumnsSection: TbycConfigSection = {
key: 'orderExportColumns',
title: '订单导出字段',
collect: () => {
const { userId, roleId } = currentIdentity()
const prefix = `order_export_columns_${userId}_${roleId}_`
const result: Record<string, Record<string, string[]>> = {}
Object.keys(localStorage).forEach((key) => {
if (!key.startsWith(prefix)) return
const [scopeKey, mode] = key.slice(prefix.length).split('_')
if (!scopeKey || !mode) return
try {
const parsed = JSON.parse(localStorage.getItem(key) || 'null')
if (!Array.isArray(parsed)) return
const scope = result[scopeKey] || (result[scopeKey] = {})
scope[mode] = parsed.filter((field: unknown): field is string => typeof field === 'string')
} catch {
// 忽略损坏的配置
}
})
return Object.keys(result).length ? result : undefined
},
apply: (data) => {
if (!data || typeof data !== 'object' || Array.isArray(data)) return 0
const { userId, roleId } = currentIdentity()
const prefix = `order_export_columns_${userId}_${roleId}_`
const source = data as Record<string, Record<string, unknown>>
let count = 0
Object.keys(source).forEach((scopeKey) => {
if (!(scopeKey in ORDER_INDEX_EXPORT_SCOPES)) return
const scoped = source[scopeKey]
if (!scoped || typeof scoped !== 'object' || Array.isArray(scoped)) return
ORDER_EXPORT_MODES.forEach((mode) => {
const list = scoped[mode]
if (!Array.isArray(list)) return
const valid = new Set(getOrderExportColumnsByMode(mode))
const fields = list.filter((field): field is string => typeof field === 'string' && valid.has(field))
try {
localStorage.setItem(`${prefix}${scopeKey}_${mode}`, JSON.stringify(fields))
count += 1
} catch {
// localStorage 不可用时跳过
}
})
})
return count
}
}
/** ============ 分区 8:自定义过滤条件(ScanBox「过滤」页签) ============ */
const scanFilterPresetsSection: TbycConfigSection = {
key: 'scanFilterPresets',
title: '自定义过滤条件',
collect: () => {
const store = useScanFilterPresetsStore()
store.ensureLoaded()
return store.presets.length ? { version: 1, presets: store.presets } : undefined
},
apply: (data) => {
if (!data || typeof data !== 'object') return 0
const store = useScanFilterPresetsStore()
store.ensureLoaded()
return store.importPresets(data)
}
}
export const TBYC_CONFIG_SECTIONS: TbycConfigSection[] = [
fieldColumnsSection,
tabOrderSection,
displaySection,
experimentalSection,
printerSection,
shortcutsSection,
orderExportColumnsSection,
scanFilterPresetsSection
]
/** 按 key 取分区 */
export function getTbycConfigSection(key: string): TbycConfigSection | undefined {
return TBYC_CONFIG_SECTIONS.find((section) => section.key === key)
}

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><rect x='3' y='6' width='18' height='12' rx='2'/><path d='M3 10h18'/><path d='M7 15h4'/></svg>

After

Width:  |  Height:  |  Size: 260 B

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M4 14v-2a8 8 0 0 1 16 0v2'/><rect x='3' y='14' width='4' height='6' rx='1.5'/><rect x='17' y='14' width='4' height='6' rx='1.5'/><path d='M19 20a3 3 0 0 1-3 3h-2'/></svg>

After

Width:  |  Height:  |  Size: 345 B

1
src/icons/svg/api.svg Normal file
View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M9 8 5 12l4 4'/><path d='M15 8l4 4-4 4'/><path d='M13 6l-2 12'/></svg>

After

Width:  |  Height:  |  Size: 245 B

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M4 5v14'/><path d='M7 5v14'/><path d='M10.5 5v14'/><path d='M13.5 5v14'/><path d='M17 5v14'/><path d='M20 5v14'/></svg>

After

Width:  |  Height:  |  Size: 294 B

1
src/icons/svg/bill.svg Normal file
View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M6 3h12v18l-3-2-3 2-3-2-3 2z'/><path d='M9 8h6M9 12h6'/></svg>

After

Width:  |  Height:  |  Size: 237 B

1
src/icons/svg/cart.svg Normal file
View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M3 4h2l2.5 11h10L20 7H6'/><circle cx='9' cy='19' r='1.5'/><circle cx='17' cy='19' r='1.5'/></svg>

After

Width:  |  Height:  |  Size: 272 B

1
src/icons/svg/combo.svg Normal file
View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><rect x='3' y='3' width='8' height='8' rx='1.5'/><rect x='13' y='13' width='8' height='8' rx='1.5'/><path d='M13 7h6M16 4v6'/></svg>

After

Width:  |  Height:  |  Size: 298 B

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M4 4v16h16'/><path d='M8 16v-4'/><path d='M12 16v-8'/><path d='M16 16v-6'/></svg>

After

Width:  |  Height:  |  Size: 256 B

1
src/icons/svg/erp.svg Normal file
View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><ellipse cx='12' cy='6' rx='7' ry='3'/><path d='M5 6v12c0 1.7 3.1 3 7 3s7-1.3 7-3V6'/><path d='M5 12c0 1.7 3.1 3 7 3s7-1.3 7-3'/></svg>

After

Width:  |  Height:  |  Size: 301 B

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M12 3 2.5 20h19z'/><path d='M12 9v5'/><path d='M12 17v.01'/></svg>

After

Width:  |  Height:  |  Size: 241 B

1
src/icons/svg/expiry.svg Normal file
View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M7 3h10'/><path d='M7 21h10'/><path d='M7 3c0 5 5 5 5 9s-5 4-5 9'/><path d='M17 3c0 5-5 5-5 9s5 4 5 9'/></svg>

After

Width:  |  Height:  |  Size: 285 B

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M3 7h11v9H3z'/><path d='M14 10h4l3 3v3h-7'/><circle cx='7' cy='18' r='1.8'/><circle cx='17.5' cy='18' r='1.8'/><path d='M3 16h1.2'/><path d='M9 18h6.7'/></svg>

After

Width:  |  Height:  |  Size: 334 B

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M3 20V11l6-3.5L15 11v9'/><path d='M3 20h12'/><path d='M18 5h4M20 3v4'/></svg>

After

Width:  |  Height:  |  Size: 252 B

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M4 7h14a2 2 0 0 1 2 2v9a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z'/><path d='M4 7V6a2 2 0 0 1 2-2h10'/><circle cx='16.5' cy='13.5' r='1.2'/></svg>

After

Width:  |  Height:  |  Size: 310 B

1
src/icons/svg/flow.svg Normal file
View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M4 7h13l-3-3'/><path d='M4 12h16'/><path d='M4 17h13l-3 3'/></svg>

After

Width:  |  Height:  |  Size: 241 B

1
src/icons/svg/goods.svg Normal file
View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M12 3 3 7.5v9L12 21l9-4.5v-9z'/><path d='M3 7.5 12 12l9-4.5'/><path d='M12 12v9'/></svg>

After

Width:  |  Height:  |  Size: 263 B

1
src/icons/svg/group.svg Normal file
View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><circle cx='9' cy='8' r='3'/><path d='M3 19a6 6 0 0 1 12 0'/><circle cx='17' cy='9' r='2.5'/><path d='M15.5 19a5 5 0 0 1 5.5-4.5'/></svg>

After

Width:  |  Height:  |  Size: 303 B

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M4 11h16v7a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2z'/><path d='M12 3v8'/><path d='M9 8l3 3 3-3'/></svg>

After

Width:  |  Height:  |  Size: 268 B

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M3 13V6a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2v7'/><path d='M3 13h5l2 3h4l2-3h5v5a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z'/></svg>

After

Width:  |  Height:  |  Size: 288 B

1
src/icons/svg/list.svg Normal file
View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M8 6h13M8 12h13M8 18h13'/><path d='M3.5 6h.01M3.5 12h.01M3.5 18h.01'/></svg>

After

Width:  |  Height:  |  Size: 251 B

1
src/icons/svg/log.svg Normal file
View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M5 4h11l3 3v13a1 1 0 0 1-1 1H5a1 1 0 0 1-1-1V5a1 1 0 0 1 1-1z'/><path d='M8 9h8M8 13h8M8 17h5'/></svg>

After

Width:  |  Height:  |  Size: 277 B

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M14 3H7a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V8z'/><path d='M14 3v5h5'/><path d='M12 11v.01'/><path d='M12 14v4'/></svg>

After

Width:  |  Height:  |  Size: 305 B

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><rect x='3' y='13' width='8' height='8' rx='1.5'/><rect x='13' y='3' width='8' height='8' rx='1.5'/><path d='M13 17h4'/><path d='M15 15v4'/></svg>

After

Width:  |  Height:  |  Size: 312 B

1
src/icons/svg/order.svg Normal file
View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M14 3H7a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V8z'/><path d='M14 3v5h5'/><path d='M9 13h6'/><path d='M9 17h4'/></svg>

After

Width:  |  Height:  |  Size: 301 B

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M4 11h16v7a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2z'/><path d='M12 13V5'/><path d='M9 8l3-3 3 3'/></svg>

After

Width:  |  Height:  |  Size: 269 B

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><rect x='4' y='6' width='16' height='14' rx='2'/><path d='M4 10h16'/><path d='M12 6v14'/></svg>

After

Width:  |  Height:  |  Size: 261 B

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M12 3l7 3v6c0 4.5-3 7.7-7 9-4-1.3-7-4.5-7-9V6z'/><path d='M9 12l2.2 2.2L15.5 10'/></svg>

After

Width:  |  Height:  |  Size: 263 B

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M3 12V4h8l9 9-8 8z'/><circle cx='7.5' cy='8.5' r='1.5'/></svg>

After

Width:  |  Height:  |  Size: 237 B

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M7 9V4h10v5'/><rect x='4' y='9' width='16' height='7' rx='2'/><path d='M7 14h10v6H7z'/></svg>

After

Width:  |  Height:  |  Size: 268 B

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><rect x='5' y='3' width='14' height='18' rx='2'/><path d='M9 8h6M9 12h6M9 16h3'/></svg>

After

Width:  |  Height:  |  Size: 253 B

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><circle cx='10.5' cy='13' r='6.5'/><path d='M10.5 9.5v7'/><path d='M8.5 11.5h4'/><path d='M16.5 5.5 20 9l-3.5 3.5'/></svg>

After

Width:  |  Height:  |  Size: 288 B

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M14 3H7a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V8z'/><path d='M14 3v5h5'/><path d='M8.5 14l2 2 4.5-4.5'/></svg>

After

Width:  |  Height:  |  Size: 294 B

1
src/icons/svg/reply.svg Normal file
View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M4 5h16v10H9l-5 4z'/><path d='M13.5 8l-2 3h3l-2 3'/></svg>

After

Width:  |  Height:  |  Size: 233 B

1
src/icons/svg/return.svg Normal file
View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M9 14 4 9l5-5'/><path d='M4 9h10a6 6 0 0 1 0 12h-3'/></svg>

After

Width:  |  Height:  |  Size: 234 B

1
src/icons/svg/role.svg Normal file
View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><circle cx='9' cy='8' r='3.2'/><path d='M3 19.5a6 6 0 0 1 12 0'/><path d='M16 6.2a3.2 3.2 0 0 1 0 6.1'/><path d='M17.5 14.2A5.2 5.2 0 0 1 21 19.5'/></svg>

After

Width:  |  Height:  |  Size: 320 B

1
src/icons/svg/scale.svg Normal file
View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M12 4v15'/><path d='M7 19h10'/><path d='M5 8h14'/><path d='M5 8 3 13h4z'/><path d='M19 8l-2 5h4z'/><circle cx='12' cy='6' r='1.6'/></svg>

After

Width:  |  Height:  |  Size: 312 B

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><circle cx='12' cy='12' r='3.2'/><path d='M12 2.5v3'/><path d='M12 18.5v3'/><path d='M2.5 12h3'/><path d='M18.5 12h3'/><path d='M5.3 5.3l2.1 2.1'/><path d='M16.6 16.6l2.1 2.1'/><path d='M18.7 5.3l-2.1 2.1'/><path d='M7.4 16.6l-2.1 2.1'/></svg>

After

Width:  |  Height:  |  Size: 409 B

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M4 8 12 4l8 4v8l-8 4-8-4z'/><path d='M4 8l8 4 8-4'/><path d='M12 12v3'/><path d='M12 18v.01'/></svg>

After

Width:  |  Height:  |  Size: 275 B

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><rect x='4' y='3' width='16' height='18' rx='2'/><path d='M8 9l1.5 1.5L12 8'/><path d='M8 16l1.5 1.5L12 15'/><path d='M14 9h3M14 16h3'/></svg>

After

Width:  |  Height:  |  Size: 308 B

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M3 20h18'/><path d='M5 20v-7h6v7'/><path d='M13 20V9h6v11'/><path d='M5 16.5h6'/><path d='M13 14.5h6'/></svg>

After

Width:  |  Height:  |  Size: 284 B

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M4 9h16'/><path d='M3 9 5 4h14l2 5'/><path d='M5 9v11h14V9'/><path d='M10 20v-5h4v5'/></svg>

After

Width:  |  Height:  |  Size: 267 B

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M4 4h16l-6 8v6l-4 2v-8z'/></svg>

After

Width:  |  Height:  |  Size: 207 B

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M3 20V11l5 3V11l5 3V9l8 4v7z'/><path d='M3 20h18'/></svg>

After

Width:  |  Height:  |  Size: 232 B

1
src/icons/svg/system.svg Normal file
View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><rect x='3' y='4' width='18' height='7' rx='2'/><rect x='3' y='13' width='18' height='7' rx='2'/><path d='M7 7.5h.01'/><path d='M7 16.5h.01'/></svg>

After

Width:  |  Height:  |  Size: 314 B

1
src/icons/svg/unpack.svg Normal file
View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M4 10v8l8 4 8-4v-8'/><path d='M4 10l8-4 8 4'/><path d='M9 6 12 2l3 4'/></svg>

After

Width:  |  Height:  |  Size: 252 B

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><circle cx='9' cy='8' r='3.5'/><path d='M3 20a6 6 0 0 1 12 0'/><path d='M16 12.5l2.2 2.2L22 11'/></svg>

After

Width:  |  Height:  |  Size: 269 B

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><rect x='3' y='6' width='12' height='12' rx='2'/><path d='M15 10.5 21 8v8l-6-2.5z'/></svg>

After

Width:  |  Height:  |  Size: 256 B

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><rect x='3' y='3' width='18' height='18' rx='2'/><path d='M9 3v18'/><path d='M15 3v18'/><path d='M3 9h18'/><path d='M3 15h18'/></svg>

After

Width:  |  Height:  |  Size: 299 B

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M3 21V9l9-5 9 5v12'/><path d='M3 21h18'/><path d='M8 21v-6h8v6'/><path d='M8 12h8'/></svg>

After

Width:  |  Height:  |  Size: 265 B

1
src/icons/svg/wave.svg Normal file
View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d='M2 11c2.5-3.5 5-3.5 7.5 0s5 3.5 7.5 0 3.5-2.5 5-2'/><path d='M2 17c2.5-3.5 5-3.5 7.5 0s5 3.5 7.5 0 3.5-2.5 5-2'/></svg>

After

Width:  |  Height:  |  Size: 294 B

View File

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" style="fill:none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><rect x='3' y='4' width='18' height='12' rx='2'/><path d='M12 16v4'/><path d='M8 20h8'/><path d='M7 12l3-3 2.5 2.5L17 8'/></svg>

After

Width:  |  Height:  |  Size: 294 B

View File

@ -93,9 +93,9 @@ function wrapRouteComponent(Component: any, routeName: string | symbol | undefin
width: 100%;
}
.fixed-header + .app-main {
padding-top: 90px;
}
/* 注:原 `.fixed-header + .app-main { padding-top: 90px }` 已移除。
顶部占位现在由 layout/index.vue 的 .fixed-header-spacer(实测高度)负责,
该选择器因中间隔着 spacer 从未命中,属于遗留死代码。 */
</style>
<style lang="scss">

View File

@ -8,13 +8,13 @@
<script setup lang="ts">
import { defineAsyncComponent } from 'vue'
import CreateOrderFloatWidget from '@/views/order/orderManagement/component/CreateOrderFloatWidget.vue'
import { useCreateOrderSession } from '@/views/order/orderManagement/composables/useCreateOrderSession'
import CreateOrderFloatWidget from '@/views/order/shared/createOrderSession/CreateOrderFloatWidget.vue'
import { useCreateOrderSession } from '@/views/order/shared/createOrderSession/useCreateOrderSession'
// 该弹窗静态引入了 xlsx / china-division(合计 ~550kB),而本组件位于布局首屏链路上;
// 改为异步组件按需加载,仅真正打开“新建订单”时才拉取对应 chunk。
const CreatePendingOrderDialog = defineAsyncComponent(
() => import('@/views/order/orderManagement/component/CreatePendingOrderDialog.vue')
() => import('@/views/order/shared/createOrderSession/CreatePendingOrderDialog.vue')
)
const { dialogVisible, sessionActive } = useCreateOrderSession()

View File

@ -70,6 +70,10 @@
{{ tMenu('Profile') }}
</el-dropdown-item>
</router-link>
<el-dropdown-item @click="settingsVisible = true">
<span style="display:block;">设置</span>
</el-dropdown-item>
<el-dropdown-item divided @click="logout">
<span style="display:block;">{{ $t('login.logOut') || 'Log Out' }}</span>
@ -86,6 +90,9 @@
</div>
</div>
</div>
<!-- 设置中心(全局入口:无表格上下文,隐藏「当前页面 → 列表字段」) -->
<settings-dialog v-model:visible="settingsVisible" />
</div>
</template>
@ -99,6 +106,7 @@ import { useFrontBrandStore, DEFAULT_BRAND_LOGO } from '@/stores/modules/frontBr
import { useAiStore } from '@/stores/modules/ai'
import { useRouter, useRoute } from 'vue-router'
import Breadcrumb from '@/components/Breadcrumb/index.vue'
import SettingsDialog from '@/components/settings/SettingsDialog.vue'
import LangSelect from '@/components/LangSelect/index.vue'
import TopMenu from './TopMenu.vue'
import dayjs from 'dayjs'
@ -115,6 +123,8 @@ const settingsStore = useSettingsStore()
const aiStore = useAiStore()
const router = useRouter()
const route = useRoute()
/** 设置中心可见性(全局入口) */
const settingsVisible = ref(false)
const sidebar = computed(() => appStore.sidebar)
const user = computed(() => userStore.user)

View File

@ -8,12 +8,19 @@
:icon="onlyOneChild.meta.icon || (item.meta && item.meta.icon)"
:title="onlyOneChild.name?.replace(/_Child$/, '')"
:path="resolvePath(onlyOneChild.path)"
v-bind="isNest ? { showStar } : {}"
/>
</el-menu-item>
</app-link>
</template>
<el-sub-menu v-else ref="subMenu" :index="resolvePath(item.path)" popper-append-to-body>
<el-sub-menu
v-else
ref="subMenu"
:index="resolvePath(item.path)"
popper-append-to-body
:popper-class="isHorizontal ? 'top-menu-popup' : ''"
>
<template #title>
<component
:is="isNest ? SubItem : Item"
@ -21,12 +28,14 @@
:icon="item.meta.icon"
:title="item.name?.replace(/_Child$/, '')"
:path="resolvePath(item.path)"
v-bind="isNest ? { showStar } : {}"
/>
</template>
<sidebar-item
v-for="child in item.children"
:key="child.path"
:is-nest="true"
:show-star="true"
:item="child"
:base-path="resolvePath(child.path)"
:is-horizontal="isHorizontal"
@ -64,6 +73,14 @@ const props = defineProps({
isHorizontal: {
type: Boolean,
default: false
},
/**
* 当前层是否显示星标(收藏)按钮。
* 递归子项时固定传 true,只有顶部「更多」下拉的一级选项会传 false。
*/
showStar: {
type: Boolean,
default: true
}
})
@ -132,5 +149,27 @@ const resolvePath = (routePath: string) => {
flex-direction: row !important;
height: 40px !important;
}
/* 叶子项:星标靠最右,与展开箭头同一列 */
:deep(.el-menu-item) {
padding-right: 12px !important;
}
/* 带子项:星标(若有)+ 展开箭头,右侧留足 34px */
:deep(.el-sub-menu__title) {
padding-right: 34px !important;
}
/* 展开箭头:与项目蓝色强调色一致,hover 时高亮 */
:deep(.el-sub-menu__icon-arrow) {
right: 12px;
font-size: 12px;
color: #909399;
transition: transform 0.25s ease, color 0.2s ease;
}
:deep(.el-sub-menu__title:hover .el-sub-menu__icon-arrow) {
color: #2f80ed;
}
}
</style>

View File

@ -6,7 +6,7 @@
</div>
<span v-if="title" class="menu-title">{{ tMenu(title) }}</span>
</div>
<div class="shortcut-toggle" @click.stop.prevent="toggleShortcut">
<div v-if="showStar" class="shortcut-toggle" @click.stop.prevent="toggleShortcut">
<el-icon :class="{ 'is-active': isShortcut }">
<Star v-if="!isShortcut" />
<StarFilled v-else />
@ -33,6 +33,14 @@ const props = defineProps({
path: {
type: String,
default: ''
},
/**
* 是否显示右侧星标(收藏)按钮。
* 顶部「更多」下拉里的一级选项关闭该项,其子项仍保留。
*/
showStar: {
type: Boolean,
default: true
}
})
@ -58,6 +66,7 @@ const toggleShortcut = () => {
align-items: center;
justify-content: space-between;
width: 100%;
min-width: 0;
}
.menu-info {
@ -65,6 +74,8 @@ const toggleShortcut = () => {
flex-direction: row;
align-items: center;
flex: 1;
/* 标题过长时先截断,不挤压右侧星标 */
min-width: 0;
}
.menu-icon-wrapper {
@ -73,6 +84,7 @@ const toggleShortcut = () => {
align-items: center;
justify-content: center;
margin-right: 12px;
flex-shrink: 0;
}
.menu-icon {
@ -83,22 +95,36 @@ const toggleShortcut = () => {
.menu-title {
font-size: 14px;
line-height: 1.2;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
/* 收藏(星标):独立点击区,不参与标题排版,避免与展开箭头抢位 */
.shortcut-toggle {
padding: 4px;
cursor: pointer;
flex: 0 0 auto;
width: 22px;
height: 22px;
display: flex;
align-items: center;
justify-content: center;
border-radius: 4px;
color: #909399;
transition: color 0.3s;
cursor: pointer;
transition: color 0.2s ease, background-color 0.2s ease;
:deep(.el-icon) {
font-size: 14px;
}
}
.shortcut-toggle:hover {
color: #f7ba2a;
color: #2f80ed;
background-color: rgba(47, 128, 237, 0.08);
}
/* 已收藏:使用项目主色蓝,与整体配色统一 */
.shortcut-toggle .is-active {
color: #f7ba2a;
color: #2f80ed;
}
</style>

View File

@ -48,20 +48,26 @@ defineExpose({
height: 100%;
:deep(.el-scrollbar__bar) {
bottom: 0px;
height: 4px;
display: none;
}
:deep(.el-scrollbar__wrap) {
height: 30px;
height: 32px;
overflow-x: auto;
overflow-y: hidden;
scrollbar-width: none;
-ms-overflow-style: none;
&::-webkit-scrollbar {
display: none;
}
}
:deep(.el-scrollbar__view) {
height: 30px;
height: 32px;
display: flex;
align-items: center;
/* 标签底边贴住容器底部,与上方按钮下沿对齐 */
align-items: flex-end;
}
}
</style>

View File

@ -3,42 +3,63 @@
<div class="navbar-wrapper">
<navbar />
</div>
<div class="shortcut-key" v-show="shortcutExpanded">
<component
:is="isExternal(shortcut.path) ? 'a' : 'router-link'"
v-for="shortcut in shortcuts"
:key="shortcut.path"
v-bind="isExternal(shortcut.path) ? { href: shortcut.path, target: '_blank' } : { to: shortcut.path }"
class="shortcut-item"
>
<el-tooltip :content="generateTitle(shortcut.title)" placement="bottom" :show-after="500">
<svg-icon v-if="shortcut.icon" :icon-class="shortcut.icon" />
<span :style="{ marginLeft: shortcut.icon ? '5px' : '0' }">{{ generateTitle(shortcut.title) }}</span>
</el-tooltip>
</component>
<!--
展开态:快捷区 = 居中收起按钮 + 上下 10px 间距 + 快捷入口行,
三者共用同一块底色,按钮下沿到入口行顶沿都属于快捷区。
-->
<div v-show="shortcutExpanded" class="shortcut-panel">
<div class="shortcut-toggle shortcut-toggle--expanded" @click="toggleShortcut">
<el-icon><ArrowUp /></el-icon>
</div>
<div class="shortcut-key">
<component
:is="isExternal(shortcut.path) ? 'a' : 'router-link'"
v-for="shortcut in shortcuts"
:key="shortcut.path"
v-bind="isExternal(shortcut.path) ? { href: shortcut.path, target: '_blank' } : { to: shortcut.path }"
class="shortcut-item"
>
<el-tooltip :content="generateTitle(shortcut.title)" placement="bottom" :show-after="500">
<!-- el-tooltip 只接受单一根节点,图标与文字必须包在同一个元素里 -->
<span class="shortcut-item__content">
<svg-icon v-if="shortcut.icon" :icon-class="shortcut.icon" />
<span class="shortcut-item__text">{{ generateTitle(shortcut.title) }}</span>
</span>
</el-tooltip>
</component>
</div>
</div>
<div class="shortcut-toggle" @click="toggleShortcut">
<el-icon><ArrowUp v-if="shortcutExpanded" /><ArrowDown v-else /></el-icon>
</div>
<scroll-pane ref="scrollPane" class="tags-view-wrapper">
<router-link
v-for="tag in visitedViews"
ref="tagsRef"
:key="tag.path"
:class="isActive(tag) ? 'active' : ''"
:to="{ path: tag.path, query: tag.query }"
class="tags-view-item"
@click.middle="!isAffix(tag) && closeSelectedTag(tag)"
@contextmenu.prevent="openMenu(tag, $event)"
<!-- 标签行 + 收起按钮浮层 -->
<div class="tags-view-row">
<scroll-pane ref="scrollPane" class="tags-view-wrapper">
<router-link
v-for="tag in visitedViews"
:ref="(el: any) => setTagRef(el, tag.path)"
:key="tag.path"
v-memo="[tag.path, tag.fullPath, isActive(tag)]"
:class="isActive(tag) ? 'active' : ''"
:to="{ path: tag.path, query: tag.query }"
class="tags-view-item"
@click.middle="!isAffix(tag) && closeSelectedTag(tag)"
@contextmenu.prevent="openMenu(tag, $event)"
>
{{ generateTitle(tag.name || tag.meta?.title) }}
<span
v-if="!isAffix(tag)"
class="close-icon"
@click.prevent.stop="closeSelectedTag(tag)"
>x</span>
</router-link>
</scroll-pane>
<!-- 居中悬浮在标签行上方的小距离里,不参与布局、不把间距撑大 -->
<div
v-show="!shortcutExpanded"
class="shortcut-toggle shortcut-toggle--collapsed"
@click="toggleShortcut"
>
{{ generateTitle(tag.name || tag.meta?.title) }}
<span
v-if="!isAffix(tag)"
class="close-icon"
@click.prevent.stop="closeSelectedTag(tag)"
>x</span>
</router-link>
</scroll-pane>
<el-icon><ArrowDown /></el-icon>
</div>
</div>
<ul v-show="visible" :style="{ left: left + 'px', top: top + 'px' }" class="contextmenu">
<li @click="refreshSelectedTag(selectedTag)">{{ $t('common.refresh') || '刷新' }}</li>
<li v-if="!isAffix(selectedTag)" @click="closeSelectedTag(selectedTag)">{{ $t('common.Close') || '关闭' }}</li>
@ -49,7 +70,7 @@
</template>
<script setup lang="ts">
import { ref, computed, watch, onMounted, nextTick, onBeforeUpdate } from 'vue'
import { ref, computed, watch, onMounted, nextTick } from 'vue'
import { useRoute, useRouter } from 'vue-router'
import { useTagsViewStore } from '@/stores/modules/tagsView'
import { usePermissionStore } from '@/stores/modules/permission'
@ -68,7 +89,8 @@ const top = ref(0)
const left = ref(0)
const selectedTag = ref<any>({})
const affixTags = ref<any[]>([])
const tagsRef = ref<any[]>([])
/** 标签 path → 组件实例(用 Map 索引,避免每次更新清空并重建 ref 数组) */
const tagEls = new Map<string, any>()
const tagsViewStore = useTagsViewStore()
const permissionStore = usePermissionStore()
@ -88,9 +110,12 @@ const toggleShortcut = () => {
settingsStore.changeSetting({ key: 'shortcutExpanded', value: !shortcutExpanded.value })
}
onBeforeUpdate(() => {
tagsRef.value = []
})
/** 函数式 ref:挂载时写入、卸载时移除,始终保持 tag.path → 元素的最新映射 */
function setTagRef(el: any, path?: string) {
if (!path) return
if (el) tagEls.set(path, el)
else tagEls.delete(path)
}
const isActive = (tag: any) => {
return tag.path === route.path
@ -145,21 +170,16 @@ const addTags = () => {
const moveToCurrentTag = () => {
nextTick(() => {
for (const [i, tag] of visitedViews.value.entries()) {
if (tag.path === route.path) {
const tagRef = tagsRef.value[i]
if (tagRef) {
// When using router-link with scoped slot or component, ref might be component instance
// router-link renders an 'a' tag by default, but in Vue 3 it's a component.
// Accessing $el gives the DOM element.
scrollPane.value?.moveToTarget(tagRef.$el)
}
if (tag.fullPath !== route.fullPath) {
tagsViewStore.updateVisitedView(route)
}
break
}
// O(1) 取当前标签元素,滚动到可见区域
const target = tagEls.get(route.path)
if (target?.$el) {
scrollPane.value?.moveToTarget(target.$el)
}
// query 变化时同步已打开标签的 fullPath
const current = visitedViews.value.find(v => v.path === route.path)
if (current && current.fullPath !== route.fullPath) {
tagsViewStore.updateVisitedView(route)
}
})
}
@ -236,10 +256,14 @@ const closeMenu = () => {
visible.value = false
}
watch(route, () => {
addTags()
moveToCurrentTag()
})
// 只监听地址变化(fullPath 含 query),避免 route 对象任一属性变化都触发全量重算
watch(
() => route.fullPath,
() => {
addTags()
moveToCurrentTag()
}
)
watch(visible, (value) => {
if (value) {
@ -261,93 +285,158 @@ onMounted(() => {
height: auto;
width: 100%;
background: #fff;
// border-bottom: 1px solid #d8dce5;
box-shadow: 0 1px 3px 0 rgba(0, 0, 0, .12), 0 0 3px 0 rgba(0, 0, 0, .04);
box-shadow: none;
border: none;
overflow: hidden;
/* 收起态按钮的定位基准 */
position: relative;
.shortcut-toggle {
height: 7px;
/* 标签行包裹层:顶部留一点与导航栏的距离,按钮悬浮在这段距离上 */
.tags-view-row {
position: relative;
padding-top: 4px;
}
/* ========== 收起态:同款 20×10 胶囊,居中悬浮 ========== */
.shortcut-toggle--collapsed {
position: absolute;
/* top: 0 保证按钮整体落在标签行容器内,不会向上压到导航栏 */
top: 0;
left: 50%;
transform: translateX(-50%);
z-index: 2;
width: 20px;
height: 10px;
margin: 0;
display: flex;
justify-content: center;
align-items: center;
background: #d8d7d7;
border-bottom: 1px solid #f0f2f5;
justify-content: center;
border-radius: 999px;
background: #e3ecf9;
color: #7c879b;
font-size: 9px;
line-height: 1;
cursor: pointer;
font-size: 14px;
color: #909399;
transition: all 0.3s;
transition: background 0.2s ease, color 0.2s ease;
&:hover {
background: #f5f7fa;
color: #409EFF;
background: #2f80ed;
color: #fff;
}
}
/*
展开态快捷区:高度只由入口行 + 按钮所占的一条窄带决定。
按钮绝对定位在快捷区内部上沿,不越界到 Navbar、也不撑高容器。
*/
.shortcut-panel {
position: relative;
margin: 0;
padding: 10px 12px 6px;
background: #f2f6fc;
border-bottom: 1px solid #e8eef7;
}
/* 收起按钮:20×10 浮层,贴快捷区上边缘内侧居中(不参与布局) */
.shortcut-toggle--expanded {
position: absolute;
top: 0;
left: 50%;
transform: translateX(-50%);
z-index: 2;
width: 20px;
height: 10px;
display: flex;
align-items: center;
justify-content: center;
border-radius: 999px;
background: #e3ecf9;
color: #7c879b;
font-size: 9px;
line-height: 1;
cursor: pointer;
transition: background 0.2s ease, color 0.2s ease;
&:hover {
background: #2f80ed;
color: #fff;
}
}
.tags-view-wrapper {
height: 35px;
position: relative;
display: flex;
align-items: flex-end;
gap: 6px;
width: 100%;
background: #f0f2f5;
padding-top: 2px;
// border-bottom: 1px solid #d8dce5;
/* 高度收紧到单行标签,顶部距离由 .tags-view-row 的 padding-top 提供 */
min-height: 36px;
padding: 0 16px;
background: #fff;
border-top: none;
border-bottom: 1px solid #e8eef7;
margin-top: 0;
overflow-x: auto;
overflow-y: hidden;
white-space: nowrap;
scrollbar-width: none;
margin-bottom: 0;
&::-webkit-scrollbar {
display: none;
}
.tags-view-item {
display: inline-block;
position: relative;
display: inline-flex;
align-items: center;
justify-content: center;
flex-shrink: 0;
cursor: pointer;
height: 26px;
line-height: 26px;
border: 1px solid #d8dce5;
color: #495060;
background: #fff;
padding: 0 12px;
height: 31px;
line-height: 31px;
border: 1px solid #e6edf8;
border-bottom: none;
color: #606266;
background: #edf3fb;
padding: 0 14px;
font-size: 12px;
margin-left: 6px;
// margin-top: 5px; // 移除 margin-top,改用 flex 居中
border-radius: 3px;
font-weight: 500;
border-radius: 8px 8px 0 0;
text-decoration: none;
transition: all 0.3s cubic-bezier(0.645, 0.045, 0.355, 1);
transition: all 0.2s ease;
box-shadow: inset 0 -1px 0 rgba(15, 23, 42, 0.03);
margin-bottom: -1px;
&:first-of-type {
margin-left: 15px;
margin-left: 0;
}
&:last-of-type {
margin-right: 15px;
margin-right: 0;
}
&:hover {
background-color: #f6f6f6;
border-color: #b4bccc;
color: #409eff;
background-color: rgba(64, 158, 255, 0.06);
border-color: rgba(64, 158, 255, 0.12);
}
&.active {
background-color: #42b983;
color: #fff;
border-color: #42b983;
background: #fff;
color: #2f80ed;
border-color: #e8eef7;
box-shadow: 0 -1px 8px rgba(47, 128, 237, 0.08);
z-index: 1;
&::before {
content: "";
background: #fff;
display: inline-block;
width: 8px;
height: 8px;
border-radius: 50%;
position: relative;
margin-right: 4px;
}
}
.close-icon {
width: 16px;
height: 16px;
line-height: 14px;
vertical-align: middle;
// border-radius: 50%;
text-align: center;
transition: all 0.3s cubic-bezier(0.645, 0.045, 0.355, 1);
transform-origin: 100% 50%;
// margin-left: 5px;
font-size: 12px;
&:hover {
background-color: #b4bccc;
color: #fff;
background: #2f80ed;
margin-right: 6px;
flex-shrink: 0;
}
}
@ -359,14 +448,15 @@ onMounted(() => {
height: 16px;
line-height: 16px;
vertical-align: middle;
// border-radius: 50%;
text-align: center;
transition: all 0.18s ease;
transform-origin: 100% 50%;
// margin-left: 5px;
font-size: 12px;
cursor: pointer;
box-sizing: border-box;
color: inherit;
margin-left: 6px;
border-radius: 50%;
&:hover {
background-color: #c7cedb;
@ -381,8 +471,6 @@ onMounted(() => {
height: auto;
}
.contextmenu {
margin: 0;
background: #fff;
@ -405,36 +493,67 @@ onMounted(() => {
}
}
}
.shortcut-key {
height: 30px;
margin: 0 15px;
.tags-view-container .shortcut-key {
/* 高度全部由入口行决定,内边距交由 .shortcut-panel 控制 */
padding: 0;
display: flex;
align-items: center;
// padding-top: 7px;
gap: 8px;
background-color: #ffffff;
overflow-x: auto;
scrollbar-width: none;
&::-webkit-scrollbar {
display: none;
}
.shortcut-item {
min-width: 70px;
padding: 0px 10px;
height: 24px;
display: flex;
min-width: 72px;
padding: 0 10px;
height: 20px;
display: inline-flex;
align-items: center;
justify-content: center;
border-radius: 4px;
background-color: #dbdada;
border-radius: 6px;
/* 对齐项目标签语言:白底卡片 + 淡蓝边框,激活态用 #2f80ed 强调 */
border: 1px solid #e6edf8;
background: #ffffff;
color: #606266;
font-size: 13px;
transition: all 0.3s;
font-size: 12px;
font-weight: 500;
line-height: 18px;
transition: all 0.2s ease;
text-decoration: none;
&:hover {
background-color: #e6e8eb;
color: #409EFF;
color: #2f80ed;
border-color: rgba(47, 128, 237, 0.35);
box-shadow: 0 1px 4px rgba(47, 128, 237, 0.08);
}
&.router-link-active {
color: #409EFF;
background-color: #ecf5ff;
color: #2f80ed;
background: rgba(47, 128, 237, 0.06);
border-color: rgba(47, 128, 237, 0.35);
}
/* el-tooltip 的唯一根节点:图标与文字横向排布 */
.shortcut-item__content {
display: inline-flex;
align-items: center;
min-width: 0;
}
.shortcut-item__text {
margin-left: 5px;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
/* 没有图标时文字不额外留白 */
.shortcut-item__content > .shortcut-item__text:first-child {
margin-left: 0;
}
}
}

View File

@ -16,7 +16,12 @@
:base-path="menuRoute.path"
:is-horizontal="true"
/>
<el-sub-menu v-if="overflowRoutes.length" index="__top_menu_more__" class="top-menu-more">
<el-sub-menu
v-if="overflowRoutes.length"
index="__top_menu_more__"
class="top-menu-more"
popper-class="top-menu-popup"
>
<template #title>
<span class="more-title">{{ moreText }}</span>
<el-icon class="more-arrow"><ArrowDown /></el-icon>
@ -28,6 +33,8 @@
:base-path="menuRoute.path"
:is-horizontal="true"
:is-nest="true"
:show-star="false"
class="nest-menu"
/>
</el-sub-menu>
</el-menu>
@ -197,7 +204,10 @@ watch(locale, refresh)
:deep(.el-menu-item), :deep(.el-sub-menu__title) {
height: 40px !important;
line-height: 40px !important;
margin: 0px 4px;
/* 间距统一交给外层 .top-menu > div / .top-menu-more 控制,
否则普通项(li 自带 margin)与下拉项(title 自带 margin)
在 flex 下的盒子宽度计算不一致,会出现忽大忽小的间距 */
margin: 0 !important;
border-radius: 4px;
/* 统一去掉下边框,避免下拉项与普通菜单项出现 2px 的高差 */
border-bottom: none !important;
@ -221,6 +231,8 @@ watch(locale, refresh)
flex: 0 0 auto;
display: flex;
align-items: center;
/* 一级项间距的唯一来源:普通项与下拉项共用(相邻项合计 12px) */
margin: 0 8px;
/* 链接层也用 flex,去掉 inline-flex 菜单项带来的行盒下沉(约 3px) */
> a {
@ -237,6 +249,8 @@ watch(locale, refresh)
.top-menu-more {
flex: 0 0 auto;
/* 与一级菜单项保持同一间距来源(相邻项合计 12px) */
margin: 0 6px;
:deep(.el-sub-menu__title) {
display: inline-flex;
@ -280,4 +294,66 @@ watch(locale, refresh)
}
}
}
</style>
<style lang="scss">
/**
* 顶部横向菜单的所有下拉浮层(一级菜单下拉 + 「更多」)统一使用 .top-menu-popup。
*
* 注意:浮层挂在 body 下,不在 .top-menu 内部,
* 所以 .top-menu 里的 `.el-sub-menu__icon-arrow { display: none }` 不会作用于它,
* 下拉里的二级子菜单依旧会显示展开箭头,与右侧星标收藏按钮抢位而重叠。
*
* 右侧间距约定(关键):
* · 叶子项 与 带子项 都留 34px —— 保证两组星标纵向对齐
* · 展开箭头固定 right:12px,位于星标右侧,两者不再重叠
*/
.top-menu-popup {
.el-menu--popup {
min-width: 200px;
padding: 6px;
border-radius: 8px;
box-shadow: 0 6px 24px rgba(15, 23, 42, 0.12);
}
.el-menu-item,
.el-sub-menu__title {
height: 38px;
line-height: 38px;
border-radius: 6px;
margin: 2px 0;
font-size: 14px;
color: #606266;
transition: background-color 0.2s ease, color 0.2s ease;
}
/* 叶子项:星标靠最右,与展开箭头同一列 */
.el-menu-item {
padding-right: 12px !important;
}
/* 带子项:右侧同时有星标(若有)与展开箭头 */
.el-sub-menu__title {
padding-right: 34px !important;
}
.el-sub-menu__icon-arrow {
right: 12px;
font-size: 12px;
color: #909399;
transition: transform 0.2s ease, color 0.2s ease;
}
.el-menu-item:hover,
.el-sub-menu__title:hover {
background-color: rgba(47, 128, 237, 0.08) !important;
color: #2f80ed;
}
.el-menu-item.is-active {
color: #2f80ed;
font-weight: 600;
background-color: rgba(47, 128, 237, 0.1) !important;
}
}
</style>

View File

@ -6,16 +6,31 @@
<sidebar v-if="layoutMode !== 'top-bottom'" class="sidebar-container" />
<div class="main-container" :class="{ 'no-sidebar': layoutMode === 'top-bottom' }">
<div :class="{ 'fixed-header': fixedHeader, 'fixed-header-top': layoutMode === 'top-bottom' }" :style="{ minHeight: shortcutExpanded ? '134px' : '97px' }">
<!--
表头高度不再硬编码:由 ResizeObserver 实测 task-view 内容高度,
spacer / AI 浮层 / 页面 --app-header-height 全部复用同一个实测值,
因此快捷入口展开收起、换语言、切换布局都不会再产生缝隙或遮挡。
-->
<div
ref="headerRef"
:class="{ 'fixed-header': fixedHeader, 'fixed-header-top': layoutMode === 'top-bottom' }"
>
<task-view />
</div>
<!-- spacer 高度与 header minHeight 对齐(97/134),避免固定表头遮挡内容顶部(原 84 比 97 矮 13px) -->
<div v-if="fixedHeader" :style="{ height: shortcutExpanded ? '134px' : '84px', minHeight: shortcutExpanded ? '134px' : '84px' }"></div>
<div
v-if="fixedHeader"
class="fixed-header-spacer"
:style="{ height: `${headerHeight}px` }"
></div>
<div class="main-box">
<app-main />
<create-order-session-host />
<transition name="ai-slide">
<div class="ai-container" v-show="aiStore.isVisible" :style="{ top: shortcutExpanded ? '134px' : '97px', height: `calc(100vh - ${shortcutExpanded ? 134 : 97}px)` }">
<div
class="ai-container"
v-show="aiStore.isVisible"
:style="{ top: `${headerHeight}px`, height: `calc(100vh - ${headerHeight}px)` }"
>
<ai-chat />
</div>
</transition>
@ -25,7 +40,7 @@
</template>
<script setup lang="ts">
import { computed, watch, onBeforeMount, onMounted, onBeforeUnmount } from 'vue'
import { ref, computed, watch, onMounted, onBeforeUnmount } from 'vue'
import { useAppStore } from '@/stores/modules/app'
import { useSettingsStore } from '@/stores/modules/settings'
import { useAiStore } from '@/stores/modules/ai'
@ -47,7 +62,27 @@ const sidebar = computed(() => appStore.sidebar)
const device = computed(() => appStore.device)
const fixedHeader = computed(() => settingsStore.fixedHeader)
const layoutMode = computed(() => settingsStore.layoutMode)
const shortcutExpanded = computed(() => settingsStore.shortcutExpanded)
/** 表头 DOM 引用(测量源) */
const headerRef = ref<HTMLElement | null>(null)
/** 表头实测高度:唯一的高度来源,替代原来的 134 / 97 两个魔法数 */
const headerHeight = ref(0)
let headerObserver: ResizeObserver | null = null
/**
* 同步表头真实高度。
* fixed-header 高度完全由内容决定(min-height: 0),所以实测值永远等于
* navbar + 快捷入口面板 + 收起开关 + 标签行 的实际占用,
* 内容一变(展开快捷区、切换语言导致换行等) spacer 自动跟随。
*/
function syncHeaderHeight() {
const el = headerRef.value
if (!el) return
const next = el.offsetHeight
if (next !== headerHeight.value) headerHeight.value = next
// 供页面复用的全局变量:height: calc(100vh - var(--app-header-height) - ...)
document.documentElement.style.setProperty('--app-header-height', `${next}px`)
}
const classObj = computed(() => {
return {
@ -72,6 +107,19 @@ const handleClickOutside = () => {
appStore.closeSideBar(false)
}
onMounted(() => {
syncHeaderHeight()
if (typeof ResizeObserver === 'undefined' || !headerRef.value) return
// 观察表头自身尺寸:快捷入口展开收起、字体/语言变化都会触发重新测量
headerObserver = new ResizeObserver(() => syncHeaderHeight())
headerObserver.observe(headerRef.value)
})
onBeforeUnmount(() => {
headerObserver?.disconnect()
headerObserver = null
})
</script>
<style lang="scss" scoped>
@ -114,7 +162,8 @@ const handleClickOutside = () => {
z-index: 9;
width: calc(100% - #{$sideBarWidth});
transition: width 0.28s;
min-height: 97px;
min-height: 0;
box-shadow: none;
&.fixed-header-top {
width: 100% !important;

View File

@ -1,6 +1,7 @@
import { createApp, watch } from 'vue'
import { createPinia } from 'pinia'
import ElementPlus from 'element-plus'
// Element Plus 组件由 unplugin-vue-components 按需自动引入(见 vite.config.ts),
// 这里只保留全量样式,避免漏样式。
import 'element-plus/dist/index.css'
import 'virtual:svg-icons-register'
@ -39,7 +40,6 @@ const pinia = createPinia()
app.use(pinia)
app.use(router)
app.use(i18n)
app.use(ElementPlus)
// 加载服务器国际化翻译
loadServerMessages()
@ -87,8 +87,10 @@ function applyDocumentTitle(route?: typeof router.currentRoute.value): void {
document.title = getPageTitle(page, site)
}
applyDocumentTitle()
// 品牌信息变化(loaded / siteTitle)时重算标题;
// 路由变化统一由 afterEach 处理,避免每次导航重复写两次 document.title。
watch(
[() => frontBrandStore.loaded, () => frontBrandStore.siteTitle, () => router.currentRoute.value.path],
[() => frontBrandStore.loaded, () => frontBrandStore.siteTitle],
() => applyDocumentTitle()
)
router.afterEach((to) => applyDocumentTitle(to))

View File

@ -43,6 +43,13 @@ function ensurePrinterConnectionsAfterLogin() {
/** 页签“刷新”经 /redirect 软刷新(非整页重载),标记为回到目标页后执行一次打印组件重连 */
let pendingRefreshReconnect = false
/**
* 打印组件连接是否已在本会话完成首次初始化。
* 打印连接绑定的是“用户 + 仓库”维度,切换身份会整页刷新(location.reload),
* 因此会话内做一次即可,不必每次路由导航都走一遍。
*/
let printerBootstrapped = false
/** 软刷新回到目标路由后:执行一次打印组件重连(登录守卫路径外的补充触发点) */
function maybeRetryPrintConnectionsAfterRefresh() {
if (!pendingRefreshReconnect) return
@ -71,7 +78,11 @@ router.beforeEach(async (to, from) => {
const hasGetUserInfo = userStore.user && userStore.user.employees_name
if (hasGetUserInfo) {
ensurePrinterConnectionsAfterLogin()
// 首次导航才做打印连接初始化;后续导航只处理 /redirect 软刷新的重连
if (!printerBootstrapped) {
printerBootstrapped = true
ensurePrinterConnectionsAfterLogin()
}
maybeRetryPrintConnectionsAfterRefresh()
return true
} else {
@ -82,6 +93,7 @@ router.beforeEach(async (to, from) => {
// 加载用户偏好配置(浏览器本地保存:登录 + 整页刷新均在此触发),再触发登录后自动连接(按用户+仓库配置执行一次)
useUserPreferenceStore().load()
ensurePrinterConnectionsAfterLogin()
printerBootstrapped = true
maybeRetryPrintConnectionsAfterRefresh()
const permissionStore = usePermissionStore()
@ -93,9 +105,13 @@ router.beforeEach(async (to, from) => {
router.addRoute(route)
})
console.log('[Router] 动态路由 (后端菜单转换):', formatRoutesForLog(accessRoutes))
console.log('[Router] 合并后完整路由 (constantRoutes + 动态):', formatRoutesForLog(permissionStore.routes))
console.log('[Router] Vue Router 实例路由:', formatRoutesForLog(router.getRoutes()))
// 路由树日志仅开发环境输出:formatRoutesForLog 会递归重建整棵树,
// 生产环境执行 3 次会带来 50~150ms 的额外开销与大量临时对象
if (import.meta.env.DEV) {
console.log('[Router] 动态路由 (后端菜单转换):', formatRoutesForLog(accessRoutes))
console.log('[Router] 合并后完整路由 (constantRoutes + 动态):', formatRoutesForLog(permissionStore.routes))
console.log('[Router] Vue Router 实例路由:', formatRoutesForLog(router.getRoutes()))
}
// hack method to ensure that addRoutes is complete
// set the replace: true, so the navigation will not leave a history record

View File

@ -4,8 +4,10 @@ import { useUserStore } from './user'
export type TableMode = 'performance' | 'resource'
/** tab 缓存默认最大数量(超出后按 LRU 淘汰最久未使用) */
export const DEFAULT_TAB_CACHE_MAX = 3
/** tab 缓存默认最大数量(超出后按 LRU 淘汰最久未使用)
* 说明:orderManagement 有 8 个页签、waveOrder 有 5 个;默认值小于页签数会导致
* 来回切换时不断淘汰重建(实测比不缓存更慢),故默认对齐最大页签数。 */
export const DEFAULT_TAB_CACHE_MAX = 8
/** 页面缓存默认最大数量(路由级 keep-alive,超出后按 LRU 淘汰最久未使用) */
export const DEFAULT_PAGE_CACHE_MAX = 8

Some files were not shown because too many files have changed in this diff Show More