Compare commits

..

447 Commits
ming ... main

Author SHA1 Message Date
yin
4eb0282a6a refactor(storage): 清理废弃组件与接口,统一筛选/排序参数并完善表单校验
- 包装耗材、包装供应商:移除未使用的搜索表单与废弃接口,去掉后端不支持的
  顶层 page/pageSize 与 order 参数,列表统一使用 pagination;新增创建/更新时间列、
  重量格式化与空值显示;编辑时被清空的数值字段显式提交 null,保留「未修改」语义
- 库存:删除已废弃的 InventoryStockPickerDialog、库存日志组件与 quickPutaway 接口;
  列表与导出支持文档声明的排序白名单(id/stock_id/space_id/时间/数量);
  库位关键字先解析为 space_id、stock_query 先解析为 stock_id 后再下发,
  规避导出接口 Unknown column 报错;新增库存类型筛选与库位库存入口,
  详情面板复用入库明细组件
- 入库:ScanBox 新增「快捷搜索」(quickWhere 直接传字符串),
  列表与导出共用当前排序
- 出库:转单表单增加字段级校验与错误提示(收货人、手机/固话二选一、
  省市区镇、详细地址)
- 包装流程:运单号汇总优先取 expresses 并去重,按选中导出一致带上运单号与
  当前排序,补充录像列表弹窗并调整详情面板布局
2026-11-18 09:09:51 +08:00
yin
4008a28796 feat(order): 新增待处理 B2B 订单批量取消,完善收货/盘点筛选与错误提示
- 新增 order.cancelB2b 接口与 CancelB2bForm 弹窗(convertToB2b 的反向操作),
  待处理订单工具栏接入:展示已选标签、去重后可提交数量与上限,支持逐个移除,
  提交后展示成功/跳过原因/未找到订单明细,并提示不支持取消的情形
- 待处理、归档等列表接口文档补充「默认排除 B2B 订单」,如需查询 B2B
  改用 order.pendingOrder2b.list / order.deliveryOrder2b.list
- 收货列表新增「隐藏无可用量」(filterDepleted)与「按入库单筛选」
  (entry_order_id 弹窗选择),移除已废弃的 getAvailableInboundQuantity 接口
- 收货库存明细面板改用 entry / inventory 接口,展示入库单号、库区、库位、
  数量、批次、生产/过期日期与库存类型;详情表单按来货方式动态隐藏物流单号
- 盘点明细新增「删除明细」(仅未开始作业的明细行可删),导出明细支持选择
  「按库位明细」或「明细汇总」模式(商品类任务生效)
- 新增 truncateLongMessage 截断工具,响应拦截与移库失败提示对超长 message
  只保留前 3 段并提示总数,完整信息仍输出到控制台
2026-11-16 18:05:41 +08:00
liufumingren
b4a458abd3 1 2026-11-16 09:55:27 +08:00
yin
dcdc3b6fd3 feat(order): 支持按 SN 码反查订单,完善 SN 订单限制与接口配置
- 订单列表、待处理、复核、异常、归档的 ScanBox 新增「SN码」字段,
  支持单码、逗号/空格/分号分隔多码及数组输入,按完整 SN 码精确匹配
- 批量快捷复核识别 SN 订单:提交前提示该批不支持,结果中统计 SN 相关失败,
  引导改用单订单复核并提交 sn_map
- 波次抓取团购单弹窗新增「返回订单 ID 列表」开关(return_order_ids),
  勾选后追加订单 ID 列并支持多值折叠复制;波次列表新增本地排序兜底与
  时间格式化,策略列表在接口仅支持 strategy_type 时改为前端筛选+分页
- 导出白名单对齐接口 57 项(补充拦截状态、复核时间),明确传入白名单后
  服务端只输出白名单内列
- 库存明细新增「按批次 / 按库位合并」切换(group_by_batch),
  库存列表与导出参数跟随表头当前排序
- 店铺接口配置新增天意云 OMS 固定类型(interface_type_id=3),
  回调地址统一由系统配置、不再下发,移除 api_version / 联系人等废弃入参
2026-11-14 18:00:15 +08:00
liufumingren
aeb13757ea feat(stock): 商品支持序列号规则配置与扫码校验
- 新增 sn_code_rules 规则编辑组件,支持前缀/后缀匹配与 full/strip 取值

- 开启序列号管理后必须配置规则,并提供扫码内容本地校验预览(不随表单提交)

- 新增/编辑保存时归一化规则并校验空值、长度、重复及条数上限

- getInfo 回显与保存请求补充 sn_code_rules 类型

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-13 21:23:03 +08:00
yin
33e0b4c459 feat(order): 支持 SN 订单筛选与复核提交,优化订单详情加载与选择交互
- recheckOrder.confirmRecheck 支持 sn_map(key=stock_id,value=SN 码数组),
  返回 has_sn_item / sn_count / sn_item_count;复核单列表新增「含SN」列
- 订单列表、待处理、复核筛选新增 is_sn_order(由 has_sn_item 归一化),
  ScanBox 增加「含SN商品」字段;导出新增 SN码数量 / SN码 / SN码汇总 三列,
  并扩展 order-common-config 的列类型(formatter / copyAction / copyValue / 折叠)
- 波次策略类型支持 3=SN 并允许数组多选,接口补充 excluded_sn_order_ids
- 新增 order-detail-cache:按请求函数隔离的 15s TTL 缓存、并发合并、
  fingerprint 失效与手动刷新绕过,切换 tab / 来回点行不再重复请求;
  订单明细、待处理详情面板增加单元格格式化缓存并处理 copyAction 列
- 商品选择、组合商品选择、拆包库存选择新增「按货主过滤」开关
  (默认开启,未指定货主时禁用),切换后保留已选状态
- 新建待处理订单预览行支持内联编辑来源单号、镇、邮编、单据类型、加急、
  是否开票等字段,并跟踪行改动;出库单单据类型/来源类型改为中文映射,
  出入库日志补充单据类型字典
- ToolbarButtonGroup 的 ResizeObserver 增加 80ms 防抖,useVerticalSplitPane
  拖动改为 rAF 节流,减少拖拽分栏时的重复重排
2026-11-13 18:01:33 +08:00
yin
2a37739b7d refactor(detail): 详情与日志列表统一迁移 UpperTable,任务进度支持收起为浮窗
- 新增 TaskProgressFloatWidget;TaskProgressDialog 增加 minimizable 与 minimize
  事件,运行中可「收起后台」,浮窗继续轮询并支持点击还原窗口,
  运单页「更新揽收状态」已接入
- UpperTable 新增 #pagination-info 插槽(支持「已选 N 项」等精简文案),
  运单号列对齐方式透传给 WaybillCodeActions
- 盘点、入库、出库、收货、波次、订单明细、库存详情、仓库与店铺等 20+ 处
  日志/明细列表由 el-table 迁移至 UpperTable,统一分页、行选择、
  虚拟滚动、状态文本样式与列插槽
- 拆包录像列表、出库单详情表单、运单称重弹窗等按 task-panel 结构统一;
  运单轨迹浮层支持拖动并复用 task-panel 标题与关闭样式
- 补充相关样式,修正内嵌表格高度与分页区布局,避免卡片阴影与高度塌陷
2026-11-12 18:01:25 +08:00
liufumingren
d21839b99d feat(waybill): 运单号统一操作组件(复制/二维码/轨迹)并接入全部列表
- 新增 WaybillCodeActions:悬停显示下拉菜单,复制仅走菜单项,取消点击运单号即复制的默认行为
- 新增 WaybillTraceFloat / WaybillTraceWindow / trace-window:轨迹悬浮窗改为全局单例,可拖动、无遮罩、换单号复用并重新拉取
- 新增 WaybillTraceList:轨迹时间线,支持复制轨迹(含运单号)与刷新;运单管理页轨迹标签页改为复用
- 二维码弹窗改为 Teleport+固定层级,避免嵌在表格单元格内层级错乱;z-index 约定见 waybill/z-index.ts(二维码 5000 > 轨迹窗 4000 > EP 弹层 2000+)
- UpperTable 默认渲染接入运单号列识别(waybill-column.ts),并支持 waybillCodes 取值器与多值解析
- 批量替换各处自定义表格的运单号列(送达/复核/工作台/转换弹窗/拆包/退件/波次物流单号等)
- 抽出 utils/clipboard 统一剪贴板降级逻辑

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-12 00:34:31 +08:00
liufumingren
3fa899d02d refactor(express/waybill): 下线更新轨迹接口与按钮,保留轨迹查询标签页
- 移除 waybill.warehouse.updateTrace / updateTraceTaskProgress 接口封装、参数类型与模块导出
- 移除工具栏「更新轨迹」按钮、按钮动作、任务进度轮询及进度弹窗
- 清理配置中的接口注册与导入
- 轨迹面板空态文案不再提示「更新轨迹」
- 保留 waybill.warehouse.getTrace 与「轨迹」标签页

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-11 21:08:11 +08:00
liufumingren
b2d53e3b72 feat(express/waybill): 新增更新轨迹按钮与运单轨迹标签页
- 接入 waybill.warehouse.updateTrace / updateTraceTaskProgress:工具栏「更新轨迹」支持更新选中与更新全部(当前筛选,直接传 where,上限 5000)
- 异步任务进度弹窗轮询 updateTraceTaskProgress,完成后刷新列表
- 新增 waybill.warehouse.getTrace 接口封装,底部明细区新增「轨迹」标签页,按运单号展示已落库轨迹(时间线、最新高亮、支持刷新)
- 抽取通用的异步任务响应/进度解析(parseTaskPayload / normalizeTaskProgress),兼容 current_count 进度字段
- 选中行时先展示行数据,避免轨迹/明细短暂显示上一条运单

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-11 20:22:50 +08:00
yin
6838d69788 perf(app): 详情面板统一迁移 UpperTable,路由按需加载并优化跨浏览器性能
- 新增 router/view-glob.ts,动态菜单兜底的全量 glob 表改为按需动态加载,
  入口 chunk 由 465KB 降至 393KB;Sidebar / TaskView 用 utils/path 的
  resolveRoutePath 替换 path-browserify 静态引用
- 新增 utils/perf-probe 轻量探针(?perf=1 或 localStorage 开启),输出导航耗时、
  资源分类统计、长任务与硬件信息;移除 text-rendering: optimizeLegibility,
  breadcrumb 过渡由 all 改为 opacity/transform,降低弱 CPU 与非 Chrome 内核开销
- Navbar 工单角标轮询在后台标签页跳过,通过 visibilitychange 回到前台补刷一次
- 库存详情、货位、条码、入库日志、出库日志与明细、收货日志、盘点记录等
  详情面板由 el-table 迁移到 UpperTable,统一展开行、分页、选择与列插槽
- 11 处模板配置及内嵌表格开启行选择;转储、转退货、批量复核弹窗改用
  SelectedTags 展示已选项并支持逐个移除,移除最后一个后自动关闭
- ImagesUpload 重构为「图库 + 上传区」面板,支持多选、最多 20 张、
  单张 10MB 校验与数量提示
- 新增《跨浏览器性能-分析与优化清单》文档
2026-11-11 18:00:42 +08:00
yin
0d549b455f feat(task-progress): 异步任务弹窗支持已选项标签,新增运单揽收状态更新
- task-progress 新增 tags 表单字段类型与 SelectedTags 组件,任务弹窗可展示
  已选订单/运单/出库单标签并支持逐个移除,样式对齐「编辑投递计划」输入行
- 更新备注、更新订单备注/地址、同步订单号、分配储位、批量异步任务等表单,
  以及待处理/异常/复核/波次面板接入该能力,提交前可核对并调整已选项
- 新增 orderTagItems 工具:按行或按 ids 顺序生成标签,兼容 id / order_id
  与 delivery_order_code / order_code 等字段差异
- waybill.warehouse 新增 updateReceive、updateReceiveTaskProgress 异步接口,
  运单页新增「更新揽收状态」工具栏按钮,接入任务进度轮询、结果汇总与列表刷新
- 库存批量编辑、出库单批量作废、收货列表等页面同步接入已选项标签展示
- UnifiedTaskProgressDialog 补充 remove-field-item 事件透传,保持各任务弹窗行为一致
2026-11-10 18:00:21 +08:00
liufumingren
da429052ed fix(express/waybill): 星河签收筛选项文案改为揽收
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-10 01:12:13 +08:00
liufumingren
468e970943 fix(express/waybill): 修正运单列表筛选条件与接口传参口径
- 状态/运单类型/是否字段按接口要求转换为 0-1、main-child、Y-N、布尔值,映射后再做类型转换,避免中文值被转成 NaN
- 运单号、主单号、订单ID、物流接口ID、包材ID 限定接口支持的操作符,并修正运单号默认模糊匹配
- 恢复物流公司、平台筛选,货主改为单选并传货主ID
- 移除后端暂不支持的发货单号、关键词筛选
- 快递/平台/货主下拉兼容 data 为数组及 list/items/records 结构,修复快递编码缺失

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-10 00:48:57 +08:00
liufumingren
2c657bd416 Merge branch 'main' of http://192.168.9.101:4000/liufumingren/WEB 2026-11-10 00:09:10 +08:00
yin
b37ebdba46 feat(scanbox): 新增自定义过滤条件预设,并在设置中心集中管理
- ScanBox「过滤」页签新增预设树:系统条件 + 我的自定义条件,支持一键应用、
  取消应用、条件追加合并,以及把当前筛选条件「存为过滤条件」并自动切换页签
- 新增 scan-filter-presets 工具与 scanFilterPresets store:条件按账号保存
  (用户级 scope,不随仓库隔离),页面字段元数据由 ScanBox 挂载时自动登记,
  预设固定输出扁平结构,页面查询构建无需区分条件来源
- 设置中心新增「自定义过滤条件」分区:左侧页面列表、右侧条件管理,
  支持启用/排序/编辑/复制/删除/恢复默认
- 设置中心分组重组为「字段与列 / 筛选与查询 / 系统设置 / 设备与打印 /
  导航与入口 / 数据与维护」,原「表格与性能」「页面与标签缓存」合并为
  「基础设置」,单条目分组不再重复显示分组标题
- tbyc-config 新增 scanFilterPresets 分区,支持随统一配置导入导出;
  stockQueryBuilder 兼容预设条件信封结构并跳过元数据键
- 新增《自定义过滤条件-设计与实施》文档,更新设置中心设计文档
2026-11-09 18:00:15 +08:00
yin
03f7f73d70 feat(settings): 新增统一设置中心,集中管理字段、标签、缓存等本地配置
- 新增 SettingsDialog 及 registry 分区注册表,按「表格 / 显示与交互 / 性能 /
  导航 / 数据与维护」分组,分区组件全部懒加载,支持关键字搜索与作用域提示
- 新增 10 个设置分区:列表字段(宿主插槽)、所有表格字段、界面显示、
  设备与打印、表格与性能、页面与标签缓存、标签排序、快捷入口、
  导出字段、导入/导出与维护(tbyc-config.json)
- Navbar 头像下拉新增「设置」入口;UpperTable 工具栏的「更多设置 / 标签排序」
  收敛为「字段设置」,通过 #field-section 插槽注入当前表格列配置
- TabOrderSettingsDialog 重命名为可复用面板 TabOrderPanel,接入设置中心
- 抽离 table-column-config 工具与 tableColumnConfig store,支持跨页面管理
  所有表格列配置,修改后按 tableId 版本号通知已打开表格重建列配置
- tbyc-config 新增 experimental、printer、订单导出字段等分区,
  导入/导出覆盖更多本地配置,并兼容旧版字段配置与 tabOrders 文件
- 移除 MoreSettingsDialog;OrderExportColumnsDialog 与设置中心共用导出字段
  存储,区分「未配置」与「空选择」;订单各页清理重复的下拉选项映射逻辑
- 新增《设置中心-设计与实施》文档,更新标签排序与 tbyc-config 说明
2026-11-08 18:00:13 +08:00
yin
f41b37aa54 feat(tab-order): 统一标签排序与默认页签配置,构建按需引入 Element Plus/ECharts
- 新增 useTabOrder、tab-order 工具与 tab-order-registry 注册表,按模块集中登记
  页面标签并懒加载默认标签;新增 TabOrderSettingsDialog、TabOrderDragList,
  支持拖拽排序、设置默认页签与重置,SortSettingDialog / TabArea 迁移到同一套实现
- 用户偏好存储新增「用户级」globalMap(不随仓库隔离),tabOrder 写入用户级 scope,
  旧 scope 一次性迁移并对齐回退读取;各页面 config 接入统一注册表,
  移除页面内自写的排序与默认页签逻辑
- 新增 tbyc-config 统一配置文件与分区注册表,UpperTable 的配置导出/导入
  升级为 tbyc-config.json(字段列、标签排序、界面显示、快捷键),
  兼容旧版「全局字段配置」与 tabOrders 文件
- Element Plus 改为 unplugin-vue-components 按需自动引入,移除
  app.use(ElementPlus)、dts 生成与强制 vendor-element-plus 分包
- ECharts 改为按需注册(折线/饼图 + 所需组件),dashboard 图表统一走
  @/utils/echarts;移除 three.js 及 overlookControls / threeScene / threeUtils,
  同步清理依赖、manualChunks 与 optimizeDeps
- vue-devtools 支持 VITE_VUE_DEVTOOLS=off 关闭;抽离 wavePrintPayload 供订单、
  复核页面复用,scanFields 承接批量搜索操作符与「包含商品」筛选项
- 补充标签排序与默认页签统一方案、tbyc-config 说明文档,
  更新标签页性能测量结论与用户偏好保存方案
2026-11-07 18:00:11 +08:00
yin
3b09d45f08 refactor(list): 抽离列表页公共模板与共享工具,优化虚拟滚动与状态渲染
- 新增 ToolbarButtonGroup 组件及类型定义,订单、波次等页面统一使用,
  工具栏按钮样式分类(刷新/设置/操作/取消)收敛到一处
- 订单共享模块迁移至 views/order/shared:创建订单会话、通用表单、
  导出、工具栏动作、订单元数据缓存;stockPickerHelpers 归入 stock/utils
- 抽离 ScanBox 字段工厂、货主/快递下拉选项映射、状态文本工具,
  新增 list-page.scss、status-text.scss,order-common-config 改为再导出
- UpperTable 虚拟滚动优化:实测行高兜底、渲染行数组引用复用、
  rowKey/复制码/收起文本缓存、窗口行数按 4 行量化、ResizeObserver 同步视口,
  减少滚动抖动与整表重建
- 列表页状态列改用轻量文本样式替代 el-tag,降低大列表渲染开销;
  标签页缓存默认上限由 3 调整为 8
- 补充标签页性能测量结论、页面模板抽离现状与实施方案文档
2026-11-06 18:01:24 +08:00
yin
b201363ad2 refactor(layout): 统一页签组件与菜单图标体系,优化顶部区域高度与渲染性能
- 新增全局 TabArea 组件及 tab-area.scss,替换 11 处页面内重复实现,
  统一标签样式、排序入口与本地排序偏好
- 新增 51 个业务 SVG 图标,侧边栏/顶栏菜单支持图标展示,
  调整收藏星标与展开箭头的间距、配色,避免图标重叠
- 顶部区域高度改为 ResizeObserver 实测,并输出 --app-header-height 变量,
  移除 97/134 魔法数字与各页面 calc(100vh - N) 的高度计算
- TaskView 快捷区与标签行重构:Map 索引定位当前标签、v-memo 减少重渲染、
  仅监听 route.fullPath 触发更新
- 打印组件连接初始化改为会话内只执行一次;路由树调试日志仅在开发环境输出
- 引入 unplugin-auto-import / unplugin-vue-components 依赖,
  补充布局性能分析、菜单图标体系、顶部区域优化三份设计文档
2026-11-05 18:00:17 +08:00
liufumingren
0c5170faac fix(order): 修复视频号浏览器打印报缺少 orders.contents 的问题
视频号(微信小店)订单为平台原生 taskList 任务结构(taskID/printInfo/printNum/splitControl/showDeliveryLogo/customInfo/extendData),不含 contents。按 WMS printer_data_template/sph.json 与 express_print_payload_builder 的 sph 分支组装 { command:'print', version:'2.0', requestID, taskList, printType, size, printer } 下发;同时为通用分支补齐 contents/预构建载荷的 JSON 字符串兼容与失败诊断日志。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-04 11:01:21 +08:00
liufumingren
093053391a fix(order): 修复分配子单号始终提交数量 1 的问题
提交时改为由表单组件通过 submit 事件回传实际输入的子单号数量,待处理/异常/配送订单三个入口统一以该数量调用接口;移除从不更新的冗余表单状态并补充整数校验。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-04 10:18:34 +08:00
yin
5b3528b601 feat(stock): add stock management dialogs and fix combo quantity handling
新增库存表单、批量编辑和回收处理弹窗,完善库存管理流程
调整库存首页及相关组件交互,统一任务面板样式与操作体验
修复组合商品在创建待处理订单时的数量展开逻辑,确保库存选择与计划数量一致
更新订单称重和订单复核页面及配置,优化业务操作流程
调整收货商品相关展示逻辑,适配最新库存数据流
2026-11-03 18:21:39 +08:00
yin
267b97330d feat(setting): 权限/角色/自动回复左侧树面板统一,小程序配置表单改版
左侧树面板统一(对齐 setting/role)
- 新增 permission/components/PermissionTreePanel.vue:220px 白底面板 + 右侧分隔线 +
  顶部搜索(仅过滤树节点,不影响右侧列表),「全部类型」根节点默认展开
- 权限页改用该组件,移除页内树与冗余样式,容器改为整页贴边卡片
- RoleTreePanel 增加默认展开根节点,并在树数据重建后保持展开状态
- 自动回复页左侧同步该样式:220px、隐藏滚动条、搜索框置顶;
  「新增类型 / 刷新」按钮暂时注释
- 自动回复「系统预设」类型/子类型改为只读摘要卡片(替代整张禁用表单),
  自定义类型/子类型仍为可编辑表单

基础管理 / 小程序配置(MiniProgramConfigForm)
- 「代注册企业小程序」「发起微信认证」两个弹窗改为 task-panel 风格:
  自定义头部 + 关闭按钮、min(px, 94vw) 宽度、字段栅格化
- 表单项 label 宽度统一为 110px,顶部 alert 说明改为底部提示文案
- 信息表单类名改为 mp-form--rows,与弹窗字段行样式保持一致

工具栏按钮与配置
- basicManagement/newview、role 页面补上 category 透传,避免按钮样式全部落到
  默认灰边分支
- basicManagement 模板配置 category 语义改为 refresh / setting / action / cancel,
  与 OrderToolbarButtonGroup 对齐

订单导出
- ORDER_EXPORT_ALL_COLUMNS 新增「拦截状态」(流程状态组),总数 53 → 54;
  注释标注:接口文档枚举暂未收录,需后端同步支持该表头

其他
- 配送计划复制 / 编辑弹窗、店铺快递绑定策略的多选下拉统一开启
  collapse-tags + collapse-tags-tooltip,避免标签横向溢出
- RolePermissionDialog 宽度收窄为 min(880px, 96vw)
2026-11-02 18:08:16 +08:00
yin
7958f0fd12 feat(inbox): 自动回复/会话页面改版,权限管理迁移 UpperTable,统一状态文本样式
自动回复(inbox/autoReply)
- 页面改为「左侧类型/子类型树 + 右侧配置区」两栏布局,树支持按类型名/子类型搜索
- 右侧类型信息与子类型列表重排:子类型改用 UpperTable,操作收敛为「配置 / 编辑 / 删除」链接按钮
- FunctionPanel / GroupPanel / NumberRulePanel 改用 UpperTable(统一 table-id、行 key 与列定义)
- KeywordPanel 关键词编辑改为 task-panel 弹窗,补充字段说明文案
- panel.scss 增补共享面板样式,减少各面板重复定义

会话消息(inbox/message)
- 会话链路由行内展开改为 task-panel 弹窗,时间线重做(收发方向标签、时间右对齐、
  消息卡片悬停态),支持直接「回复」并在弹窗内展示收发条数统计

品牌 Logo(frontBrand / Navbar / login)
- 新增 DEFAULT_BRAND_LOGO 常量与 isBrandExemptHost 计算属性
- 品牌豁免域名(主域名)恒用前端默认 Logo,不再消费后端 logo_url
- 登录页与顶栏统一改用该常量,修正兜底路径 '../../../public/logo/1.png'

权限管理(setting/permission)
- 列表迁移到 UpperTable(permissionColumns 抽到 permission-config)
- 新增「路径 / 名称 / 标题」关键字过滤、客户端分页、工具栏按钮组与批量删除(按勾选态置灰)

通用组件
- UpperTable 新增 selectionMode='native':树形表格使用原生勾选列,展开箭头不再挤占勾选列,
  并统一勾选框尺寸与行高
- 消息模块 DocSearchPicker 改为「单行筛选 + 表格填满高度 + 底部内嵌分页」,
  新增重置、已选提示(多选时提示只取第一条)

样式与交互统一
- 售后类型列表/详情、账号角色列的状态标签改为 ut-status-text 彩色文本(去掉 el-tag 色块)
- 售后列表、拣货车、打印电脑/工作台模板配置的工具栏按钮统一为
  refresh / setting / action / cancel 四类,批量操作按 noSelection 置灰
- ExpressWaybillPanel 表格内容居中;绑定包材弹窗成功后直接关闭并移除结果展示区
- 隐藏拣货车「详情」入口与角色树面板头部
2026-11-01 18:07:39 +08:00
yin
6053b8916f feat(stock): 新增拣货缺货补货页面并统一弹窗样式
新增「拣货缺货(缺货补货)」页面
- 基于 views/mode 模板 v2:ScanBox 筛选 + 工具栏(刷新/导出选中/字段设置)+ 汇总指标
  (SKU 总数 / 缺货 SKU / 建议补货 / 真实缺货)
- 表格展开行展示「补货库位明细」(存货区与分拣区库存),替代原侧栏「缺货明细」面板
- 路由 stock/pickingShortage/index 改为指向新页面,原补货需求页保留在
  storage/management/replenishmentDemand
- UpperTable 新增 showExpand 属性与 expand 插槽,支持通用展开行

perf(order): 订单模块参照数据复用缓存并降低切页开销
- 新增 utils/order-meta-cache.ts:快递公司 / 平台 / 店铺列表 60s 缓存,key 带
  当前 token(切账号自动失效),请求失败不落缓存
- 订单管理 8 个页签、待处理建单、储位分配、同步订单号等改为复用该缓存
- 角标查询增加 3s 节流(手动刷新强制)、tab→角标字段改反查表、
  选中订单 ID 改 computed,避免切页签重复请求与重复计算
- 状态文本 class 改为查表 + 结果缓存,减少大列表单元格渲染开销

feat(task-progress): 进度弹窗成功后统一 1.5 秒自动关闭
- 新增 components/task-progress/useAutoCloseOnSuccess.ts:成功延时关闭、失败保持
  打开、手动关闭/组件卸载清理定时器
- 波次抓取 / 波次批量 / 快速扫描、同步订单号、批量异步任务、储位分配等接入
- 同步更新《进度条弹窗-使用清单》

style(ui): 继续统一弹窗与详情面板为 task-panel 风格
- 店铺策略配置 / 一键开户、快递接口配置、收货详情面板、待处理订单详情、
  订单商品明细等页面重排为自定义头部 + 关闭按钮、min(px, 96vw) 宽度、
  双列栅格与静态信息行
- 收货详情面板拆为「表单区可独立滚动 + 图片区固定」
- ScanBox 多选折叠标签气泡固定向下弹出、限宽换行,方便逐个移除标签
- 异常单 / 待处理单批量处理的订单 ID 改为胶囊换行展示
- 带远程搜索的下拉补充 remote-show-suffix,面单数量输入占满右侧剩余宽度
2026-10-31 18:10:51 +08:00
yin
c2b8a9fe5e refactor(ui): 统一各模块弹窗为 task-panel 风格并完善交互细节
将 20+ 处 el-dialog 统一为自定义头部(标题 + 说明 + 关闭按钮)的 task-panel
布局,宽度改为 min(px, vw) 自适应,表单单列/双列栅格化,补齐底部提示与
滚动区域,移除冗余的 title/footer 默认样式;并顺带移除部分弹窗中已失效的
提示文案。

包含范围:
- 系统设置:角色/权限/账号/工作台/打印电脑/拣货车、基础管理(报表定义、
  应用、配送计划、详情面板)
- 订单:波次策略、绑定包材、面单面板、售后退货相关弹窗
- 仓储:收货建单、出库转单、盘点(表单/记录)、库存明细、组合商品
- 消息/售后/物料/装箱流水/自动回复等模块的表单与详情弹窗

feat(video): 新增录像播放失败原因诊断
- 新增 utils/videoDiagnose.ts:结合 <video> error.code 与源地址探测
  (HEAD,失败回退 Range GET)区分证书失效 / 断网 / CORS / 404 / 超时 /
  编码不支持,给出可读原因与排查建议
- packingflow、returnUnpack 的 VideoPlayerDialog 与 VideoListDialog 接入,
  错误态展示原因、建议与录像地址,异步结果按序号丢弃过期响应

feat(stock-check): 支持静态盘点拣货完成标记
- stock.check.ts 补充 picking_completed / locked_quantity / detail_id /
  location_id / snapshot_quantity 等字段类型与口径注释
- 盘点记录面板对 picking_completed=0 的商品展示「拣货中」标签(仅提示,
  不拦截上报)

feat(wave): 波次策略快速扫描成功后 1.5 秒自动关闭弹窗
- 失败保持打开以便查看错误;同步更新《进度条弹窗-使用清单》
2026-10-29 18:02:23 +08:00
yin
60e7b4d132 1 2026-10-28 18:00:13 +08:00
liufumingren
b12420e5a9 feat(stock-check): 添加盘点商品支持多行商品查询
- 商品查询框改为多行文本域,支持换行一行一个(去空行、去重)并展示已识别数量
- 查询条件统一为 where.stock_query = { operator: 'contains', value: [...], type: 'text' } 数组下发
- 支持 Ctrl+Enter 快捷查询,Enter 保留换行
- 补充 storage.inventory.list 的 stock_query 数组用法注释

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-28 07:44:28 +08:00
liufumingren
d76d3c6746 feat(stock-check): 新建盘点支持静态盘点并在审核时提示锁定
- 新建盘点新增 isStatic 参数(0 关闭 / 1 开启),仅商品盘点显示并传递,库位盘点不传
- 盘点任务回包新增 is_static,列表与详情展示静态盘点标记
- 审核通过确认框对静态盘点任务额外提示:锁定移库、分配储位(拣货不受影响),盘点完成后自动解锁
- 操作列按钮配置支持 confirmMessageWhen 动态确认文案与 HTML 渲染

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-28 07:37:11 +08:00
yin
41a3563bce 1 2026-10-27 19:10:53 +08:00
liufumingren
b7d302d65a fix(svg):修正退出全屏的svg图标 2026-10-27 00:34:15 +08:00
liufumingren
0601dca37d fix(express-interface):面单余量不属于表单内容,移除 2026-10-27 00:27:27 +08:00
liufumingren
e2e1aeaa95 feat(express-interface): pick 产品编码 from the express product type list
- read product_types from index.getShopExpressList and keep it keyed by both
  wp_code and sys_express_code, mirroring the existing site option mapping
- render 产品编码 as a filterable select labelled "名称(编码)" and keep storing
  the code; hide the field entirely when the express returns no product_types
- clear a stale product_type when the express / platform / shop changes

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-27 00:21:21 +08:00
liufumingren
9aa6e4ca0d fix(login): surface business failures and localize the login panel art
- request interceptor: treat flag=failure / success=false as a business error
  even when code is 0 (the gateway returns code 0 for login failures), so the
  backend message is shown instead of being swallowed
- tag already-notified errors so callers do not toast twice
- user store: throw a readable error when the login response has no token
  (previously crashed on null.token and the login page silently ignored it)
- login page: show an error message for errors the interceptor did not report
- replace the remote gw.alipayobjects.com decoration with a local svg

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-27 00:20:48 +08:00
liufumingren
e9c73ecd79 feat(nav): collapse top menu into a local-only "More" menu and fix navbar icons
- top menu: compute available width via flex layout (fixed logo / right-menu),
  collapse the overflow into a "更多" sub menu with one item per line and
  right-side flyout for nested menus
- align menu item heights (remove el-sub-menu 2px border causing 3px offset),
  rotate the "更多" caret when opened
- add local svg icons: fullscreen / exit-fullscreen / time / message / email
  (were referenced but never added, so the toolbar icons rendered empty)
- navbar icons follow the light text color instead of inheriting dark gray
- replace the empty chat button image with the ChatDotRound icon
- drop the external IM redirect in AiChat: the panel now stays in-app
- localize the avatar fallback (was wpimg.wallstcn.com)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-27 00:20:15 +08:00
yin
bb92c720fd refactor: update dialog components for consistent styling and button sizes
- Adjusted button sizes in CameraPreviewDialog and OperationCellRenderer for uniformity.
- Enhanced the layout and structure of ServerFormDialog and sign dialog to improve user experience.
- Implemented a new task panel design for better alignment and readability in various dialogs.
- Added computed properties for dynamic subtitles and footers in the sign dialog.
- Replaced ElMessageBox.prompt with a custom rename remark dialog for better styling consistency.
2026-10-26 17:59:21 +08:00
liufumingren
ad15972f20 feat: enhance user profile management and security features
- Added new API functions for account information retrieval and username/password updates.
- Updated AccountSecurity component to reflect password status and provide password management options.
- Removed BasicInfoForm and OperationLogs components, streamlining the profile interface.
- Enhanced UserInfoCard to allow username editing directly within the card.
- Improved overall user experience with loading states and error handling during API calls.
- Updated profile configuration to remove unused mock data and components.
2026-10-26 09:34:07 +08:00
yin
e8b3eda895 1 2026-10-23 18:00:35 +08:00
yin
7a8a087b17 1 2026-10-22 18:00:49 +08:00
yin
0d57e2d04a 1 2026-10-21 18:00:05 +08:00
yin
52536bb9e3 1 2026-10-20 18:00:51 +08:00
yin
06cb62fad1 1 2026-10-19 18:01:46 +08:00
yin
f9cc3b73e8 1 2026-10-18 17:57:06 +08:00
yin
697e50c51e 1 2026-10-17 18:08:29 +08:00
yin
b92f40734a 1 2026-10-16 18:00:04 +08:00
liufumingren
cf674d9fd0 feat(setting.warehouse): 自动出库规则改为数组结构并新增顶层开关
- 新增 auto_outbound_enabled 顶层开关,auto_outbound_rules 改为规则数组(多条为「或」,规则内条件为「与」)
- 移除 auto_outbound_rules 旧的 normalize 逻辑:不再按旧对象结构补齐子项,否则数组会被改写为对象并被 schema 回退成 [],导致用户配置保存时被静默清空
- 表单字段定义同步为 array 类型,更新各项 label/描述与默认值
2026-10-16 05:18:47 +08:00
yin
a344ba9544 2 2026-10-15 18:16:35 +08:00
yin
993b73fc9d 1 2026-10-15 17:57:29 +08:00
yin
931410c36d 1 2026-10-14 18:00:07 +08:00
liufumingren
a38529fa29 feat(dashboard): 首页应用下载新增数据大屏(Android TV)直接下载入口 2026-10-13 22:44:10 +08:00
yin
ac66dce6cf 1 2026-10-13 17:59:29 +08:00
yin
1925741ada 1 2026-10-12 18:01:25 +08:00
yin
714a300a10 1 2026-10-10 18:04:26 +08:00
liufumingren
66a40bbec4 refactor(库存盘点): 明细面板统一走 stock.check.result(detail 已不再返回明细列表) 2026-10-10 04:33:39 +08:00
liufumingren
460c8984b9 feat(库存盘点): 已完成任务新增导出盘点明细(stock.check.exportDetail 异步导出) 2026-10-10 04:24:50 +08:00
liufumingren
dbf7654c0b feat(库存盘点): 添加盘点商品时按任务货主限定只显示该货主的商品 2026-10-09 20:51:56 +08:00
yin
743f714246 1 2026-10-09 17:59:55 +08:00
yin
0cea3df5d5 1 2026-10-08 18:01:10 +08:00
liufumingren
bb80fd7130 perf(构建): 拆分 vendor chunk,入口 3.9MB -> 204kB
vite.config 增加 manualChunks 按库拆分与 chunkSizeWarningLimit;china-division 换用不含街道级的 pca-code.json(省 1.75MB);CreatePendingOrderDialog 改为异步组件,xlsx/china-division 不再进首屏。构建告警清零。
2026-10-08 01:10:16 +08:00
liufumingren
457d4d23d6 feat(订单管理): 订单列表新增复核时间(recheck_time)筛选、字段列与导出字段
待处理(含待出库)/配送/待处理异常/归档 4 个页签新增「复核时间」ScanBox 区间筛选与列表列;order.export 白名单「时间信息」组新增「复核时间」。
2026-10-08 01:10:13 +08:00
liufumingren
ec153b2267 fix(订单导出): 导出字段表头对齐后端新枚举(商品种数→订单商品总类数,商品件数→订单商品总数) 2026-10-07 23:50:43 +08:00
liufumingren
674f159780 feat(订单导出): 导出下拉四项统一先选字段,「导出全部」也挂上字段设置 2026-10-07 23:40:49 +08:00
yin
897d95f046 1 2026-10-07 18:16:55 +08:00
liufumingren
b31eef97c2 fix(仪表盘): PDA 版本信息字段对齐 latest.json
- PdaVersionInfo 改为 { version, file, url, sha256, publishedAtUtc }

- 模板取 publishedAtUtc / url(原 publishedAt / downloadUrl 已不存在)
2026-10-07 05:04:30 +08:00
liufumingren
2cdedda6f2 fix(商品): 统一列表查询 where 为 operator/value/type 结构
外仓商品页(stock/external_stock):

- 筛选条件改用 buildStockQuery;原来把 ScanBox 的 {value,operator,type} 拍平成裸值,后端解析失败(搜索条件格式错误)

- 筛选字段对齐系统商品页:修复「货物编码」被标成条码、重复两个「条码」;库存数量改 number;Y/N 开关改 boolean;分组/操作符统一

- 筛选不再重置工具栏选择的仓库

其余页面统一:

- 收回/组合商品选择弹窗、商品回收站:where 统一改用 buildStockQuery

- 合计 5 处调用 stock.warehouse.list 的页面全部为嵌套规范
2026-10-06 20:05:21 +08:00
liufumingren
0b00014427 feat(退回记录): 新增退回记录多标签页(退回收件任务/退回收件登记/退回拆包单/未退登记/收件/退回拆包作业)
新增:

- data/returnrecord tab 合并页 + router/map 映射(支持 ?tab= 刷新回到该页签)

- api/returnreceivedtask(list/create/delete-ids)

退回收件任务:

- 列表/筛选(关键词移至工具栏、是否有登记)/分页;新建(仅标题,批次号服务端生成);多选批量删除;登记数列(el-tag)

收件 tab:

- 左=锁定任务+扫码登记表单(无左侧label),右=该任务登记列表(语义化列+'-')

- 备注可复用下拉(localStorage)且常驻;扫码枪焦点无关自动登记(防双提交)

- 仅从任务列表「登记收件」进入,切走即移除页签

其它:

- 退回拆包单内嵌「拆包作业」入口;作业页键盘监听随激活态收放;进行中任务离开拦截

- 退回收件登记移除内置扫码表单/扫描人员工号;点 tab 清筛选;运单退回登记更名未退登记

- ScanBox/弹窗/单位换算等若干交互修复
2026-10-05 20:13:35 +08:00
yin
bf5471bd1b 1 2026-10-04 17:59:56 +08:00
yin
43cafbba83 1 2026-10-03 18:00:19 +08:00
yin
ef732ca2c6 1 2026-10-02 18:09:50 +08:00
yin
9913eba441 1 2026-10-02 18:04:11 +08:00
yin
72127ac45e 1 2026-10-02 18:03:43 +08:00
liufumingren
eb305306eb feat(库存盘点): 明细平铺/批量删除、库位级联选择器与 addDetail 新契约
- 明细面板:库位行内商品平铺成行、新增「明细类型」列、批量删除明细(stock.check.detailDelete,按明细ID去重,上限 200)

- 新增 LocationPicker(仓库→库区→货架→库位逐层下拉,v-model 为库位ID数组),「添加盘点库位」接入该组件

- addDetail 改走 location_ids(优先于 locations),补 invalid_location_ids 提示

- 删除调试用临时文件 temp_stockcheck_tail.txt
2026-10-02 03:22:21 +08:00
yin
4d89cd31d0 1 2026-10-01 18:02:41 +08:00
liufumingren
4dc90ac539 1 2026-10-01 09:07:35 +08:00
yin
48dbe020ff 1 2026-09-30 18:13:53 +08:00
liufumingren
1836500043 feat(订单列表): 筛选新增商品重量区间与重量类型 2026-09-30 02:23:04 +08:00
liufumingren
e21a19cc85 feat(商品管理): 新增作业要求(拣货/复核/打包/合并)与列表筛选(是否有作业要求、毛重) 2026-09-30 02:23:04 +08:00
yin
2cf3806edf 1 2026-09-29 18:15:06 +08:00
yin
cf119f7ff3 1 2026-09-28 18:00:22 +08:00
yin
afe4298997 1 2026-09-26 18:00:37 +08:00
yin
835eede083 1 2026-09-25 17:59:55 +08:00
liufumingren
a01f1371db feat(待处理订单): 建单弹窗导入预览支持异常筛选、勾选批量删除与导出选中
筛选:预览表格新增「全部 / 有异常 / 正常」下拉(含计数),切换时同步异常口径、回到第 1 页并恢复勾选。

批量操作:新增「删除选中(N)」「导出选中(N)」;单行/批量删除后保持当前筛选与页码,并在当前筛选结果内选中下一行。

导出选中:列名与列序取自「下载模板」的模板表头(解析失败回退内置表头),一条明细含多商品拆多行,导出文件可直接再次导入;本地 XLSX 生成并下载。

重构:表头别名抽为 IMPORT_FIELD_ALIASES,导入解析(buildPreviewRow)与导出共用;重置弹窗时异常筛选还原为「全部」。
2026-09-25 03:14:43 +08:00
liufumingren
b20be60f45 feat(系统设置): 前端独立部署改接 frontConfig.* 8 接口,页面改左菜单布局
API:src/api/frontconfig/frontConfig.ts 新增 getInfo/saveInfo/getDomain/setDomain/checkDomain/getCert/saveCert 及类型、FRONT_DOMAIN_STATUS 常量;移除被取代的 setting.warehouse.getFrontConfig/saveFrontConfig/saveFrontCert 封装与类型。

页面:FrontConfigForm.vue 改为左菜单(域名设置 / HTTPS 证书 / 品牌配置)+ 右内容布局;域名段支持保存域名、TXT 主机名与记录值复制、校验 DNS、刷新状态;证书段 saveCert 不再提交 domain,按 getCert 的 can_set_cert/can_set_cert_reason 置灰上传并展示同步状态;品牌段展示 updated_at。

请求层:request.ts 新增请求级 silentError(静默失败不弹全局提示,token 失效逻辑不受影响);frontConfig.getByDomain 静默失败(未登记/未验证域名 404「域名未配置」属预期);frontBrand 失败改为仅开发环境 debug 日志,并新增并发去重。

文档:前端独立部署操作与部署说明、接口落实任务清单同步新口径(8 接口矩阵与 2026-09-24 流程更正章节)。
2026-09-25 03:13:22 +08:00
liufumingren
2fe9a2c844 fix(系统设置): 仓库设置支持嵌套 object 子项,售后跟进时间不再渲染为 [object Object]
- 新增 ObjectFieldEditor.vue:object 字段按 meta itemFields 递归渲染(bool/select/color/number/string),
  嵌套 object 不再退化成文本框 String(对象);留空表示「跟随服务端默认」,提交时不写入该键
- WarehouseSettingsForm.vue:object 字段改用递归编辑器并整体回写;ensureFieldDefaults 不再为嵌套 object 预填二级值;
  顺带修掉模板 `as number | undefined` 触发的 vue/no-deprecated-filter 与 v-loading 属性顺序告警
- settingwarehouse.ts normalizeSchemaValue 增加 depth(顶层=1):
  * 扁平标量(如 order: "24")归一为 { _default: 24 },不再被内层默认值覆盖丢值
  * 嵌套 object 无实际值或归一化后为空则不写入该键
  * 嵌套层叶子缺省不注入 meta 默认(留空 = 跟随服务端默认)
2026-09-24 03:23:39 +08:00
yin
c926beb226 1 2026-09-23 18:10:36 +08:00
liufumingren
6a2e1c055e fix(系统设置): 仓库设置页移除顶部重复按钮,统一使用底部固定操作条
头部只保留标题与当前仓库 ID,刷新/保存统一放在底部固定操作条(右对齐,常驻可见),
避免头尾各一组按钮;同步删除已无用的 .header-actions / .footer-hint 样式。
2026-09-23 02:43:31 +08:00
liufumingren
19e55726d9 fix(系统设置): 仓库设置页顶部固定、设置项独立滚动、底部新增固定保存条
配置项很长而保存按钮只在顶端,配置完要滚回顶部才能保存,体验差。改为:
- 顶部标题与操作固定,中间设置项区独立滚动(overflow-y:auto + overscroll-behavior:contain)
- 底部新增固定操作条(刷新 / 保存,与顶部按钮等效,带说明文案)
- 补全页面 flex 高度链路(flex:1 + height:100% + min-height:0),使长表单只在设置项区域滚动
2026-09-23 02:41:15 +08:00
liufumingren
4b6def1d89 fix(系统设置): 仓库设置子项归一化改为按 getFieldMeta 的 item_keys 驱动
- auto_outbound_rules 字段名对齐后端:allow_same_day_outbound 改为 exclude_same_day_outbound
  (语义相反、默认 true),并兼容读取旧字段名
- normalizeWarehouseSubjectConfig 新增可选 schema:顶层 object / array 字段的子项按 meta
  item_keys 递归归一化(flag→boolean、integer→number、缺省用 default),避免后端改字段名
  或新增子项时读取与提交再次出现漂移;顶层其它类型保持既有归一化,不改 flag 的 0/1 语义
- normalizeGetSettingsPayload / buildSaveSettingsRequest / normalizeSaveSettingsPayload 透传 schema;
  页面先解析 meta 再解析 settings,并把字段元信息作为 schema 传入
- 顺带修复 after_sale_followup_hours 提交空对象的问题
2026-09-23 02:34:47 +08:00
liufumingren
5c3ad6ad75 feat(微信小程序): 认证状态对接 queryauth 新契约,新增发起认证与同步微信信息
- wechat.ts:wechat.queryauth 契约更新(is_verified / verify_type_id / taskid / apply_status 等);
  新增 wechat.wxaauth(发起认证,图片字段支持 COS URL,超时 180s)与 wechat.getAuthorizerInfo
- MiniProgramConfigForm.vue:认证状态面板按新契约重写,新增「发起微信认证」弹窗与「同步微信信息」入口
2026-09-23 02:22:44 +08:00
liufumingren
b32bc4ec7e fix(系统设置): 仓库设置自动出库规则不再丢失「出库当天订单」的时间字段
normalizeWarehouseSubjectConfig 原先按「值是否为 boolean」过滤 auto_outbound_rules 子项,
字符串子项 same_day_outbound_deadline_time / same_day_outbound_release_time(HH:mm)
在读取(getSettings)与保存(saveSettings)时都被静默丢弃;改为按 flag 与 HH:mm 时间
白名单逐项归一化,并补全页面兜底字段与输入长度限制。
2026-09-23 02:22:42 +08:00
yin
b370cfd706 1 2026-09-22 18:10:52 +08:00
liufumingren
1db19bafdd style(微信小程序): 调整左菜单顺序,支付配置移到发布之后
- 左菜单顺序:基础信息 / 认证状态 / 备案配置 / 发布 / 支付配置 / 微信用户
2026-09-22 02:42:50 +08:00
liufumingren
fc5a80717e feat(微信小程序): 授权页支持主域名校验、代注册入口与左菜单+右明细结构
- 主域名校验:复用 frontBrand 导出 isMainDomainHost/normalizeFrontHost/getMainDomainHosts,非主域名禁用授权/代注册并提示
- 新增「代注册小程序」按钮:wechat.getRegisterUrl 取链接,在新小窗打开
- 已授权改为左菜单+右明细(基础信息/认证状态/备案配置/支付配置/发布/微信用户),左右各自滚动、边框到底
- 基础信息改为「名称:不可编辑输入框」;头像只显示图片;隐藏启用状态/所属仓库/记录ID
- 修正 auth_time(Unix 秒)与 ISO 时间本地化;func_info JSON 解析为功能标签
2026-09-22 02:39:47 +08:00
liufumingren
401d1aa3df feat(系统设置): 新增微信小程序配置页(标签页 + 独立页)
- 接口:setting.warehouse.getweChatApp 拉取已授权小程序配置
- 接口:wechat.getAuthUrl 获取微信授权链接(点击按钮后在新小窗打开)
- 未授权(data 为 null)时提示需要授权,授权完成自动轮询刷新
- 新增「微信小程序」标签页与 system/setting/miniprogram 独立页路由(备用)
2026-09-21 18:26:00 +08:00
yin
f68c1fd301 1 2026-09-21 18:00:26 +08:00
liufumingren
d5f598da57 feat(工作台): 列表支持多选,新增批量打印工作台二维码(A4 三列) 2026-09-21 03:00:46 +08:00
liufumingren
9a0ac370ec fix(打印): 浏览器打印时打印时间为空的兜底处理 2026-09-20 17:08:17 +08:00
liufumingren
bf9bba5059 feat(order): 波次/订单新增「确认打印状态」「领料状态」,波次页支持扫码确认打印
波次:注册全局扫码事件(src/composables/useBarcodeScan.ts),长度超过 8 位的面单号提交 order.wave.confirmPrintScan 整波确认打印,切页/失活自动摘除监听;tab 区新增「确认打印未领单 N」角标,order.wave.confirmPrintUnclaimedWaveCount 长轮询实时刷新(离开页面停止、回到页面重新轮询);列表新增确认打印状态/领料状态筛选、列与明细展示

订单:列表补齐「确认打印状态」(confirm_print_status) 与「领料状态」(claim_status) 列;ScanBox 流程状态组新增两项筛选(待处理/待出库/待处理异常/配送订单);导出字段白名单新增「领料状态」「确认打印状态」(流程状态分组,52 → 54);claim_status 文案由「认领」统一为「领料」
2026-09-20 05:01:59 +08:00
yin
648a6eb86c 1 2026-09-19 17:59:58 +08:00
yin
6b073283bf 2 2026-09-18 18:37:15 +08:00
yin
216d23ef5f 1 2026-09-18 18:37:05 +08:00
liufumingren
68f7990373 1 2026-09-18 09:55:20 +08:00
yin
54e1caf8de 1 2026-09-17 18:00:43 +08:00
liufumingren
6f8e1c9ca9 Merge branch 'main' of http://192.168.9.101:4000/liufumingren/WEB 2026-09-17 09:09:51 +08:00
liufumingren
9179f9c5d8 1 2026-09-17 09:09:47 +08:00
yin
c20eff0d8a 1 2026-09-16 18:11:39 +08:00
liufumingren
60318d9b07 feat(camera): 摄像头预览弹窗新增云台控制面板(方向/转速/预置点)
- src/api/camera: 新增 ptzControl / ptzStop / ptzPresetGoto / ptzPresetSet 及 PtzDirection、转速与预置点校验

- src/components/CameraPtzPanel: 8 方向按住转动(松手停止)、转速 1-7、预置点 1-8 快捷键与编号跳转/覆盖保存

- 防呆: 按下请求未返回时先记录、返回后补发 stop;window pointerup/pointercancel/blur 与卸载时兜底停止

- newcamara 预览弹窗接入云台面板
2026-09-15 21:08:49 +08:00
yin
3e9095c73e 1 2026-09-15 18:31:55 +08:00
liufumingren
4ecf3c32b8 1 2026-09-15 09:04:56 +08:00
liufumingren
2cc558be60 1 2026-09-15 09:04:25 +08:00
yin
f4db240163 1 2026-09-14 18:07:40 +08:00
liufumingren
cc9c0f71c4 fix(shipperSigning): 修正 @/api/storeWarehouse.warehouse 导入路径大小写(TS1261) 第8次
abf03a9 把 Externalwarehouse/store 两个 shipperSigning/index.vue 的 import 改成小写 storewarehouse.warehouse,导致 vue-tsc 报 TS1261。已改回磁盘真实目录名 storeWarehouse.warehouse;storewarehouse.store 目录磁盘为全小写,引用保持小写不变。
2026-09-13 20:15:55 +08:00
liufumingren
9532289947 fix(packingflow): 恢复打包流水列表「任务ID」列
取消 packingColumns 中 id 列注释(该列在 7afc669 提交中被注释掉)。
2026-09-13 20:15:52 +08:00
yin
7afc6697fc 1 2026-09-12 18:00:18 +08:00
yin
abf03a901f 1 2026-09-11 17:59:33 +08:00
liufumingren
1b4107c437 feat(波次拣货): 拣货中任务列表新增「车编码」查询条件(where.cart_code,默认模糊匹配) 2026-09-10 23:33:36 +08:00
liufumingren
7219f2eda4 feat(订单列表): 新增「商品种类数量」「商品总数」筛选条件(订单管理各页签共用商品统计分组);顺带修正 shipperSigning 导入路径大小写(TS1261) 2026-09-10 23:00:44 +08:00
liufumingren
39eae631ea 1 2026-09-10 22:53:06 +08:00
yin
598f60c6a3 1 2026-09-10 18:04:04 +08:00
yin
fd9dce6ecd Merge branch 'main' of http://192.168.9.101:4000/liufumingren/WEB 2026-09-09 18:02:21 +08:00
yin
1d29952e22 1 2026-09-09 18:02:17 +08:00
liufumingren
26625838af 1 2026-09-09 15:08:51 +08:00
liufumingren
db5c935f87 feat(基础设置): 前端独立部署(品牌配置+自持域名证书)拆分为独立标签页;基础设置页移除该区块 2026-09-09 04:19:59 +08:00
yin
90bd48b2f9 1 2026-09-08 18:04:27 +08:00
liufumingren
f7dbc127cc chore(vite): 开发服务器允许所有 Host 访问(allowedHosts: true) 2026-09-08 03:38:19 +08:00
liufumingren
1bae275cef feat(波次拣货): 状态栏查询用时旁新增平均拣货/复核时长提示(剔除缺失与≤1分钟记录);UpperTable 增加 pagination-info-extra 可选插槽 2026-09-08 02:40:52 +08:00
liufumingren
5fffd8bb45 feat(波次拣货): 拣货用时改为 HH:MM:SS 补零格式;新增复核用时列(复核完成-复核开始,同格式) 2026-09-08 02:26:27 +08:00
liufumingren
e5f13c1019 fix(shipperSigning): 修正 @/api/storeWarehouse.warehouse 导入路径大小写不一致(TS1261) 第6次 2026-09-08 02:18:17 +08:00
liufumingren
3df2ae0404 feat(波次拣货): 拣货任务列表新增「拣货用时」字段(完成时间-开始时间,单位分钟,保留2位小数) 2026-09-08 02:18:15 +08:00
yin
7ae618471d 1 2026-09-07 18:13:14 +08:00
liufumingren
e94ecb4e63 fix(shipperSigning): import 路径大小写修正为 storeWarehouse.warehouse 防 TS1261 2026-09-06 01:31:21 +08:00
liufumingren
6d49da8b43 feat(波次管理): 页签切换写回 URL query(tab),刷新/复制链接可恢复对应页签 2026-09-06 01:31:20 +08:00
liufumingren
74e31d0e0b feat(订单列表): 波次类型筛选 wave_scope 枚举修正(0未分配/1大团购/2散单/3小团购/4单品单件) 2026-09-06 01:31:20 +08:00
yin
134fdbc4b3 1 2026-09-05 18:12:01 +08:00
liufumingren
7e380d6c54 feat(波次拣货): 拣货任务列表增加波次号/操作人/拣货人/领料人/复核人筛选,操作符经 where 下发后端;contains/in/notin 的 value 按全站约定以数组传递,like 等为字符串 2026-09-05 02:17:47 +08:00
liufumingren
9b6be17119 feat(收货商品): 查询系统商品改用 stock.warehouse.search 关键字检索+本地分页 2026-09-05 01:11:26 +08:00
liufumingren
5b0f1f9c00 feat(波次筛选): 波次类型拆分为大团购/小团购并新增 value=3 选项 2026-09-05 01:11:24 +08:00
liufumingren
e6e46f0023 fix(shipperSigning): 修正 @/api/storeWarehouse.warehouse 导入路径大小写不一致(TS1261) 2026-09-05 01:11:21 +08:00
liufumingren
269e74927e feat(拣货任务): 列表新增领料人列,读取 claim_operator/claim_operator_id 2026-09-05 01:11:19 +08:00
yin
fe3a963748 1 2026-09-04 18:06:23 +08:00
liufumingren
321e1110a2 1 2026-09-04 10:17:48 +08:00
liufumingren
caa1b83cc8 feat(库存报表): 列表改服务端分页并按其他接口传 pagination/sort;导出语义修正为 item=含锁定、不传=仅出入库,新增导出选中(仅出入库/全部含锁定) 2026-09-04 02:32:38 +08:00
yin
e3f5c9ede5 1 2026-09-03 18:36:28 +08:00
yin
7f4a4549b6 1 2026-09-03 18:05:47 +08:00
yin
9d5b179059 1 2026-09-02 18:02:26 +08:00
liufumingren
12b26d5eb0 1 2026-09-02 09:00:09 +08:00
liufumingren
01f0727602 Merge branch 'main' of http://192.168.9.101:4000/liufumingren/WEB 2026-09-02 08:58:55 +08:00
yin
8c140fa767 1 2026-09-01 19:26:55 +08:00
liufumingren
4b2d7b195c feat(报表定义): 字段支持排序(拖拽+上移下移按钮),顺序即导出表格列顺序 2026-09-01 00:41:05 +08:00
liufumingren
de80a1d1f2 fix(导入路径): 统一 storeWarehouse.warehouse 导入大小写,修复 TS1261 打包报错 2026-08-31 22:50:13 +08:00
liufumingren
d02d68867a fix(报表定义): 编辑时剔除类型注册清单中不存在的失效字段 2026-08-31 22:36:56 +08:00
yin
ae95560aef 1 2026-08-31 19:48:07 +08:00
liufumingren
81b663de63 fix: 打包报错修复与部署脚本 Windows 跨平台化
- 修复 TS1261 import 大小写(33 处)、TS2561 report_code→report_id、TS2339 类型标注
- deploy/rollback 支持 Windows: npm.cmd EINVAL(改用 node 直跑 npm-cli.js)、sshKey 绝对路径
- map.ts 兼容后端菜单老路径,强制指向 basicManagement newview(含投递计划/报表定义)
- report.deliveryPlan.copy 返回结构对齐后端 created/skipped,修正前端误报复制成功
2026-08-30 09:29:57 +08:00
liufumingren
08b3dc4739 部署脚本跨平台化:新增 scripts/deploy.mjs、rollback.mjs 及远程执行脚本,package.json 改用 node 执行;移除根目录 deploy.sh/rollback.sh;部署配置独立到 scripts/deploy.config.json 并加入 .gitignore 不跟踪 2026-08-30 08:30:04 +08:00
liufumingren
6c8843e85b 重构报表配置与投递计划:定义按id+type+fields管理、投递计划关联报表定义、复制到其他货主
- report.definition: save/list/delete/typeList 对接新契约(id upsert、type 注册表、fields 子集、{date} 文件名模板)
- 报表定义表单改为下拉选 type + 勾选 fields(来自 report.definition.typeList)
- 投递计划改按 report_id 关联报表定义,下拉单选、渠道收敛 inbox、新增计划名称与 store_name 展示
- 新增 report.deliveryPlan.copy 复制到其他货主(DeliveryPlanCopyDialog 多选货主)
- inbox.group.quickList 增加 store_id 过滤;members 改为 groupIds 数组入参
- 移除导出任务标签页及关联代码
- 移除 code/scope/三段 JSON 配置等旧模型字段
2026-08-30 07:22:13 +08:00
liufumingren
92a731c8a3 订单导出字段设置增加来源列 2026-08-30 02:26:14 +08:00
yin
026f600378 修复某些页面表格数据渲染异常问题 2026-08-29 20:00:22 +08:00
yin
6ab17998e8 1 2026-08-29 18:16:18 +08:00
yin
378cdffb0f 1 2026-08-28 18:11:55 +08:00
yin
b0512d3308 1 2026-08-27 18:11:02 +08:00
yin
21d168cafc 1 2026-08-26 18:27:37 +08:00
liufumingren
3ef327e0b8 1 2026-08-26 09:04:05 +08:00
liufumingren
5211f818fc feat: 收货单未设置货主时禁止创建商品并提示 2026-08-25 22:59:15 +08:00
liufumingren
53f3b824f4 修复快递接口ext_data结构:改为服务值映射并兼容系统快递编码 2026-08-25 22:58:49 +08:00
yin
072f4dd833 1 2026-08-25 18:14:47 +08:00
liufumingren
82c280e0dc feat: 收货单筛选新增毛重筛选条件 2026-08-25 01:36:28 +08:00
liufumingren
b57d08af5c feat: 拆包列表增加强制录制(returnUnpack.forceRecord) 2026-08-25 01:35:35 +08:00
liufumingren
5eecfda9fa feat: 拆包明细备注下拉选项支持删除并持久化 2026-08-24 22:34:05 +08:00
liufumingren
8e808db6ce feat: 拆包创建单返回货主时锁定货主,不可移除和编辑 2026-08-24 22:22:13 +08:00
liufumingren
6d2df0f0d0 fix: 拆包选择商品后锁定货主不可清空,商品搜索限定当前货主,修复弹窗回传store_id缺失 2026-08-24 22:11:24 +08:00
yin
7803bc2879 fix:语法 2026-08-24 19:27:42 +08:00
liufumingren
9c31a5353e feat: 拆包选择商品弹窗增加图片组预览及货主名称,商品行备注改为可持久化下拉并修复输入误判扫码 2026-08-24 19:14:49 +08:00
liufumingren
2dcf4de60a feat: 拆包扫码商品模式增加一次性数量输入框(默认1,用后重置) 2026-08-24 19:03:17 +08:00
liufumingren
3494d6b2a7 fix: 拆包扫码未匹配商品时不阻断,按未识别商品登记空stock_id和条码 2026-08-24 18:47:32 +08:00
liufumingren
2a1efd296f feat: 收货单新增直入库存按钮,快捷入库更名为转入库单 2026-08-24 04:57:50 +08:00
liufumingren
06029b6bb3 fix: 拆包 OSD 字幕清屏改为推「无任务」待命文字,默认开启并增加推送反馈 2026-08-23 23:02:29 +08:00
liufumingren
558aacbae1 feat: 拆包工作台接入摄像头 OSD 字幕推送(扫单号/商品条码自动推送) 2026-08-23 22:45:52 +08:00
yin
a241495afc 1 2026-08-23 18:15:02 +08:00
liufumingren
5b9a529c84 1 2026-08-23 09:37:09 +08:00
yin
e46feaaa01 1 2026-08-22 20:20:47 +08:00
liufumingren
154cf6081b feat(storage/inventory): 批次/汇总查询库位列展示与明细双模式移库
- 批次查询主列表新增库位列并映射 batch_no
- 查询条件改为 stock_query(参考订单查询),移除商品ID选择器
- 汇总模式主列表库位通过 listByStockId 按商品批量补全(单库位显示库位名,多库位显示n个库位)
- 明细面板支持按明细/按库位汇总双视图(group_by_space),按视图显示对应移库按钮
- 明细表格动态高度可滚动,勾选行驱动按库存记录/按商品移库
- 明细面板默认高度占比调整,新增刷新按钮
2026-08-22 01:56:05 +08:00
liufumingren
de5b25a04b refactor: 明细表移除库存数量列 2026-08-21 22:32:22 +08:00
liufumingren
ccd9e7011c fix: 入库单列表恢复订单状态、收货绑定等状态列 2026-08-21 22:29:20 +08:00
liufumingren
051927c20f feat: 入库单列表新增应收总数、实收总数列 2026-08-21 22:18:56 +08:00
liufumingren
83de2a8106 refactor: 入库单列表列调整:商品数改为商品种类数,精简冗余列 2026-08-21 22:14:15 +08:00
yin
b38c6ae918 1 2026-08-21 18:09:54 +08:00
liufumingren
b26129cf4d Merge branch 'main' of http://192.168.9.101:4000/liufumingren/WEB 2026-08-21 02:16:40 +08:00
liufumingren
f472e3edda feat: 收货单批量导入与货架批量修改改用 searchSpaces 批量查询库位 2026-08-21 02:16:07 +08:00
yin
9e344a845b Merge branch 'main' of http://192.168.9.101:4000/liufumingren/WEB 2026-08-21 01:54:24 +08:00
yin
89b6a154a1 1 2026-08-21 01:54:20 +08:00
yin
69781b1f73 1 2026-08-21 01:54:14 +08:00
liufumingren
5ef2f10139 feat: 批量入库库位解析改用 index.searchSpaces 批量查询,失败兜底默认收货区 2026-08-21 01:43:00 +08:00
yin
2bcee8db80 1 2026-08-20 18:10:12 +08:00
yin
49655a585a 1 2026-08-19 18:13:26 +08:00
liufumingren
5b58f329ea feat: 拦截筛选分粒度配置(待处理/异常查是否拦截,配送查全枚举)并加固库内拦截确定校验 2026-08-19 03:19:21 +08:00
liufumingren
f9495211d0 feat: 待处理列表新增批量库内拦截确定(order.recheckOrder.confirmIntercept) 2026-08-19 02:58:51 +08:00
liufumingren
1b7025a1e8 feat(order): 订单列表新增波次内序号 wave_index 显示列与区间筛选 2026-08-19 02:50:34 +08:00
yin
8839bbc601 1 2026-08-18 18:11:42 +08:00
liufumingren
916aa4444c 1 2026-08-18 09:20:39 +08:00
liufumingren
55b6255421 feat(inbox): 群管理新增清空群类型配置操作(inbox.group.reset) 2026-08-17 22:12:28 +08:00
yin
5cd18ae9de 1 2026-08-16 18:11:37 +08:00
yin
4822637729 1 2026-08-15 18:16:52 +08:00
yin
637a1092cc 1 2026-08-14 19:43:35 +08:00
yin
b92745c8ec 1 2026-08-13 18:16:38 +08:00
liufumingren
40ea445e4f feat: 新增退回收件登记页面(returnReceived) & 售后详情/文案调整 2026-08-13 01:57:37 +08:00
yin
b3be2e11e6 1 2026-08-12 18:10:00 +08:00
liufumingren
aef02273ad feat: 群信息编辑子类型按群类型动态约束,补全warehouse/express子类型选项 2026-08-11 21:37:58 +08:00
yin
dc707e653e 1 2026-08-11 18:21:46 +08:00
liufumingren
0cfec94047 chore: 售后列表 & 消息页面其他改动 2026-08-11 17:48:10 +08:00
liufumingren
91105102bf feat(afterSale): 售后详情弹窗排版优化 & 批量操作按钮颜色调整
- 售后详情: 新增related关联数据展示(订单/运单/店铺), 操作状态栏, 订单操作日志
- 售后详情: 详细描述移出表格防撑开, 移除角色组/处理结果/完成时间字段
- 售后列表: 批量完成按钮改为warning橙色, 批量关闭改为danger红色
- 售后列表: 处理下拉增加等待反馈选项
- API类型: AfterSale接口补充related等关联数据类型
- 工具栏组件: resolveButtonStyle支持显式type覆盖 & 按钮key强制样式映射
2026-08-11 17:47:48 +08:00
yin
797256463f 1 2026-08-11 14:48:46 +08:00
liufumingren
03051fb0d4 1 2026-08-11 09:34:45 +08:00
yin
3b35ce2d8b 1 2026-08-10 18:13:39 +08:00
liufumingren
abe6d3f668 feat(afterSale): 售后模块V2 - 工单入口、发起售后、订单快速搜索
- 新增售后API层(afterSale.workList/detail/create/update/transfer/handleWorkOrder/registerClaim/export/workCount/quickSearch)
- 消息中心改为工单入口(/workorder),支持ScanBox+UpperTable筛选列表
- Navbar工单角标(每60s轮询afterSale.workCount)
- 新增发起售后单弹窗(关联单据按类型动态切换、货主下拉、订单快速搜索)
- 订单搜索使用order.deliveryOrder.quickSearch跨表联合搜索
- DocSearchPicker通用单据搜索组件
- 售后明细页增加附件上传(handleWorkOrder/registerClaim)
- 移除已废弃的workOrder页面、下载入口、LangSelect图标
- 修复where字段camelCase/snake_case不一致问题
2026-08-10 04:40:36 +08:00
yin
ac42f708fe 1 2026-08-08 18:14:24 +08:00
liufumingren
692e5cd4a4 refactor(stockout): 出库单页面优化 2026-08-08 01:53:56 +08:00
liufumingren
21b0249097 feat(inbox): 站内信消息列表和群组列表功能增强
- 消息列表: 增加货主下拉多选、时间范围查询,请求格式对齐 pagination/where 结构
- 消息列表: 表格列优化(隐藏外部ID/目标类型/渠道/父消息ID,新增发送人列)
- 群组列表: 增加货主下拉多选、是否禁用筛选,默认过滤已启用群组
- 群组列表: 表格列优化(货主ID→货主名称,快递编码→系统快递名称,新增AI回复列)
- 群组编辑: 货主/快递接口下拉改用 index.loadStores / index.loadExpressInterfaces
- 群组编辑: 系统快递编码筛选联动快递接口列表
2026-08-08 01:53:21 +08:00
yin
2d955cf961 1 2026-08-07 18:10:07 +08:00
liufumingren
e1a967b765 1 2026-08-07 09:17:58 +08:00
yin
1a0495f41e 1 2026-08-06 18:18:03 +08:00
yin
78f638a3e8 1 2026-08-06 18:16:33 +08:00
liufumingren
c69d332b1b chore: 订单模块微调 2026-08-06 04:05:27 +08:00
liufumingren
a40e1d56b7 feat: 新增站内信模块 - 消息列表和群组管理页面 2026-08-06 04:05:19 +08:00
yin
63b81aad31 1 2026-08-05 18:12:37 +08:00
liufumingren
d11c89a54d 1 2026-08-05 09:23:58 +08:00
yin
064635a59d 1 2026-08-04 18:15:11 +08:00
liufumingren
cdde7183e4 feat: 快递编码支持自定义 & 快递策略列表显示名称
- 移除 getExpressList 的 systemOnly 参数,快递编码下拉不再限定系统编码 (pendingOrder, exceptionOrder)
- 新增货主快递绑定策略页面 (storeExpressBindingPolicy)
- 策略列表快递编码列改为显示快递名称 (express_name)
- 路由注册 storeExpressBindingPolicy 页面
2026-08-04 08:22:24 +08:00
yin
6274ce1407 1 2026-08-03 20:04:17 +08:00
yin
1706b927e7 1 2026-08-02 18:42:32 +08:00
yin
8cdc82b4ff 1 2026-08-01 18:15:27 +08:00
liufumingren
f7f50a3c99 feat: 新增API开放接口管理模块
- 新增 src/api/system/apiApp.ts: 封装 apiApp.list/detail/create/update/delete/regenerateSecret 全部接口
- 新增 ApiOpenInterface.vue: API应用列表+CRUD+详情+密钥管理完整功能
- 修改 index.vue: 添加「API开放接口」tab页签
2026-08-01 03:39:02 +08:00
yin
1827ea30de 1 2026-07-31 18:16:07 +08:00
yin
1fc20db3d5 1 2026-07-31 18:12:31 +08:00
liufumingren
5c1aeb2a61 1 2026-07-31 09:35:35 +08:00
yin
8d9360bb9f 1 2026-07-30 18:12:43 +08:00
liufumingren
11aeb0401e fix: 打包流水设置结束时间格式对齐后端 YYYY-MM-DD HH:mm:ss,修复默认值计算逻辑 2026-07-30 00:37:58 +08:00
yin
af204d3c70 1 2026-07-29 18:18:57 +08:00
yin
690737c1b4 1 2026-07-28 18:18:54 +08:00
liufumingren
05137c2e3f feat: 打印电脑设置录制时移除远程连接(remote_play_url)传参 2026-07-28 01:10:57 +08:00
yin
2385b40866 1 2026-07-27 18:01:47 +08:00
liufumingren
9743cdd36f refactor: 打印组件二维码渲染改用 qrcode 库 2026-07-27 04:54:10 +08:00
liufumingren
01d26f6649 fix: 订单重量标签 kg→g + 订单状态/来源中文翻译 2026-07-27 04:54:00 +08:00
liufumingren
1137f75cd2 fix: 移除仓库空间 max_weight 字段(接口不接受) 2026-07-27 04:53:57 +08:00
liufumingren
2e5093ddd2 fix: 库存/收货/包材 - 重量单位添加 g 标注及整数校验 2026-07-27 04:53:53 +08:00
liufumingren
15f096b7c1 fix: 订单称重/复核/波次/运单面板 - 重量单位 kg 改为 g 2026-07-27 04:53:48 +08:00
liufumingren
623150288e fix: API 注释 - 重量单位 kg 改为 g 2026-07-27 04:53:44 +08:00
yin
5ccc42fdbc 1 2026-07-25 18:14:50 +08:00
yin
cd205c4853 1 2026-07-24 18:17:35 +08:00
yin
ae76229068 1 2026-07-23 18:23:55 +08:00
yin
99dd76a1ab 2 2026-07-22 18:19:06 +08:00
yin
daebceebd6 1 2026-07-22 18:18:30 +08:00
yin
6c8d1f5014 1 2026-07-21 18:21:00 +08:00
yin
77f54c1151 1 2026-07-20 18:21:57 +08:00
liufumingren
292e69a6d1 fix: 修复摄像头编辑/操作列数据引用问题
CameraFormDialog: 添加isPopulating标记防止watch清空已填充字段; 兼容row.server.id和row.server_id两种数据结构; 使用append-to-body避免z-index遮挡

OperationCellRenderer: 使用watch捕获row最新值解决slot scope引用失效; 简化buildFormProps参数传递

newcamara/index: 操作列改为直接渲染编辑/删除/预览按钮; 添加getRowById通过ID从listData查找完整行数据

camera/index: 添加isEditingMode标记防止编辑时watch清空字段; 使用formData.id判断创建/编辑模式; dialog添加z-index
2026-07-20 02:24:10 +08:00
liufumingren
3508316fca feat: 面单余额变动日志支持筛选与导出
添加充值/消费类型筛选与时间范围筛选; 新增异步导出功能(exportPrintQuantityLogs API + 进度查询); where参数支持gt/lt/between操作符; 集成AsyncExportProgressDialog导出进度弹窗
2026-07-20 02:24:04 +08:00
liufumingren
86f76ba14a feat: 新增打包流水功能
新增打包流水页面(data/packingflow)及API(api/order/packing); 添加路由映射与中英文国际化; 清理zh-CN中多余空字符串
2026-07-20 02:23:59 +08:00
yin
19ac3babad 2 2026-07-18 18:23:45 +08:00
yin
17964ec59a 1 2026-07-18 18:13:20 +08:00
liufumingren
056e34da40 Merge branch 'main' of http://192.168.9.101:4000/liufumingren/WEB 2026-07-18 08:49:18 +08:00
liufumingren
737866aa92 feat: 摄像头管理模块 - 连通测试、通道拉取、实时预览
- 新增 localServerApi.ts: 本地代理 API (通道列表/连通测试/实时流)
- 新增 localCameraServer store: 管理本机多端口连接
- 新增 CameraPreviewDialog: 摄像头预览弹窗 (RTSP→MJPEG, 内外网回退)
- 新增 CameraPlayer: 海康SDK播放器组件(备用)
- 录像服务器列表增加连通测试按钮(先内网后公网)
- 摄像头表单选择服务器后自动拉取通道列表
- 通道选中自动填充设备信息(IP/端口/型号/序列号)
- camera API create/update 入参扩充(ip/port/model/serial_number/stream_type)
- custom_name 改为必填
- vite.config.ts 增加 /ISAPI 代理转发
- public/hikvision/ 海康Web SDK静态资源
2026-07-18 03:02:31 +08:00
yin
288923f205 1 2026-07-17 20:30:29 +08:00
yin
4ebef7adc1 1 2026-07-17 18:25:58 +08:00
liufumingren
11fe10829e feat: 新增货主侧商品流水、视频监控模块,完善工作台与库存报表功能
- 新增货主侧商品流水页面 storage/productflow/store
- 新增视频监控模块 video/camera 和 video/cameraServer
- 完善工作台配置与视图功能
- 增强库存 API、报表 API 和工作台 API
- 更新路由映射 componentMap
2026-07-17 05:30:55 +08:00
yin
c7d832b0b0 1 2026-07-16 18:23:21 +08:00
yin
7e83aae2c0 1 2026-07-15 18:15:56 +08:00
yin
8981807258 1 2026-07-14 18:16:27 +08:00
yin
1d7964770e 1 2026-07-13 18:20:20 +08:00
liufumingren
9e0b85624b 1 2026-07-13 02:48:04 +08:00
yin
476f6c20a1 1 2026-07-11 18:17:37 +08:00
liufumingren
51416d367e 1 2026-07-11 10:11:18 +08:00
yin
d1ef9e502d 1 2026-07-10 18:15:10 +08:00
liufumingren
e2f09a9bc3 1 2026-07-10 09:27:53 +08:00
yin
9c1ba8d5a2 1 2026-07-09 18:14:25 +08:00
liufumingren
84291ca149 feat: 恢复签约管理页 ScanBox 筛选面板;仓库页移除发起签约、新增奇门配置只读查看;新建外仓商品页面
- warehouses: 恢复 ScanBox,移除预览签约,新增奇门配置查看(支持复制货主/仓库编码)

- stores: 恢复 ScanBox,移除发起签约按钮及弹窗(签约已统一由货主方发起)

- storeWarehouse API: 新增 storeWarehouseList 导出

- 新建 stock/external_stock 外仓商品页面
2026-07-09 03:33:51 +08:00
yin
6ea17d71ed 78 2026-07-08 18:11:22 +08:00
liufumingren
558fa53970 feat: 订单列表状态标签语义修正 & 分配快递号异步进度窗口
- 状态标签语义化: print_status 已打印, pick_status 已拣货, pack_status 已打包, storage_status 已分配
- 全局移除订单状态(status)列: pendingCloums/reviewColums/expectionColumns 及所有页面模板
- 新增 TaskProgressDialog 组件 + useTaskProgress 组合式函数
- 分配快递号改为异步任务模式: 提交后弹出进度窗口, 完成后自动关闭刷新列表
- allocateExpressCodeTaskProgress API 支持轮询任务进度
2026-07-08 01:27:29 +08:00
yin
342125bfd6 2 2026-07-07 18:24:04 +08:00
yin
4653c1c3b3 1 2026-07-07 18:23:32 +08:00
liufumingren
faea143906 1 2026-07-07 11:22:14 +08:00
yin
4dc2935ba5 76 2026-07-06 18:16:55 +08:00
liufumingren
57dd323679 1 2026-07-06 13:23:07 +08:00
yin
4db690ea50 74 2026-07-04 18:17:50 +08:00
liufumingren
06d49f83b9 1 2026-07-04 00:50:25 +08:00
liufumingren
806f53d1d6 1 2026-07-03 21:57:28 +08:00
yin
a9ba68e0fd 73 2026-07-03 18:26:57 +08:00
liufumingren
2fbe0c2f8e 1 2026-07-03 13:37:59 +08:00
yin
b7826027b9 73 2026-07-02 18:11:23 +08:00
yin
7558b61e33 71 2026-07-01 18:16:50 +08:00
yin
1d3e0c0f64 1 2026-06-30 18:19:51 +08:00
yin
57b95fb8bf 629 2026-06-29 18:15:32 +08:00
liufumingren
cde142f113 1 2026-06-29 03:40:57 +08:00
liufumingren
1146ed6c1d 1 2026-06-27 20:26:35 +08:00
yin
6e61f3a5be 1 2026-06-26 18:13:58 +08:00
liufumingren
af3c6ba6e6 新增一键虚拟入库 2026-06-26 17:14:40 +08:00
yin
d1c87cb752 626 2026-06-26 16:11:03 +08:00
liufumingren
55e06d51aa 1 2026-06-26 09:22:43 +08:00
yin
ce6ff6d406 1 2026-06-25 18:20:37 +08:00
yin
84daac9220 625 2026-06-25 18:12:26 +08:00
liufumingren
bf0eba0f3d 1 2026-06-25 02:01:35 +08:00
yin
32459a98ed 624 2026-06-24 18:14:36 +08:00
yin
2c0d0225f1 623 2026-06-23 18:24:16 +08:00
yin
d1eecae3b1 622 2026-06-22 18:15:09 +08:00
liufumingren
3b7f21dc7d 1 2026-06-22 08:51:12 +08:00
yin
dfea0c3164 621 2026-06-21 18:21:10 +08:00
liufumingren
8e0b5211e3 1 2026-06-19 16:11:03 +08:00
yin
cc7ce02a02 618 2026-06-18 18:35:20 +08:00
liufumingren
6dda813dc8 1 2026-06-18 02:33:10 +08:00
yin
699fc15a79 617 2026-06-17 18:42:40 +08:00
yin
ca20e218dd 616 2026-06-16 18:24:32 +08:00
liufumingren
54cf1b3d17 1 2026-06-16 08:58:37 +08:00
yin
dddb132893 615 2026-06-15 18:13:39 +08:00
liufumingren
a680b9e9b2 1 2026-06-15 09:10:53 +08:00
liufumingren
4c9636b1ee 1 2026-06-13 20:26:27 +08:00
yin
f7c0951737 613 2026-06-13 18:13:53 +08:00
liufumingren
5480033c3c 1 2026-06-13 09:52:12 +08:00
yin
323aa323fb 613 2026-06-12 18:17:13 +08:00
liufumingren
401a282186 1 2026-06-12 12:17:23 +08:00
yin
f8de12ab8b 611 2026-06-11 18:24:22 +08:00
liufumingren
8ccae95455 1 2026-06-11 09:38:02 +08:00
liufumingren
a641265cf9 1 2026-06-11 09:01:58 +08:00
liufumingren
2e68b59e60 1 2026-06-10 23:08:01 +08:00
yin
00f416d847 610 2026-06-10 18:18:57 +08:00
liufumingren
517bd83c76 1 2026-06-10 09:01:41 +08:00
yin
48718b521e 69 2026-06-09 18:14:40 +08:00
liufumingren
45923ec6cb 1 2026-06-09 14:18:51 +08:00
liufumingren
cf39d2380d 1 2026-06-09 14:12:18 +08:00
liufumingren
332ebac7b4 1 2026-06-09 00:00:50 +08:00
yin
9eb6eded6e 68 2026-06-08 18:20:47 +08:00
yin
a872bb2ac4 68 2026-06-08 18:20:12 +08:00
liufumingren
e042da850d 1 2026-06-08 08:57:27 +08:00
yin
50bf6ad735 67 2026-06-07 18:21:08 +08:00
liufumingren
b561cf3a77 1 2026-06-07 01:52:20 +08:00
liufumingren
faf5e76526 1 2026-06-06 22:59:50 +08:00
yin
b7054d2ca3 66 2026-06-06 18:16:24 +08:00
yin
c131d72b6f 65 2026-06-05 18:22:15 +08:00
liufumingren
1c055d2bfc 1 2026-06-05 02:11:05 +08:00
liufumingren
76687296b9 1 2026-06-05 02:05:56 +08:00
yin
6099c150df 642 2026-06-04 19:26:45 +08:00
yin
358acf3ff5 64 2026-06-04 15:49:53 +08:00
yin
dee64416c3 63 2026-06-03 18:18:52 +08:00
yin
55e7c46f05 62 2026-06-02 18:10:32 +08:00
liufumingren
7dde297f52 1 2026-06-02 09:16:01 +08:00
liufumingren
79a872dea7 1 2026-06-02 07:50:06 +08:00
yin
8e984512d1 61 2026-06-01 18:13:54 +08:00
liufumingren
3641af8694 1 2026-06-01 03:01:02 +08:00
yin
9d434f3be3 530 2026-05-30 18:17:25 +08:00
liufumingren
b0676bf140 1 2026-05-30 03:53:42 +08:00
yin
8a1cc63a09 529 2026-05-29 18:21:11 +08:00
liufumingren
1494b3b7dc 1 2026-05-29 05:37:47 +08:00
yin
21a21c44bb 528 2026-05-28 18:13:41 +08:00
liufumingren
0265323c09 1 2026-05-28 08:44:17 +08:00
yin
d86c65d0df 527 2026-05-27 18:14:43 +08:00
yin
d7d57446e0 526 2026-05-26 18:16:02 +08:00
liufumingren
e54e3e7745 1 2026-05-26 01:56:35 +08:00
yin
33756ce1fd 525 2026-05-25 18:14:47 +08:00
liufumingren
5547fc74b1 1 2026-05-25 08:57:20 +08:00
yin
cb70b96229 523 2026-05-23 18:15:21 +08:00
liufumingren
580893127b 快递接口页面固定 2026-05-23 00:53:54 +08:00
yin
02bf99d229 522 2026-05-22 16:36:55 +08:00
liufumingren
2c6c10b79c 修改快递接口配置,未完成 2026-05-22 08:38:20 +08:00
yin
8440c01b4d 521-2 2026-05-21 18:14:09 +08:00
liufumingren
6d2f39a4c9 521 2026-05-21 03:42:13 +08:00
yin
6a2abf37ff 520 2026-05-20 18:13:15 +08:00
liufumingren
0c3b83fb54 订单界面优化 2026-05-20 08:55:58 +08:00
yin
3531a7893d 5月19 2026-05-19 18:14:36 +08:00
yin
207a21e272 5月18 2026-05-18 18:13:38 +08:00
liufumingren
4afce2376d 收货和商品的优化 2026-05-18 01:44:07 +08:00
yin
baff37ad45 5月16 2026-05-16 18:13:28 +08:00
liufumingren
452634fba9 1 2026-05-16 02:45:24 +08:00
yin
349053e2ed 5月15 2026-05-15 18:22:48 +08:00
yin
c84f9c82a7 5月14 2026-05-14 18:16:24 +08:00
liufumingren
98ddaf83a7 1 2026-05-14 03:58:49 +08:00
yin
c2060e4d57 5月13 2026-05-13 18:14:13 +08:00
liufumingren
33a47dad2c 1 2026-05-13 09:12:25 +08:00
yin
2194cd9cca 5月12 2026-05-12 18:16:09 +08:00
liufumingren
53c0321e0d 1
Co-authored-by: Copilot <copilot@github.com>
2026-05-12 09:10:49 +08:00
yin
7f9ed5eb67 5月11 2026-05-11 18:13:14 +08:00
liufumingren
6f6281f500 散单策略列表增加是否显示下一波可以抓取的数量
Co-authored-by: Copilot <copilot@github.com>
2026-05-10 03:59:58 +08:00
yin
18e875ad56 5月9日 2026-05-09 18:18:05 +08:00
liufumingren
70ed7232ef 新页面
Co-authored-by: Copilot <copilot@github.com>
2026-05-09 09:49:03 +08:00
yin
abd7ab7013 5月8日 2026-05-08 18:15:30 +08:00
liufumingren
097846f385 小修改 2026-05-08 00:50:58 +08:00
yin
f2fb59d356 5月7日 2026-05-07 18:19:02 +08:00
liufumingren
91f5295b4f 删单抓取的一些小改动,记得拉取 2026-05-07 01:41:25 +08:00
yin
776bfb01fa 5月6日v2 2026-05-06 17:54:18 +08:00
yin
21afb90213 5月6-2 2026-05-06 17:53:45 +08:00
yin
e732e7fa9d 5月6日 2026-05-06 17:44:37 +08:00
liufumingren
fb118d96b6 1 2026-05-06 01:37:40 +08:00
yin
dba7bbc8d7 5月5日 2026-05-05 18:15:34 +08:00
yin
487a7a64f7 5月4日 2026-05-04 18:21:28 +08:00
liufumingren
b30cb15793 Merge branch 'main' of http://192.168.9.101:4000/liufumingren/WEB 2026-05-04 00:36:44 +08:00
yin
4323e78fa7 5月2日 2026-05-04 00:34:56 +08:00
yin
4269253dc3 5月2日 2026-05-02 18:25:16 +08:00
yin
f75ea53f9f 5月1日 2026-05-01 18:28:15 +08:00
liufumingren
ce0d10eb95 Merge branch 'main' of http://192.168.9.101:4000/liufumingren/WEB 2026-05-01 06:05:32 +08:00
liufumingren
e6ec226c9f Merge branch 'main' of http://192.168.9.101:4000/liufumingren/WEB 2026-05-01 06:05:27 +08:00
liufumingren
fb258dafae Merge branch 'main' of http://192.168.9.101:4000/liufumingren/WEB 2026-04-30 19:42:10 +08:00
liufumingren
b1b1f55e42 Merge branch 'main' of http://192.168.9.101:4000/liufumingren/WEB 2026-04-30 19:42:01 +08:00
liufumingren
8f669a3240 Merge branch 'main' of http://192.168.9.101:4000/liufumingren/WEB 2026-04-30 19:37:40 +08:00
liufumingren
77cf2ef1aa Merge branch 'main' of http://192.168.9.101:4000/liufumingren/WEB 2026-04-30 19:37:33 +08:00
liufumingren
dbe110e155 Merge branch 'main' of http://192.168.9.101:4000/liufumingren/WEB 2026-04-30 19:27:29 +08:00
yin
78333866b9 Merge branch 'main' of http://192.168.9.101:4000/liufumingren/WEB 2026-04-30 19:26:38 +08:00
yin
c246f364d6 Merge branch 'main' of http://192.168.9.101:4000/liufumingren/WEB 2026-04-30 19:19:26 +08:00
liufumingren
fcb1a982de feat(receiving): 新增批量审核、批量驳回功能及审核状态列 2026-04-30 19:17:17 +08:00
liufumingren
c32d6effb4 feat(receiving): 新增批量审核、批量驳回功能及审核状态列 2026-04-30 06:55:00 +08:00
liufumingren
42bf6c7bfa feat(warehouse): 批量修改弹窗、库位类型接口化、储位列表添加库位类型列 2026-04-29 17:35:25 +08:00
yin
d022634749 4月28 2026-04-28 18:22:32 +08:00
yin
ea900c810f 4月27 2026-04-27 17:54:29 +08:00
yin
6b0835d922 4月25 2026-04-27 16:07:03 +08:00
yin
7aac712b13 4月25 2026-04-25 17:58:47 +08:00
yin
a4a156101d 4月24 2026-04-24 18:24:42 +08:00
yin
94fcdd879e 4月23 2026-04-23 18:27:12 +08:00
yin
c2c19faa15 4月22 2026-04-22 19:54:18 +08:00
yin
7a428fbdf3 4月21 2026-04-21 18:35:09 +08:00
liufumingren
411df459f5 feat: 支持取消分配储位与状态展示 2026-04-20 23:52:22 +08:00
yin
67bd0bb7c5 4月19 2026-04-19 18:27:27 +08:00
yin
13b25e1d9c 4月18号2 2026-04-18 21:01:32 +08:00
yin
14b1476982 4月18 2026-04-18 20:52:27 +08:00
yin
f1dba6c6ab 4月17 2026-04-17 21:04:52 +08:00
yin
31c71bf68f 4月16 2026-04-16 20:59:44 +08:00
yin
c52355ad8c 4月15 2026-04-15 21:01:12 +08:00
yin
9712731d19 4月14日 2026-04-14 18:44:25 +08:00
yin
a97c7214dd 4月13 2026-04-13 21:38:47 +08:00
yin
309357bba7 4月11号 2026-04-11 18:36:18 +08:00
yin
59474b0394 4月10号 2026-04-10 18:17:39 +08:00
yin
69e6a26f03 4月9日 2026-04-09 18:53:43 +08:00
yin
3dbd7d43b1 4月8日 2026-04-09 09:01:20 +08:00
yin
af865de6fc 4月7日 2026-04-07 18:27:40 +08:00
yin
df0b693592 4月6日 2026-04-06 18:22:55 +08:00
yin
29a3f7701c 4月4日 2026-04-04 18:11:20 +08:00
yin
a237a8bdb0 4月3日 2026-04-03 18:22:18 +08:00
yin
1ed76337c9 4月2日 2026-04-02 18:21:21 +08:00
yin
43649f696e 4月1日更新 2026-04-01 18:25:16 +08:00
yin
28fae29f89 3月31日更新 2026-03-31 17:57:27 +08:00
yin
884cee76e7 3月30 2026-03-31 09:15:36 +08:00
yin
6b2c2f9f16 3月28日更新 2026-03-28 17:55:54 +08:00
yin
b183c7fcb0 3月27日更新 2026-03-27 17:57:54 +08:00
yin
24e4114c6c 3月26日更新 2026-03-26 18:23:54 +08:00
yin
b105e7f72b 3月25号更新 2026-03-25 18:17:54 +08:00
yin
868c43be9f 3月24日更新 2026-03-24 18:26:53 +08:00
yin
0070f15944 3月23日更新 2026-03-23 18:39:46 +08:00
yin
2054018dda 3月21 2026-03-21 18:19:55 +08:00
yin
cbced86a1d 3月20号更新 2026-03-20 18:18:53 +08:00
yin
864ca910eb 19号更新 2026-03-20 09:03:44 +08:00
yin
e1cbf289ed 18号的更新 2026-03-18 17:47:43 +08:00
yin
4f5d788fbd 更新代码 2026-03-18 17:47:15 +08:00
762 changed files with 279955 additions and 11438 deletions

View File

@ -4,5 +4,21 @@ VITE_USER_NODE_ENV = development
# base api
VITE_APP_BASE_API = 'http://192.168.11.56:6060/'
# file server (export download)
VITE_FILE_SERVER_BASE = 'https://ye4s.file.gzxunren.com'
VITE_APP_IM_WS_URL=wss://your-im-server.com/ws
VITE_APP_IM_API_URL=https://your-im-server.com/api
# frontConfig.getByDomain 品牌豁免域名(逗号分隔,可多个;留空=不豁免,便于本地调试品牌配置)
# 注意:主域名被豁免后访问主域名将不拉取品牌(显示默认「天豹云仓」);要在 localhost 验证品牌标题请勿把 localhost 加入豁免
VITE_FRONT_CONFIG_EXEMPT_HOSTS = 'wms.wms.gztbyc.com,127.0.0.1'
# 本地开发:浏览器直传对象存储(COS)跨域(CORS)绕过开关
# 存储桶 CORS 白名单不含开发机域名时,直传会被浏览器拦截(文件其实已上传,但响应读不到)。
# 开启后前端把直传地址改写成同源 /cos-proxy/...,由 vite dev server 转发(仅 dev 生效)
# 取值:off = 关闭(改回直传,可用于验证存储桶 CORS 是否已配好);其它/不配置 = 开启
VITE_COS_DEV_PROXY = 'on'
# /cos-proxy 代理目标存储桶,必须与后端 index.getCOSUploadConfig 返回的 uploadUrl 主机一致
VITE_COS_DEV_PROXY_TARGET = 'https://ye4s-1255377868.cos.ap-guangzhou.myqcloud.com'

View File

@ -2,7 +2,13 @@
VITE_USER_NODE_ENV = production
# base api
VITE_APP_BASE_API = 'http://qimen.wms.gztbyc.com/'
VITE_APP_BASE_API = 'https://qimen.wms.gztbyc.com/'
# file server (export download)
VITE_FILE_SERVER_BASE = 'https://ye4s.file.gzxunren.com'
VITE_APP_IM_WS_URL=wss://your-im-server.com/ws
VITE_APP_IM_API_URL=https://your-im-server.com/api
# frontConfig.getByDomain 品牌豁免域名(逗号分隔,可多个;主域名不拉取/不使用品牌配置)
VITE_FRONT_CONFIG_EXEMPT_HOSTS = 'wms.wms.gztbyc.com'

View File

@ -3,3 +3,6 @@ VITE_USER_NODE_ENV = production
# base api
VITE_APP_BASE_API = '/stage-api'
# file server (export download)
VITE_FILE_SERVER_BASE = 'https://ye4s.file.gzxunren.com'

13
.gitignore vendored
View File

@ -11,9 +11,13 @@ node_modules
.DS_Store
dist
dist-ssr
dist.tar.gz
coverage
*.local
# 部署配置(含服务器/密钥信息,不纳入版本控制)
/scripts/deploy.config.json
# Editor directories and files
.vscode/*
!.vscode/extensions.json
@ -37,3 +41,12 @@ __screenshots__/
# Vite
*.timestamp-*-*.mjs
# Workflows (local tooling, not tracked)
/workflows/
# 本地离线二维码工具(独立小工具,不入库)
/batchQrcode/
# 死代码扫描产物(本地产物,不入库)
/unused-report.json

6
.prettierignore Normal file
View File

@ -0,0 +1,6 @@
dist
node_modules
.vite
coverage
package-lock.json
workflows/api-doc-sync/data/history

7
.prettierrc.json Normal file
View File

@ -0,0 +1,7 @@
{
"semi": true,
"singleQuote": false,
"printWidth": 100,
"tabWidth": 2,
"trailingComma": "all"
}

161
.tmp-def-form.txt Normal file
View File

@ -0,0 +1,161 @@
<template>
<el-dialog
:model-value="visible"
class="definition-form-dialog"
width="min(680px, 94vw)"
align-center
destroy-on-close
:close-on-click-modal="false"
append-to-body
:show-close="false"
@closed="handleClosed"
>
<div class="task-panel">
<header class="task-panel__head">
<div class="task-panel__titles">
<h2>{{ isEdit ? '编辑报表定义' : '新增报表定义' }}</h2>
<p>
{{ isEdit
? '报表类型不可修改,可调整名称、勾选字段与导出文件名'
: '选择报表类型后勾选字段,字段顺序即导出表格的列顺序' }}
</p>
</div>
<button class="task-panel__close" type="button" aria-label="关闭" @click="handleClosed">
<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="task-panel__body">
<el-form ref="formRef" :model="form" :rules="rules" class="task-panel__form">
<div class="task-panel__field task-panel__field--input">
<span class="task-panel__field-label is-required">报表名称</span>
<el-form-item prop="name">
<el-input v-model="form.name" placeholder="请输入报表名称(≤100 字符)" maxlength="100" />
</el-form-item>
</div>
<div class="task-panel__field task-panel__field--input">
<span class="task-panel__field-label is-required">报表类型</span>
<el-form-item prop="type">
<el-select
v-model="form.type"
:disabled="isEdit"
placeholder="请选择报表类型"
style="width: 100%"
@change="handleTypeChange"
>
<el-option
v-for="opt in typeOptions"
:key="opt.value"
:label="opt.label"
:value="opt.value"
/>
</el-select>
</el-form-item>
</div>
<div class="task-panel__field task-panel__field--input">
<span class="task-panel__field-label">导出文件名</span>
<el-form-item prop="file_name">
<el-input
v-model="form.file_name"
placeholder="导出文件名模板,支持 {date}/{time}/{datetime}/{timestamp} 占位(≤200 字符)"
maxlength="200"
/>
</el-form-item>
</div>
<div class="task-panel__field task-panel__field--input">
<span class="task-panel__field-label">勾选字段</span>
<el-form-item prop="fields">
<div class="field-picker">
<el-checkbox-group v-model="form.fields" class="field-checkbox-group">
<el-checkbox
v-for="f in currentTypeFields"
:key="f.key"
:label="f.key"
>
{{ f.label }}
<span v-if="f.computed" class="field-computed">(预计算)</span>
<span v-else-if="f.asText" class="field-astext">(文本)</span>
<span v-if="f.children?.length" class="field-array">(含子字段 {{ f.children.length }} 项)</span>
</el-checkbox>
</el-checkbox-group>
<div v-if="!currentTypeFields.length" class="field-empty">
{{ isEdit ? '未找到该类型的字段清单' : '请先选择报表类型' }}
</div>
<div v-if="form.fields.length" class="field-order">
<div class="field-order__title">
字段顺序(自上而下即导出表格列顺序)
<span class="field-order__tip">已选 {{ form.fields.length }} 项,可拖动手柄或使用按钮调整</span>
</div>
<div ref="orderListRef" class="field-order__list">
<div
v-for="(key, idx) in form.fields"
:key="key"
class="field-order__item"
>
<el-icon class="field-order__drag" :size="14"><Rank /></el-icon>
<span class="field-order__idx">{{ idx + 1 }}</span>
<span class="field-order__label" :title="key">{{ fieldLabel(key) }}</span>
<span class="field-order__key">{{ key }}</span>
<span class="field-order__actions">
<el-button link size="small" :disabled="idx === 0" @click="moveField(idx, -1)">
上移
</el-button>
<el-button link size="small" :disabled="idx === form.fields.length - 1" @click="moveField(idx, 1)">
下移
</el-button>
</span>
</div>
</div>
</div>
</div>
</el-form-item>
</div>
<div class="task-panel__field task-panel__field--control">
<span class="task-panel__field-label">启用状态</span>
<div class="task-panel__field-control">
<el-form-item prop="is_enabled">
<el-switch v-model="form.is_enabled" :active-value="1" :inactive-value="0" />
</el-form-item>
</div>
</div>
<div class="task-panel__field task-panel__field--input task-panel__field--textarea">
<span class="task-panel__field-label">备注</span>
<el-form-item prop="remark">
<el-input
v-model="form.remark"
type="textarea"
:rows="2"
resize="none"
maxlength="500"
placeholder="最长 500 字符"
/>
</el-form-item>
</div>
</el-form>
<!-- 提示条:对齐「手工录入运单号」的 .task-panel__form-tip -->
<p class="task-panel__form-tip">
<template v-if="isEdit">报表类型一经创建不可更改;</template>
导出文件名支持 {date} 数据日期、{time} 生成时刻 HHmmss、{datetime} 数据日期_生成时刻、{timestamp} 毫秒时间戳;勾选字段的顺序即导出表格的列顺序。
</p>
</div>
<footer class="task-panel__foot">
<span class="task-panel__hint">提交前请确认报表类型与勾选字段无误</span>
<div class="task-panel__actions">
<el-button size="small" @click="handleClosed">取消</el-button>
<el-button size="small" type="primary" :loading="submitting" @click="handleSubmit">确认</el-button>
</div>
</footer>
</div>
</el-dialog>
</template>

66
.tmp-stock-doc.json Normal file
View File

@ -0,0 +1,66 @@
{
"stock.warehouse.list": {
"method": "stock.warehouse.list",
"title": "仓库商品列表查询(支持 where 条件与分页)",
"description": "仓库商品列表查询(支持 where 条件与分页)",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "pagination",
"type": "object",
"required": false,
"description": "pagination 参数"
},
{
"name": "where",
"type": "object",
"required": false,
"description": "统一 where 条件对象;推荐使用 { operator, value, type } 标准结构,历史简写会在 main 中自动标准化;支持 quickWhere、barcode、prohibited_type、has_bound_item 等商品筛选字段。示例:where.barcode={operator:like,value:69}; where.prohibited_type={operator:eq,value:liquid}; where.has_bound_item={operator:eq,value:true}(已绑定外部商品)/ where.has_bound_item={operator:eq,value:false}(未绑定外部商品)。"
}
],
"response": []
},
"stock.warehouse.getInfo": {
"method": "stock.warehouse.getInfo",
"title": "查询仓库商品详情",
"description": "查询仓库商品详情",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [],
"response": [
{
"name": "need_recheck",
"type": "string",
"required": true,
"description": "是否需要复核:Y=需要复核,N=不需要复核"
}
]
}
}

View File

@ -0,0 +1,8 @@
{
"user": "webdev",
"ip": "112.124.21.102",
"basePath": "/www/wwwroot/web",
"keepReleases": 5,
"siteHost": "wms.wms.gztbyc.com",
"sshKey": "C:\\Users\\Administrator\\.ssh\\id_ed25519"
}

View File

@ -0,0 +1,401 @@
# UpperTable 大列表滚动性能优化方案
> 状态:方案①②⑥⑦⑧⑨已实施(2026-08-29);双模式默认"开销优先";
> ⚠️ 关键发现:el-table `:data` 变化硬成本 ~300ms,performance 模式已改"冻结+快速更新"(滚动流畅);
> 根治"实时跟随+流畅"需 el-table-v2 / transform(待评估)
> 日期:2026-08-28(创建)/ 2026-08-29(更新)
> **用户决策(2026-08-29)**:双模式可切换——"性能优先"提升资源开销换取使用性能;"开销优先"减少资源开销保证基础体验;在"字段设置"中切换。**默认模式 = 开销优先**。
> 组件:`src/components/UpperTable/index.vue`
> 涉及页面:订单管理、波次管理(waveOrder)等所有使用 UpperTable 的大数据列表
---
## 1. 背景与问题
列表在展示大量数据(如每页 200~500 条)时,**滚动查看存在明显视觉卡顿**,用户反馈"用起来不舒服"。
**关键现象**:任务管理器 / 性能面板显示 **CPU 与内存占用并不高**,但滚动时画面明显掉帧、卡顿。这说明问题**不在 JS 计算密集度,而在渲染管线与组件渲染规模**,需要针对"滚动时主线程被长任务阻塞"这一根因定位。
## 2. 现状分析
### 2.1 UpperTable 已具备的能力
| 能力 | 说明 |
|---|---|
| 行级虚拟滚动 | `virtualThreshold=80` 时启用,仅渲染可视窗口行 + 缓冲行(`virtualBufferRows=12`),上下用 spacer 行撑高 |
| 滚动驱动 | 监听 `.el-scrollbar__wrap` 的 scroll 事件(rAF 节流),更新 `virtualScrollTop` 后重算渲染窗口 |
| 列配置 | `enableColumnConfig` + `tableId` 支持用户自定义列显示/排序/固定,配置存 localStorage |
| 服务端分页 | 各页面通过 `pagination` 驱动,pageSize 可到 200/500 |
### 2.2 虚拟滚动实现方式(关键)
当前为 **"spacer 撑高 + 窗口替换"** 模式:
```
tableRenderData = [顶部spacer(高=startIndex*行高)] + [可视窗口行] + [底部spacer]
```
- 行高按 `tableSize` **硬编码假设**:large=49 / default=41 / small=33
- 滚动时通过**替换渲染的行集合**来更新可视窗口
- 无 transform 位移跟随、无 `will-change` / `contain` 合成层优化
### 2.3 各页面使用情况(以实测页面为例)
- **订单管理 - 待处理订单**:35 列,每页最多 500 条
- **波次管理 - 团购波次**:22 列 + 左/右固定列(波次号 left、操作 right)+ 选择列
## 3. 实测诊断数据(DevTools 实测,待处理订单页)
### 3.1 表格规模与组件数量
| 指标 | 值 |
|---|---|
| 总列数 | 35 |
| 总数据量 | 约 515 行(滚动高度 17016px ÷ 33px 行高)|
| 虚拟滚动渲染行数 | 43 行(可视 ~19 + 缓冲 24)——**虚拟滚动正常生效** |
| 单元格总数 | 43 × 35 = **1505 个** |
| **el-tag 组件** | **440 个**(同步/复核/储位/快递/打印/拣货/打包/拦截/锁定 等状态列)|
| **el-tooltip 组件** | **1540 个**(`show-overflow-tooltip` 对全列默认开启)|
| 固定列 | 无(此页)|
### 3.2 滚动性能实测
| 测试 | 平均耗时 | 最大耗时 |
|---|---|---|
| 单步滚动 20px(**不跨行**,窗口不变)| **141ms** | 304ms |
| 单步滚动 100px(跨行)| **144ms** | 253ms |
> 帧预算为 16.7ms,实测每次滚动卡 141~860ms,是帧预算的 **8~50 倍**。
### 3.3 长任务分析(决定性证据)
1.5 秒连续滚动,`PerformanceObserver` 捕获 longtask:
```
7 个长任务,总阻塞 2785ms,单个最长 862ms(全部为 self 页面脚本)
```
### 3.4 结论:根因不是 paint,而是 JS 组件树过重
| 证据 | 指向 |
|---|---|
| 长任务全部为 `self` 脚本,且高达 862ms | JS 逻辑/组件渲染,**非** paint/composite |
| **不跨行滚动(20px)同样卡 141ms** | 卡顿不来自虚拟滚动"窗口替换",而来自 el-table 每次滚动都要驱动大量组件更新 |
| 虚拟滚动已将行数降至 43,但仍卡 | 每行 35 列 × 每列 tooltip + 状态列 tag = **43 行也要 diff 1505 单元格 / 约 1980 个组件** |
**为什么 CPU 不高却卡**:不是持续高占用,而是**滚动瞬间的渲染尖峰**(700ms+ 长任务阻塞主线程 → 掉帧)。CPU 平均占用不高,但瞬时峰值阻塞了渲染。
## 4. 根因排序
| 优先级 | 根因 | 影响 |
|---|---|---|
| ★★★ | `show-overflow-tooltip` 全列默认开启 → **每单元格一个 el-tooltip 组件(1540 个)** | 组件树最大头,滚动时 diff 成本极高 |
| ★★★ | 状态列大量使用 `el-tag`(440 个)| 第二大组件源 |
| ★★☆ | 列数过多(订单管理 35 列)| 线性放大所有成本 |
| ★★☆ | 虚拟滚动"窗口替换"式重渲染(无 transform 位移)| 滚动跨行时整块重渲染 |
| ★☆☆ | 行高硬编码假设,可能与实际不符(如操作列按钮换行)| 内容跳变/错位 |
| ★☆☆ | 固定列复制表(waveOrder 页)| paint 面积放大,属次要叠加 |
## 5. 优化方案(按收益/成本排序)
### 方案 ①:收窄 `show-overflow-tooltip`(P0,最优先)
**目标**:把 1540 个 tooltip 组件降为几十个。
**做法**:
- `UpperTable` 默认值从"全列开启"改为"默认关闭,仅按需开启"
- 在 `UpperTable/index.vue` 中调整 `:show-overflow-tooltip` 的默认判定
- 各页面列配置只对**需要看全内容的列**显式开启(如订单号、物流单号、买家留言、商品快照等)
**预期收益**:组件树规模降一个量级,滚动重渲染成本显著下降。这是**成本最低、收益最大**的一步。
**改动范围**:
- `src/components/UpperTable/index.vue`(默认值逻辑)
- 各页面 `columns` 配置(订单管理、波次管理等,按需显式开启)
### 方案 ②:状态列 `el-tag` → 纯文本 + CSS 颜色(P0)
**目标**:把 440 个 el-tag 组件降为文本节点。
**做法**:
- 状态列(同步/复核/储位/快递/打印/拣货/打包/拦截/锁定 等)由 `<el-tag>` 改为 `<span>` + 状态色 class
- 保留视觉区分(颜色圆点/着色文字),不损失可读性
**预期收益**:440 个组件 → 0,进一步降低组件树。
**注意**:涉及多个页面模板,改动面较广,需逐页确认状态色映射。
### 方案 ③:虚拟滚动改造为 transform 位移模式(P1)
**目标**:减少"窗口替换"式整块重渲染,滚动更平滑。
**做法**(业界标准做法,react-window / vue-virtual-scroller 原理):
- 保持固定行窗口,用 `transform: translateY(offset)` 让内容连续跟随滚动条
- 仅在越过行边界时替换窗口,并用 transform 补平偏移,消除跳变
- 可选加 `will-change: transform` / `contain` 合成层优化
**预期收益**:滚动跨行时不再整块重渲染;配合 ①② 后接近原生滚动体验。
**风险**:改动 `UpperTable` 内部核心,需回归测试列配置/选择/拖拽等功能。
### 方案 ④:默认列数收敛(P1)
**目标**:减少列数 = 线性减少组件与重渲染成本。
**做法**:利用现有"字段设置"能力,把 35 列的大表**默认只显示核心列**,用户按需自行开启更多列。
**预期收益**:不改变功能,但显著降低默认渲染成本。
### 方案 ⑤:长期评估 `el-table-v2`(P2)
**做法**:Element Plus 官方虚拟表格,自带高效渲染与固定列支持;逐步替换 `UpperTable` 内部实现。
**成本**:高(需适配列配置/选择/拖拽等既有能力),仅在前述方案仍不足时考虑。
## 6. 实施建议与验证
### 6.1 建议顺序
```
第一步:方案①(收窄 tooltip)—— ✅ 已完成(2026-08-29)
第二步:方案②(el-tag 文本化)—— ✅ 已完成(2026-08-29)
↓ 复测:滚动长任务从 862ms 降到 ~500ms;单步滚动从 141ms 降到 45~77ms
第三步:方案⑥⑦(向上滚动真空期优化,见第 9 章)—— 待实施
第四步:方案③(transform 位移虚拟化)—— 评估后实施
第五步:方案④(默认列收敛,可随时做)
```
### 6.2 验证方法(DevTools)
1. Performance 面板录制滚动过程
2. 查看 `PerformanceObserver` 的 longtask:**目标是滚动时无 >50ms 长任务**
3. 单步滚动耗时:**目标从 141ms 降到 <30ms**
4. 配合 `Rendering → Paint Flashing` 确认 paint 范围(waveOrder 固定列页)
### 6.3 复测工具(可在浏览器 Console 执行)
```js
// 长任务监控
const longtasks = [];
const obs = new PerformanceObserver(list => {
for (const e of list.getEntries()) longtasks.push(Math.round(e.duration));
});
obs.observe({ entryTypes: ['longtask'] });
// 滚动 1.5s 后查看
// obs.disconnect(); console.log(longtasks);
```
## 7. 风险与注意事项
1. **tooltip 收窄的影响**:`show-overflow-tooltip` 关闭后,超长内容不再自动显示 tooltip 提示。需对关键列(订单号/留言/商品快照等)显式保留,避免信息不可见。
2. **el-tag 文本化**:需保持状态色的可读性,避免用户混淆。
3. **虚拟滚动改造**(方案③)影响面大,必须回归:
- 行选择/全选、行点击高亮
- 列配置(拖拽排序、固定、显示/隐藏)
- 复制按钮、二维码、tooltip 交互
- 分页切换、数据刷新后的滚动位置
4. **行高**:方案③ 之前建议先锁定行高(操作按钮禁止换行、单元格单行),否则 transform 位移会错位。
5. **waveOrder 固定列页**:固定列复制表是独立 paint 层,若 ①② 之后仍有卡顿,再单独评估减少固定列或 content-visibility。
## 8. 参考资料
- 组件:`src/components/UpperTable/index.vue`
- 页面示例:`src/views/order/orderManagement/`、`src/views/order/waveOrder/`
- 列配置示例:`src/views/order/waveOrder/config/wave-config.ts`
---
## 9. 向上滚动渲染"真空期"(2026-08-29 新发现)
### 9.1 现象
方案①②实施后,**向下滚动明显改善**,但**向上滚动查看上方数据时,可视区域出现明显的渲染"真空期"**:滚动位置已经移动,但表格内容迟迟未渲染到位,出现数百毫秒的空白/错位,体验不佳。
### 9.2 实测数据
在待处理订单页(500 条/页,虚拟滚动)快速向上滚动 7000px(scrollTop 8000 → 1000):
| 指标 | 值 |
|---|---|
| 滚动位置到达目标时刻 | T+0 |
| 数据行(43 行窗口)首次更新时刻 | **T+632ms** |
| 真空期时长 | **约 632ms** |
> 即:滚动条已到目标位置,但可视区的行内容要再等约 **632ms** 才渲染出来。这 632ms 内可视区显示的是旧窗口内容(与滚动位置严重错位)或空白。
### 9.3 根因分析(结合代码)
当前虚拟滚动是 **"spacer 撑高 + 窗口替换"** 模式,向上滚动时真空期由三个因素叠加:
1. **窗口更新链路过长(主因)**
滚动位置变化 → scroll 事件 → rAF 节流 `handleBodyScroll` → 更新 `virtualScrollTop` → computed 重算 `virtualStartIndex` → `tableRenderData` 变化 → Vue 异步渲染新窗口。整条链路每步都要在**事件循环 + 渲染循环**中排队,累积延迟可达数百 ms。
2. **整块窗口替换的渲染耗时**
窗口变化时,新进入可视区的行需创建 DOM(43 行 × 35 列 ≈ 1505 单元格,含 tooltip)。即使方案①②已大幅降组件,创建这些 DOM 仍需数十~上百 ms,期间可视区内容缺失。
3. **滚动条连续 vs 窗口步进的不匹配**
原生滚动位置是连续的,但虚拟窗口按**整数行**切换。窗口切换瞬间,顶部 spacer 高度与行内容**同时跳变**,若渲染未同步完成,就会出现内容与滚动位置错位的"真空期"。向上滚动时(从大 startIndex 往小跳),新增行在顶部,视觉上更明显。
4. **buffer 对称且偏小(放大因素)**
`virtualBufferRows = 12` 上下对称。快速向上滚动一次超过 12 行时,顶部新行不在 buffer 内,必须即时创建 → 真空期更明显。
### 9.4 优化方案(按收益/成本排序)
#### 方案 ⑥:方向感知 + 增大 buffer(P0,低成本)—— ✅ 已实施(2026-08-29)
**目标**:让新进入可视区的行提前存在(预渲染),减少"即时创建"带来的真空期。
**做法(已落地)**:
- `virtualBufferRows` 默认 12 → **16**
- 新增 `scrollDirection`(up/down)在 `handleBodyScroll` 中检测滚动方向
- **方向感知 buffer**:当前滚动方向一侧 buffer ×2(向上滚动时 topBuffer=32 / bottom=16,反之亦然)
**实测结果**:
| 指标 | 方案⑥前 | 方案⑥后 |
|---|---|---|
| 渲染行数 | 43 | 59 |
| 向上滚 7000px 真空期 | 632ms | **469ms(-26%)** |
| 向上滚 1000px | — | 474ms |
| 向上滚 300px(9 行) | — | 433ms |
**关键发现**:即使**小距离滚动(9 行,在 buffer 内)真空期仍 ~433ms**。说明根本瓶颈不是"新行即时创建",而是**每次滚动(无论大小)都触发全窗口(59 行 × 35 列)的 Vue 重渲染**——buffer 预渲染只减少了"新行创建",未解决"每次滚动全窗口 diff"的固有开销。
**结论**:方案⑥改善有限(-26%),需配合方案⑦(调度优化)或③/⑤(根治)才能彻底消除真空期。
#### 方案 ⑦:窗口更新调度优化(P1)—— ⑦A 已实施(2026-08-29)
**目标**:缩短"滚动位置变化 → 窗口更新"的链路延迟。
**⑦A(已实施,但体验权衡不佳 → 拟回退/调整)**
- `handleBodyScroll` 中滚动过程**冻结 `virtualScrollTop`**(不触发全窗口重渲染),仅更新方向与视口高度
- 停止滚动 **120ms** 后(debounce `scrollSettleTimer`)一次性更新窗口
**⑦A 实测(单步滚动 median)**:
| 单步滚动 | 方案⑥后 | 方案⑦A 后 |
|---|---|---|
| 20px(不跨行) | 74ms | **19ms** |
| 100px(跨行) | 45ms | **6ms(-87%)** |
- 滚动中虚拟窗口冻结验证:连续滚动 1.2s,tbody childList 仅变化 3 次(之前每帧变)
- **体验权衡(❌ 不满足用户决策)**:
- 滚动中**内容不跟随滚动位置**(停滞/错位),缓慢滚动逐行查看体验差
- 停止滚动后约 **400ms** 内容才更新到位——真空期从"滚动中"挪到"停止后"
- 换来的是滚动中流畅(6ms),但这牺牲了"内容实时跟随"
- **结论**:按"可接受性能开销换体验"的决策,**⑦A 的冻结策略不再推荐**,应回退或改造为"内容实时跟随"(见 ⑨ / ③)。
**⑦B(推荐方向):滚动中每帧最多同步一次窗口**
- 回退⑦A 冻结,恢复"滚动中每帧(rAF 节流)同步窗口",内容实时跟随滚动位置
- **关键**:单次渲染必须够快(否则滚动中卡)→ 必须配合方案⑧(降低单次渲染成本)与方案⑥(buffer 预渲染)
- 代价:渲染频率回到每帧,但通过 ⑧ 让单次渲染从 400ms 降到可接受范围
#### 方案 ③(复用):transform 位移虚拟化(P1,根治,高风险)
**目标**:彻底消除"窗口切换真空期"。
**做法**:固定行窗口 + `transform: translateY(offset)` 让内容**连续跟随**滚动条;滚动时仅 GPU 合成,不重建 DOM;越过行边界时**复用**已有行(首尾追加/移除),而非整块替换。
**风险**:`el-table` 是原生 `<table>` 布局,transform 与原生滚动、固定列、行高计算冲突,需大量回归。若评估后不可行,则转向方案⑤(el-table-v2)作为根治手段。
#### 方案 ⑧:继续压渲染耗时(P1,辅助)—— ✅ 已实施(2026-08-29)
**做法(已落地)**:
- **① formatter 结果按行缓存**:`UpperTable` 新增 `formatterCache = WeakMap<row, Map<prop, string>>` + `getFormattedCell(row, column, value, index)`,模板 `v-html` 改用它;行对象生命周期自动回收、数据刷新自动失效,滚动窗口切换不重复计算
- **② 关闭序号 / 货主列多余 tooltip**:`orderWaveIndexColumn`、`orderStoreRemarkColumn` 移除 `showOverflowTooltip`
- **③(未做,可选项)**:关键列之外 el-tooltip 改用 `title` 原生属性降级——改动复杂、收益不确定,暂缓
**实测(performance 模式,renderRows=67)**:
| 单步滚动 | 方案⑨(performance) | 方案⑧后 |
|---|---|---|
| 20px(不跨行)median | 严重卡(1.2s 滚 3 步) | **11ms** |
| 100px(跨行)median | 严重卡 | **60ms** |
- 对比方案⑨时"1.2s 滚 3 步(~400ms/步)"大幅改善
- **残留**:performance 跨行渲染仍 ~60ms(67 行 × 35 列 DOM 成本);noCross 偶发 1s 长任务(滚动方向切换时 buffer 对调触发大重渲染)
- **可继续**:压剩余 248 个 tooltip、或降低 performance buffer(16→12)、或方案③ transform
#### 方案 ⑨:双工作模式(性能优先 / 开销优先,P0)—— ✅ 已实施(2026-08-29,默认"开销优先")
**目标**:将"性能开销 vs 使用体验"的取舍做成**用户可切换的双模式**,兼顾不同设备与场景需求。用户可在"字段设置"中切换表格工作模式。
**背景**:⑦A(冻结省资源但内容不跟随)与 ⑦B+⑧(内容实时跟随但开销大)是互斥取舍。与其二选一,不如**做成两种可切换模式**,把选择权交给用户。
**两个模式定义**:
| 维度 | 性能优先模式 | 开销优先模式(默认) |
|---|---|---|
| 目标 | 滚动体验最佳、**停止后快速到位、真空期小** | 资源开销最小、保证基础体验 |
| 适用场景 | 高性能设备 / 大数据量 | 低性能设备 / 资源紧张 |
| buffer(方案⑥) | 大(base=12,**对称**,避免方向切换突变) | 小(base=8,方向侧 ×2 省资源) |
| 渲染行数 | ~34 行(预渲染较充分) | ~34 行 |
| 滚动调度(方案⑦) | **滚动中冻结 + 停止后 60ms 更新**(流畅) | 滚动中冻结 + 停止后 120ms 更新(省资源) |
| 内容实时跟随 | ❌(el-table 限制,见下方关键发现) | ❌ |
| 停止后到位 | ~350ms(快速) | ~420ms |
| 资源开销 | 高 | 低 |
| 可选增强 | 方案③ transform / ⑤ el-table-v2(根治实时跟随) | — |
**切换入口**:字段设置弹窗新增"**表格工作模式**"选择器(两个单选:性能优先 / 开销优先),并存 localStorage。
**实现要点(已落地)**:
1. `UpperTable` 新增 `tableMode` prop:`'performance' | 'resource'`,**默认 `'resource'`(开销优先)**
2. `activeTableMode` ref 优先读 localStorage,兜底 prop;onMounted `initTableMode` 初始化
3. 模式驱动:
- `effectiveBufferRows`:performance = 12(**对称**,避免方向切换突变);resource = 8(方向 ×2 省资源)
- 滚动调度(统一冻结):滚动中冻结窗口,停止后统一更新;**debounce:performance=60ms / resource=120ms**
4. 模式存 localStorage,key `upper_table_mode_${userId}_${roleId}`(全局)
5. 字段设置弹窗 toolbar 新增"表格工作模式" radio-group(性能优先 / 开销优先),切换时 `handleTableModeChange` 持久化 + 重置虚拟滚动状态
**⚠️ 关键技术发现:el-table `:data` 变化是硬成本 ~300ms**
实测:单次窗口同步(el-table `:data` 数组替换)耗时 **273~358ms(稳定 ~300ms)**,且与 tooltip 数量、buffer 大小、节流频率**无关**(均已验证无效)。这是 el-table 对 data 变化的**全量重算**所致。
**结论**:在 el-table 上,"滚动中实时同步窗口(内容实时跟随)"与"滚动流畅"**不可兼得**。因此 **performance 模式放弃"实时跟随(⑦B)",改为"滚动中冻结 + 停止后快速更新"**(与 resource 同机制,但 debounce 更短、buffer 更大)。
**实测验证(待处理订单 500 条/页)**:
| 指标 | 优化前(实时同步) | 优化后(冻结+快速更新) |
|---|---|---|
| 1.5s 连续滚动 steps | 5(每步 ~300ms,卡) | **29(流畅)** |
| 长任务总数 | 6~10 | **4** |
| 总阻塞 | ~2000ms | **726ms** |
| 渲染行数 | 67 | 34 |
| 停止后到位 | ~400ms | **~350ms(performance)/ ~420ms(resource)** |
**根治"实时跟随 + 流畅"**:需方案⑤ `el-table-v2`(官方高效虚拟表格,内部窗口管理不依赖 el-table data 全量重算)或方案③ transform 位移(在 el-table 上 hack,高风险)。两者均需重写/改造虚拟滚动部分,待评估。
**预期收益**:
- 性能优先:滚动中内容实时跟随、无真空期、体验最佳(开销大)
- 开销优先:资源占用低、滚动流畅(但内容冻结、停止后更新)
- 用户按设备/场景自选,兼顾两端
### 9.5 建议实施顺序(双模式:性能优先 / 开销优先)
```
第一步:方案⑥(方向感知 + 增大 buffer)—— ✅ 已完成:真空期 632→469ms(-26%)
第二步:方案⑦A(滚动停止后统一更新)—— ✅ 已实施:作为"开销优先"模式的调度基础
第三步:抽象双模式(方案⑨)—— ✅ 已完成:tableMode prop(默认 resource)+ 字段设置切换 + 存储
第四步:方案⑧(压渲染耗时)—— ✅ 已完成:formatter 按行缓存 + 关闭序号/货主 tooltip;
performance 模式单步 20px→11ms / 100px→60ms(之前 ~400ms)
第五步:字段设置 UI 切换控件 —— ✅ 已完成(随方案⑨)
第六步:复测两模式—— ⏳ 待做:性能优先(内容实时跟随+单步<30ms)
第七步:方案③ transform 位移(或⑤ el-table-v2)—— 性能优先模式的终极增强,评估后做
```
### 9.6 真空期复测方法(浏览器 Console)
```js
// 向上滚动后检测数据行更新延迟
const wrap = document.querySelector('.el-table__body-wrapper .el-scrollbar__wrap');
const tbody = document.querySelector('.el-table__body-wrapper tbody');
const mo = new MutationObserver(() => { /* 记录行数变化时刻 */ });
mo.observe(tbody, { childList: true, subtree: true });
wrap.scrollTop = 8000;
await new Promise(r => setTimeout(r, 600));
const t0 = performance.now();
wrap.scrollTop = 1000; // 快速向上滚
// 等待首个数据行更新事件,计算与 t0 的差值即真空期
```
> 目标:真空期从当前 **632ms** 降到 **<100ms**。

View File

@ -0,0 +1,183 @@
# 摄像头本地流服务接口文档
> 服务地址:`http://localhost:17311`(主端口,备用端口依次为 `17312`、`17313`)
> 服务职责:代理前端与海康威视录像机(NVR)之间的连接,拉取实时视频流并转为 MJPEG 输出。
> 本服务独立于主后端 `/system`,由前端 `src/api/camera_server/localServerApi.ts` 直接调用。
## 目录
- [1. 获取海康通道列表](#1-获取海康通道列表)
- [2. 获取实时流(MJPEG)](#2-获取实时流mjpeg)
- [3. 停止实时流](#3-停止实时流)
---
## 1. 获取海康通道列表
用于测试录像服务器连通性,并获取其通道列表。
- **URL**:`POST /api/hikvision/channels`
- **Content-Type**:`application/json`
### 请求参数
| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| ip | string | 是 | 录像机 IP 地址 |
| port | number | 否 | 录像机端口,默认 `8000` |
| user | string | 是 | 录像机登录账号 |
| pass | string | 是 | 录像机登录密码 |
### 请求示例
```json
{
"ip": "192.168.8.241",
"port": 8000,
"user": "admin",
"pass": "ky666888"
}
```
### 响应示例
```json
{
"success": true,
"channels": [
{ "channel": 1, "name": "通道1" },
{ "channel": 2, "name": "通道2" }
]
}
```
或兼容格式:
```json
{
"code": 0,
"message": "ok",
"data": [
{ "channel": 1, "name": "通道1" }
]
}
```
---
## 2. 获取实时流(MJPEG)
拉取指定通道的实时视频流,以 `multipart/x-mixed-replace` 的 MJPEG 流返回,前端用 `<img src="...">` 直接渲染。
- **URL**:`GET /api/hikvision/live-stream`
- **返回**:`multipart/x-mixed-replace` 的 MJPEG 流(长连接)
### Query 参数
| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| ip | string | 是 | 录像机 IP 地址 |
| user | string | 是 | 录像机登录账号 |
| pass | string | 是 | 录像机登录密码 |
| channel | number | 是 | 通道号 |
| streamType | number | 否 | 码流类型,`0` 主码流(默认),`1` 子码流 |
| port | number | 否 | 录像机端口,默认 `8000` |
### 请求示例
```
GET /api/hikvision/live-stream?ip=192.168.8.241&user=admin&pass=ky666888&channel=9&streamType=0&port=8000
```
### 后端实现要求
- 每个「录像机 + 通道」应维护**独立的 ffmpeg 子进程**,并按 `ip + channel`(或生成的 session id)登记。
- 客户端断开(`req.on('close')` / `res.on('close')`)时,应立即 `kill` 对应 ffmpeg 子进程,作为兜底回收机制。
- 同一 `ip + channel` 若已有活跃进程,建议复用或先停旧再启新,避免重复拉起。
---
## 3. 停止实时流
显式停止指定通道的实时流,后端据此 kill 对应 ffmpeg 子进程。前端在关闭预览浮窗、切换摄像头、组件卸载时调用。
- **URL**:`POST /api/hikvision/stop-stream`
- **Content-Type**:`application/json`
### 请求参数
| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| ip | string | 是 | 录像机 IP 地址 |
| user | string | 是 | 录像机登录账号 |
| pass | string | 是 | 录像机登录密码 |
| channel | number | 是 | 通道号 |
| port | number | 否 | 录像机端口,默认 `8000` |
> `ip + channel` 作为流实例的定位键,与「获取实时流」一致。
### 请求示例
```json
{
"ip": "192.168.8.241",
"user": "admin",
"pass": "ky666888",
"channel": 9,
"port": 8000
}
```
### 响应示例
成功:
```json
{
"code": 0,
"message": "ok",
"data": {
"stopped": true,
"channel": 9
}
}
```
无对应流(幂等,不报错):
```json
{
"code": 0,
"message": "no active stream",
"data": {
"stopped": false,
"channel": 9
}
}
```
### 后端实现要求
1. 根据 `ip + channel` 在进程表中查找对应 ffmpeg 子进程;
2. 找到后 `ffmpeg.kill('SIGKILL')`(或先 `SIGTERM` 再兜底 `SIGKILL`),并从进程表移除;
3. **幂等**:未找到对应流时也应返回成功(`stopped: false`),不应返回 4xx/5xx;
4. 若同时存在基于 session id 的实例,应同时支持按 `sessionId` 定位(可选扩展)。
---
## 前端调用关系
```
returnUnpackwork/index.vue
└─ 关闭浮窗 closePreview() → livePreviewRef.stop()
CameraLivePreview.vue
├─ 拉流成功 → 记录 activeStream
└─ stopStream() → stopLiveStream(activeStream) // POST /api/hikvision/stop-stream
```
前端调用封装位于 `src/api/camera_server/localServerApi.ts`:
- `getHikvisionChannels(baseUrl, params)` → `POST /api/hikvision/channels`
- `getLiveStreamUrl(params)` → 生成 `GET /api/hikvision/live-stream` 地址
- `stopLiveStream(params)` → `POST /api/hikvision/stop-stream`

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,351 @@
# returnUnpackwork 扫码指令条码功能设计
> 状态:设计稿(待评审)
> 涉及页面:`src/views/express/returnUnpackwork/index.vue`
> 目标:用扫码枪扫描「指令条码 / 运单号 / 商品条码」,**不依赖输入框焦点**自动路由并执行对应操作。
---
## 1. 需求概述
在拆包工作台引入「扫码枪全流程操作」,实现:
| # | 需求 | 确认结论 |
|---|------|---------|
| 1 | 扫描「提交确认」条码 → 自动执行提交确认 | **单次直接执行**(条码即确认,跳过二次弹窗) |
| 2 | 扫描「切换产品状态」条码 → 切换产品状态 | **语义 A**:设置默认状态(先扫状态条码,再扫商品条码入库),纯前端、无需后端 |
| 3 | 未创建拆包时,**无论焦点是否在「运单号」输入框**,扫条码即输入运单号并创建拆包 | 焦点无关 |
| 4 | 已创建拆包后,**无论焦点是否在「商品条码」输入框**,扫条码即搜索并添加商品 | 焦点无关 |
核心诉求:**扫码枪扫描结果不再依赖当前输入框焦点,统一由全局扫码路由接管。**
---
## 2. 现状与问题
现有实现(`src/views/express/returnUnpackwork/index.vue`):
- 运单号输入框 `@keyup.enter="handleCreate"`:仅焦点在运单号输入框时才触发创建。
- 商品条码输入框 `@keyup.enter`/`@change="handleBarcodeQuickAdd"`:仅焦点在商品条码输入框时才触发快速添加。
- 已有全局 `window keydown` 监听 `handleKeydown`(负责 ←/→ 切换焦点、Enter 提交确认、Esc 取消/清除)。
- 产品状态由下拉 `defaultProductStatus` 控制,仅影响**后续快速添加**的明细;明细表产品状态列为只读 tag。
- `returnUnpack.updateDetail` **不支持修改 `product_status`**(仅 quantity/remark)——这正是选择「语义 A」的原因。
**问题**:扫码枪是"键盘设备",当前行为完全依赖焦点所在输入框:
- 焦点不在对应输入框时,扫的条码会打乱到当前聚焦元素,动作不触发。
- 需求 3/4 要求彻底解决该问题。
---
## 3. 目标行为定义
统一入口后,无论焦点在哪,一次扫码按**业务状态**路由:
```
未创建拆包单
└─ 任何条码 → 当作「运单号」→ 创建拆包单
已创建拆包单(status = unpacking)
├─ 指令条码 SUBMIT → 提交确认(单次直接执行)
├─ 指令条码 NORMAL/DAMAGED → 切换默认产品状态(语义 A)
└─ 其他条码 → 当作「商品条码」→ 查询并快速添加
```
---
## 4. 总体架构
在页面内新增一层 **扫码输入路由**,置于现有事件链之前:
```mermaid
flowchart LR
A[扫码枪 / 键盘] --> B[全局 keydown 扫码缓冲<br/>识别连续快速输入]
B --> C{判定为扫码输入?}
C -- 是 --> D[routeScan 业务路由]
C -- 否手工输入 --> E[现有输入框回车<br/>/ 现有快捷键]
D --> F[创建拆包 / 指令动作 / 商品快速添加]
```
要点:
1. 全局 `keydown` 收集**扫码缓冲**,用"字符输入间隔"区分扫码枪与手工键盘。
2. 判定为扫码输入的字符**一律 `preventDefault()`**,不写入任何输入框 → 从根源避免脏数据与双触发。
3. 扫码 Enter 触发 `routeScan(barcode)` 路由。
4. 手工输入回车(焦点在输入框)仍走原输入框逻辑,与扫码互不干扰。
---
## 5. 指令条码定义
统一前缀 `UNPACK.`(与商品条码零冲突),识别时 `trim()` + 忽略大小写:
| 指令 | 条码内容 | 动作 |
|------|---------|------|
| 提交确认 | `UNPACK.SUBMIT` | 调用 `returnUnpackSubmit({ id })`,成功即重置工作台 |
| 设为正常 | `UNPACK.NORMAL` | `defaultProductStatus = 'normal'` |
| 设为破损 | `UNPACK.DAMAGED` | `defaultProductStatus = 'damaged'` |
> 集中管理:新增 `src/views/express/returnUnpackwork/scan-commands.ts`,导出指令常量与 `resolveScanCommand()` 解析函数。
### 5.1 条码制式(推荐 Code 128)
指令条码贴纸用 **Code 128** 制式生成:
| 维度 | Code 128 ✅ | EAN-13 | QR Code |
|------|-------------|--------|---------|
| 免费/专利 | 免费无专利 | 内部可用(零售厂商码需申请) | 免费 |
| 开销(贴纸尺寸) | **高密度**,短文本最紧凑 | 密度低且仅支持数字 | 点阵,占面积大 |
| 扫描性能 | **一维快速扫、识别率高** | 快速 | 需近距/对准,稍慢 |
| 字符支持 | 全 ASCII(字母+符号) | 仅数字 | 任意 |
结论:**Code 128 免费、高密度、支持全 ASCII、一维快速扫,最适合指令条码**。`UNPACK.SUBMIT / NORMAL / DAMAGED` 均为 ASCII 文本,直接 Code 128 编码即可,无需改动指令内容。
---
## 6. 扫码输入识别(全局缓冲)
在现有 `handleKeydown` 内新增扫码缓冲逻辑:
```
常量:
SCAN_INTERVAL_MS = 50 // 判定同一段扫码的最大字符间隔(可配置)
SCAN_MIN_LEN = 2 // 至少 2 个字符才判定为扫码(排除单字符回车)
状态:
scanBuffer = ''
lastScanCharTime = 0
keydown 处理(在每个分支前先执行):
if (e.key 是单个可打印字符 && 非功能键/非组合键) {
const now = Date.now()
if (now - lastScanCharTime > SCAN_INTERVAL_MS) scanBuffer = '' // 新一段输入
scanBuffer += e.key
lastScanCharTime = now
e.preventDefault() // 阻止写入输入框,杜绝脏数据
return
}
if (e.key === 'Enter' && scanBuffer.length >= SCAN_MIN_LEN
&& Date.now() - lastScanCharTime <= SCAN_INTERVAL_MS) {
const barcode = scanBuffer
scanBuffer = ''
lastScanCharTime = 0
e.preventDefault() // 阻止输入框 @keyup.enter 双触发
routeScan(barcode)
return
}
```
设计说明:
- **时间间隔判定**:人类手工打字字符间隔普遍 > 100ms,扫码枪连续输入 < 50ms,阈值 50ms 可可靠区分。
- **`preventDefault()` 阻止字符进输入框**:扫码结果只存在 `scanBuffer`,路由成功后由代码决定回填输入框还是直接执行动作。这是实现"焦点无关"的关键。
- **排除项**:功能键(F1–F12)、方向键、Enter/Esc/组合键(Ctrl/Alt 等)不进入缓冲。
- **`SCAN_MIN_LEN = 2`**:手工在输入框按单字符回车不会被误判为扫码。
---
## 7. 扫码路由 `routeScan(barcode)`
```
function routeScan(barcode) {
const id = createResult.value?.id
const record = createResult.value?.record
// 1) 未创建拆包单 → 当作运单号创建
if (!id) { handleCreate(barcode); return }
// 2) 已创建但非拆包中(completed/cancelled)→ 提示,不路由
if (record?.status !== 'unpacking') { ElMessage.warning('当前拆包单已终态'); return }
// 3) 指令条码
const cmd = resolveScanCommand(barcode)
if (cmd) {
if (cmd === 'submit') doSubmit() // 单次直接执行
else if (cmd === 'normal') setDefaultStatus('normal')
else if (cmd === 'damaged') setDefaultStatus('damaged')
return
}
// 4) 商品条码 → 复用现有快速添加
detailBarcode.value = barcode // 回填输入框做视觉反馈
handleBarcodeQuickAdd()
}
```
### 7.1 创建拆包(`handleCreate(barcode?)`)
- 改造 `handleCreate` 支持传入条码:`const code = (barcode ?? waybillCode.value).trim()`。
- 扫码路径:直接传入条码创建;创建成功后沿用现有逻辑自动 `focus` 商品条码输入框。
- 手工路径:仍读输入框 `waybillCode.value`。
### 7.2 提交确认(`doSubmit()`)
- 抽出现有 `confirmSubmit` 成功分支为 `doSubmit()`:调 `returnUnpackSubmit({ id })` → 成功 → `resetWorkState()` + `loadUnpackList()` + `focusWaybill()`。
- **扫码直接调用 `doSubmit()`,不弹二次确认**(条码即确认)。
- `submitLoading` 防重入;无拆包单/非 unpacking 时提示不执行。
### 7.3 切换默认状态(`setDefaultStatus(status)`)
- 纯前端:`defaultProductStatus.value = status` + `ElMessage` 反馈(正常=绿 / 破损=红)。
- 联动:左侧下拉框回显当前状态(与明细表 tag 配色一致)。
- 未创建拆包单时也允许设置(作为纯前端状态,为后续快速添加做准备)。
---
## 8. 手工回车与现有快捷键的协同
为避免破坏现有交互,`handleKeydown` 内分支编排顺序(自上而下):
```
1. 扫码缓冲收集 / 扫码路由(见 §6) ← 新增,最先
2. 弹窗打开时(stockPicker/quickAdd/detailForm)→ return(弹窗自处理)
3. ←/→ 切换焦点(现有逻辑,不变)
4. Enter:
a. 受控确认弹窗 → 各确认动作(现有,不变)
b. 其他弹窗 → return
c. 焦点在「运单号」输入框且未创建 → handleCreate()(现有 @keyup.enter 保留或并入)
d. 焦点在「商品条码」输入框且已创建 → handleBarcodeQuickAdd()
e. 无输入框焦点 → 提交确认(现有,不变)
5. Esc:取消/清除(现有,不变)
```
**双触发防护**(关键):
- 扫码字符已 `preventDefault` 不写入输入框,因此扫码 Enter 时输入框 `@keyup.enter` 若触发,其读取的 `v-model` 为空 → 直接 `return`,不会重复执行。
- 为稳妥,输入框 `@keyup.enter` 的 handler 开头可加守卫:`if (Date.now() - lastScanAt < 100) return`(`lastScanAt` 为扫码路由完成时刻),彻底杜绝双触发。
---
## 9. UI 改动:扫码指令展示区块
在 `express/returnUnpackwork` 页面新增「扫码指令」展示区块,让工人一眼看到可扫的指令条码、含义与当前激活状态。
### 9.1 位置与结构
左侧面板「键盘快捷键」(`.shortcut-tips`) **下方**新增独立区块 `.scan-commands-tips`,与快捷键区块同风格、以条形码图标区分:
```
┌──────────────────────────────────────────┐
│ 📟 扫码指令 [打印贴纸] │
│ 直接用扫码枪扫描下方条形码(无需聚焦输入框) │
│ │
│ ▓▓▓▓▓▓▓▓▓▓ UNPACK.SUBMIT [提交确认] │ ← 可扫条形码图(jsbarcode Code 128)
│ ▓▓▓▓▓▓▓▓▓▓ UNPACK.NORMAL [设为正常] │ ← 激活时高亮(绿)
│ ▓▓▓▓▓▓▓▓▓▓ UNPACK.DAMAGED [设为破损] │ ← 激活时高亮(红)
└──────────────────────────────────────────┘
```
### 9.2 每行结构(模板草案)
```html
<div
v-for="cmd in SCAN_COMMANDS"
:key="cmd"
class="scan-command-row"
:class="{
'is-active': cmd === 'normal' && defaultProductStatus === 'normal',
'is-active--damaged': cmd === 'damaged' && defaultProductStatus === 'damaged'
}"
>
<!-- 真实条形码图形:jsbarcode Code 128,工人可直接扫屏幕 -->
<svg :ref="barcodeRefs[cmd]" class="scan-command-barcode-img"></svg>
<div class="scan-command-info">
<div class="scan-command-info-line">
<span class="scan-command-code">{{ CMD[cmd] }}</span>
<el-button link size="small" class="scan-copy-btn" @click="copyScanCommand(CMD[cmd])">复制</el-button>
</div>
<el-tag size="small" :type="CMD_TAG_TYPE[cmd]">{{ CMD_LABEL[cmd] }}</el-tag>
</div>
</div>
```
### 9.3 视觉样式(对齐现有 shortcut-tips)
| 元素 | 设计 |
|------|------|
| 区块 `.scan-commands-tips` | `border-top: 1px dashed #e8eef7` 与快捷键区块分隔;`padding-top: 12px` |
| 标题 `.scan-commands-title` | `📟 扫码指令`,13px / 600 / `#303133`(与 `.shortcut-tips-title` 一致) |
| 副标题 `.scan-commands-sub` | "直接用扫码枪扫描下方条形码即可(无需聚焦输入框)",12px / `#909399` |
| 条形码图 `.scan-command-barcode-img` | jsbarcode 生成 **Code 128 SVG**(`height:36`),白底圆角,**可直接被扫码枪扫描屏幕**;`onMounted → renderBarcodes()` 渲染 |
| 条码文本 `.scan-command-code` | 辅助文本:等宽字体、深底浅字,便于人工对照(非可扫对象) |
| 动作标签 | `el-tag`:提交=warning / 正常=success / 破损=danger,与明细表状态列配色一致 |
| 激活态 `.is-active` | 当前默认状态对应行加高亮边框 + 浅色背景(正常=绿浅、破损=红浅),**扫码切换时实时更新** |
| 行间距 `.scan-command-row` | `margin-bottom: 10px`,行间留足空隙,**条码不挨太近**;`align-items: center` |
| 复制按钮 `.scan-copy-btn` | `el-button link size=small`,hover 显示,点击复制条码文本(用于打印贴纸) |
### 9.4 数据源与联动
- 条码文本统一从 `scan-commands.ts` 常量读取(`CMD.SUBMIT / CMD.NORMAL / CMD.DAMAGED`),与 `resolveScanCommand()` **同源**,避免硬编码漂移。
- 激活高亮绑定 `defaultProductStatus`:扫码或下拉切换状态时实时联动。
- `copyScanCommand(code)`:`navigator.clipboard.writeText(code)` 复制条码文本,便于工人用条码打印机生成贴纸。
- 页面条形码图形:`renderBarcodes()` 用 jsbarcode 按 `CMD[cmd]` 生成 **Code 128 SVG** 到对应 `svg`(`barcodeRefs` 收集),`onMounted` 后渲染 → 工人可直接扫屏幕。
### 9.5 打印条码贴纸(确认实现)
- **「打印条码贴纸」按钮**:位于扫码指令区块标题栏右侧,点击调起浏览器打印包含三条码的排版页,直接产出贴纸。
- **排版**:每条码一行 = Code 128 条码图 + 下方文字(内容 + 动作含义),A4 多行排列供裁剪。
- **条码生成**:轻量免费库 `jsbarcode` 前端生成 Code 128 SVG,无后端依赖。
- **无折叠开关**:面板空间通过精简快捷键提示释放(见 §9.7)。
### 9.6 其他 UI 改动
1. 产品状态下拉旁展示当前激活状态高亮(与 tag 配色一致)。
2. 保留运单号 / 商品条码输入框(扫码自动回填,兼顾手工输入)。
### 9.7 键盘快捷键提示精简(给扫码指令区块腾空间)
精简左侧「键盘快捷键」区低频提示,释放高度给「扫码指令」区块:
**保留**(高频/核心):
- `Enter` 运单号:创建拆包单(创建后锁定置灰)
- `Enter` 商品条码:查询并添加
- `Enter` 无表单时:提交确认
- `Esc`:取消拆包 / 清除信息
**删除**(低频/扫码工作流下少用):
- `←/→` 切换焦点(页面 + 商品选择弹窗内)
- `↑/↓` 切换商品、`Enter` 确定选中商品(弹窗内鼠标可替代)
- 整体删除「表单(商品选择弹窗内生效)」小节
---
## 10. 边界与异常
| 场景 | 处理 |
|------|------|
| 未创建拆包单时扫「提交/状态」指令 | 提交→提示无进行中单据;状态→仍可设置默认状态 |
| 已 completed/cancelled 时扫商品条码 | 提示"当前拆包单已终态",不添加 |
| 扫的条码非指令且查不到商品 | 走现有"未找到匹配的商品"提示 |
| 扫码枪快速连扫 | `submitLoading`/`quickAddLoading` 防重入 |
| 弹窗打开时扫码 | 弹窗打开时路由不生效,条码不收集(避免干扰表单) |
| 手工在输入框按单字符回车 | 不被误判为扫码(`SCAN_MIN_LEN=2`) |
| 条码含空格/小写 | `trim()` + 大小写不敏感解析 |
---
## 11. 落地清单(文件级)
1. 新建 `src/views/express/returnUnpackwork/scan-commands.ts`
- 指令常量 + `resolveScanCommand(barcode): 'submit' | 'normal' | 'damaged' | null`
2. 修改 `src/views/express/returnUnpackwork/index.vue`
- `handleKeydown` 增加扫码缓冲收集 + 路由(§6/§7)
- `handleCreate` 支持传入条码参数
- 抽出 `doSubmit()`、`setDefaultStatus()`(复用 `confirmSubmit` 成功分支)
- 输入框 `@keyup.enter` 加双触发守卫
- 新增「扫码指令」展示区块(§9:模板 + 样式 + 激活高亮 + `copyScanCommand()`)
- 「打印条码贴纸」:引入 `jsbarcode` 生成 Code 128 SVG 打印(§9.5)
- 精简「键盘快捷键」提示,删除低频项(§9.7)
3. 无需后端改动(语义 A,纯前端)
---
## 12. 决策记录与待确认项
### 已确认
- [x] 条码制式:**Code 128**(免费、高密度、全 ASCII、一维快速扫)
- [x] 指令内容:`UNPACK.SUBMIT / UNPACK.NORMAL / UNPACK.DAMAGED`
- [x] 「打印条码贴纸」:确认实现(`jsbarcode` 生成 Code 128 SVG)
- [x] 折叠开关:不需要(用快捷键提示精简释放空间,§9.7)
- [x] 条码间距:行间距加大(`margin-bottom: 10px`),条码不挨太近
### 待确认
- [ ] 扫码间隔阈值 50ms 是否合适(可调)

View File

@ -0,0 +1,191 @@
# 出库单批量打印 —— 商品明细分页设计
> 状态:已实施(2026-08-27)
> 日期:2026-08-27
> 相关页面:`storage/stockout` 批量打印出库单(`BatchReceivingPrintDialog.vue`)
> 相关模板:出库单A5模板(`template_18`,OUTBOUND,148mm × 210mm)
## 1. 背景与目标
批量打印出库单时,商品明细可能很多,且商品名称长短不一导致行高不固定。当前模板对「商品明细」表格不做任何分页/裁剪处理,内容一多就会**向下压过「备注」「打印时间」等固定元素,甚至溢出页面**。
**目标**:
- 商品明细表格内容到达「备注」位置(截止线)后,将剩余明细**自动拆分到第 2、3…N 页**打印。
- 分页数量**不按固定行数**,而是**按每行的实际渲染高度动态计算**。
- 打印台(`print.send`)与浏览器打印**两条通道都要支持**,且都采用**前端逐页发任务**的方式。
- 第 2 页起**重复单据头**,并通过单据头(出库单号)确认多页属于同一张出库单、同一批次。
## 2. 现状与问题定位
### 2.1 打印链路
```mermaid
flowchart LR
A[stockout/index.vue<br/>选择多张已完成出库单] --> B[BatchReceivingPrintDialog.vue]
B --> C[fetchPrintData<br/>获取单据头 + details 明细]
C --> D[预览 .preview-page 单页渲染]
C --> E[doPrint 打印台通道<br/>print.send customize]
C --> F[browserPrint 浏览器通道<br/>拷贝 preview-page 到新窗口]
```
- `doPrint()`:构造 `PrintSendCustomizeParams`(`type:'customize'` + `computerId` + `printer` + `template` + `data` + `count`),调用 `stationApi.sendPrint()`,由**打印台客户端**渲染。
- `browserPrint()`:把当前 `.preview-page` 的 `outerHTML` 写入新窗口后 `print()`。
- 两条通道目前都只能表达「一张单、一页」。
### 2.2 模板布局(出库单A5,148×210mm)
| 区域 | 元素 | top(mm) | 说明 |
|---|---|---|---|
| 单据头 | 出库单号/波次号/创建时间/快递公司/运单号/收件人/地址… | 4 ~ 74 | 每页要重复的部分 |
| 商品明细 | `table`(type=table) | 77 | 表头高 `headerHeight`=6,行高 `rowHeight`=6 |
| 截止线 | 分割线 / **备注** | 154 / **158** | 表格不得越过此线 |
| 页脚 | 打印时间 | 166 | 仅最后一页显示 |
表格列:商品编码 `item_code`(22) / 商品名称 `item_name`(40) / 数量 `plan_qty`(18) / 单价 `actual_price`(20) / 明细备注 `detail_remark`(28),合计 128mm。
### 2.3 问题根因
- `computePreviewItemStyle()` 对 `type==='table'` 设置 `width/height: auto`,表格高度完全由 `details` 行数 + 每行实际换行高度决定,**不裁剪、不分页**。
- 表格 `top=77`、截止线 `158`,单页数据区可用高度固定 ≈ `158 − 77 − 6 = 75mm`。
- 行高不固定:商品名称列宽 40mm、字号约 3mm(≈13 字/行),名称超长换行后该行高度 = `换行行数 × rowHeight`,所以**不能按固定行数拆页**。
## 3. 总体方案
**核心思路:前端按「实际渲染高度」动态切分明细 → 一张出库单生成多页 → 前端逐页发送(打印台逐次 sendPrint / 浏览器逐页渲染)→ 每页带完整单据头。**
```mermaid
flowchart TD
A[打印队列中取一张出库单] --> B[准备: 定位 table 与截止线<br/>tableTop=77 header=6 cutline=158]
B --> C[逐行计算实际高度 h_i<br/>估算: ceil(text/colWidth) x rowHeight]
C --> D[累加, 达到截止线则切页]
D --> E[每页生成独立 template_content + data]
E --> F{打印通道}
F -->|打印台| G[逐页调用 print.send<br/>type=customize count=1]
F -->|浏览器| H[逐页渲染 .preview-page<br/>拼接 + 强制分页]
G --> I[全部页完成 → 队列下一张单]
H --> I
```
### 3.1 关键参数(出库单A5)
```
tableTop = table.top // 77
headerH = table.headerHeight // 6
cutlineTop = 158 // 备注 top(截止线,不遮挡备注)
usableH = cutlineTop - tableTop - headerH // = 75mm(第1页)
```
- **第 1 页**:单据头完整 + 表格(重复表头)+ 截止线下方的备注、打印时间。
- **第 2…N 页**:**重复单据头**(`top < tableTop` 的模板元素)+ 表格(重复表头)+ 页码标识;备注、打印时间等页脚元素**仅最后一页**保留。
- 第 2+ 页的 `usableH` 与第 1 页一致(因为重复单据头后,表格仍从 77 开始,截止线仍为 158)。
### 3.2 动态行高计算
**推荐:估算法(快、无 DOM 开销)**
```
perLineH = rowHeight(6)
cols: 每列 { width, field }
行高 = max over 列 of ( ceil( 文本宽度 / 列宽 ) ) × perLineH
文本宽度 = 估算字符数 × 字宽(中文≈fontSize,ASCII≈0.5×fontSize)
```
**备选:测量法(更准)**
- 在隐藏 DOM 中按模板列宽/字号渲染该行,读取 `scrollHeight` 换算成 mm 累加。
- 成本高,仅当估算误差影响分页正确性时启用。
### 3.3 页面模板内容生成
对每个拆出的页 `P`:
```ts
// 第1页(多页时也加页码)
pageTemplateContent(P0) = [
...单头元素(top<77),
table元素(表头 + P0 的行),
...页脚元素(备注 top=158 / 打印时间 top=166),
页码 text 元素, // "第 1/N 页"
]
// 第2..N页
pageTemplateContent(Pk) = [
...单头元素(top<77), // 重复单据头
table元素(表头 + Pk 的行),
页码 text 元素, // 如 "第 2/3 页",可用自定义 text,无 field_code
]
```
> 页码仅在多页(N>1)时追加,第 1 页同样有;单页场景保持原模板不加页码。
> 表格元素的 `rows`(表头列定义)保持不变,仅数据行 `details` 切片不同。
### 3.4 每页 data
```
pageData = {
...formData, // 单据头字段完整(含 delivery_order_code 出库单号)
details: details.slice(页起始行, 页结束行),
pageNo: k, // 第几页
pageTotal: N, // 共几页
}
```
> 通过单据头字段(出库单号 + 收件人等)确认多页属于同一张单;批量队列中多张单按出库单号区分批次。
## 4. 打印台通道(doPrint)
改造后逐页发送:
```ts
for (const page of pages) {
const payload: PrintSendCustomizeParams = {
type: 'customize',
computerId: printSettings.station,
printer: printSettings.printer,
template: { ...template, template_content: page.templateContent },
data: page.data,
timestamp: String(Date.now()),
count: 1,
}
await stationApi.sendPrint(payload) // 每页一次任务,顺序等待
}
```
- 一张单的 N 页全部成功后再打印队列中的下一张单。
- 进度提示:`打印队列 (M)` 按单据计数;当前页提示「出库单号 xxx (第 k/N 页)」。
- 失败处理:单页失败记录该单据为 `error`,允许补打(沿用现有 `printStatusMap`)。
## 5. 浏览器通道(browserPrint)
改造后逐页渲染:
- 一张单生成 N 个 `.preview-page`(每页内容与打印台一致),拼接写入打印窗口。
- 页与页之间强制分页:`@page { size: 148mm 210mm; margin: 0 }` + 每个 `.preview-page` 之间 `page-break-after: always`。
- 图片(条码/二维码)加载完成后再 `print()`(沿用现有逻辑)。
## 6. 单据头与批次确认
- **每页都重复单据头**:出库单号(`delivery_order_code`)、收件人、地址、物流等 `top<77` 的元素。
- 多页时每页右下角渲染页码(`第 k/N 页`,**含第 1 页**),便于纸质面单归档时确认页序与归属。
- 批量队列 = 多张出库单 = 多个批次;同单多页通过「出库单号」归属同一批次。
## 7. 涉及改动点
| 文件 | 改动 |
|---|---|
| `src/components/BatchReceivingPrintDialog.vue` | ① 新增分页计算(定位 table/截止线、动态行高、切分 details)② `doPrint` 逐页发送 ③ `browserPrint` 逐页渲染 + 强制分页 ④ 页码/进度展示 |
| `src/utils/printPaginate.ts`(新增,建议) | 抽公共分页工具:`paginateDetails(template, details) → Page[]`,供打印台/浏览器复用 |
| `src/views/storage/stockout/index.vue` | `fetchPrintData` 补充单据头字段映射(`delivery_order_code`/`wave_no`/`logistics_name` 等模板字段与 `stockout_order_code` 数据的对齐),确保第 2+ 页单据头有值 |
## 8. 实施前需核对
1. **字段映射**:模板出库单号 `field_code=delivery_order_code`,而 stockout 数据为 `stockout_order_code`,需确认打印取值是否已正确映射(`getPreviewValue` 按 `field_code` 直取)。
2. **打印台渲染行为**:`print.send` 的 `template.template_content` 是否严格按 `top/left/width/height` 绝对定位渲染第 2+ 页模板(依赖打印台客户端,需联调验证)。
3. **截止线取值**:目前取备注 `top=158`,若后续模板编辑改动布局,分页参数应改为**运行时从模板读取**(取 `table` 下方第一个非表格元素的 top),而不是硬编码。
4. **留白策略**:第 1 页表格只到 158mm,页面下方(158~210)仍保留备注/打印时间,符合「不遮挡备注」要求;如需减少留白可后续再调截止线策略。
## 9. 验收标准
- 商品明细少(表格不越 158)时:仍为单页,行为与现状一致。
- 商品明细多(越 158)时:自动拆分多页;第 2+ 页重复单据头与表头;每页均不遮挡备注。
- 商品名称长短变化:每页行数随之动态变化,总页数正确。
- 打印台与浏览器两条通道分页结果一致。
- 批量多张单:逐张、逐页按序打印,出库单号可区分批次与页序。

View File

@ -0,0 +1,168 @@
# 前端独立部署 · 项目落实任务清单
> 当前口径(2026-09-24 更正):全部能力已迁入独立模块 **前端独立部署模块 `frontConfig.*`(共 8 个方法)**:
> `frontConfig.getByDomain`(公网拉品牌,免登录免鉴权)、`frontConfig.getInfo` / `frontConfig.saveInfo`(品牌)、
> `frontConfig.getDomain` / `frontConfig.setDomain` / `frontConfig.checkDomain`(域名 + DNS TXT 归属验证)、
> `frontConfig.getCert` / `frontConfig.saveCert`(证书)。
> 旧口径 `setting.warehouse.getFrontConfig / saveFrontConfig / saveFrontCert` 已废弃,前端封装已移除。
> 历史背景(`pending-updates.json` 2026-09-08 added):`frontConfig.getByDomain`、`setting.warehouse.*` 共 4 接口。
---
## 1. 接口矩阵与角色
| 接口 | 角色 | 鉴权 | 状态 |
|---|---|---|---|
| `frontConfig.getByDomain` | 公网按域名拉品牌(仅放行 domain_status=1) | 免登录/免鉴权/免权限 | ✅ 已接入(store 消费端) |
| `frontConfig.getInfo` | 仓库侧品牌回显(8 字段) | 登录 + 仅仓库主体 | ✅ 已接入 |
| `frontConfig.saveInfo` | 仓库侧保存品牌 | 登录 + 仅仓库主体 | ✅ 已接入 |
| `frontConfig.getDomain` | 仓库侧域名与验证状态回显(9 字段) | 登录 + 仅仓库主体 | ✅ 已接入 |
| `frontConfig.setDomain` | 设置/变更域名 + 发起 DNS TXT 验证 | 登录 + 仅仓库主体 | ✅ 已接入 |
| `frontConfig.checkDomain` | 主动校验 DNS TXT 并回写 | 登录 + 仅仓库主体 | ✅ 已接入 |
| `frontConfig.getCert` | 仓库侧证书回显(13 字段,含 can_set_cert) | 登录 + 仅仓库主体 | ✅ 已接入 |
| `frontConfig.saveCert` | 上传证书(域名取库内已验证记录) | 登录 + 仅仓库主体 | ✅ 已接入 |
> 兼容说明:`setting.warehouse.getFrontConfig / saveFrontConfig / saveFrontCert` 后端仍存在,但已不是本页流程口径;
> `setting.warehouse.getSettings / getFieldMeta / saveSettings / getweChatApp` 不受影响。
---
## 2. 现状盘点
> 以下 §2 / §3 / §4 为 2026-09-08 首次落实时的盘点与任务记录(历史留档)。
> 其中涉及的 `setting.warehouse.getFrontConfig / saveFrontConfig / saveFrontCert` 口径已于 2026-09-24 更正,最新口径见 §1 与 §6。
### 2.1 已完成
- **API 封装**
- `src/api/frontconfig/frontConfig.ts`(新目录,`frontConfigGetByDomain` + `FrontConfigPublicItem`)
- `src/api/setting.warehouse/settingwarehouse.ts` 新增 3 个封装与 `SettingWarehouseFrontConfig` 等类型
- **配置管理(「前端独立部署」独立标签页)**:`src/views/system/setting/basicManagement/newview/pages/FrontConfigForm.vue`
- 由 `.../newview/config/template-config.ts` `tabPages` 注册为独立 tab `frontConfig`「前端独立部署」,不再挤在基础设置(`WarehouseSettingsForm.vue`)内
- 品牌表单(title/logo/favicon/login_bg + 主题键值编辑)+ 保存品牌配置(`saveFrontConfig`)
- 自持域名&证书表单(domain/pem/key)+ 上传证书(`saveFrontCert`)
- 加载即 `getFrontConfig` 回显;meta 展示 `domain / cert_expire_at / sync_status`
- 已通过 type-check / build。
### 2.2 未落实 / 缺口
- `frontConfig.getByDomain` 的**消费端**完全没有(登录页/入口仍用静态品牌,`index.html` 的 favicon/title 固定)。
- 配置页**同步状态展示不完整**:`last_sync_error / sync_attempts / last_synced_at` 未回显、无证书到期提醒。
- 缺少“按域名品牌”的全局承载层(品牌状态/store、动态 favicon & `document.title` 应用点)。
- 缺少端到端验收步骤与登记核对项。
---
## 3. 任务清单
> 分级:P0=核心闭环必须;P1=建议;P2=可选优化。括号为建议涉及文件(最终以实现为准)。
### 模块 A:品牌消费端(frontConfig.getByDomain)【P0 · 主要缺口】
| # | 任务 | 涉及文件 | 说明 / 验收 |
|---|---|---|---|
| A1 | 新建「前端品牌」store(或 composable) | `src/stores/modules/frontBrand.ts`(新建) | 保存 getByDomain 结果:`{ domain,title,logo_url,login_bg_url,favicon_url,theme, configured }`;提供 `loadBrandByDomain()`:取 `location.hostname` → `frontConfigGetByDomain({domain})`;404/异常/空结果时置默认(不报错) |
| A2 | 登录前/入口初始化触发加载 | `src/main.ts` 或 `src/permission.ts` 或 `src/views/login/index.vue` | 免鉴权时机(登录页挂载 / 路由守卫放行白名单段);成功才应用品牌,失败静默走默认;可加本地短缓存避免每次刷新请求 |
| A3 | 登录页品牌化 | `src/views/login/index.vue` | 左侧品牌图/标题/Logo 用 store 值替换静态资源;登录背景图用 `login_bg_url` |
| A4 | 全局 favicon / document.title 动态化 | `index.html`、`src/permission.ts`、布局入口 | 有 `favicon_url` 时替换 `<link rel="icon">`;`document.title`(页面标题前缀)用 `title` 覆盖默认系统名;无则维持现状 |
| A5 | theme 应用(CSS 变量级联) | 主题相关(settings/样式入口) | 若返回 `theme` 对象有既定 CSS 变量约定则写入 `:root`/`html`;暂无字段约定时仅记录、不强行映射(与后端确认字段后补) |
| A6 | 多仓库同部署的域名解析说明 | ✅ 已落地:并入 `docs/前端独立部署-操作与部署说明.md` §5 第 5 点 | 同一部署访问不同仓库自持域名 → 后端按 hostname 区分返回;前端无需感知 |
> ✅ **进度(2026-09-08):A1 ~ A6 已全部落地**
> - A1 `src/stores/modules/frontBrand.ts`(新增 Pinia store):`loadBrandByDomain()` 按 `location.hostname` 拉品牌,404/异常/`configured=false` 静默回退默认;`loaded` 幂等;`applyBrandGlobals()` 应用 favicon、登录页标题
> - A2 触发:`src/main.ts` `app.mount` 后调用 `useFrontBrandStore(pinia).loadBrandByDomain()`(免鉴权)
> - A4 全局标题/favicon:`src/utils/get-page-title.ts` 支持第二参 `baseTitle`;`src/permission.ts` 路由守卫标题前缀用 `frontBrand.siteTitle`;favicon `<link rel=icon>` 动态替换(仅当品牌有效)
> - A3 登录页品牌化:`src/views/login/index.vue` Logo(`:src=brandLogo`)、站点标题(`brand-name` h1,仅品牌 title 存在时显示)、登录背景(`:style=loginBgStyle` 用 `login_bg_url`)
> - A5 theme→CSS 变量:`src/stores/modules/frontBrand.ts` `applyThemeCssVars(theme)` 将 theme 顶层键写入 `--<key>` 至 `<html>`(仅标量值;非法键/嵌套对象忽略;键需 `[A-Za-z_][A-Za-z0-9_-]*`);brand 为空/换品牌时清除已应用变量(无残留)。约定:theme 键即 CSS 变量名(如 `primary`→`--primary`,`bgColor`→`--bgColor`)
> - 验证:type-check 通过
### 模块 B:配置页完善(前端独立部署标签页)【P1】
| # | 任务 | 涉及文件 | 说明 / 验收 |
|---|---|---|---|
| B1 | 同步状态详情回显 | `.../newview/pages/FrontConfigForm.vue` | meta 区补充 `sync_attempts / last_sync_error / last_synced_at`;`sync_status=2` 时红色展示 `last_sync_error` 文案 |
| B2 | 证书到期提醒 | 同上 | `cert_expire_at` 距当前 <30 天(或已过期)时给出 `el-alert`/tag 提醒;未上传显示“未上传” |
| B3 | 保存/上传后处理核对 | ✅ 已落地:`FrontConfigForm.vue` 品牌/证书按钮区补语义提示文案(品牌留空即清空、主题删空即清空、保存/上传成功后自动重新加载),实现已符合(空值清空 + 成功后 loadFrontConfig);该区块已随拆分迁至独立「前端独立部署」tab |
| B4 | 接口登记核对 | `workflows/api-doc-agent/config/接口.md` | 4 个 method 应 `启用=是、占位=否`(api-list-update 已自动同步;人工复核一次) |
> ✅ **进度(2026-09-08):B1 ~ B4 已全部落地**
> - B1 同步状态详情:`FrontConfigForm.vue` meta 区新增「同步详情」列(`last_synced_at` · 尝试 `sync_attempts` 次);`sync_status=2` 时顶部红 `el-alert` 展示 `last_sync_error`
> - B2 证书状态:meta「证书状态」列按 `cert_expire_at` 显示 tag(未上传→灰、正常→绿、≤30 天→黄「剩 N 天」、过期→红);过期/临期在配置区顶部显示 `el-alert` 提醒
> - B4 接口登记核对:`workflows/api-doc-agent/config/接口.md` 人工复核通过 —— 4 个 method(frontConfig.getByDomain / setting.warehouse.getFrontConfig / saveFrontConfig / saveFrontCert)均 `启用=是、占位=否`,归属路径正确
> - 验证:type-check 通过
### 模块 C:文档与端到端验收【P1】
| # | 任务 | 说明 / 验收 |
|---|---|---|
| C1 | 端到端验收用例 | ① 仓库设置保存 title/logo → `frontConfig.getByDomain(该域名)` 返回新值;② 上传证书成功 → `domain` 生效、`sync_status=0`;③ 未登记域名访问 getByDomain → 404/`configured=false` → 前端默认品牌;④ 品牌字段留空保存 → 返回空串清空;⑤ theme 键值保存后回显一致(对象结构);⑥ 换域名后无旧品牌残留(后端已清缓存,前端无本地旧值) |
| C2 | 操作/部署说明(可选) | ✅ 已落地:`docs/前端独立部署-操作与部署说明.md`(登记流程 / 证书格式与 SAN / 错误码对照 / 前端部署验证 / 代码落点) |
> ✅ **进度(2026-09-08):C1、C2 已落地**(C1 清单见下;C2 操作/部署说明见 `docs/前端独立部署-操作与部署说明.md`)
>
> **C1 端到端验收清单(可执行)**
>
> 0. 环境准备:在仓库设置登记自持域名并保存品牌;浏览器访问对应域名(或临时改 hosts 把域名指向该部署)。
>
> | # | 操作 | 预期结果 |
> |---|---|---|
> | ① | 仓库设置保存 title/logo_url/login_bg_url/favicon_url/theme | `getFrontConfig` 回显与保存一致;theme 键值回显一致(对象结构) |
> | ② | 用登记域名访问登录页(无缓存/新会话) | 登录页显示品牌 Logo/标题/背景;`<link rel=icon>` href 变为 favicon_url;`document.title` 使用品牌 title;theme 标量键已作为 `--<key>` 写入 `<html>`(DevTools 验证) |
> | ③ | 未登记域名 / 主域名访问 | `getByDomain` 404/`configured=false` → 登录页保持系统默认品牌与主题(无报错) |
> | ④ | 上传证书(domain+pem+key) | `getFrontConfig` 返回 `domain` 生效、`cert_expire_at` 有值、`sync_status=0`;配置页“证书状态”为绿/黄并显示有效期 |
> | ⑤ | 将证书改成即将过期/过期的时间(或造数) | 配置页顶部出现对应 warning/error `el-alert`;证书状态 tag 变黄/红 |
> | ⑥ | 触发同步失败(如证书不可用) | 配置页顶部红 alert 显示 `last_sync_error`;“同步详情”展示尝试次数与最近同步 |
> | ⑦ | 切换/清除域名配置后刷新 | 前端无旧品牌残留:favicon/标题/主题 CSS 变量恢复默认 |
>
> **getByDomain 请求示意(免鉴权公共接口)**
>
> ```bash
> POST /system
> {"method":"frontConfig.getByDomain","v":"1.0","data":{"domain":"<自持域名>"}}
> # 命中:code=200 + domain/title/logo_url/login_bg_url/favicon_url/theme
> # 未登记:404 / configured=false
> ```
---
## 4. 建议执行顺序
1. **A1 + A2**:建 store 并接入入口加载(形成闭环主干)
2. **A3 + A4**:登录页品牌化 + favicon/title 动态化(可直观验证)
3. **B1 + B2**:配置页同步状态与到期提醒(让后台能自助排查)
4. **A5 / B4 / C1**:theme 映射(需确认字段)、登记核对、验收回归
5. **C2**:部署/操作文档(收尾)
---
## 5. 风险与边界(后端约束提醒)
- `frontConfig.setDomain`:`domain` 全局唯一(占用→409);格式需至少两段标签且每段 1~63 位字母数字与连字符(排除通配符/下划线/首尾点),否则 400;**域名变更会同时清空既有证书并重置同步状态**;同一域名重复设置时已验证则幂等返回(不刷新校验码、不清证书)。
- `frontConfig.checkDomain`:解析目标为库内 `domain_verify_host`(不解析裸域名);DoH 优先、失败降级系统 DNS;失败时 `domain_status=2`、`attempts+1`、`last_error` 截断 ≤500 字符。
- `frontConfig.saveCert`:**不接受 domain 入参**(前端传了也忽略);无域名→400「请先设置并验证域名」,`domain_status≠1`→400「域名未通过验证,暂时无法上传证书」;证书校验链任一失败统一 400「证书不合法」(不吐细节);`cert_expire_at` 以证书 validTo 权威写入;`cert_path/key_path` 置空,等 crontab 脚本部署后回填。
- 证书可设置性:前端按 `getCert` 的 `can_set_cert` / `can_set_cert_reason` 置灰上传入口(无域名「请先设置域名」/ 未验证「域名待验证」/ 失败「域名验证失败」)。
- `frontConfig.saveInfo`:只受理品牌字段,`domain`/证书字段由白名单静默忽略;`theme` 须合法 JSON 对象或 JSON 字符串;保存即重置同步状态(sync_status=0、attempts=0、清空错误与时间)并清当前域名公共缓存。
- `frontConfig.getByDomain`:仅放行 `domain + domain_status=1`,未验证/验证失败一律按未配置返回 404「域名未配置」;仅返回 6 个公开字段,绝不返回证书/私钥/同步等内部字段;未登记域名写 60s 空缓存防穿透。
- 证书 PEM/私钥:禁止出现在前端日志;私有回显(`cert_pem`/`key_pem`)仅在仓库主体登录后的 settings 页接口。
- 主题结构:`theme` 仅作动态 CSS 变量容器(顶层标量键→`--<key>`)。网页名称/Logo 等业务语义由品牌顶层字段承担:网页名称=`title`、主页面/登录页 Logo=`logo_url`。历史 theme 中曾约定的 siteName/mainLogoUrl/loginLogoUrl/loginText 不再展示/编辑,保存时透传保留。
---
## 6. 2026-09-24 流程更正:迁入 frontConfig.* 8 接口
### 6.1 差异(旧 → 新)
| 能力 | 旧口径 | 新口径 |
|---|---|---|
| 品牌回显/保存 | `setting.warehouse.getFrontConfig` / `saveFrontConfig`(15 字段,含证书/同步) | `frontConfig.getInfo` / `saveInfo`(8 字段,不再混载证书) |
| 证书回显/上传 | `setting.warehouse.saveFrontCert`(`domain + pem + key` 一次提交) | `frontConfig.getCert` / `saveCert`(域名不再入参,一律取库内已验证记录;新增 `can_set_cert` 闸门) |
| 域名与 DNS 验证 | 无(仅随证书一起提交域名) | `frontConfig.getDomain` / `setDomain` / `checkDomain`(TXT 归属验证,未验证不可上传证书;换域名会清证书) |
| 公网拉品牌 | `frontConfig.getByDomain`(按 domain 查库) | 同方法,但**仅放行 domain_status=1 的已验证域名** |
### 6.2 前端落点
- API:`src/api/frontconfig/frontConfig.ts` 新增 7 个方法 + `FrontConfigInfo` / `FrontConfigDomain` / `FrontConfigCheckDomainResult` / `FrontConfigCert` / `FrontConfigSaveInfoParams` / `FrontConfigSaveCertParams` 类型 + `FRONT_DOMAIN_STATUS` 状态常量;`setting.warehouse.ts` 中 3 个旧封装与类型已移除。
- 页面:`.../newview/pages/FrontConfigForm.vue` 改为**左菜单 + 右内容**布局(参考微信小程序配置页),菜单为 **域名设置 → HTTPS 证书 → 品牌配置**:
- 域名菜单:`setDomain` 保存(生成 TXT 主机名/记录值,可一键复制)+ `checkDomain` 校验 + 「刷新状态」仅重查 `getDomain`;
- 证书段:`getCert` 回显(cert_pem/key_pem 与复制入口)、`can_set_cert=false` 时置灰「上传证书」并提示原因、证书到期/临期告警、同步状态与错误展示;
- 品牌段:`getInfo` 回显 + `saveInfo` 保存(保留历史 theme 透传与自定义 CSS 变量键值编辑),底部展示 `updated_at`。
- 加载:三个接口 `Promise.all` 并行拉取,均未配置时返回默认空值而非 404。
### 6.3 验收回归建议(增量)
- ① 新增域名 → `getDomain` 返回 verify_host/verify_value 且 domain_status=0,上传证书按钮置灰并提示「域名待验证」;
- ② 添加 TXT 后 checkDomain → domain_status=1,上传入口解禁,且已配置证书被清空(换域名场景);
- ③ 未验证域名直接调 saveCert → 400「域名未通过验证,暂时无法上传证书」;无域名 → 400「请先设置并验证域名」;
- ④ 未验证域名访问 `getByDomain` → 404「域名未配置」→ 前端保持默认品牌;
- ⑤ 品牌保存 → `getInfo` 回显一致,`updated_at` 刷新,同步状态重置为待同步。

View File

@ -0,0 +1,162 @@
# 前端独立部署 · 操作与部署说明(C2)
> 适用:仓库「自持域名 + 品牌化」的配置与部署运维。关联任务清单 `docs/前端独立部署-接口落实任务清单.md`。
> 关联接口(前端独立部署模块 `frontConfig.*`,共 8 个):
> - 公网消费端:`frontConfig.getByDomain`(免登录免鉴权,按 hostname 拉品牌)
> - 品牌配置:`frontConfig.getInfo` / `frontConfig.saveInfo`
> - 域名与 DNS 验证:`frontConfig.getDomain` / `frontConfig.setDomain` / `frontConfig.checkDomain`
> - 证书:`frontConfig.getCert` / `frontConfig.saveCert`
>
> 已废弃口径:`setting.warehouse.getFrontConfig / saveFrontConfig / saveFrontCert`(域名+证书一步提交的时代)。
---
## 1. 使用链路(速览)
```
仓库侧(本系统 ·「前端独立部署」标签页) 后端 部署后的浏览器
──────────────────────────────────────────────────────────────────────────────
1 保存自持域名(setDomain) → 生成校验子域 verify_host + 校验值 verify_value
domain_status=0(未验证)
2 域名服务商添加 TXT 记录 → 点「校验 DNS」(checkDomain)
→ domain_status=1(已验证)/ 2(验证失败)
3 上传证书 pem/key(saveCert,域名取库内已验证 domain)
→ 校验:可解析→未生效/过期→SPKI 配对→SAN/CN 覆盖域名
→ 写 cert_expire_at;crontab 脚本部署证书回填 cert_path/key_path
4 保存品牌 title/logo/favicon/login_bg/theme(saveInfo)
→ 重置同步状态并清公共缓存
5 访问 https://<自持域名>/... │
▼
免鉴权 frontConfig.getByDomain(domain) ← 按 hostname 拉品牌
应用:网页名称(title)/主页面·登录页 Logo(logo_url)/背景/favicon、
document.title、其余 theme 键→CSS 变量(theme 不再承载业务键)
```
- 顺序硬约束:**先域名并通过 DNS 校验(domain_status=1),才能上传证书**。
- **域名变更会清空既有证书并重置同步状态**(避免 nginx 继续用旧域名证书对外服务),需重新上传证书。
- 品牌与「域名 / 证书」**分开保存**、互不覆盖(`saveInfo` 白名单静默忽略 domain 与证书字段)。
- 证书的部署落地由**后端 crontab 脚本**完成,前端只负责 PEM 文本上传与状态展示。
---
## 2. 仓库侧操作(网页后台)
入口:**系统设置 → 基础设置(仓库设置)→「前端独立部署」标签页**(`basicManagement/newview` 独立表单页 `FrontConfigForm.vue`,由 `config/template-config.ts` 的 `tabPages` 注册;已不再挤在基础设置页内)。
页面为**左侧菜单 + 右侧内容**布局(与「微信小程序」标签页一致):左侧三个菜单 **域名设置 → HTTPS 证书 → 品牌配置**(顺序与接口调用一致,菜单项带状态标签:域名待验证 / 证书同步失败 / 待域名验证),右侧为对应菜单的表单与告警;右侧内容区独立滚动。
### 2.1 域名设置与 DNS 归属验证(setDomain / getDomain / checkDomain)
1. 填写 自持域名 `domain`(≤100,全局唯一,统一转小写;多段标签、每段 1~63 位字母数字与连字符)。
2. 点击「保存域名」→ `frontConfig.setDomain`:
- 生成一次性校验子域 `verify_host`(形如 `wmsv-<10 位 hex>.<domain>`)与校验值 `verify_value`(32 位 hex),`domain_status=0`(未验证);
- 域名已被其他仓库占用 → 409「域名 X 已被其他仓库使用」;
- **域名变更(仅大小写差异不算变更)会清空既有证书并重置同步状态。**
3. 到域名服务商为该主机名添加 **TXT 记录**(值为 `verify_value`),前端部署按 CNAME 指向 `cname`。
4. 点击「校验 DNS」→ `frontConfig.checkDomain`:
- 通过 → `domain_status=1`(已验证),写入 `verified_at`,并清理该域名的公共拉取缓存;
- 失败 → `domain_status=2`(验证失败),`attempts` +1,页面展示 `last_error`(如「未解析到 TXT 记录」「TXT 记录未包含校验值」)。
- 说明:解析走 DoH 优先、失败降级系统 DNS;DNS 生效有延迟,稍后重试即可。
- 「刷新状态」按钮:仅重查 `frontConfig.getDomain`,刷新验证状态与 TXT 信息,不覆盖尚未保存的域名输入(顶部「刷新」则整页重拉三段)。
### 2.2 上传 HTTPS 证书(getCert / saveCert)
1. 页面回显当前仓库证书 `cert_pem` / 私钥 `key_pem`,可直接修改后重新上传。
2. 粘贴 证书 PEM `pem`(≤65536)、私钥 PEM `key`(≤65536)。
3. 点击「上传证书」→ `frontConfig.saveCert`:
- **域名不再是入参**,一律取库内已设置并验证通过的 `domain`;
- 前置闸门:无域名 → 400「请先设置并验证域名」;`domain_status≠1` → 400「域名未通过验证,暂时无法上传证书」;
- 前端按 `getCert` 返回的 `can_set_cert` / `can_set_cert_reason` 置灰上传入口(无域名「请先设置域名」/ 未验证「域名待验证」/ 失败「域名验证失败」)。
成功后自动:
- 写入 `cert_expire_at`(以证书 validTo 为准);
- 重置同步状态 `sync_status=0`(页面「证书状态」展示同步状态、尝试次数、最近同步时间);
- 清空当前域名的公共缓存(后端处理)。
### 2.3 保存品牌配置(getInfo / saveInfo)
- 字段:
- 站点标题 `title`(≤100)
- Logo `logo_url`、favicon `favicon_url`、登录背景 `login_bg_url`(各 ≤255)
- 主题 `theme`:仅承载“自定义 CSS 变量”键值,保存时组装为 JSON 对象
- 每个键即前端 CSS 变量名(如 `primary`→`--primary`),值支持文本或 JSON(对象/数组/数字/布尔);应用时顶层标量键写入 `--<key>`
- 网页名称/Logo 等业务字段一律使用上方品牌顶层字段配置:网页名称=`title`、主页面/登录页 Logo=`logo_url`、登录背景=`login_bg_url`、favicon=`favicon_url`(`getByDomain` 读取、`saveInfo` 保存)
- 历史 theme 中曾约定过的 `siteName/mainLogoUrl/loginLogoUrl/loginText` 不再展示与编辑,保存时原样透传保留(不丢失历史数据)
- 品牌字段留空即清空该字段;主题自定义键删空全部行=清空主题。
- 点击「保存品牌配置」→ 成功后自动刷新回显(面板底部展示 `updated_at` 最近更新)。
- 说明:此处不受理 `domain`/证书字段(后端白名单静默忽略,不报错也不生效)。
---
## 3. 证书准备(PEM 与 SAN)
- 证书 `pem`:X.509 证书的 PEM 文本,形如
```
-----BEGIN CERTIFICATE-----
...
-----END CERTIFICATE-----
```
- 私钥 `key`:证书对应私钥的 PEM 文本,形如
```
-----BEGIN PRIVATE KEY----- (或 -----BEGIN RSA PRIVATE KEY-----)
...
-----END PRIVATE KEY-----
```
- 必须满足:
- 证书可解析、当前已生效、未过期;
- 私钥与证书成对(后端按 SPKI 公钥指纹比对);
- 证书 `SAN DNS` / `CN` 覆盖**库内已保存的 `domain`**(支持精确匹配与 `*.example.com` 通配,通配仅覆盖恰好一级标签:`*.a.com` 覆盖 `b.a.com`,不覆盖 `x.y.a.com`)。
- 生成(示意,正式环境请用 CA 签发):
```bash
# 自签测试证书(SAN 包含 domain)
openssl req -x509 -newkey rsa:2048 -nodes -days 365 \
-keyout key.pem -out cert.pem \
-subj "/CN=self.example.com" \
-addext "subjectAltName=DNS:self.example.com,DNS:*.example.com"
# 分别把 cert.pem、key.pem 内容填入页面
```
- 提示:同一证书可在 SAN 里放多个域名;换域名/加域名需先 `setDomain` + `checkDomain` 通过,再重新上传证书。
---
## 4. 常见错误对照
| 现象 / 返回 | 原因 | 处理 |
|---|---|---|
| 400「域名不能为空」/「domain 格式不正确」/「domain 长度不能超过 100 字符」 | `setDomain` 入参缺失、形态非法(含通配符、下划线、单段主机名等)或超长 | 填 至少两段标签、每段 1~63 位字母数字与连字符(首尾不得为连字符)、≤100 字符 |
| 409「域名 X 已被其他仓库使用」 | `domain` 全局唯一,已被占用 | 换未占用域名,或联系占用方释放 |
| 400「请先设置域名」 | `checkDomain` 时库内无域名 | 先走「保存域名」(setDomain) |
| 400「请先设置并验证域名」 | `saveCert` 前尚未设置域名 | 先 setDomain → 添加 TXT 记录 → checkDomain |
| 400「域名未通过验证,暂时无法上传证书」 | `domain_status≠1`(未验证/验证失败) | 确认 TXT 记录已生效后点「校验 DNS」;页面按 `can_set_cert_reason` 置灰上传入口 |
| 校验 DNS 失败:未解析到 TXT 记录 / TXT 记录未包含校验值 / DNS 解析失败 | TXT 记录未添加、主机名写错、未生效或值不一致 | 核对「TXT 主机名 + TXT 记录值」(`verify_host` / `verify_value`),DNS 生效后重试 |
| 400「证书不合法」(统一文案,不返回细节) | 证书无法解析 / 未生效或已过期 / 私钥与证书不匹配 / SAN 或 CN 未覆盖库内 domain | 检查 PEM 完整性与配对、有效期、SAN 是否包含域名;用 `openssl x509 -in cert.pem -noout -text` 核对 |
| 400「pem/key 内容长度不能超过 65536 字符」 | 证书/私钥文本过大 | 检查是否误粘贴多个证书 |
| 保存品牌后 `getByDomain` 仍返回旧值 | 缓存 600s 内 | 等缓存过期;`saveInfo` / `saveCert` 成功后后端会自动清该域名缓存 |
| 上传成功但 `sync_status=1/2` | 证书部署/同步中或失败 | 看「证书状态」的同步状态与 `last_sync_error`,按需重新上传 |
| 域名已生效但 `cert_expire_at` 为空 | 证书未上传 | 补传证书(saveCert) |
| 访问自持域名仍是默认品牌(`getByDomain` 404「域名未配置」) | 域名未验证(`domain_status≠1`)、未登记、或前端豁免域名命中(主域名会跳过拉取) | 先完成 DNS 校验;确认 `.env` 的 `VITE_FRONT_CONFIG_EXEMPT_HOSTS` 未把该域名当作主域名豁免 |
---
## 5. 前端侧部署与验证
1. 把本系统部署(或已有部署)解析到自持域名:按页面「CNAME 指向」把 `<自持域名> -> <cname>`,并配置 HTTPS(证书由后端部署链路提供,前端不需持证)。
2. 浏览器访问 `https://<自持域名>`:前端入口自动按 `location.hostname` 调 `frontConfig.getByDomain` 应用品牌。
- 生效项:网页名称=`title`(登录页标题与 document.title)、主页面/登录页 Logo=`logo_url`、登录背景、favicon;其余 `theme` 键→CSS 变量(`--<key>`)。登录页文字无独立配置字段,用默认标语“现代化仓储管理系统 - 助力企业高效运营”。
3. 未登记域名 / 未验证域名(`domain_status≠1`)/ 直连主域名(命中 `VITE_FRONT_CONFIG_EXEMPT_HOSTS`):接口返回 404 / `configured=false` → 前端静默使用系统默认品牌(无报错)。
4. 本地联调建议:改 hosts 把自持域名指向本机测试环境即可看到品牌效果;注意本地调试可把 `VITE_FRONT_CONFIG_EXEMPT_HOSTS` 置空(不豁免)以验证品牌;确认无旧品牌残留可清理站点数据后刷新。
5. **多仓库同一部署的域名解析(A6)**:一套前端部署可同时服务多个仓库——
- 各仓库在各自「前端独立部署」标签页里登记自己的 `domain`(一仓一行、`domain` 全局唯一)并通过 DNS TXT 校验,各自保存品牌/证书;
- 后端按访问 hostname 从 `wms_warehouse_front_config` 及缓存 `front:config:domain:{domain}` 返回对应仓库的公开品牌;
- 前端仅按 `location.hostname` 调 `frontConfig.getByDomain`,对“多仓库同部署”无感知;
- `saveInfo` / `setDomain` / `checkDomain` / `saveCert` 成功后后端会自动清理相关域名缓存,因此换域名/改品牌基本即时生效(600s 缓存窗口内读到旧值属正常,无需前端处理);
- 访问主域名或未登记/未验证域名 → 返回 404 / `configured=false` → 前端走系统默认品牌。
---
## 6. 前端已落点速查(代码)
| 层 | 文件/位置 |
|---|---|
| API 封装 | `src/api/frontconfig/frontConfig.ts`(`frontConfig.*` 8 个方法:getByDomain / getInfo / saveInfo / getDomain / setDomain / checkDomain / getCert / saveCert) |
| 配置管理(独立标签页) | `src/views/system/setting/basicManagement/newview/pages/FrontConfigForm.vue`(域名设置 + HTTPS 证书 + 品牌配置);tab 注册:`.../newview/config/template-config.ts` `tabPages`(name=`frontConfig`);基础设置页已移除该区块(`.../pages/WarehouseSettingsForm.vue` 仅剩仓库配置) |
| 品牌 store | `src/stores/modules/frontBrand.ts`(loadBrandByDomain / applyThemeCssVars / applyBrandGlobals) |
| 入口触发 | `src/main.ts` |
| 登录页品牌 | `src/views/login/index.vue` |
| 标题/favicon | `src/permission.ts` + `src/utils/get-page-title.ts` |

View File

@ -0,0 +1,291 @@
# 命名规范与 TS1261(文件名大小写)修复指南
> **给 AI 助手的执行说明**
> 本文档用于修复本仓库在 Windows 上因「目录/文件名大小写不一致」导致的 `TS1261 / TS1149` 类型检查失败。
> 第 4 节是**执行步骤**,第 5 节是**可直接运行的审计脚本**,第 6 节是**验收标准**,第 7 节是**禁止事项(务必先读)**。
> 所有命令均为 PowerShell(Windows)。执行前请先读完第 2、3 节理解原理,避免"反向修复"。
---
## 1. 项目命名规范(硬性约定)
| 范围 | 规范 | 示例 |
| --- | --- | --- |
| `src/api/` 的**一级目录名** | **必须全小写**,与 API 模块文档的 `folder` 字段完全一致 | `storewarehouse.warehouse`、`storewarehouse.store`、`storage.inventory`、`order.wave` |
| `src/api/` 目录名 | 允许小写字母、数字、`.`、`_`;**禁止驼峰** | ✅ `order.deliveryorder` ❌ `order.deliveryOrder` |
| `src/api/` 下的文件名 | 可以用驼峰(这是正常的) | `storeWarehouse.ts`、`inventory.ts` |
| 其它目录(`src/views`、`src/components` …) | 以 **git 索引为准**,磁盘必须与索引完全一致(索引里有驼峰目录是正常的,如 `src/views/Externalwarehouse`) | — |
| 代码里的 `import` 路径 | **大小写必须与磁盘(= git 索引)完全一致,逐字符匹配** | ✅ `@/api/storewarehouse.warehouse/storeWarehouse` |
| Git 配置 | 仓库级 `core.ignorecase` 必须为 `false` | `git config core.ignorecase false` |
**判断"谁是对的"的唯一依据 = git 索引**:
```powershell
git ls-tree --name-only HEAD:src/api # 看提交树里的真实目录名(权威)
git ls-files src/api # 看索引里的路径
```
不要用「我本机磁盘是这样的」来当依据 —— Windows 磁盘改名对 git 可能不可见(见第 2 节)。
---
## 2. 为什么会报 TS1261(原理)
报错原文形如:
```
error TS1261: Already included file name 'D:/repo/src/api/storeWarehouse.warehouse/storeWarehouse.ts'
differs from file name 'D:/repo/src/api/storewarehouse.warehouse/storeWarehouse.ts' only in casing.
The file is in the program because:
Imported via '@/api/storeWarehouse.warehouse/storeWarehouse' from file '.../shipperSigning/index.vue'
Matched by include pattern 'src/**/*' in 'tsconfig.app.json'
```
三个条件叠加导致:
1. **Windows 文件系统不区分大小写**,因此 `storewarehouse.warehouse` 和 `storeWarehouse.warehouse` 在磁盘上"看起来"是同一个目录,很容易被改名而没人发现。
2. `tsconfig.app.json` 使用 `"include": ["env.d.ts", "src/**/*", "src/**/*.vue"]` —— glob 是按**磁盘上的真实大小写**把文件收进编译程序的。
3. TypeScript 的 `forceConsistentCasingInFileNames`(TS 5 起默认 `true`)会把"同一个文件以两种大小写被收录"判定为错误 → **TS1261 / TS1149**。
**关键推论**:
> 同一个文件,只要 **import 里的大小写** 与 **磁盘上的真实大小写** 不一致,就必然报 TS1261。
> 磁盘与 git 索引不一致时,改 import 只能让「本机通过」,代价是其它所有机器失败。
### 2.1 为什么 git 没记录这次改名
仓库级配置 `core.ignorecase = true`(Windows 上 git 的默认值)。
* 它让 git 认为文件系统大小写不敏感,于是**只改大小写的改名对 git 完全不可见**(`git status`、`git mv`、`git add` 都不反映)。
* 结果:某台机器把磁盘目录改成了驼峰,**只有它本机变了**;git 索引/提交树里仍然是原来的小写目录。
* 于是出现"镜像互坑":谁把 import 改成自己磁盘的样子,就把对方弄挂。
| 磁盘目录名 | 小写 import | 驼峰 import |
| --- | --- | --- |
| `storewarehouse.warehouse`(git 索引真值 / 所有正常克隆) | ✅ 通过 | ❌ TS1261 |
| `storeWarehouse.warehouse`(被改过名的机器) | ❌ TS1261 | ✅ 通过 |
---
## 3. 本次案例的事实核对(2026-09 实测,可直接采信)
| 项目 | 结论 |
| --- | --- |
| git 索引中 `src/api` 一级目录名 | **全部小写,无任何大写字母**(共 60 个一级目录) |
| `src/api/storewarehouse.warehouse` | 该目录在 git 索引 / 提交树中**始终是全小写**(`7afc669`、`9532289`、`cc9c0f7` 三个提交树一致) |
| 提交 `cc9c0f7` | 把两个页面的 import 从 `@/api/storewarehouse.warehouse/…` 改成 `@/api/storeWarehouse.warehouse/…`;`git ls-tree cc9c0f7:src/api/storeWarehouse.warehouse` → `fatal: Not a valid object name`(该路径在仓库中**不存在**) |
| 隔离实测(临时 worktree 检出 `cc9c0f7` + 独立 `vue-tsc --build --force`) | ❌ ExitCode=2,报 TS1261 |
| 隔离实测(把 import 回退为小写,即 `9532289` 状态) | ✅ ExitCode=0 |
**结论:真值是小写。`cc9c0f7` 是反向修复,需要用「磁盘改名」而不是「改 import」来修复。**
涉及的两个文件(import 行):
* `src/views/Externalwarehouse/shipperSigning/index.vue`
* `src/views/store/shipperSigning/index.vue`
正确写法:
```ts
import { storeWarehouseWarehouseList } from '@/api/storewarehouse.warehouse/storeWarehouse'
import { storeWarehouseUnbind, storeWarehouseRename, storeWarehouseConfirmSign } from '@/api/storewarehouse.store/storeWarehouse'
```
---
## 4. 修复步骤(在「命名有问题的设备」上执行)
### Step 0 — 保护本地工作
先把未提交的本地改动提交到自己的分支,或者 `git stash`。
> ⚠️ **在磁盘改名完成之前,绝对不要执行 `git add -A` / `git add .` / 提交**。否则错误的大小写会被写进 git 索引并推到远端,问题会扩散给所有人。
```powershell
git status --short
```
### Step 1 — 定位所有不一致(先看清单,再动手)
先执行第 5 节的**审计脚本**,得到"索引名 vs 磁盘真实名"的不一致清单。
快速检测(把 git 临时切换成大小写敏感模式,不一致会显示成**成对**的 ` D …` + `?? …`):
```powershell
git -c core.ignorecase=false -c core.quotepath=false status --porcelain
```
* 输出为空 → 磁盘与索引一致,跳到 Step 5。
* 有输出 → 继续 Step 2,逐个改名。
### Step 2 — 改磁盘目录名(Windows 只改大小写**必须两步**)
Windows 上直接 `Rename-Item a b`(仅大小写不同)会认为"名字没变"而失败,必须借道一个临时名:
```powershell
# 目标:把 src\api 下被改成驼峰的目录改回索引里的小写名
Set-Location <仓库根目录>\src\api
Rename-Item -LiteralPath storeWarehouse.warehouse -NewName storeWarehouse.warehouse.__casefix
Rename-Item -LiteralPath storeWarehouse.warehouse.__casefix -NewName storewarehouse.warehouse
```
* 新名字**必须逐字符等于 git 索引里的名字**(本仓库 = 全小写)。
* 目录内文件不用动(文件名的所属层级不变)。
* 因为索引里本来就是小写,所以**不需要也不应该** `git mv`,改完 git 不会有任何 diff(这是正常的、期望的结果)。
确认磁盘真实名(**必须用精确正则**):
```powershell
cmd /c dir /b src\api | Select-String -CaseSensitive -Pattern "^storewarehouse|^storeWarehouse"
```
期望:只有 `storewarehouse.store` 和 `storewarehouse.warehouse`;`^storeWarehouse` 一行都没有。
### Step 3 — 让 git 以后能发现这类问题
```powershell
git config core.ignorecase false # 仓库级配置,每台设备都要各自执行一次
```
### Step 4 — 复核
```powershell
git status --short # 期望:干净,或只剩你自己的业务改动;不应再出现成对的 删除+未跟踪
```
如仍有成对条目,回到 Step 2 继续改名,直到干净。
### Step 5 — 拉取并验收
```powershell
git pull
# 自检 1:不应存在任何 "@/" 开头的驼峰 api 目录引用(期望:无输出)
git grep -n -E "@/api/[A-Z]" -- "src/**"
# 自检 2:确认 api 引用与磁盘一致(期望:输出的目录名都是全小写)
git grep -n -E "@/api/[a-zA-Z]" -- "src/**" | Select-Object -First 20
# 自检 3:类型检查
npm run type-check # 期望:ExitCode=0,无 TS1261
```
### Step 6 — 兜底方案(最省事,推荐在无本地独有改动时使用)
如果该设备本地没有独有改动(改动已推送或已丢弃),**直接删除目录重新 clone** 最稳:磁盘布局会按 git 索引一次性还原成正确大小写,不需要逐个改名。
```powershell
git push <自己的分支> # 如有本地提交
# 然后重命名/删除旧目录,重新 git clone,再 npm install
```
---
## 5. 审计脚本(只读,不修改任何文件)
保存为 `audit-case.ps1`,在**仓库根目录**执行:`powershell -ExecutionPolicy Bypass -File .\audit-case.ps1`
* 输出 `OK: disk names match git index exactly ...` 表示大小写完全一致。
* 对本仓库实测输出:`OK: disk names match git index exactly (checked 624 ASCII paths, skipped 14 non-ASCII paths)`。
* 脚本刻意只用 ASCII 输出(中文在 GBK 终端下会乱码),并跳过含中文的路径(`docs/*.md` 等永远不会被 import,与 TS1261 无关)。
```powershell
# ===== 大小写一致性审计:对比 git 索引路径 与 磁盘真实路径 =====
# 只读操作,不修改任何文件。
$root = (git rev-parse --show-toplevel).Trim()
Set-Location $root
$listingCache = @{}
function Get-Listing([string]$dir) {
if (-not $listingCache.ContainsKey($dir)) {
$listingCache[$dir] = @(Get-ChildItem -LiteralPath $dir -Force -ErrorAction SilentlyContinue)
}
return $listingCache[$dir]
}
# 必须加 core.quotepath=false,否则含中文的路径会被 git 转义成 "\350\..."
$files = @(git -c core.quotepath=false ls-files)
$bad = [System.Collections.Generic.List[string]]::new()
$skipped = 0
foreach ($f in $files) {
if ($f -notmatch '^[\x20-\x7E]+$') { $skipped++; continue }
$segs = $f -split '/'
$cur = $root
for ($i = 0; $i -lt $segs.Count; $i++) {
$name = $segs[$i]
$items = Get-Listing $cur
$exact = $items | Where-Object { $_.Name -ceq $name } | Select-Object -First 1
if ($exact) { $cur = $exact.FullName; continue }
# 磁盘上找不到「逐字符相同」的名字,但可能存在「仅大小写不同」的名字
$ci = $items | Where-Object { $_.Name -ieq $name } | Select-Object -First 1
if ($ci) {
$bad.Add("index: " + (($segs[0..$i]) -join '/') + " disk: " + $ci.Name + " (parent: " + $cur + ")")
} else {
$bad.Add("in index but missing on disk: " + (($segs[0..$i]) -join '/'))
}
break
}
}
$bad = $bad | Sort-Object -Unique
if ($bad.Count -eq 0) {
Write-Host ("OK: disk names match git index exactly (checked " + ($files.Count - $skipped) + " ASCII paths, skipped " + $skipped + " non-ASCII paths)")
} else {
Write-Host ("Found " + $bad.Count + " case mismatch(es), rename the disk entry to the index name:")
$bad | ForEach-Object { Write-Host (" " + $_) }
}
```
**成对改名的辅助写法**(对审计结果里每一条 `index: xxx disk: XXX`):
```powershell
$parent = "<父目录,来自审计输出的 (parent: …)>"
$diskName = "<磁盘上的真实名,来自审计输出的 disk:XXX>"
$indexName = "<索引里的名字,来自审计输出的 index:xxx 最后一段>"
Set-Location $parent
Rename-Item -LiteralPath $diskName -NewName ($diskName + ".__casefix")
Rename-Item -LiteralPath ($diskName + ".__casefix") -NewName $indexName
```
---
## 6. 验收标准(全部满足才算修复完成)
1. `git -c core.ignorecase=false -c core.quotepath=false status --porcelain` 输出为空(或只剩自己的业务改动)。
2. 第 5 节审计脚本输出以 `OK:` 开头(且 `Found` 计数为 0)。
3. `git grep -n -E "@/api/[A-Z]" -- "src/**"` 无输出。
4. `npm run type-check` → `ExitCode=0`,无 `TS1261` / `TS1149`。
5. `git config --get core.ignorecase` → `false`。
---
## 7. 禁止事项与常见坑
| 禁止 / 注意 | 说明 |
| --- | --- |
| ❌ 用「改 import 大小写」去适配自己本机的磁盘 | 这是本次问题的根源(提交 `cc9c0f7`)。真值在 git 索引里,不要在本地反向同步 |
| ❌ 在磁盘改名完成前执行 `git add -A` | 会把错误大小写写进索引并推到远端 |
| ❌ 单步 `Rename-Item a b`(仅大小写差异) | Windows 上会失败/无效,必须借道 `.__casefix` 再改回来 |
| ❌ 用 `Select-String -Pattern "store"` 判断目录大小写 | `storeWarehouse` 里也含 `store`,区分不出来。必须用 `-CaseSensitive -Pattern "^storewarehouse"` / `"^storeWarehouse"` |
| ❌ 用 `findstr /i`、`grep -i` 判断大小写 | 同上,必须区分大小写 |
| ❌ PowerShell `Remove-Item <junction> -Recurse` | 5.1 下可能递归删除**链接目标**的内容;删 junction 请用 `cmd /c rmdir "<path>"`(不带 `/s`) |
| ⚠️ 用 junction 把 `node_modules` 链接进临时 git worktree,再 `git worktree remove --force` | git 会递归进 junction,**删除主工作区 `node_modules` 里排序靠前的条目**(`.bin`、`.package-lock.json`、`.modules.yaml` 等)。正确清理顺序:先 `cmd /c rmdir "<tmp>\node_modules"`,再 `Remove-Item <tmp> -Recurse -Force`,最后 `git worktree prune`;万一已误删,主工作区 `npm install` 可恢复 |
| ⚠️ `core.ignorecase=false` 的执行时机 | 必须在磁盘改名**之后**再开启。若磁盘仍是驼峰就开启,`git status` 会立刻出现大量成对的「删除 + 未跟踪」,此时**不要** `git add` |
| ⚠️ `git grep` 与 `Select-String` 的默认行为 | `git grep` 默认区分大小写;PowerShell `Select-String` 默认**不区分**,需要 `-CaseSensitive` |
---
## 8. 相关提交与文件索引
| 对象 | 说明 |
| --- | --- |
| `cc9c0f7` | ❌ 反向修复:把 2 处 import 改成驼峰 `@/api/storeWarehouse.warehouse/…`,在所有磁盘为小写的机器上复现 TS1261 |
| `9532289` | `cc9c0f7` 的父提交,import 为正确的小写 |
| `7afc669` | 更早的提交,同样是小写 |
| `src/views/Externalwarehouse/shipperSigning/index.vue` | import 行约 143 行 |
| `src/views/store/shipperSigning/index.vue` | import 行约 195 / 196 行 |
| `tsconfig.app.json` | `include: ["env.d.ts", "src/**/*", "src/**/*.vue"]`,TS1261 的触发条件之一 |
| `package.json` | `type-check` = `vue-tsc --build` |

View File

@ -0,0 +1,312 @@
# 打印组件连接:登录自动尝试 / 持久化防断连 / 增强失败自动重连
- 状态:**已废弃**(v1.0 草案,含“多入口自动尝试”设计)
- 日期:2026-09-04
- **取代文档**:`docs/打印组件连接-登录一次连接与失败重连方案.md`(v1.1,按用户口径收敛为“登录一次连接 / 复用不断连 / 失败驱动自动重连”),本文档不再使用
- 范围:`order/waveOrder` 及 `order/orderManagement`(pendingOrder / deliveryOrder / exceptionOrder)等提供「批量打印(平台数据)」的页面所用的**打印组件连接链路**
- 原则:**不改动打印协议与载荷**(print.ts 的 payload / 组件消息协议保持现状),只优化「连接生命周期、失败重连、配置持久化」三部分
- 关联正式方案:`docs/用户偏好配置-浏览器本地保存方案.md`(v1.1,配置持久化的唯一依据,本文在此之上扩展“仓库”维度)
---
## 1. 背景与目标
“批量打印(平台数据)”会把面单直接通过**浏览器 WebSocket 直发本机打印组件**(抖音 / 拼多多 / 快手 / 京东 / 菜鸟 / 视频号 / 小红书 / LODOP 等 8 个本地控件)。当前连接体验存在三类问题,对应本方案三个目标:
| # | 目标 | 现状痛点 |
|---|------|----------|
| 1 | 登录后 / 进入打印页**自动尝试连接一次**打印组件 | 连接仅在登录成功的那个时间点尝试一次;若当时控件未启动,之后进入打印页/打开打印弹窗**不会自动再试**,需手动点“重连” |
| 2 | 组件连接**持久化**,切换页面后**不断连、不需重新连接** | 组件在后台可能被本地控件重启/断开;开关页回来后若失败自动重连关闭,就显示“未连接”需手动重连 |
| 3 | **增强失败自动重连**:可设置哪些组件“失败自动尝试 / 排除自动重连”;配置**分用户 + 分仓库持久化**(与表格字段排序等用户偏好同模式) | 现有“失败自动重连”是**浏览器全局布尔**,不分用户/仓库;只能整开整关,不能按组件排除 |
> 说明:仓库(warehouse)维度取自当前登录上下文 `userStore.user?.warehouse_id ?? userStore.user?.store_id`(代码中已有同类取值先例)。控件安装在“本机/本仓”,不同仓库常用平台不同,因此“哪些组件参与自动重连”需要按 **用户 + 仓库** 分别记忆。
---
## 2. 现状梳理(关键代码位置)
| 文件 | 角色 | 现状要点 |
|------|------|----------|
| `src/core/printerComponentCore.ts` | 连接引擎(模块级单例) | WebSocket 长连接 map;`autoReconnectEnabled` 全局布尔默认 `false`;失败重连固定间隔 `3000ms`、**无退避/无上限/无按组件排除**;`connectGeneration` 已防竞态;`initAll/setAutoReconnectEnabled/reconnectAll/disconnectAll` 遍历的是模块常量 `DEFAULT_PRINTER_COMPONENTS` 而非 `this.ports`(小瑕疵) |
| `src/core/printerRuntime.ts` | 生命周期门面 | `initPrinterRuntime()`(main 启动,仅挂消息);`startPrinterComponentConnections()`(`connectionsStarted` 置位,**会话内只一次**,登录成功调用);`ensurePrinterConnectionsForBrowserPrint()`(打印前调用,当前只是置位标记,**不实际建连**);`stopPrinterComponentConnections()`(登出断开) |
| `src/core/printerComponentConnection.ts` | loopback/HTTPS 环境检测 + preflight | 无需改(仅被复用) |
| `src/stores/modules/printerComponent.ts` | 连接状态 Pinia store | 全局布尔 key `printer_component_auto_reconnect`(localStorage,**不分用户/仓库**);`bindRuntimeEvents` 于 main.ts 挂一次 |
| `src/stores/modules/userPreference.ts` | 用户偏好 store(localStorage) | key=`user_prefs_{userId}`,按 scope 存 `{value,updated_at}`;**目前只有 user 维度,无仓库维度**;`load()` 挂在 permission 守卫 getInfo 成功后 |
| `src/stores/modules/user.ts` / `src/permission.ts` | 登录/登出接入 | login / getInfo 成功后 `startConnections()`;logout / resetToken 时 `stopConnections()` |
| `src/views/order/waveOrder/component/PrinterComponentConnectionPanel.vue` | 连接面板 UI(共享) | 含“失败自动重连”开关(全局)、连接概况、组件表格(名称/端口/状态/重连);**无逐组件配置** |
| `src/views/order/waveOrder/component/WavePlatformPrintPreviewDialog.vue` | 平台数据打印预览弹窗 | 打开时 `watch(modelValue)` 只 `refreshFromRuntime()`,**不自动尝试连接**;底部“打印组件连接”按钮内嵌连接面板;`allComponentsConnected` 未全连时“打印”禁用 |
| 打印流程 `src/views/order/waveOrder/config/print.ts` | 下发 | `sendWavePlatformBrowserPrint` 前调 `ensurePrinterConnectionsForBrowserPrint`(不实际连),随后校验未连接组件直接失败并提示去连接面板 |
| 页面(复用平台打印弹窗) | 入口 | `SandanWaveBatchListPanel.vue`、`GroupWaveBatchListPanel.vue`、orderManagement 的 `pendingOrder.vue / deliveryOrder.vue / exceptionOrder.vue`(经各自 `use-*.ts`);各面板含内嵌连接对话框;页面处于 `keep-alive`(index.vue / orderManagement index 用 KeepAlive + LRU) |
**关键结论**
1. 路由切换本身**不会**断开 WebSocket(模块级单例、无 onUnmounted 断连),痛点是“断连后无自愈 + 未连组件无自动尝试 + 开关/排除配置不可按用户/仓库记忆”。
2. “进入打印页/弹窗”与“打印前”都存在**可以且应该自动尝试一次**的时机,目前都未利用。
3. 失败自动重连从“全局布尔”升级为“**用户+仓库级配置 + 逐组件参与开关 + 退避重试**”即可同时覆盖三目标。
---
## 3. 方案总览
```mermaid
flowchart TB
subgraph P[打印相关页面 order/waveOrder 等]
E[进入页面/打开平台打印弹窗<br/>onMounted / onActivated / watch modelValue]
D[批量打印(平台数据) 下发前]
C[连接面板 / 设置弹窗]
end
subgraph S[printerComponent store(用户+仓库配置作用域)]
L[loadReconnectConfig 登录后/换仓后加载]
A[applyConfig 应用引擎]
T[autoTryConnectOnce 节流自动尝试]
W[watch 状态变更刷新 UI]
end
subgraph CORE[PrinterComponentCore 引擎]
R[失败自动重连<br/>退避 + 上限 + 排除集合]
O[one-shot 自动尝试<br/>连接代数防竞态]
H[健康检查/自愈<br/>page focus / 页签回前台]
end
subgraph STORE[localStorage 分用户+仓库]
PREFS[user_prefs_{userId}_{warehouseId}<br/>scope: printer.autoReconnect]
end
E -->|进入即自动尝试| T
D -->|下发前按配置自动尝试一次<br/>未连才报错| T
C -->|修改配置即存即生效| L
L --> A --> CORE
T --> CORE
T -.读配置(排除集合).-> PREFS
L -.读写.-> PREFS
CORE -->|状态/重连事件| W
CORE -->|断连触发| R
CORE -->|页面回前台触发| H
```
---
## 4. 数据与存储设计(分用户 + 分仓库)
### 4.1 身份与 key(userPreference 层扩展)
沿用 `userPreference` store(与标签/字段排序等用户偏好**同源同模式**),在其上引入**仓库维度**,并做向后兼容迁移:
```ts
// 新增:稳定取当前仓库标识(与订单页“仓库 ID 优先取行、其次登录上下文”一致)
function currentWarehouseId(): string {
const userStore = useUserStore()
const user = userStore.user || {}
const wh = user.warehouse_id ?? user.store_id
return wh != null && wh !== '' ? String(wh) : ''
}
// 存储 key:有仓库上下文时 用户+仓库,否则退化为现状 user_prefs_{userId}
function currentStorageKey(): string {
const wh = currentWarehouseId()
return wh ? `user_prefs_${currentUserId()}_${wh}` : `user_prefs_${currentUserId()}`
}
```
- **load()**:先读 `user_prefs_{userId}_{warehouseId}`(新主 key);无数据则回退读旧 key `user_prefs_{userId}`,读到后**一次性迁移**(同内容写回新 key,仅当有仓库上下文时)。
- **set / reset / persist**:一律写新 key;旧 key 保留不主动删(保守,避免回滚丢配置)。
- 无仓库上下文的部署 key 不变,完全向后兼容;已有标签顺序等旧配置通过回退迁移无缝保留。
- **身份变化时重载**:`changeRole` 成功(可能换仓)与 `userStore.getInfo` 成功后,若 `warehouse_id` 变化需重新 `load()`(可在 `userPreference` 内监听 user 或由调用方显式调用)。
- localStorage 满/禁用仍沿用 try/catch 降级内存态。
### 4.2 新 scope 与配置结构
scope 命名沿用规范 `<模块>.<能力>.<页面标识>`,本方案注册:
```
printer.autoReconnect
```
value 结构:
```ts
interface PrinterAutoReconnectConfig {
/** 主开关:是否开启“失败自动重连” */
enabled: boolean
/** 参与失败自动重连的组件;默认全部组件都参与 */
excluded: string[] // 排除名单(= 关闭逐组件开关的组件)
/** 基础重连间隔 ms,默认 3000 */
intervalMs: number
/** 退避上限 ms,默认 30000(可选字段,UI 可不暴露) */
maxIntervalMs: number
/** 连续失败达到该次数后暂停自动重连,默认 5(0=不限,可选字段) */
maxConsecutiveFailures: number
/** 进入打印页/打开打印弹窗时对未连接且未排除组件自动尝试一次,默认 true */
autoTryOnPageEntry: boolean
updated_at: number
}
```
> 术语对齐需求 3:“失败自动尝试”=组件参与 `enabled && !excluded` 的断线自动重连;“排除自动重连”=组件在 `excluded` 名单内(不自动尝试、不自动重连,仅可手动“重连”)。
### 4.3 旧全局开关迁移
- `printerComponent` store 启动读取时:若 `printer.autoReconnect` 尚无配置,则把旧 key `printer_component_auto_reconnect`(浏览器全局布尔)迁移为 `enabled`,然后写入新 scope;后续不再读写旧 key。
---
## 5. 连接引擎增强(`src/core/printerComponentCore.ts`)
在保留现有 `connectGeneration` 防竞态机制基础上扩展:
1. **配置化**
- 新增成员:`excluded = Set<string>`、`reconnectIntervalMs`、`maxIntervalMs`、`maxConsecutiveFailures`、`autoTryOnPageEntry`、`attempts = Map<name, number>`、`lastAutoTryAt`。
- `applyConfig(cfg)`:合并配置;**不关闭已连 socket**,只影响后续失败处理与重连节奏;主开关由关→开时,对“未连接且未排除”的组件触发一次连接尝试(沿用现有 `setAutoReconnectEnabled` 行为并收敛到 `this.ports`)。
- 辅助:`isExcluded(name)`、`shouldAutoReconnect(name) = enabled && !excluded`。
- 修正 `initAll / setAutoReconnectEnabled / reconnectAll / disconnectAll` 遍历 `this.ports`(而非模块常量),为将来“按仓库组件集”留口。
2. **失败自动重连(需求 3)**
- `onclose / onerror`:手动关闭(`_manualClose`)不处理;否则若 `shouldAutoReconnect(name)` → 走退避重连;若被排除 → 仅置为 disconnected(记录一次 `attempts` 供 UI 显示“已排除”)。
- `scheduleReconnect`:基础间隔 + 指数退避 `min(intervalMs * 2^attempts, maxIntervalMs)`;达到 `maxConsecutiveFailures` 后**暂停**(清 timer,标记 paused),等待手动重连 / 页面进入 auto-try / 页面回前台健康检查再重置。
- `onopen`:重置该组件 `attempts`。
3. **one-shot 自动尝试(需求 1)**
- `autoTryConnectOnce(names?: string[])`:对 `names`(缺省=全部注册组件)中“未 OPEN 且未排除”的组件各尝试一次 `initComponent`;内置节流(`lastAutoTryAt`,如 ≥3s)避免在打印页/弹窗反复进出时抖动。
- 手动 `reconnectComponent(name)` 不受排除限制,始终可用,并重置 `attempts`。
4. **健康检查 / 自愈(需求 2)**
- `healthCheck()`:遍历参与组件,对已断开者按节流自动尝试一次;由 store 在“打印页激活 / 弹窗打开 / tab 回前台(visibilitychange)”触发,使切换页面或控件重启后回来能自愈,无需手点。
5. **事件补充**:`printerComponentStatusChange` 之外增发 `printerReconnectStateChange`(含 attempts / paused / excluded 信息),供 UI 显示“连续失败 N 次/已暂停/已排除”。
> 边界:不做心跳保活(本地控件长连接本就稳定,多为控件进程重启导致断开);保持“断连→自愈”即可。
---
## 6. 运行时与生命周期接入
### 6.1 `src/core/printerRuntime.ts`
- `startPrinterComponentConnections()`:保持“登录成功后初始化并连接一次”;同时改为读取并应用当前(用户+仓库)重连配置(无 token/无仓库信息也安全)。
- 新增导出:`loadAndApplyReconnectConfig()`、`autoTryConnectOnce(names?)`、`healthCheck()` 薄封装(内部调 core,并做节流)。
- `ensurePrinterConnectionsForBrowserPrint(names?)`:从“仅置位”升级为“置位 + `autoTryConnectOnce(names)` 自动尝试一次”,使打印下发路径能自愈(见 §6.4)。
- 登出 `stopPrinterComponentConnections()`:保持断开(登出后清空连接,符合预期);**文档化唯一断连点**。
### 6.2 登录/会话接入
- `main.ts` `bindRuntimeEvents()` 后:`printerComponent` store 在 `bind` 时读取并应用持久化配置(先 `load` 用户偏好)。
- `permission.ts` getInfo 成功后:现有 `startConnections()` 保留(登录自动尝试一次 → 需求 1 会话级);随后 `loadReconnectConfig()`。
- `user.ts` `login()` / `changeRole()` 成功:同步 `loadReconnectConfig()`(换仓时配置随之切换)。
### 6.3 页面进入自动尝试(需求 1 + 2)
统一封装进 store action(避免各页重复写逻辑):
```ts
// printerComponent store
autoTryForPage(names?: string[]) {
this.ensureConfigLoaded() // 已加载则跳过
this.applyConfigToRuntime()
core.autoTryConnectOnce(names) // 节流内置
}
```
接入点(“等提供打印功能的页面”):
- `WavePlatformPrintPreviewDialog.vue`:`watch(modelValue)` 为 true 时 `autoTryForPage(requiredComponents)`(本次弹窗涉及组件优先);
- `SandanWaveBatchListPanel.vue` / `GroupWaveBatchListPanel.vue` / orderManagement 三个订单页:`onMounted` 一次 + `onActivated`(keep-alive 返回页签时再次,覆盖 LRU 淘汰后重建)调用 `autoTryForPage()`(缺省=全部未排除组件)。
### 6.4 打印下发路径配合
- `print.ts` `sendWavePlatformBrowserPrint` 调用 `ensurePrinterConnectionsForBrowserPrint(requiredComponents)` 后,若仍有未连接组件:
- 未连接且**被排除** → 直接失败并提示“该组件已设为排除自动重连,请在连接面板手动连接”;
- 未连接且未排除但本次尝试仍失败 → 失败并提示“自动尝试失败,可开启失败自动重连或手动连接”。
- 错误文案带组件名与处置建议,沿用现有“未连接”报错结构(不改接口返回结构)。
### 6.5 切页/回前台自愈(需求 2)
- store `bindRuntimeEvents` 内注册 `document visibilitychange`:页面从后台回前台时 `healthCheck()`(节流)。
- **约定固化**:任何页面/弹窗的 `onBeforeUnmount`、`destroy-on-close`、路由离开都**不得**调用 `disconnectAll / removeComponent / stopConnections`(登出除外),避免回归性断连。
---
## 7. 设置 UI(`PrinterComponentConnectionPanel.vue` 改造)
在既有 el-form + el-table 结构内扩展,保持“配置表单”与表格样式/排序一致:
1. **主开关区(form)**
- “失败自动重连”主开关(改存 `printer.autoReconnect.enabled`,不再写旧全局 key)。
- 文案:开启后组件连接断开将按退避自动重连;下方“全部重连/刷新状态”保留。
- 高级项(可折叠“高级设置”,可选一期不做):重连间隔(s)、连续失败上限、页面进入自动尝试开关。
2. **组件表格**
- 新增列 **“自动重连”**:逐组件 `el-switch`,关闭 = 加入 `excluded`(“排除自动重连”),该组件断开后不自动尝试/重连,仅手动。
- 保留列:组件名称、本地端口、连接状态;状态列在“连续失败暂停”时显示辅助标签(如 `已暂停(3/5)`)。
- 主开关关闭时逐组件开关置灰(提示“先开启失败自动重连”)。
- 修改即存即生效:`store.updateComponentAutoReconnect(name, on)` → 写 scope → `core.applyConfig`;**不断开已连 socket**。
3. **入口收敛(可选优化,降低多页面重复)**
- 目前各页各自持有连接对话框(Sandan 内嵌 + 平台弹窗内嵌等)。可把 `printerComponentConnectionVisible` 收敛为 store 单例 `connectionPanelVisible`,所有“打印组件连接”按钮打开同一个弹窗(全局单一入口,天然“持久一致”)。若考虑影响面,也可保留现状仅复用面板组件。
4. 弹窗打开时先 `ensureConfigLoaded()`,保证展示的是当前用户+仓库配置。
---
## 8. 涉及文件改动清单(实施时参照)
| 文件 | 改动 |
|------|------|
| `src/stores/modules/userPreference.ts` | 增加 `currentWarehouseId()`/`currentStorageKey()`;`load` 主 key + 旧 key 回退迁移;`persist/reset` 写新 key;暴露身份变化重载入口 |
| `src/core/printerComponentCore.ts` | 配置化成员 + `applyConfig`;逐组件 excluded;退避/上限/暂停计数;`autoTryConnectOnce`/`healthCheck`;`shouldAutoReconnect`;遍历统一走 `this.ports`;新事件 |
| `src/core/printerRuntime.ts` | 加载/应用配置封装;`autoTryConnectOnce`/`healthCheck` 导出;升级 `ensurePrinterConnectionsForBrowserPrint` 为真实自动尝试 |
| `src/stores/modules/printerComponent.ts` | 移除旧全局 key 逻辑;改为读写 `userPreference` scope `printer.autoReconnect`(含旧 key 迁移);状态加 excluded/attempts/paused;`autoTryForPage`、`updateComponentAutoReconnect`、`ensureConfigLoaded`、visibilitychange 自愈 |
| `src/main.ts` / `src/permission.ts` / `src/stores/modules/user.ts` | 登录/换仓后加载并应用配置;`startConnections` 保留 |
| `src/views/order/waveOrder/component/PrinterComponentConnectionPanel.vue` | 逐组件“自动重连”开关列 + 主开关/高级项 + 状态辅助展示 + 即存即生效 |
| `src/views/order/waveOrder/component/WavePlatformPrintPreviewDialog.vue` | 打开时 `autoTryForPage(requiredComponents)`;`allComponentsConnected` 文案优化 |
| `SandanWaveBatchListPanel.vue` / `GroupWaveBatchListPanel.vue` | `onMounted`/`onActivated` 调 `autoTryForPage`(平台打印相关页签) |
| `orderManagement`:`pendingOrder.vue` / `deliveryOrder.vue` / `exceptionOrder.vue`(及复用 `use-*.ts`) | 同上前置自动尝试;保持弹窗内连接面板不变 |
| `print.ts`(打印下发) | 未连接时按“排除/未排除”给出差异化提示(不改返回结构) |
> 不改:`printerComponentConnection.ts`、打印协议/载荷、消息处理 handler。
---
## 9. 分阶段实施计划
| 阶段 | 内容 | 验收 |
|------|------|------|
| P0 数据层 | userPreference 仓库维度 + 回退迁移;新 scope 读写 | 旧用户标签顺序升级后仍保留;换仓 key 隔离 |
| P1 引擎 | core 配置化 + 排除集合 + 退避/上限 + one-shot + healthCheck | 单测/手测:断连→退避重连、排除组件不重连、手动重连恢复 |
| P2 运行时/store | runtime/store 封装、旧全局开关迁移、事件、visibilitychange | 登录/换仓自动加载应用配置;切页/回前台自愈 |
| P3 UI | 连接面板逐组件配置 + 高级项 | 开关即存即生效、显示暂停/排除态 |
| P4 页面接入 | 打印弹窗/各打印页 onMounted/onActivated 自动尝试;打印前自愈 + 提示 | 进入页面即自动尝试一次;打印路径未连提示准确 |
| P5 验证 | `npm run type-check` / `npm run build`;真机控件矩阵 | 见 §11 |
---
## 10. 兼容、风险与注意事项
- **key 迁移风险**:写路径切到 `user_prefs_{userId}_{warehouseId}`,必须保留旧 key 回退读取 + 一次性迁移,避免升级后丢失已保存的标签顺序等配置;旧 key 不主动删除。
- **“连接面板关/开”与切页**:面板/弹窗 `destroy-on-close` 只销毁 UI,不触碰单例连接;全流程 audit 确保无意外断连(登出除外)。
- **keep-alive / LRU**:orderManagement 与 waveOrder 用 KeepAlive+LRU,组件可能被淘汰重建,`onActivated`/`onMounted` 都要兜底自动尝试(节流内置防抖)。
- **重复 preflight / 端口扫描负担**:自动尝试节流(≥3s)+ 暂停机制,避免控件未安装时对 `ws://127.0.0.1:<port>` 高频重试。
- **竞态**:沿用 `connectGeneration` 丢弃过期建连结果;`applyConfig` 不改动已 OPEN 连接。
- **loopback 限制**:HTTP 公网不可连(`accessBlockedHint`)时,自动尝试直接短路并展示既有提示,不做无意义重试。
- **warehouse 缺失**:登录上下文取不到 `warehouse_id/store_id` 时退化为现状 `user_prefs_{userId}`(单仓部署零影响)。
- **多实例/多标签**:本方案仍是“每浏览器实例一个 SPA 单例”;不同浏览器标签各自独立连接,符合控件按本机安装的语义。
- **高级参数**(间隔/上限)默认值保守,避免误配导致刷屏;若 UI 一期不做则用默认值 + 预留字段。
---
## 11. 测试验证清单(真机/手测)
1. 登录后:未开控件 → 状态未连接;启动控件后**进入任一打印页**,页面自动尝试成功(需求 1)。
2. 切换页签(waveOrder↔orderManagement↔其他菜单)往返:已连接组件保持已连接,不需要手动重连(需求 2)。
3. 打印过程中关闭控件再开启,回前台/回到打印页自动重连成功(需求 2/3)。
4. 面板开启主开关:断开某组件(杀控件进程)→ 3s 起退避自动重连,控件重启后自动恢复。
5. 面板关闭某组件“自动重连”(加入排除):该组件断开后不自动尝试/重连,仅手动可连;主开关开启不影响其他组件。
6. 连续失败达上限后显示“已暂停”,不再高频尝试;手动“重连”立即恢复尝试。
7. 配置持久化:A 仓库关闭抖音自动重连、B 仓库开启 → 切换用户/仓库后配置各自生效(分用户+仓库)。
8. 升级兼容:已有标签顺序配置、旧 `printer_component_auto_reconnect` 开关在首次进入后迁移且行为不变。
9. HTTP(非 HTTPS)环境:仍显示无法连接提示,不产生无意义重试。
10. 批量打印(平台数据):全部所需组件已连接→正常打印;有组件排除未连→报“已排除需手动连接”提示,不改打印流程返回结构。
---
## 12. 待确认问题(评审时定)
1. 需求 3“哪些组件是失败尝试 / 排除自动重连”是否即“**逐组件开关(默认全开,关闭=排除)**”这一实现口径?是否需要三态(自动重连 / 仅失败尝试一次 / 排除)?
2. “分用户和仓库”是否意味着**所有**用户偏好(含标签顺序/字段排序)都要升级为分仓库,还是仅本打印配置分仓库(本文推荐后者 + userPreference 预留仓库维度)?
3. 仓库上下文是否会在一次登录内动态切换(changeRole 换仓)?若是,身份变化重载触发点需确认到具体入口。
4. 是否本期就把“打印组件连接”入口收敛为全局单例弹窗(含页面顶部入口),还是维持现状仅共享面板组件?
5. 高级参数(重连间隔/连续失败上限/页面进入自动尝试)是否需要 UI 暴露,还是先用默认值。
6. 连接状态变化是否需要全局轻提示(如右上角角标/Toast),避免用户在非打印页感知不到控件离线。

View File

@ -0,0 +1,314 @@
# 打印组件连接:登录一次连接与失败自动重连方案
- 状态:**已实现(2026-09-04 落地,审计修订 v1.1,取代 `docs/打印组件连接-持久化与自动重连方案.md`)**
- 日期:2026-09-04
- 范围:`order/waveOrder` 及 `order/orderManagement`(pendingOrder / deliveryOrder / exceptionOrder)等提供「批量打印(平台数据)」的页面所用的**打印组件连接链路**
- 原则:**不改动打印协议与载荷**(`print.ts` 的 payload / 组件消息协议保持现状),只优化「连接生命周期、失败重连、配置持久化」三部分
- 关联正式方案:`docs/用户偏好配置-浏览器本地保存方案.md`(v1.1,配置持久化的唯一依据,本文在此之上扩展“仓库”维度)
> **落地范围**(2026-09-04):`userPreference.ts`(仓库维度+旧 key 迁移)、`printerComponentCore.ts`(有界退避重连/排除/暂停/applyConfig)、`printerComponent.ts`(scope `printer.autoReconnect`+旧全局开关迁移)、`permission.ts`/`user.ts`(登录一次连接前先加载配置、changeRole 重载)、`PrinterComponentConnectionPanel.vue`(逐组件“自动重连”开关与状态提示)、`print.ts`(失败提示区分,不改发送/返回结构)。已通过 `npm run type-check` 与 `npm run build`。
---
## 0. 核心模型(用户口径,审计后收敛)
> **一次连接**:登录成功后**只自动发起一次**连接;连上后**一直复用**,切任何页面都不断连;**任何打印页 / 打印动作都不再触发新的建连**,打印仅通过既有长连接发送,未连接则明确提示。
**不变式(实现必须守住)**
1. **建连自动入口(低频率、有界)**:登录成功后自动连接一次;**页面刷新也会各触发一次**——整页刷新(F5 / 顶部刷新)走登录守卫 getInfo 路径并由 `main.ts` 兜底一次,页签软刷新(经 `/redirect` 回到目标页)触发一次 `retryConnectionsOnce`。登录 / 刷新产生的“这一次连接”**对所有组件各尝试一次(不看逐组件“自动重连”开关/排除名单)**,与“失败自动重连”主开关无关;保留已连接、不无限重试。
2. **断连唯一入口**:登出 / resetToken。路由切换、页面/弹窗 `onBeforeUnmount`、`destroy-on-close` 一律**不得**关闭 WebSocket。
3. **发送唯一路径**:复用已 OPEN 的 socket;未 OPEN → 直接给出明确失败提示(含处置建议),**不新建、不静默重试**。
4. **自动重连唯一触发(失败后)**:由“连接建立失败 / 连接断开”事件驱动(失败驱动的自愈);仅当 **“失败自动重连”主开关开启 + 该组件“自动重连”开启(未排除)+ 当前未连接** 时才会退避重试,带次数上限与暂停;与页面/路由/标签可见性**无关**。
5. **手动重连**:连接面板“重连 / 全部重连”始终可用、不受排除限制。
**明确不做的(与 v1.0 草案的差异,逐条删除)**
- ❌ 页面 `onMounted / onActivated` 进入自动尝试
- ❌ 打开打印弹窗(`WavePlatformPrintPreviewDialog`)时自动尝试
- ❌ `document.visibilitychange` 回前台健康检查
- ❌ 打印下发前自动尝试(`ensurePrinterConnectionsForBrowserPrint` 保持“不实际建连”)
- ❌ 配置字段 `autoTryOnPageEntry`
> 例外(用户明确要求保留):**“页面刷新”是一次有界的主动触发**——整页刷新或页签软刷新后执行**一次**重连(`reconnectOnceAll`,对**所有组件**各尝试一次、保留已连接),与逐组件“自动重连”开关无关;不构成“每次进打印页都重连”。
> 之所以删掉这些:它们会造成“每进一个打印页/每打一次都重复尝试建连”,正是要减少的**无效连接请求**。一次连接 + 失败自愈已覆盖“登录后自动连、连上一直用”的全部诉求。
---
## 1. 背景与目标
“批量打印(平台数据)”会把面单通过**浏览器 WebSocket 直发本机打印组件**(抖音 / 拼多多 / 快手 / 京东 / 菜鸟 / 视频号 / 小红书 / LODOP 等 8 个本地控件)。按用户口径拆解为三条:
| # | 需求(用户原话口径) | 实现策略 |
|---|------|----------|
| 1 | 登录成功后自动发起**一次**连接 | 保留并强化现有“登录一次性连接”;连接前先加载“用户+仓库”配置;对所有组件各尝试一次(排除名单仅约束“失败后的自动重连”) |
| 2 | 连接成功后**一直使用**;访问其他页面**不断连**;打印**无需多次重连** | 复用模块级单例长连接;固化“登出是唯一断连点”;打印路径只复用不建连 |
| 3 | 增强**失败自动重连**:可设置哪些组件“失败尝试 / 排除自动重连”,配置**分用户 + 分仓库持久化**(与表格字段排序等用户偏好同模式) | 主开关 + 逐组件参与开关(排除名单)+ 退避/上限/暂停;存入 `userPreference`(分用户+仓库 key) |
> 仓库(warehouse)维度取自当前登录上下文 `userStore.user?.warehouse_id ?? userStore.user?.store_id`(代码中已有同类取值先例)。不同仓库常用平台/安装的控件不同,因此“哪些组件参与失败自动重连”按 **用户 + 仓库** 分别记忆;对本仓不用的组件做“排除”后,不会再对其进行失败后的持续重试,从而减少无效重试请求(登录/刷新仍会对它一次性尝试)。
---
## 2. 现状梳理与审计结论(代码事实)
| 文件 | 角色 | 审计结论 |
|------|------|----------|
| `src/core/printerComponentCore.ts` | 连接引擎(模块级单例) | WebSocket 长连接 map 已存在;`autoReconnectEnabled` 全局布尔默认 `false`;失败重连**固定 3000ms、无限重试、无退避/无上限/无按组件排除**(→ 无效连接请求的源头之一);`connectGeneration` 已防竞态 |
| `src/core/printerRuntime.ts` | 生命周期门面 | `startPrinterComponentConnections()`:`connectionsStarted` 置位,**会话内一次**(→ 满足“登录一次”);`ensurePrinterConnectionsForBrowserPrint()`:目前只置位、**不实际建连**(→ 保持,勿“升级”成自动尝试);`stopPrinterComponentConnections()`:登出断开(唯一断连点) |
| `src/core/printerComponentCore.ts` → 打印发送 | `sendPayloadToComponentWs` / `sendWavePlatformBrowserPrint` / `queryComponentPrinterList` | **只复用已 OPEN socket**,未 OPEN 直接报错提示(→ 打印本就不建连,符合“一次连接”,无需改协议) |
| `src/stores/modules/printerComponent.ts` | 状态 Pinia store | 全局布尔 key `printer_component_auto_reconnect`(**不分用户/仓库**);`setAutoReconnect(true)` 会立即对所有未连组件再试一次 |
| `src/stores/modules/userPreference.ts` | 用户偏好 store | key=`user_prefs_{userId}`,**仅 user 维度,无仓库维度**;`load()` 挂在 permission 守卫 getInfo 成功后 |
| `src/stores/modules/user.ts` / `src/permission.ts` | 登录/登出接入 | login / getInfo 成功后 `startConnections()`;logout / resetToken 时 `stopConnections()`(→ 登录一次连接已具备) |
| 各打印页/弹窗 | 入口 | `WavePlatformPrintPreviewDialog` 打开时仅 `refreshFromRuntime()`,**不建连**(正确);各面板含内嵌连接对话框;页面在 `keep-alive`(LRU)内,但**均无 unmount 断连逻辑**(→ 切页本就不应断连) |
**审计结论(为什么现在用户感觉“要反复重连/无效请求多”)**
1. 登录那次尝试若失败(控件后启动 / 中途重启),因默认关闭失败自动重连,之后**再无任何自动尝试** → 用户到打印页只能手动重连 → 表现为“要重新连接”。
2. 一旦开启“失败自动重连”,未安装的控件端口会**每 3s 无限重试**;登录与开关键又会对**全部 8 个组件**无差别尝试 → “无效连接请求”多。
3. 切换页面本身**不会**断连(单例 + 无 unmount 关闭);用户体感来自“断了没自愈 + 开关/排除无法按用户/仓库记忆”。
→ 据此:**不多加触发入口**,而是把登录那“一次连接”做可靠、把失败自愈做“有界 + 按组件可配 + 按用户/仓库持久化”,并让打印路径永远“只复用、不建连”。
---
## 3. 方案总览
```mermaid
flowchart LR
subgraph 登录[登录成功 getInfo 后]
L[加载 用户+仓库 配置<br/>排除名单 excluded]
C[自动连接一次<br/>所有组件各尝试一次<br/>跳过已连接]
end
subgraph 使用期[会话内长期复用]
S[(任意页面)打印/查打印机<br/>只复用已 OPEN socket<br/>不新建连接]
K[切页面 / 关弹窗<br/>不断连]
end
subgraph 失败自愈[失败驱动 自动重连]
F[连接失败/断开]
R[仅对 参与组件<br/>退避重连 · 次数上限 · 暂停]
M[手动 重连/全部重连<br/>不受排除限制]
end
L --> C -->|成功 OPEN| S
S --> K
C -->|失败| F
F -->|enabled && !excluded| R
R -->|控件恢复| S
F -->|excluded| X[置未连接<br/>等待手动]
X --> M
R -->|连续失败达上限| P[暂停<br/>等待手动/重新启用]
P --> M
M --> S
M --> C
```
---
## 4. 数据与存储设计(分用户 + 分仓库)
### 4.1 身份与 key(userPreference 层扩展)
沿用 `userPreference` store(与标签/字段排序等用户偏好**同源同模式**),引入**仓库维度**,并向后兼容迁移:
```ts
// 稳定取当前仓库标识(与订单页“仓库 ID 优先取行、其次登录上下文”一致)
function currentWarehouseId(): string {
const userStore = useUserStore()
const user = userStore.user || {}
const wh = user.warehouse_id ?? user.store_id
return wh != null && wh !== '' ? String(wh) : ''
}
// 有仓库上下文:用户+仓库;否则退化为现状 user_prefs_{userId}
function currentStorageKey(): string {
const wh = currentWarehouseId()
return wh ? `user_prefs_${currentUserId()}_${wh}` : `user_prefs_${currentUserId()}`
}
```
- **load()**:先读 `user_prefs_{userId}_{warehouseId}`(新主 key);无则回退读旧 key `user_prefs_{userId}`,读到后**一次性迁移**写回新 key(仅当有仓库上下文时)。
- **set / reset / persist**:一律写新 key;旧 key 不主动删(保守,避免回滚丢配置)。
- 无仓库上下文的部署 key 不变,完全向后兼容;已有标签顺序等旧配置通过回退迁移无缝保留。
- **身份变化重载**:`changeRole` 成功(可能换仓)后若 `warehouse_id` 变化需重新 `load()`。
- localStorage 满/禁用仍沿用 try/catch 降级内存态。
### 4.2 新 scope 与配置结构
scope 沿用 `<模块>.<能力>.<页面标识>` 规范,注册:
```
printer.autoReconnect
```
```ts
interface PrinterAutoReconnectConfig {
/** 主开关:是否开启“失败自动重连”(连接建立失败/断开后对参与组件自动重试) */
enabled: boolean
/** 排除“失败自动重连”的组件名单(= 逐组件“自动重连”开关关闭者);只影响失败后的自动重试,不影响登录/刷新对所有组件的一次尝试 */
excluded: string[]
/** 基础重连间隔 ms,默认 3000 */
intervalMs: number
/** 退避上限 ms,默认 30000(可选字段,UI 可不暴露) */
maxIntervalMs: number
/** 连续失败达到该次数后暂停自动重连,默认 5(0=不限;可选字段) */
maxConsecutiveFailures: number
updated_at: number
}
```
> 术语对齐:**“失败自动重连”触发条件**=“失败自动重连”主开关 `enabled=true` **且** 该组件“自动重连”开启(不在 `excluded`)**且** 当前未连接时,断线后才会退避重试;**排除自动重连**=组件在 `excluded` 名单内,断开后不做持续自动重试(仍会在登录/刷新的一次性连接中被尝试,也可手动“重连”)。**默认全关**:`enabled=false`(主开关关);`excluded` = 全部组件(各组件“自动重连”默认关闭)。
### 4.3 旧全局开关迁移
- `printerComponent` store 启动读取时:若 `printer.autoReconnect` 尚无配置,则把旧 key `printer_component_auto_reconnect`(浏览器全局布尔)迁移为 `enabled` 后写入新 scope;此后不再读写旧 key。
---
## 5. 引擎设计(`src/core/printerComponentCore.ts`)
保留现有 `connectGeneration` 防竞态,改造如下:
1. **配置化**
- 新增成员:`excluded: Set<string>`、`intervalMs/maxIntervalMs/maxConsecutiveFailures`、`attempts: Map<name,number>`、`paused: Map<name,boolean>`。
- `applyConfig(cfg)`:合并配置,**不关闭已 OPEN socket**;仅影响“失败后的自动重连”(参与范围与节奏)。
- `shouldAutoReconnect(name) = enabled && !excluded.has(name)`(失败自动重连判定)。
- 修正 `initAll / reconnectAll / disconnectAll` 遍历 `this.ports`(而非模块常量 `DEFAULT_PRINTER_COMPONENTS`)。
2. **登录 / 整页刷新“一次连接”(对全部组件)**
- `initAll()`:对**所有**注册组件各尝试一次(跳过已 OPEN/CONNECTING),不看逐组件“自动重连”开关;此后**不再有页面级/事件级自动建连**(页面刷新属例外,见 §0/§6)。
- 一次连接失败/成功即定格:失败只进入 §5.3 的失败驱动重连(若主开关+组件“自动重连”都开),不会因为页面切换/打印而重试。
3. **失败驱动自动重连(需求 3,有界、按组件)**
- `onopen`:重置该组件 `attempts`、清 `paused`。
- `onclose/onerror`:`_manualClose` 忽略;否则
- `shouldAutoReconnect(name)` → `scheduleReconnect(name)`;
- 否则仅置 `disconnected`(被排除 / 未开主开关 → 不重试,等手动)。
- `scheduleReconnect`:指数退避 `min(intervalMs * 2^attempts, maxIntervalMs)`;`attempts` 达 `maxConsecutiveFailures` → **暂停**(清 timer、`paused[name]=true`),不再高频轮询(消除对未安装端口的无限 3s 无效请求);手动重连或主开关重新启用时重置。
- 主开关由关→开:对“未 OPEN 且参与”组件做**一次性**尝试(等同受限的“全部重连”),随后的节奏交给上表管理——不再无限轮询。
4. **手动重连**
- `reconnectComponent(name)` / `reconnectAll()`:不受 `excluded` 限制、重置 `attempts`,是唯一绕过排除的入口(连接面板按钮)。
5. **事件补充**
- 在 `printerComponentStatusChange` 外增发 `printerReconnectStateChange`(含 attempts / paused / excluded 信息),供 UI 显示“连续失败 N 次 / 已暂停 / 已排除”。
> 边界:不做心跳保活(本地控件长连接本就稳定,断开多为控件进程重启);不断言“回前台自愈”,避免引入页面级重连。
---
## 6. 运行时与生命周期接入
### 6.1 `src/core/printerRuntime.ts`
- `startPrinterComponentConnections()`:登录/整页刷新后调用一次(现状保留),行为 = `initAll()`(对所有组件各尝试一次)。
- `ensurePrinterConnectionsForBrowserPrint(names?)`:**保持“只置位、不建连”**,不改造成自动尝试(否则打印就会重复建连,违背核心模型)。
- `stopPrinterComponentConnections()`:登出断开(唯一断连点,文档固化)。
- 可选清理:导出与 `print.ts` 打印路径无关,无需改动发送侧。
### 6.2 会话接入(登录一次连接 = 需求 1)
- `permission.ts` getInfo 成功后顺序调整:先 `useUserPreferenceStore().load()`(含 `printer.autoReconnect` 配置),**再** `usePrinterComponentStore().startConnections()` → 使登录那一次连接已加载“用户+仓库”配置(排除名单仅影响“失败后的自动重连”)。
- `main.ts` `bindRuntimeEvents()` 保留(事件绑定 + 读一次旧开关做迁移)。
- `user.ts` `login()` 现有 `startConnections()` 保留(幂等,配合 permission 守卫一起确保“登录/整页刷新都只连一次”);`changeRole()` 成功后重载偏好并 `applyConfig`(换仓配置切换,不断开已连 socket)。
### 6.3 打印路径(需求 2:只复用、不建连)
- `print.ts`:**不改**发送逻辑(`sendPayloadToComponentWs` / `sendWavePlatformBrowserPrint` 已做到“未 OPEN 即失败提示、不新建连接”)。
- 仅在失败文案上可区分两类原因(可选优化,不改返回结构):
- 该组件在 `excluded` 内 → “已设为排除自动重连,请到连接面板手动连接”;
- 未排除但当前未连 → “组件未连接(登录后自动连接或失败自动重连中),请到连接面板查看/手动重连”。
### 6.4 页面/弹窗
- **不新增**任何 onMounted/onActivated/watch/visibilitychange 建连钩子。
- 各打印页与 `WavePlatformPrintPreviewDialog` 仅展示全局连接状态(store 已共享),打开面板时 `refreshFromRuntime()`(现已是如此)。
- 固化约定:任何页面/弹窗 `onBeforeUnmount`、`destroy-on-close`、路由离开都不得调用 `disconnectAll / removeComponent / stopConnections`(登出除外)。
---
## 7. 设置 UI(`PrinterComponentConnectionPanel.vue` 改造)
在既有 el-form + el-table 内扩展(样式与表格排序保持现有一致):
1. **主开关区(form)**
- “失败自动重连”主开关 → 存 `printer.autoReconnect.enabled`。
- 文案:开启后,仅对“自动重连”开启且当前未连接的组件,在断开后按退避自动重试(有限次数,避免无效请求);关闭则断开后不做持续自动重试。
- 保留“全部重连 / 刷新状态”。
- 高级项(可折叠,可选一期不做):重连间隔(s)、连续失败上限。
2. **组件表格**
- 新增列 **“自动重连”**:逐组件 `el-switch`(关闭 = 加入 `excluded`,即该组件不参与“失败自动重连”),提示:排除仅影响断开后的自动重试;登录 / 刷新的一次连接仍会对它尝试一次,也可手动“重连”。
- 保留:组件名称、本地端口、连接状态;**连接状态列不显示“已排除”**(排除组件按“未连接”展示,排除状态由“自动重连”开关体现);连续失败暂停时显示辅助标签(如 `已暂停(连续失败 3 次)`)。
- 逐组件“自动重连”开关不受主开关影响,可随时预先配置(即存即生效)。
- 修改即存即生效:`store.updateComponentAutoReconnect(name, on)` → 写 scope → `core.applyConfig`;**不断开已连 socket**。
3. **入口(可选优化)**:把各页零散连接对话框收敛为 store 单例 `connectionPanelVisible`(全局同一面板),与“一次连接”体验一致;若求稳可保留现状仅共享面板组件。
4. 弹窗打开时先 `ensureConfigLoaded()`,保证展示当前“用户+仓库”配置。
---
## 8. 涉及文件改动清单
| 文件 | 改动 |
|------|------|
| `src/stores/modules/userPreference.ts` | 加 `currentWarehouseId()`/`currentStorageKey()`;`load` 主 key + 旧 key 回退迁移;`persist/reset` 写新 key;暴露身份变化重载入口 |
| `src/core/printerComponentCore.ts` | 配置化成员 + `applyConfig`;逐组件 `excluded`;失败重连退避/上限/暂停(有界,非无限 3s);`initAll`/`reconnectOnceAll` 对所有组件各尝试一次(不受排除约束);`reconnectAll/disconnectAll` 收敛到 `this.ports`;`printerReconnectStateChange` 事件 |
| `src/core/printerRuntime.ts` | `startPrinterComponentConnections` 保持一次性;`ensurePrinterConnectionsForBrowserPrint` **保持不建连**;新增 `retryPrintConnectionsOnce()`(刷新一次重连);文档化唯一断连点 |
| `src/stores/modules/printerComponent.ts` | 旧全局 key → 读写 `userPreference` scope `printer.autoReconnect`(含旧 key 迁移);状态加 excluded/attempts/paused;`ensureConfigLoaded/applyConfig/updateComponentAutoReconnect`;`retryConnectionsOnce`(刷新重连);visibilitychange 等页面级触发器**不新增** |
| `src/main.ts` | 整页刷新(F5 / 顶部刷新)后:`router.isReady()` 完成后对已登录用户 `startConnections()` 一次(与主开关无关、幂等兜底) |
| `src/permission.ts` / `src/stores/modules/user.ts` | 调整顺序:先 load 偏好配置再 `startConnections`(登录一次连接对所有组件各尝试一次);`changeRole` 换仓后重载配置;识别 `/redirect` 软刷新 → 回到目标页执行一次重连 |
| `src/views/order/waveOrder/component/PrinterComponentConnectionPanel.vue` | 逐组件“自动重连”开关列 + 主开关/高级项 + 状态辅助(已暂停);连接状态列不展示“已排除”+ 即存即生效 |
| `src/views/order/waveOrder/config/print.ts` | **发送逻辑不改**;仅失败文案区分“已排除/未连接”(可选,不改返回结构) |
> 不改:`printerComponentConnection.ts`、打印协议/载荷、消息处理 handler、`WavePlatformPrintPreviewDialog` 及 `SandanWaveBatchListPanel/GroupWaveBatchListPanel/orderManagement 各页`(**不加任何自动尝试钩子**)。
---
## 9. 分阶段实施计划
| 阶段 | 内容 | 验收 |
|------|------|------|
| P0 数据层 | userPreference 仓库维度 + 回退迁移;`printer.autoReconnect` scope 读写 | 旧标签顺序升级后保留;换仓 key 隔离 |
| P1 引擎 | core 配置化 + 排除集合 + 有界退避/暂停 + 登录/刷新一次连接对所有组件尝试 | 断连→仅对 主开关开启 + 组件“自动重连”开启 的未连接组件有界重连;无无限轮询 |
| P2 运行时/store | 迁移旧全局开关、`ensureConfigLoaded/applyConfig`、事件 | 登录/换仓自动加载应用;行为与页面/路由无关 |
| P3 UI | 连接面板逐组件配置 + 高级项 | 开关即存即生效、显示已暂停/已排除 |
| P4 回归 | 登录只连一次;多打印页复用不重连;登出唯一断连 | 见 §11 |
| P5 验证 | `npm run type-check` / `npm run build`;真机控件矩阵 | 见 §11 |
---
## 10. 兼容、风险与注意事项
- **登录后仍保持“会话内一次”**:连接在登录/刷新后只触发一次;失败是否继续由“失败自动重连”决定,与切页/打印无关。
- **key 迁移**:写路径切到 `user_prefs_{userId}_{warehouseId}`,必须保留旧 key 回退读取 + 一次性迁移;旧 key 不删。
- **无效连接请求收敛点**:① 登录/刷新的一次性连接对每个组件只尝试一次、不重复;② 失败自动重连有退避 + 次数上限 + 暂停,且可逐组件排除(对本仓不用的控件不做失败后的持续重试),杜绝未安装端口的无限 3s 轮询;③ 打印路径永远不建连。
- **默认全关**:主开关“失败自动重连”默认关;各组件“自动重连”也默认关(`excluded` = 全部组件);两者都开启后才会有失败后的自动重试 + 有界重连,不会造成风暴。
- **连接面板/弹窗生命周期**:`destroy-on-close` 只销毁 UI;全流程 audit 无意外断连(登出除外)。
- **竞态**:沿用 `connectGeneration`;`applyConfig` 不动已 OPEN socket。
- **loopback 限制**:HTTP 公网不可连时(`accessBlockedHint`)登录自动连接直接短路并展示既有提示,不做无意义重试。
- **warehouse 缺失**:取不到 `warehouse_id/store_id` 时退化为 `user_prefs_{userId}`(单仓部署零影响)。
- **多标签页**:每个浏览器标签独立 SPA 单例,各自登录时连接一次,符合控件按本机安装语义。
---
## 11. 测试验证清单(真机/手测)
1. 登录成功 → **只发起一次连接**(Network/日志可见仅一次 ws 握手);成功组件显示已连接。
2. 已连接后遍历各打印页(waveOrder ↔ orderManagement ↔ 其他菜单)往返:状态保持已连接,**无任何新建 ws**。
3. 在任一打印页点击批量打印(平台数据):直接发送成功,日志中**无 init/preflight 建连动作**。
4. 控件未启动时登录:该组件未连接;启动控件后打开连接面板点击“重连”成功;此后打印复用该连接。
5. 开启主开关 + 某组件未安装(端口不通):按退避重试,连续失败达上限后**暂停**(不再每 3s 请求)。
6. 关闭某组件“自动重连”(排除):登录/刷新仍会对它一次性尝试;断开后不做持续自动重试;手动“重连”仍可连;**连接状态列不显示“已排除”**。
7. 已连接状态下登出再登录:旧连接关闭、新会话登录后自动连接一次。
8. **页面刷新重连(与主开关、逐组件“自动重连”开关均无关)**:a) F5 / 顶部刷新整页重载后,对所有组件自动重连一次;b) 页签“刷新”(经 /redirect 软刷新)后回到目标页也对所有组件重连一次(保留已连接)。
9. 配置持久化:A 仓库排除抖音、B 仓库不排除 → 换用户/仓库后各自生效(分用户+仓库)。
10. 升级兼容:旧标签顺序、旧 `printer_component_auto_reconnect` 首次进入后迁移且行为不变。
11. HTTP(非 HTTPS)环境:仅提示无法连接,无无效重试。
---
## 12. 待确认问题(评审时定)
1. 需求 3 口径:逐组件开关两态(**默认关**;开启 = 参与“失败自动重连”)+ 主开关“失败自动重连”(默认关)即可,还是需要三态(持续自动重连 / 仅失败尝试一次 / 排除)?当前方案按**两态、默认全关**设计。
2. “分用户和仓库”仅用于本打印配置,还是要推广到全部用户偏好(标签顺序/字段排序)?当前方案:仅打印配置分仓库 + userPreference 预留仓库维度。
3. 登录“一次连接”的范围:全部未排除组件,还是可进一步限定为该仓库常用平台组件(若有仓库→组件映射可再减少无效请求)?
4. 失败自动重连主开关默认值:保持默认关,还是默认开?
5. “打印组件连接”入口是否本期收敛为全局单例弹窗(含页面顶部入口),还是维持现状仅共享面板组件?
6. 高级参数(重连间隔 / 连续失败上限)是否本期在 UI 暴露,还是先走默认值。

View File

@ -0,0 +1,101 @@
# 本地开发:对象存储(COS)直传跨域(CORS)绕过方案
## 现象
`stock/stock` 图片组件、`basicManagement → 前端独立部署` 品牌图片上传等「浏览器直传 COS」的功能,在本地开发时控制台报 CORS 错误:
| 请求 | 结果 |
| --- | --- |
| `index.getCOSUploadConfig`(xhr) | 200 ✅(接口正常) |
| `https://<bucket>.cos.<region>.myqcloud.com/`(fetch) | ❌ CORS 错误 |
⚠️ 易误判:报错的**不是** `index.getCOSUploadConfig`,而是它之后浏览器直传存储桶的 `fetch`。
响应头里有 `Vary: Origin, Access-Control-Request-Headers, Access-Control-Request-Method`,但没有 `Access-Control-Allow-Origin`。
另外注意:网络面板里这条 COS 请求往往已经是 **200 + ETag + Location**,即**文件其实已上传成功**,只是浏览器不允许 JS 读取响应,于是 `uploadSuccessNotify` 不执行、URL 也填不进去。
## 根因定位(一条命令)
```powershell
curl.exe -s -X OPTIONS "https://<bucket>.cos.<region>.myqcloud.com/" `
-H "Origin: http://localhost:5175" -H "Access-Control-Request-Method: POST"
```
返回即说明存储桶 CORS 未放行当前站点域名:
```xml
<Error>
<Code>AccessForbidden</Code>
<Message>CORSResponse: This CORS request is not allowed ... not whitelisted by the resource's CORS spec</Message>
</Error>
```
## 方案 A:配置存储桶 CORS(根治,需腾讯云控制台权限)
控制台 → 对象存储 COS → 存储桶 → **安全管理 → 跨域访问 CORS 设置 → 添加规则**:
| 配置项 | 建议值 |
| --- | --- |
| 来源 Origin | `*`(开发期);生产改为 `https://前端域名`,多个一行一个 |
| 操作 Methods | `GET`、`POST`、`PUT`、`HEAD`、`DELETE` |
| Allow-Headers | `*` |
| Expose-Headers | `ETag`、`Location`、`x-cos-request-id` |
| 超时 Max-Age | `600` |
```xml
<CORSConfiguration>
<CORSRule>
<AllowedOrigin>*</AllowedOrigin>
<AllowedMethod>GET</AllowedMethod>
<AllowedMethod>POST</AllowedMethod>
<AllowedMethod>PUT</AllowedMethod>
<AllowedMethod>HEAD</AllowedMethod>
<AllowedMethod>DELETE</AllowedMethod>
<AllowedHeader>*</AllowedHeader>
<ExposeHeader>ETag</ExposeHeader>
<ExposeHeader>Location</ExposeHeader>
<MaxAgeSeconds>600</MaxAgeSeconds>
</CORSRule>
</CORSConfiguration>
```
> 线上域名也必须在白名单里,否则线上同样失败。
## 方案 B:本地开发走同源代理(已实现,生产不生效)
dev 下把直传地址改写为同源路径 `/cos-proxy/...`,由 vite dev server 转发到存储桶;浏览器侧变成同源请求,不再有 CORS 检查。
涉及的三个文件:
| 文件 | 作用 |
| --- | --- |
| `src/utils/cosDevProxyConfig.ts` | 共享常量:代理前缀 `/cos-proxy`、默认目标存储桶、开关取值 `off` |
| `vite.config.ts` | dev server 挂 `server.proxy['/cos-proxy']`(`changeOrigin: true`、去 `Origin/Referer`、去掉前缀) |
| `src/utils/cosImageUpload.ts` | `resolveUploadUrl()`:`import.meta.env.DEV` 且目标 host 匹配时才改写,`fetch` 用改写后的地址 |
环境变量(`.env.development`):
```ini
VITE_COS_DEV_PROXY = 'on' # off = 关闭(改回直传,可验证存储桶 CORS 是否已配好)
VITE_COS_DEV_PROXY_TARGET = 'https://<bucket>.cos.<region>.myqcloud.com'
```
### 关键点
- **只影响 dev**:`import.meta.env.DEV` 守卫,生产构建里 `resolveUploadUrl` 直接原样返回。
- **不改后端**:COS 的 POST Object 表单签名只覆盖 policy,不绑定 Host,所以代理转发后签名依然有效。
- **请求体原样流式转发**:multipart 边界与 `Content-Length` 不变,表单字段、文件都完整到达 COS。
- **`changeOrigin: true`**:转发时 Host 换成存储桶域名;同时在 `proxyReq` 上移除 `Origin`/`Referer`,避免存储桶按 CORS 规则判定。
- 已在两个上传入口生效:`src/utils/cosImageUpload.ts`(`basicManagement → 前端独立部署` 品牌图片)与 `src/components/ImagesUpload/index.vue`(`stock/stock` 图片组件)。
## 验证命令
```powershell
# 1) 代理是否生效(不是返回前端 HTML,而是 COS 的 XML 错误即说明已转发)
curl.exe -s -X POST "http://localhost:5174/cos-proxy/" -H "Origin: http://localhost:5174"
# 2) multipart 请求体是否完整转发(应返回 COS 的 InvalidPolicyDocument,且不会创建对象)
curl.exe -s -X POST "http://localhost:5174/cos-proxy/" `
-F "key=probe/not-created.png" -F "policy=invalid" -F "signature=invalid" `
-F "file=@public/logo/1.png"
```

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

@ -0,0 +1,417 @@
# 用户偏好配置:每账号每页面自定义排序(纯浏览器本地保存方案)
- 状态:**已决策** —— 接口方案已废弃,正式采用纯浏览器本地保存(方案B,见 §8)
- 决策日期:2026-09-01
- 版本:v2.0(方案B 为正式方案;§2~§6 接口方案存档仅参考)
## 读者导航
| 角色 | 重点阅读 |
|------|---------|
| **前端(实现设计)** | §8 正式方案(纯浏览器保存)、§7 前端设计(复用 store 抽象与接入模板) |
| **后端** | 无需开发接口;如需了解已废弃方案可参考 §2~§6(勿按此实现) |
---
## 0. 方案决策(2026-09-01)
> **接口方案(方案A,§2~§6 的 `user.preference.*`)已废弃**,不再开发后端接口。
> 正式方案为 **§8 纯浏览器本地保存(localStorage)**:零后端依赖、每账号按 user_id 隔离、同设备跨刷新/会话生效。
> **已放弃「跨设备同步」**:浏览器数据不经过服务端,无法跨设备。若将来需跨设备,再评估是否恢复接口方案。
> 前端实现只需关注 §8、§7(store 抽象 / 接入模板 / 兜底);§2~§6 仅存档参考。
---
## 1. 背景与目标
订单管理 `order/orderManagement` 各 tab(待审核订单、待处理订单、待处理异常订单、配送单等)当前排序由用户本次操作决定,刷新/换设备后丢失。需要:
1. 每个 tab 页可配置自定义排序(排序字段 + 排序方向)。
2. 排序配置**绑定账号**(同设备内按 user_id 隔离保存)。
3. **刷新/重新登录后自动应用**已保存配置。
> 说明:原「跨设备同步」目标因采用纯浏览器方案(§8)而**放弃**(浏览器数据不经过服务端,见 §0 决策)。
该机制设计为**模块无关**:除订单模块外,`order/waveOrder`、`setting/basicManagement` 等页面均可复用(按同一 key 规范注册即可)。
### 非目标(本期不做)
- **不做跨设备同步**(纯浏览器方案的固有取舍,见 §0)。
- 不要求"不刷新页面也实时同步"(浏览器本地保存天然即时生效,无需轮询)。
- 不做多用户/角色的差异化权限(配置仅按 user_id 隔离)。
- 不做复杂多级排序 UI(数据结构预留 `secondary`,UI 本期只做单字段)。
---
## 2. 通用约定(前后端共用)【已废弃:接口方案存档】
> ⚠️ 本节及 §3~§6 为**已废弃的接口方案(方案A)存档**,仅供将来可能恢复时参考;当前实现**不采用**,勿按此开发接口。正式方案见 §8。
### 2.1 接口风格
- 全部走统一系统接口:`POST /system`
- URL Query:`method` / `v`(=1.0)/ `timestamp`
- 请求体:`data`(业务参数,JSON)
- 请求头:`Authorization: Bearer <token>`,`platform: web`,`project: all`
### 2.2 认证与用户隔离
- 所有接口需登录(`isNeedAuth=false`、`isNeedLogin=true` 口径与 `order.export` 一致)。
- `user_id` **一律由服务端从 token 解析**,接口不接受前端传 user_id(安全边界)。
### 2.3 scope 命名规范
统一格式:`<模块>.<能力>.<页面标识>`,全小写,`.` 分隔。示例:`order.sort.pending`。
### 2.4 value 即不透明 JSON
- `value` 对接口层是**不透明 JSON**:后端只做白名单校验 + 存储 + 体积校验,不解析业务结构;业务结构由前端各页面定义与校验(见 §6.3)。
- 这样保证"新增一个功能 = 新增一个 scope",后端接口零改动。
---
## 3. 通用响应封装
```jsonc
// 成功
{ "code": 200, "flag": "success", "message": "ok", "data": { ... } }
// 失败
{ "code": 40007, "flag": "fail", "message": "scope 未在白名单内", "data": null }
```
- 成功码:`200 / 20000 / 1 / 0`(前端 `request.ts` 统一判定)。
- `code !== 成功码` 时,前端优先展示 `message`,并可按 code 做分支处理(见 §4)。
---
## 4. 错误码表(后端按此实现)
> 建议码段,后端可对齐现有 `ERROR_CODE_MAP` 惯例后调整,但**前端会按这些语义分支**,请保持语义一致。
| code | 含义 | 前端行为 |
|------|------|---------|
| 200 / 20000 / 1 / 0 | 成功 | - |
| 40007 | `scope` 未在白名单 / 格式非法 | 提示错误,不写入、不覆盖本地 |
| 40008 | `value` 超过体积上限(>4KB) | 提示错误,不写入 |
| 40009 | 乐观锁冲突(`base_updated_at` 与服务端 `updated_at` 不一致) | 弹窗提示「该配置已在其他设备更新」,提供「以本地为准覆盖」或「放弃」 |
| 40010 | 参数缺失 / 类型错误(如缺 `scope`、`value` 非对象) | 提示错误 |
| 401 / 50008 / 50012 / 50014 | 未登录 / 登录失效 | 跳转登录 |
| 403 / 40005 / 40006 | 无操作权限 | 提示无权限 |
---
## 5. 接口契约(后端按此开发)【已废弃:接口方案存档】
### 5.1 `user.preference.get` — 获取偏好
**请求**
| 项 | 值 |
|----|----|
| method | `user.preference.get` |
| 入参(data) | 见下表 |
| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| scope | string | 否 | 指定时只返回该 scope;缺省返回该用户**全部**偏好 |
| scope[](扩展,待确认) | array&lt;string&gt; | 否 | 可选支持批量查询(见 §11-2) |
**响应 `data`**
```
data: {
[scope: string]: {
value: object, // 该 scope 的配置内容(不透明 JSON)
updated_at: number // 毫秒时间戳,写入/乐观锁使用
}
}
```
- 未注册的 `scope`(不在白名单):**返回空对象,不报错**(幂等友好)。
- 该用户无任何配置:`data = {}`。
**成功示例**
```jsonc
// 请求
POST /system?method=user.preference.get&v=1.0&timestamp=...
{ "scope": "order.sort.pending" }
// 响应
{
"code": 200,
"flag": "success",
"message": "ok",
"data": {
"order.sort.pending": {
"value": { "field": "create_at", "order": "desc", "secondary": [{ "field": "id", "order": "asc" }] },
"updated_at": 1720000000000
}
}
}
```
---
### 5.2 `user.preference.set` — 保存偏好
**请求**
| 项 | 值 |
|----|----|
| method | `user.preference.set` |
| 入参(data) | 见下表 |
| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| scope | string | 是 | 必须命中白名单,否则返回 `40007` |
| value | object | 是 | 可 JSON 序列化对象;非对象返回 `40010`;序列化后 >4KB 返回 `40008`;传 `{}` 视为**清空/重置该 scope**(后端删除该行) |
| base_updated_at | number | 否 | 乐观锁:不传 = 强制覆盖(首次写入用);传入后与服务端当前 `updated_at` 不一致 → 返回 `40009` 冲突,不写入 |
**响应 `data`**
```
data: {
scope: string, // 写入的 scope
updated_at: number // 本次写入后的最新毫秒时间戳(后续 set 用其作为 base_updated_at)
}
```
**成功示例**
```jsonc
// 请求
POST /system?method=user.preference.set&v=1.0&timestamp=...
{
"scope": "order.sort.pending",
"value": { "field": "create_at", "order": "desc" },
"base_updated_at": 1720000000000
}
// 响应
{ "code": 200, "flag": "success", "message": "ok", "data": { "scope": "order.sort.pending", "updated_at": 1720000100000 } }
```
**冲突示例(40009)**
```jsonc
// 请求(base_updated_at 与服务端已不一致)
{ "scope": "order.sort.pending", "value": { "field": "id", "order": "asc" }, "base_updated_at": 1720000000000 }
// 响应
{ "code": 40009, "flag": "fail", "message": "配置已在其他设备更新", "data": { "current_updated_at": 1720000200000 } }
```
> 冲突时建议后端在 `data` 返回 `current_updated_at`,供前端展示/提示「以本地为准覆盖」时使用。
---
## 6. 数据模型与 scope 注册表
### 6.1 存储模型(后端)
**关系表方案(推荐)**
```sql
CREATE TABLE `user_preferences` (
`user_id` BIGINT NOT NULL COMMENT '用户ID(服务端从 token 取)',
`scope` VARCHAR(128) NOT NULL COMMENT '命名空间 key:<模块>.<能力>.<页面标识>',
`value` JSON NOT NULL COMMENT '配置内容(不透明 JSON,前端各页定义结构)',
`updated_at` BIGINT NOT NULL COMMENT '毫秒时间戳,用于乐观锁与跨设备同步探测',
PRIMARY KEY (`user_id`, `scope`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='用户偏好配置';
```
**Redis 方案(可选)**:`user_prefs:{userId}` Hash,field=scope,value=JSON;另存 `updated_at` 字段于同一 hash(或 `user_prefs_ver:{userId}`)。
### 6.2 scope 注册表(前后端共享白名单)
> 后端以此表做 `set` 白名单校验;前端以此表注册各页消费。新增功能 = 在此表加一行。
**本期(排序)**
| scope | 含义 |
|-------|------|
| `order.sort.review` | 待审核订单排序 |
| `order.sort.pending` | 待处理订单排序 |
| `order.sort.pendingException` | 待处理异常订单排序 |
| `order.sort.delivery` | 配送单排序 |
| `order.sort.archive` | 归档单排序 |
| `order.sort.outbound` | 出库单排序 |
**预留(后续功能直接注册,后端接口零改动)**
| scope | 含义 |
|-------|------|
| `order.columns.<tab>` | 列显隐/顺序 |
| `order.filter.preset.<tab>` | 筛选条件预设 |
| `order.table.<tab>` | pageSize / 表格密度 |
| `setting.*` | 基础管理设置类页面偏好(按 `模块.能力.页面` 命名) |
### 6.3 排序 value 结构(排序类 scope 的约定结构)
> 接口层不感知此结构(§2.4);下表是**前端各排序页面统一遵守**的 value 约定,便于跨页复用与后端抽查时理解。
```jsonc
{
"field": "create_at", // string:排序字段名,须命中各页 sort 白名单(前端校验)
"order": "desc", // 'asc' | 'desc'
"secondary": [ // 可选:多级排序预留(数组顺序=优先级)
{ "field": "id", "order": "asc" }
]
}
```
- 消费时主排序取 `field/order`,转各列表接口的 `{ sortField, sortOrder }`(如 `order.list`)。
- 若后端列表接口暂只支持单字段排序,本期只透传主排序(见 §11-3)。
---
## 7. 前端设计(前端按此实现)【接口方案版;方案B 复用其中 store 抽象、接入模板与兜底思路】
### 7.1 `userPreference` store 职责
新建 `src/stores/modules/userPreference.ts`(Pinia):
- `load()`:调 `user.preference.get`(不传 scope)拉取全部偏好 → 写内存 + localStorage(key 含 user_id,如 `user_prefs_{userId}`)。
- `get(scope)`:内存 → localStorage → 默认值,逐级兜底。
- `set(scope, value)`:本地立即生效 + 防抖写回 `user.preference.set`(带 `base_updated_at`)。
- `reset(scope)`:`set(scope, {})` 清空该 scope。
- `isLoaded` / `lastLoadedAt`:避免会话内重复全量拉取。
### 7.2 拉取时机(核心)
| 触发点 | 行为 |
|--------|------|
| 登录成功 / 整页刷新(`permission.ts` 守卫走 `userStore.getInfo()` 成功后) | 调 `preferenceStore.load()` 一次 |
| SPA 内部切换 tab(`hasGetUserInfo` 早退分支) | **不**重复拉取(避免高频请求) |
| 切到某 tab 时 | 读对应 `order.sort.<tabKey>`,填充 `currentSort` |
> 关键:`load()` 挂在 `getInfo` 成功路径之后,天然覆盖「登录」与「整页刷新」两种场景,满足跨设备刷新同步。
### 7.3 跨设备刷新同步机制
```mermaid
sequenceDiagram
participant A as 设备A(订单页)
participant S as 服务端
participant B as 设备B(另一台登录设备)
A->>S: user.preference.set(order.sort.pending, 新排序)
S-->>A: ok(updated_at)
Note over B: 用户在设备B 刷新页面
B->>S: getInfo(认证) → user.preference.get
S-->>B: 返回最新配置
B->>B: 填充 currentSort → 重新拉列表(带新排序)
```
- 刷新即最新(每次刷新重新 `getInfo` + `preference.get`)。
- 可选增强(非本期必需):`user.preference.version` 轻量探测 + 前端定时轮询,实现"不刷新也近实时"。
### 7.4 写回与乐观锁冲突处理
- 排序变更(`@sort-change`)→ 更新本地 `currentSort` → 防抖 500ms → `preference.set({ scope, value, base_updated_at })`。
- `base_updated_at` = 最近一次 `get` 返回的该 scope `updated_at`。
- 收到 `40009` 冲突:弹窗「该配置已在其他设备更新」→ 用户选择「以本地为准覆盖」(用 `data.current_updated_at` 作为新 base 重试 set)或「放弃本次修改」(用服务端最新值回填本地)。
- 写回失败(网络/后端故障):不回滚本地排序,保留 `dirty` 标记,下次 `@sort-change` 或进入页面时重试。
### 7.5 排序消费(各页接入模板)
订单各子页(`reviewOrder/pendingOrder/pendingException/...`)、`waveOrder`、`basicManagement` 均已具备 `currentSort` → 列表 `sort` 参数链路,接入只需:
1. 定义 `tabKey`(稳定标识,如 `'pending'`,勿用易变路由 path)。
2. 挂载时:`currentSort = normalizeSort(preferenceStore.get('order.sort.' + tabKey)) ?? 默认`。
3. `@sort-change`:更新 `currentSort` 后 `preferenceStore.set('order.sort.' + tabKey, { field, order })`。
4. 默认值来源:各页既有默认(如 `created_at desc`),无配置时行为与现在一致。
> 建议抽通用 composable `usePageSortPreference(tabKey, { whitelist, defaultSort })`,收敛多页重复代码。
### 7.6 兜底与降级
| 场景 | 行为 |
|------|------|
| `get` 失败(超时/报错/后端故障) | **不抛出、不阻塞**登录与路由;优先级:localStorage 缓存(记 `lastLoadedAt`)→ 各页默认配置;`console.warn` 一次 |
| 响应结构异常(缺 data、scope 值非对象、value 非法) | 视为该 scope 无配置,走默认值,不让单条坏数据拖垮整包 |
| `set` 失败(40008/40010/网络) | 提示错误;不回滚本地,保留 `dirty` 待重试 |
| `set` 冲突(40009) | 见 §7.4 弹窗处理 |
---
## 8. 正式方案:纯浏览器本地保存(不使用接口)
> 本章为**正式方案(方案B)**:不新增任何后端接口,仅用浏览器存储保存配置。零后端依赖、每账号按 user_id 隔离、同设备跨刷新/会话生效;代价是**放弃跨设备同步**(§0 决策)。
### 8.1 定位与关键限制
- **零后端开发、零接口依赖**,纯前端实现。
- **关键限制**:纯浏览器方案**无法实现「跨设备同步」**——数据不经过服务端,仅在同一设备、同一浏览器的跨刷新/跨会话内生效。若将来需要跨设备同步,再评估恢复接口方案(见 §0)。
### 8.2 实现
- **存储**:`localStorage`(key=`user_prefs_{userId}`,JSON 对象);配置体量增大或接近 5MB 上限时改用 IndexedDB。
- **结构**:与接口方案保持一致(`{ [scope]: { value, updated_at } }`),便于将来无痛切换数据源。
- **读写**:`userPreference` store 改为纯本地读写,无网络请求。
- **每账号隔离**:key 含 user_id;登出不清除(保留账号配置),登录时按 user_id 读取。
- **校验**:无服务端白名单,由前端自校验 scope / 结构 / 体积(仍建议单 scope ≤ 4KB)。
- **写回**:直接写 localStorage;无网络开销,可即时写,也可防抖合并写入降低 IO。
### 8.3 与接口方案对比
| 能力 | 方案B(纯浏览器) | 方案A(接口) |
|------|------------------|--------------|
| 每账号绑定 | ✅ 同设备按 user_id 分 key | ✅ 服务端隔离 |
| 刷新页面保留 | ✅ | ✅ |
| **跨设备同步** | ❌ 无法 | ✅ |
| 登录后自动获取 | ✅ 读本地 | ✅ 接口拉取 |
| 后端开发量 | 零 | 需开发 get/set + 存储 |
| 多端并发 / 乐观锁 | 不涉及(单端) | 需要(base_updated_at) |
| 数据迁移 | 手动导出/导入 JSON | 天然同步 |
| 安全 / 容量 | 前端自管,约 5MB/域名 | 服务端校验 + 体积上限 |
### 8.4 适用场景与建议
- 「跨设备同步」为硬需求 → **必须用接口方案**;纯浏览器方案仅作为其 **localStorage 兜底层**(即 §7.6 已有内容)。
- 后端暂未排期、以单设备为主、可接受手动迁移 → 可先用方案B快速上线。
- **推荐组合**:接口方案为正式形态;前端 store 将数据源抽象为「本地 / 服务端」两层,接口就绪前用本地层,就绪后切服务端层,**页面接入代码不变**(§7.5 的 `usePageSortPreference` 不感知数据源)。
### 8.5 从方案B平滑升级到方案A
1. store 定义统一读写接口:`load()` / `get(scope)` / `set(scope, value)`(页面只调这些,不关心数据源)。
2. 本地层:读写 localStorage;服务端层:调 `user.preference.get/set`。
3. 接口就绪后,将 store 数据源实现替换为服务端层,同时保留 localStorage 作为缓存/降级(§7.6)。
4. scope 与 value 结构两端保持一致,无需迁移数据格式。
---
## 9. 扩展性设计
**新增一个功能 = 新增一个 scope**,与既有数据、登录接口、前端 store 互不干扰:
- 列配置 `order.columns.<tab>`:存 `{ visible, order }`,前端列表列渲染消费。
- 筛选预设 `order.filter.preset.<tab>`:存 `{ name, where }`。
- 其他模块 `report.*` / `storage.*` / `setting.*` 按同一命名规范注册即可。
- 数据结构升级:每个 scope 可带 `schema_version`,前端按版本做 normalize 迁移。
因此可支撑 tab 数量增加与其他功能扩展,且**登录接口载荷恒定**(偏好不经过 getInfo)。
---
## 10. 里程碑
| 阶段 | 内容 | 验收 |
|------|------|------|
| M1 服务端 | `user_preferences` 存储 + `user.preference.get/set` + scope 白名单 + 体积/乐观锁 | 接口联调通过 |
| M2 前端基础 | `userPreference` store + 登录/刷新拉取 + localStorage 缓存 | 登录后控制台可见偏好已加载 |
| M3 排序落地 | 订单各 tab(+waveOrder/basicManagement)挂载读取 + `@sort-change` 防抖写回 | 双设备刷新互相同步通过 |
| M4 扩展 | 列配置/筛选预设等新 scope 接入 | 新功能走同一套机制上线 |
---
## 11. 待确认事项(评审时与后端对齐)
1. 服务端存储选型:关系表 vs Redis。
2. `user.preference.get` 是否支持 `scope` 批量(`scope[]`),还是先只支持缺省全量。
3. 多级排序 `secondary` 本期是否透传到列表接口(取决于 `order.list` 是否支持多字段 sort;不支持则本期只用主排序)。
4. 是否本期就做 `user.preference.version` 轮询增强,还是先做"刷新即同步"。
5. 错误码段(§4)是否与现有后端错误码体系合并/调整。
6. `value = {}` 表示清空该 scope 的约定是否可接受(后端需实现删除语义)。

View File

@ -0,0 +1,197 @@
# 用户偏好配置:每账号每页面自定义配置(浏览器本地保存方案)
> ⚠️ **本文档关于「标签排序」的章节已过期(2026-11-07)**:
> 标签排序与默认页签已统一为注册表 + `useTabOrder` + `TabArea`,配置写入 `userPreference` 用户级 scope `tabOrder`,
> 并可在「字段设置 → 标签排序」中统一管理。请以 **`docs/标签排序与默认页签-统一方案.md`** 为准。
- 状态:**已决策(正式方案)**
- 日期:2026-09-01
- 版本:v1.1
- 说明:原「接口方案」已废弃(存档见 `docs/用户偏好配置-排序与跨设备同步设计.md`,不再使用)。**本文档为正式落地方案的唯一依据。**
- 本期实现:**订单管理多标签页自定义排序**(v1.0 曾规划「列排序」,已按需求更正为「标签页顺序」,见 §3.3/§3.4/§4.5)。
---
## 1. 背景与目标
订单管理 `order/orderManagement` 顶部多标签页(待审核订单、待处理订单、待处理异常订单、配送单等)的显示顺序固定,部分账号希望把常用页签(如「待处理订单」)排到更靠前的位置。需要:
1. 可自定义**多标签页的显示顺序**(如把「待处理订单」拖到「待审核订单」前面)。
2. 配置**绑定账号**(同设备内按 user_id 隔离保存)。
3. **刷新 / 重新登录后自动应用**已保存配置。
> 取舍说明:本方案**不做「跨设备同步」**——数据保存在浏览器本地,不经过服务端,无法跨设备;仅同设备、同浏览器内跨刷新/跨会话生效。若将来需要跨设备同步,再评估是否引入接口方案。
方案设计为**模块无关**:除订单模块外,`order/waveOrder`、`setting/basicManagement` 等页面均可复用(按同一 key 规范注册即可)。
### 非目标(本期不做)
- 不做跨设备同步。
- 不做多用户/角色的差异化权限(配置仅按 user_id 隔离)。
- 不做列表数据列排序(如按订单ID/发货单号排序列表)——本期仅做**标签页顺序**,列排序留待后续按需接入。
---
## 2. 方案总览(纯浏览器本地保存)
- **存储**:`localStorage`,key = `user_prefs_{userId}`(JSON 对象);配置体量增大或接近 5MB 上限时改用 IndexedDB。
- **每账号隔离**:key 含 user_id;登出**不清除**(保留账号配置),登录时按 user_id 读取。
- **读写**:通过 `userPreference` store 统一读写,页面不直接操作 localStorage。
- **即时生效**:标签顺序变更直接写本地,刷新/重登自动读取。
```mermaid
flowchart LR
A[标签排序弹窗拖拽] -->|保存| B[userPreference store]
B --> C[(localStorage<br/>user_prefs_{userId})]
D[登录/整页刷新] --> E[store.load 读取本地]
E --> F[index.vue 按已存顺序重排 tabs]
```
---
## 3. 数据与命名规范
### 3.1 存储结构
```jsonc
// localStorage key: user_prefs_{userId}
{
"order.tabs.order": {
"value": ["pendingOrder", "reviewOrder", "exceptionOrder", "outboundOrder", "entrustWarehouse", "deliveryOrder", "deliveryException", "archiveOrder"],
"updated_at": 1720000000000 // 毫秒时间戳,用于脏标记/冲突识别(预留)
}
}
```
- 预留 `updated_at` 是为了将来接入接口方案时无需迁移格式(§6)。
- 单 scope `value` 仍建议 ≤ 4KB。
### 3.2 key 命名规范(scope)
统一格式:`<模块>.<能力>.<页面标识>`,全小写,`.` 分隔。
### 3.3 本期 scope 表(标签排序)
| scope | 含义 |
|-------|------|
| `order.tabs.order` | 订单管理多标签页显示顺序 |
| `order.wave.tabs.order` | 波次管理(waveOrder)标签顺序 |
| `stock.tabs.order` | 商品管理(stock/stockManagement)标签顺序 |
| `setting.basicManagement.tabs.order` | 基础设置(basicManagement/newview)标签顺序 |
| `order.sort.<tab>` | 各 tab 列表列排序(预留,v1.0 曾规划) |
预留(后续功能直接注册新 key):
| scope | 含义 |
|-------|------|
| `order.columns.<tab>` | 列显隐/顺序 |
| `order.filter.preset.<tab>` | 筛选条件预设 |
| `order.table.<tab>` | pageSize / 表格密度 |
### 3.4 标签顺序 value 结构(`order.tabs.order`)
```jsonc
// value = tab.name 数组,数组顺序即标签页显示顺序
{
"order": ["pendingOrder", "reviewOrder", "exceptionOrder", "outboundOrder", "entrustWarehouse", "deliveryOrder", "deliveryException", "archiveOrder"]
}
```
- 消费时按数组顺序重排 `index.vue` 的 `tabs`(`applyTabOrder`);缺失/非法 tab 名自动剔除,新增 tab 自动补在末尾。
- 未配置时使用默认顺序(`ORDER_TAB_LIST` 定义的顺序)。
---
## 4. 前端实现
### 4.1 `userPreference` store
新建 `src/stores/modules/userPreference.ts`(Pinia):
| 方法 | 行为 |
|------|------|
| `load()` | 按当前 user_id 从 localStorage 读取全部偏好 → 写内存;无缓存则置空 |
| `get(scope)` | 内存 → 默认值,逐级兜底 |
| `set(scope, value)` | 本地立即生效(写内存 + localStorage) |
| `reset(scope)` | 删除该 scope(`localStorage` 中移除该 key) |
| `isLoaded` / `lastLoadedAt` | 会话内加载状态标记 |
- `load()` 在 `src/permission.ts` 路由守卫 `userStore.getInfo()` 成功后调用一次(覆盖登录 + 整页刷新);SPA 内部切 tab 不重复调用。
- `set()` 写回本地即时生效,无需网络;可防抖合并(500ms)减少 IO。
### 4.2 加载时机
| 触发点 | 行为 |
|--------|------|
| 登录成功 / 整页刷新(`getInfo` 成功后) | `preferenceStore.load()` 一次 |
| SPA 内部切换 tab | 不重复 load |
| orderManagement 挂载时 | 读 `order.tabs.order` 重排 tabs(`applySavedTabOrder`) |
### 4.3 写回
- 标签排序弹窗点「保存」→ `preferenceStore.set('order.tabs.order', tab.name 数组)` → 本地即时生效 + 持久化;父级按新顺序重排 tabs。
### 4.4 兜底与边界
| 场景 | 行为 |
|------|------|
| 无缓存 / 首次使用 | 用各页默认排序,不报错 |
| localStorage 不可用/满(抛异常) | try/catch 兜底,降级为内存态,不阻塞页面 |
| 结构异常(value 非对象等) | 视为该 scope 无配置,走默认值 |
| 登出 | 不清除 localStorage(保留账号配置),重新登录按 user_id 读取 |
### 4.5 标签排序接入(本期已实现)
已接入页面(弹窗为**共享组件** `src/components/SortSettingDialog.vue`,props 传 `tabs`(默认顺序)+ `scope`(存储 key),各页只做入口 + 应用顺序):
1. **订单管理** `order/orderManagement`:配置 `ORDER_TAB_LIST`(`config/order-common-config.ts`),scope=`order.tabs.order`。
2. **波次管理** `order/waveOrder`:inline tabs(5 个),scope=`order.wave.tabs.order`。
3. **商品管理** `stock/stockManagement`:inline tabs(2 个),scope=`stock.tabs.order`。
4. **基础设置** `setting/basicManagement`(newview):`tabPages` 配置驱动,scope=`setting.basicManagement.tabs.order`;`TabArea.vue` 增加 `headerLeftInset` 给入口按钮让位。
每页接入模式:
1. 入口:tab 区域左侧「标签排序」按钮(`.sort-entry-btn`)→ 打开 `SortSettingDialog`。
2. 弹窗:`VueDraggable` 拖拽重排默认 tab 列表,点「保存」→ `preferenceStore.set(scope, names)` + `emit('saved', names)`。
3. `index.vue`:`handleSortSaved(order)` → `applyTabOrder(order)` 重排 tabs;挂载时 `applySavedTabOrder()` 读取已存顺序。
4. 无配置时保持默认顺序;非法/缺失项自动处理(缺失 tab 补末尾)。
---
## 5. 扩展性
**新增一个功能 = 新增一个 scope key**,store 与页面接入模板不变:
- 列配置 `order.columns.<tab>`:存 `{ visible, order }`。
- 筛选预设 `order.filter.preset.<tab>`:存 `{ name, where }`。
- 其他模块 `report.*` / `storage.*` / `setting.*` 按同一命名规范注册。
数据结构升级:每个 scope 可带 `schema_version`,前端按版本做 normalize 迁移。
---
## 6. 升级路径(将来如需跨设备同步)
1. store 保持统一读写接口 `load()/get(scope)/set(scope,value)/reset(scope)`,页面不感知数据源。
2. 增加「服务端数据源」实现(`user.preference.get/set`),与本地层并存。
3. 接口就绪后切换数据源,localStorage 降级为缓存/兜底。
4. 数据结构(§3.1)两端保持一致,无需迁移格式。
---
## 7. 里程碑
| 阶段 | 内容 | 验收 |
|------|------|------|
| M1 store | `userPreference` store + 登录/刷新 load + localStorage 读写 | 登录后控制台可见偏好已加载 |
| M2 标签排序落地 | orderManagement 标签排序弹窗 + 保存 + 挂载恢复 | 刷新/重登后标签顺序保持 |
| M2.5 扩展页 | waveOrder / stockManagement / basicManagement 接入共享弹窗 | 4 页均可拖拽排序并持久化 |
| M3 扩展 | 列配置/筛选预设等新 scope 接入 | 新功能走同一套机制上线 |
---
## 8. 遗留 / 待确认
1. 是否把标签排序扩展到其他多标签模块(如 `setting/encoding`、`express/waybill` 等,同机制注册新 scope)。
2. 列表列排序(`order.sort.<tab>`)是否按需接入(本期仅做标签顺序)。
3. 跨设备同步暂不做;若业务上出现强需求,再走 §6 升级路径。

View File

@ -0,0 +1,187 @@
# 登录功能 + 页面渲染框架 · 文件清单与移植指南
> 目的:把本项目的「登录功能」与「后台菜单驱动的页面渲染框架」完整搬到新项目。
> 范围约定:**不含** `userPreference.ts`(用户偏好)、`frontBrand.ts`(域名品牌)、语言切换(`LangSelect` + `lang/` 全量词条)。
---
## 0. 依赖包
```jsonc
{
"vue": "^3",
"vue-router": "^4",
"pinia": "^2",
"axios": "^1",
"element-plus": "^2",
"nprogress": "^0.2", // 路由进度条(permission.ts)
"js-cookie": "^3", // token 存 Cookie(utils/auth.ts)
"path-browserify": "^1", // 页签路径拼接(TaskView)
"@vueuse/core": "^10", // useWindowSize / useFullscreen
"dayjs": "^1", // 顶栏有效期天数计算
"qrcode": "^1", // 登录页扫码二维码(若不需要扫码登录可去掉)
"sass": "^1" // 布局 SCSS
}
```
`vite.config.ts` 需要 `@` → `src` 别名,`tsconfig` 需同步 `paths`。
---
## 1. 登录功能
| # | 文件 | 职责 | 关键点 |
|---|---|---|---|
| 1 | `src/views/login/index.vue` | 登录页:账号密码登录、注册、微信扫码登录 | 登录成功 → `router.push(redirect \|\| '/')`;扫码成功后 `setToken` + `userStore.$patch({token})` |
| 2 | `src/stores/modules/user.ts` | **登录核心 store** | `login / register / getInfo / changeRole / logout / resetToken / updateToken / checkPermission` |
| 3 | `src/api/user/user.ts` | 登录相关接口 | `user.login`、`user.loginByCode`、`user.register`、`user.info`、`user.getAccountInfo`(个人中心)、`user.updateUsername`(改账号)、`user.changePassword`(设置/修改密码)、`user.changeRole`、`user.logout`、`user.getLoginWechatCode`(扫码)、`user.getBindWechatCode` / `user.unbindWechat`(绑定) |
| 4 | `src/utils/auth.ts` | token 存取(Cookie,key=`token`) | `getToken / setToken / removeToken` |
| 5 | `src/utils/request.ts` | axios 封装 | 请求头 `platform/project`、注入 `Authorization: Bearer <token>`、**响应头新 token 自动回写**、`401/50008/50012/50014` → 弹窗重登 |
| 6 | `src/permission.ts` | 路由守卫(登录准入 + 动态路由) | 白名单、getToken 判定、`getInfo()` 拉菜单、失败 `resetToken()` |
| 7 | `src/router/index.ts` | `/login`、`/redirect` 常量路由 | `/login` 在 `constantRoutes` 且 `meta.hidden` |
| 8 | `src/layout/component/Navbar.vue` | 退出登录入口 | `await userStore.logout(); router.push('/login?redirect=' + route.fullPath)` |
| 9 | `.env.development` / `.env.staging` / `.env.production` | `VITE_APP_BASE_API`(后端地址) | `request.ts` 的 `baseURL` |
| 10 | `src/lang/zh-CN.ts` / `en-US.ts`(若做 i18n) | `login.*` 文案 | 不做 i18n 时改为硬编码中文 |
| 11 | `src/views/redirect/index.vue` | `/redirect` 软刷新中转(登出/刷新链路相关) | 见 2.2 |
### 登录链路
```mermaid
flowchart LR
A[访问页面] --> B{permission.ts<br/>getToken?}
B -- 无 --> C[/login?redirect=xxx/]
C --> D[views/login/index.vue]
D --> E[userStore.login]
E --> F[api/user: user.login]
F --> G[utils/request.ts POST /system]
G --> H[auth.ts setToken Cookie]
H --> I[router.push redirect]
I --> B
B -- 有 --> J[userStore.getInfo → user.info]
J --> K[permissionStore.generateRoutes menus]
```
---
## 2. 页面渲染框架
> 核心思想:**后端菜单(`user.menus`)→ `transformMenusToRoutes` → `router.addRoute` → Layout 渲染 → Sidebar/TaskView 消费 `permissionStore.routes`**。
### 2.1 路由层(4 个文件,框架心脏)
| 文件 | 职责 |
|---|---|
| `src/router/index.ts` | `constantRoutes`(`/redirect`、`/login`、`/admin/land`、`/`→dashboard、`/workorder`、`/inbox`、`/profile`、`/download`)、`notFoundRoute`、`notFoundPage`、`transformMenusToRoutes()`、`resolveComponent()`、`resolveViewFromGlob()`、`ParentView`、`createRouter` |
| `src/router/map.ts` | `componentMap`:**后端菜单 `component` 字段 → 页面组件** 的静态映射表(避免 Vite 动态 import 报错) |
| `src/stores/modules/permission.ts` | `routes` / `addRoutes` / `hasAddRoutes`;`generateRoutes(menus)` → 末尾追加 404 |
| `src/permission.ts` | `beforeEach`:白名单 → 取用户信息 → `generateRoutes` → 逐条 `router.addRoute` → `return { ...to, replace: true }` 重进;`afterEach` `NProgress.done()` |
### 2.2 布局层(Layout / 顶栏 / 页签)
| 文件 | 职责 |
|---|---|
| `src/layout/index.vue` | 外壳:`sidebar`(非 top-bottom 模式)+ `fixed-header`(`task-view`)+ `main-box`(`app-main`);响应式 992px 切 `device=mobile` |
| `src/layout/component/AppMain.vue` | **页面渲染出口**:`router-view` + `transition` + `keep-alive`;`wrapRouteComponent()` 把路由组件包装成 `name = route.name` 以让 `include` 生效;`:key="route.name ?? route.path"` |
| `src/layout/component/TaskView/index.vue` | **顶部容器**:`<navbar>` + 快捷键区 + **页签(tags-view)**;`watch(route)` → `tagsViewStore.addView(route)`;右键菜单刷新/关闭/关闭其他/全部关闭 |
| `src/layout/component/TaskView/ScrollPane.vue` | 页签横向滚动容器(横向滚轮) |
| `src/layout/component/Navbar.vue` | **顶部导航栏**:Logo、Breadcrumb(sidebar 模式)、TopMenu(top-bottom 模式)、右侧 有效期/全屏/工单角标/语言/AI、**头像下拉(切换角色 + 个人中心 + 退出登录)** |
| `src/layout/component/TopMenu.vue` | 顶部横向菜单(`layoutMode === 'top-bottom'` 时使用) |
| `src/layout/component/Sidebar/index.vue` | 左侧菜单容器(`el-menu` + `SidebarItem`) |
| `src/layout/component/Sidebar/SidebarItem.vue` | 递归菜单项(唯一子项拍平逻辑) |
| `src/layout/component/Sidebar/Item.vue` / `SubItem.vue` / `Link.vue` | 菜单项渲染 / 子项模板 / 内外链跳转 |
| `src/components/Breadcrumb/index.vue` | 面包屑(依赖 `permissionStore.routes` + `route.matched`) |
| `src/components/SvgIcon/index.vue` | 图标组件(`svg-icon` 全局注册;依赖 `vite-plugin-svg-icons` 的 `virtual:svg-icons-register`) |
| `src/views/redirect/index.vue` | `/redirect/:path(.*)` 中转页(页签"刷新"软刷新) |
| `src/views/404.vue` | 兜底页(动态路由找不到组件时也指向它) |
### 2.3 状态层(Pinia)
| 文件 | 职责 | 是否必需 |
|---|---|---|
| `src/stores/modules/permission.ts` | 动态路由表 | ✅ 必需 |
| `src/stores/modules/app.ts` | `sidebar{opened,withoutAnimation}`、`device`、`toggleDevice/toggleSideBar/closeSideBar` | ✅ 必需 |
| `src/stores/modules/settings.ts` | `fixedHeader`、`layoutMode('sidebar'\|'top-bottom')`、`shortcutExpanded`(`changeSetting`) | ✅ 必需 |
| `src/stores/modules/tagsView.ts` | `visitedViews` / `cachedViews` + `add/del/update` | ✅ 必需(页签 + keep-alive) |
| `src/stores/modules/shortcuts.ts` | 快捷键区数据 | ⚠️ 可选(TaskView 引用,可删) |
| `src/stores/modules/experimental.ts` | `pageCacheEnabled` / `pageCacheMax` | ⚠️ 可选(AppMain 引用,可给默认值) |
| `src/stores/modules/user.ts` | 登录态 | ✅ 必需(见第 1 节) |
### 2.4 样式层
`src/styles/index.scss`、`variables.scss`、`variables.module.scss`(Sidebar 用 JS 取色)、`mixin.scss`(`clearfix` 等)、`sidebar.scss`、`transition.scss`(`fade-transform` 过渡)、`element-ui.scss`。
### 2.5 入口与配置
| 文件 | 职责 |
|---|---|
| `src/main.ts` | `createApp` → `pinia` → `router` → `ElementPlus`;`import './permission'`;注册全局 `svg-icon`;`app.mount('#app')`;`document.title` 统一设置 |
| `src/App.vue` | `el-config-provider`(Element 语言)+ `<router-view />` |
| `src/settings.ts` | `title`、`fixedHeader`、`sidebarLogo`、`shortcutExpanded`、`toolbarMode` 等默认值 |
| `src/utils/get-page-title.ts` | 页面标题拼接 |
| `src/utils/validate.js` | `isExternal`(Sidebar/TaskView/SvgIcon 依赖) |
| `.env.*` | `VITE_APP_BASE_API` 等 |
| `index.html` | `#app` 挂载点 + favicon |
| `vite.config.ts` | `@` alias、`vite-plugin-svg-icons` |
---
## 3. 渲染调用链
```mermaid
flowchart TD
A["后端 user.info → user.menus"] --> B["stores/permission.ts generateRoutes(menus)"]
B --> C["router/index.ts transformMenusToRoutes()"]
C --> D{"menu.component 是什么?"}
D -- "Layout" --> E["Layout (layout/index.vue)"]
D -- "字符串" --> F["componentMap (router/map.ts)"]
F --> G["命中 → 直接返回 lazy loader"]
F --> H["未命中 → import.meta.glob('@/views/**/*.vue') 兜底"]
H --> I["再未命中 → views/404.vue"]
C --> J["permission.ts: router.addRoute(route)"]
J --> K["Layout 渲染"]
K --> L["Sidebar / TopMenu ← permissionStore.routes"]
K --> M["TaskView 页签 ← route 变化 addView"]
K --> N["AppMain router-view + keep-alive ← tagsView.cachedViews"]
```
---
## 4. 照搬不能改的契约(最容易踩坑)
1. **`componentMap` 的 key 必须与后端菜单 `component` 字段一致**(如 `order/waveOrder`、`system/setting/role/index`);不一致时靠 `import.meta.glob` 兜底,再不一致落到 404。
2. **禁止多段路径的模板字符串动态 import**:Vite 生产构建会报 `unknown variable dynamic import`。只能用 `componentMap` 或 `import.meta.glob`。单段路径(如 `warehouse`)才允许 `import(\`@/views/${p}/index.vue\`)`。
3. **keep-alive 的 `include` 用「路由 name」**,但 `<script setup>` 页面组件无 `name` → 必须用 `AppMain.vue` 的 `wrapRouteComponent()` 包装成同名组件,否则缓存完全失效。
4. **keep-alive 必须常驻**(不能放 `v-if` 里),访问 `/login`、`/404` 等 Layout 外页面会卸载 Layout 并清空缓存,这是正常的。
5. **路由 name 冲突**:子路由 name 与父路由相同 → `transformMenusToRoutes` 自动改名为 `${name}_Child`,不要依赖原始 name 做缓存 key 匹配。
6. **顶层路由 path 必须以 `/` 开头**(Vue Router 4 要求,代码已自动补)。
7. **`notFoundPage` / `notFoundRoute` 必须最后追加**,否则会抢先匹配动态路由。
8. `generateRoutes` 后必须 `return { ...to, replace: true }` 让导航重跑一次,否则首次进入白屏。
9. **`permission.ts` 判定登录态用 `userStore.user.employees_name`**(不是只用 token),配合 `getToken()`。
10. **token 双写**:Cookie(`utils/auth.ts`)+ Pinia(`user.ts`);`request.ts` 收到响应头 `Authorization`/`new-authorization` 会回写两者(续期场景)。
---
## 5. 移植步骤建议
1. **初始化**:装依赖 §0,配 `vite.config.ts` 的 `@` 别名 + `vite-plugin-svg-icons`(指向 `src/icons/svg`),`tsconfig` 配 `paths`。
2. **拷贝样式**:`src/styles/*` + `src/icons/` + `src/components/SvgIcon/`。
3. **拷贝工具**:`utils/auth.ts`、`utils/request.ts`、`utils/validate.js`、`utils/get-page-title.ts`、`settings.ts`、`App.vue`。
4. **拷贝状态**:`stores/modules/{app,settings,tagsView,permission,user}.ts`(`app.ts` 里的 `device` 需保留,登录接口要传)。
5. **拷贝路由**:`router/{index,map}.ts`(**删掉业务页面路由,只留 `/redirect`、`/login`、`/404`、dashboard 占位**;`map.ts` 按新项目页面重写)。
6. **拷贝布局**:`layout/**` + `components/Breadcrumb/`。
7. **拷贝登录**:`views/login/index.vue` + `api/user/user.ts`。
8. **接守卫**:`main.ts` 里 `import './permission'`。
9. **改常量**:`.env` 的 `VITE_APP_BASE_API`、`settings.ts` 的 `title`。
10. **验证顺序**:未登录访问任意页 → 跳 `/login`;登录后 `user.info` 拿到 `menus` → 侧边栏出现菜单;点菜单能渲染;开页签;切页签不白屏不重复请求(缓存生效);点退出回登录页。
---
## 6. 本次明确排除(新项目按需自行决定)
| 项目 | 关联文件 | 排除后的副作用 |
|---|---|---|
| 用户偏好 | `stores/modules/userPreference.ts` | 删掉 `permission.ts` 里 `prefs.load()` 三处调用 |
| 域名品牌 | `stores/modules/frontBrand.ts`、`api/frontconfig/` | 删掉 `main.ts` 的 `loadBrandByDomain()`、`Login` 页品牌 computed、`Navbar` 的 `mainLogo` 改用固定图 |
| 语言切换 | `components/LangSelect/`、`lang/`、`vue-i18n`、`App.vue` 的 `el-config-provider` | ⚠️ **注意**:布局里 `tMenu()` 与 `$t()` 大量出现(`Navbar`、`TaskView`、`Sidebar/Item|SubItem`、`Breadcrumb`、`main.ts`),排除 i18n 后这些调用点要改成纯文本 |
| 打印组件 / AI / 工单角标 | `stores/modules/printerComponent.ts`、`layout/component/AiChat/`、`Navbar` 的 `afterSaleWorkCount` | `permission.ts` 的 `ensurePrinterConnectionsAfterLogin()`、`user.ts` 的 `usePrinterComponentStore()` 需一并删除 |
| 快捷键 | `stores/modules/shortcuts.ts` | 删 `TaskView` 里的快捷键区块 |

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,198 @@
# 跨浏览器性能:实测数据、已做优化与待办清单
> 背景:同一套前端,在另一台 PC 上用 Edge 打开明显比 Chrome 慢。
> 本文记录**实测数据**、**已落地的代码优化**、**部署侧待调整项**和**浏览器侧排查清单**。
---
## 1. 结论先说
1. **Edge 与 Chrome 同属 Chromium**,渲染引擎基本一致,代码层面不会「只为 Chrome 优化」。
体感差距通常来自三类原因,按影响从大到小:
- **环境**:Edge 的「效率模式 / 睡眠标签页」、硬件加速被组策略关闭、扩展、企业代理 / DoH、版本差异;
- **首屏包体偏大**:弱 CPU 上「解析 JS + 应用 382KB CSS」的耗时会被放大;
- **资源数量多**:产物有 **493 个 JS + 329 个 CSS** 分片,切页时会产生一串小请求,
弱机 / 有安全软件逐个扫描的环境下,差异被放大。
2. 所以正确做法是**把首屏关键路径做小 + 减少请求数 + 补齐缓存策略**,
而不是针对某个浏览器写分支代码。
---
## 2. 实测数据(2026-11-11,本机 Chrome,线上 `wms.wms.gztbyc.com`)
登录页(首屏):
| 指标 | 数值 |
|---|---|
| 协议 | h2(HTTP/2 已启用 ✅) |
| 请求数 | 10 |
| 传输合计 | 400KB(gzip) |
| 解压合计 | 1317KB |
| TTFB | 120ms |
| DOMContentLoaded | 387ms |
| load | 430ms |
首屏三个关键资源(gzip 后):`index.js` 147KB、`vendor-vue.js` 112KB、`index.css` 54KB。
构建产物(`npm run build-only`):
| 项 | 数值 |
|---|---|
| 文件总数 | 822 |
| JS 分片 | 493(合计 6284KB,未压缩) |
| CSS 分片 | 329(合计 1723KB,未压缩) |
| `index.css`(Element Plus 全量样式 + 全局样式) | **382KB** |
| 入口 `index.js` | 465KB → 优化后 **404KB**(gzip 150KB → 137KB) |
线上响应头现状:
```
Cache-Control: max-age=43200 # 12 小时(带 hash 的资源本可以 1 年 + immutable)
Content-Encoding: gzip # 已开启 ✅(无 brotli)
HTTP/2 # 已开启 ✅(curl 探测不到不代表没有,浏览器实测 h2)
Alt-Svc: h3=":443" # 已通告 HTTP/3
```
---
## 3. 已落地的代码优化
### 3.1 入口 chunk 瘦身:把 400+ 条目的 `import.meta.glob` 拆出首屏
- 文件:`src/router/index.ts`、新增 `src/router/view-glob.ts`
- 原因:`import.meta.glob('@/views/**/*.vue')` 会在构建期展开成一张 400+ 条的映射表
以及每条懒加载的依赖表,全部打进**入口 chunk**,而实际只有「后端菜单的 component
路径在 `componentMap` 里查不到」时才会用到。
- 做法:拆成独立模块 `view-glob.ts`,在 `loadViewModules()` 里**按需 `import()`**;
菜单推断分支改为「先同步查 `componentMap`,未命中再走 glob 兜底」。
- 效果:入口 465KB → 404KB(gzip −13KB),首屏少解析 ~70KB JS。
### 3.2 替换 `path-browserify`
- 文件:新增 `src/utils/path.ts`,改 `layout/component/TaskView/index.vue`、
`layout/component/Sidebar/SidebarItem.vue`
- 原因:全仓只用到了 `path.resolve(base, sub)`,却把 15.5KB 的 CJS polyfill 静态带进了入口。
- 效果:入口再减 ~15KB,并去掉 `process` 垫片依赖。
### 3.3 去掉逐帧 / 全属性过渡带来的抖动
- `src/styles/index.scss`:移除 `text-rendering: optimizeLegibility`
(CJK 下排版收益≈0,弱 CPU 上有额外字形计算开销)。
- `src/styles/transition.scss`:面包屑 `transition: all .5s` →
`opacity/transform` + 0.28s,避免 `all` 把 `left/top/width` 纳入过渡触发 layout。
### 3.4 后台标签页停止轮询
- `src/layout/component/Navbar.vue`:工单角标 30s 轮询改为 `document.hidden` 时跳过,
`visibilitychange` 回到前台补一次。避免 Edge「睡眠标签页 / 效率模式」与 Chrome
后台节流策略不同导致的请求堆积。
### 3.5 增加可对比的性能探针
- 新增 `src/utils/perf-probe.ts`,`main.ts` 里安装(**默认关闭**)。
- 开启:访问地址加 `?perf=1`,或控制台 `localStorage.setItem('__perf_probe','1')` 后刷新。
- 输出:协议版本、TTFB / FCP / DCL / load、请求数与各类资源传输量、
长任务(卡顿)统计、CPU 核数 / 内存 / DPR / UA。
- 用法:在两台机器上分别打开 `?perf=1`,复制控制台 JSON 对比,
能直接判断是「网络慢」还是「CPU 卡」。随时可用 `__perfReport()` 重测。
---
## 4. 部署侧待调整(收益最大,需要服务器/Nginx 配置权限)
> 以下都不改动业务代码,但会显著影响「首次打开 / 隔天首次打开」的速度。
### 4.1 带 hash 的静态资源改长缓存
现在 `max-age=43200`(12 小时)。带内容 hash 的文件可以安全地长缓存:
```nginx
location ^~ /assets/ {
# 文件名含 hash,内容变了文件名就会变 → 可以放心 immutable
add_header Cache-Control "public, max-age=31536000, immutable";
access_log off;
try_files $uri =404;
}
# 入口 HTML 必须每次校验,否则发版后用户仍加载旧资源
location = /index.html {
add_header Cache-Control "no-cache";
try_files $uri =404;
}
```
收益:隔天首次打开不再对 30+ 个分片发条件请求(304 也要一次往返),
弱网 / 高延迟下有肉眼可见差别。
### 4.2 开启 Brotli(比 gzip 再小 15~20%)
```nginx
# 需要 ngx_brotli 模块(宝塔/oneinstack 通常自带开关)
brotli on;
brotli_comp_level 5;
brotli_min_length 1024;
brotli_types text/plain text/css application/javascript application/json image/svg+xml;
```
若不想装模块,至少开启静态预压缩,减少动态压缩的 CPU 抖动:
```nginx
gzip_static on;
```
### 4.3 HTTP/3 的取舍
响应头里有 `Alt-Svc: h3=":443"`。如果 QUIC 监听实际不稳定(部分企业网络封 UDP 443),
**部分浏览器会先尝试 h3 再回退**,表现为首包变慢。建议二选一:
- 确认 `listen 443 quic reuseport;` 正常、UDP 443 可达 → 保留;
- 不确定 → 去掉 `add_header Alt-Svc ...`,让所有浏览器统一走已验证的 h2。
---
## 5. Edge 侧排查清单(在慢的那台 PC 上做)
1. `edge://version`:确认版本与 Chrome 接近(相差太大会有新 API 降级路径)。
2. `edge://gpu`:确认 **硬件加速已开启**(`Graphics Feature Status` 里
`Canvas` / `Compositing` 为 `Hardware accelerated`)。被组策略关掉时,
大表格滚动、阴影、过渡会明显变卡。
3. 设置 → 系统和性能:
- 关闭「**效率模式**」(Efficiency mode);
- 关闭本站在「**睡眠标签页**」里被挂起的可能(把站点加入「从不休眠」);
- 开启「启动加速」。
4. 扩展:用「InPrivate 窗口 / 禁用所有扩展」复测一次,排除单个扩展注入脚本。
5. 网络:`edge://net-internals/#dns` 清 DNS;确认没有走慢速代理;
关闭「使用安全 DNS」后再测(DoH 解析慢会直接拖慢首包)。
6. 安全软件:确认 Defender 实时防护 / 第三方安全软件没在逐个扫描每个 `.js` 分片
(这也是「分片多」会被放大的典型场景)。
7. 复测方法:两台机器都打开 `https://<站点>/?perf=1`,对比控制台报告里的
`TTFB`(网络)与 `长任务合计`(CPU)。
---
## 6. 后续可选(按性价比排序,需单独评估回归)
| 优化 | 预期收益 | 风险 / 成本 |
|---|---|---|
| Element Plus 样式按需(`importStyle: 'css'`,替代 `element-plus/dist/index.css`) | `index.css` 382KB → 约 100KB 级;样式匹配 / 重算成本明显下降 | 需补 message / message-box / notification / loading / overlay 等命令式样式入口,**必须做全站视觉回归** |
| `build.cssCodeSplit: false`(329 个 CSS 合并为 1 个) | 切页 CSS 请求数 → 0;弱网 + 分片多时收益明显 | 首屏 CSS 体积上升(约 +30KB gzip),需实测首屏是否变慢 |
| 把 Element Plus 用到的组件合并成 1~2 个 `vendor-ep` chunk | 减少重复小请求、提升缓存命中 | 与「按需引入减小体积」需权衡,需实测 chunk 总量 |
| 清理剩余 `transition: all`(约 40 处) | 减少 hover / 插入时的 layout 抖动 | 纯样式,逐处验证动画效果 |
| 首屏骨架 / 预渲染 `index.html` | 首屏感知更快 | 需与品牌化标题逻辑(frontBrand)协调 |
---
## 7. 附:本次改动的文件清单
```
src/router/index.ts glob 改为按需加载 + 推断分支调整
src/router/view-glob.ts 新增(glob 兜底表独立 chunk)
src/utils/path.ts 新增(替代 path-browserify)
src/utils/perf-probe.ts 新增(?perf=1 性能探针)
src/layout/component/TaskView/index.vue 改用 resolveRoutePath
src/layout/component/Sidebar/SidebarItem.vue 改用 resolveRoutePath
src/layout/component/Navbar.vue 后台标签不轮询
src/styles/index.scss 移除 text-rendering
src/styles/transition.scss 面包屑过渡收窄属性
src/main.ts 安装性能探针
```

View File

@ -0,0 +1,203 @@
# 进度条类弹窗 / 表单使用清单
> 整理范围:任务进度弹窗,以及提交任务后在**弹窗表单内**原地展示进度的表单。
> 不含页面内联进度(如库位容量、仪表盘统计、账号安全强度)。
>
> **状态(2026-10-20)**:下列 9 个进度弹窗组件均已改为基于
> `components/task-progress/UnifiedTaskProgressDialog.vue`(猎豹进度条)渲染,
> 组件名与页面调用方式保持不变。
> **完成任务后的关闭策略**:任务**成功**后 **1.5 秒自动关闭**(失败保持打开,便于查看错误)。
> 已接入:第 4、5、6 项(波次策略快速扫描 / 抓取任务 / 波次批量任务)与第三节 3 个表单内嵌进度弹窗,
> 统一由 `components/task-progress/useAutoCloseOnSuccess.ts` 实现;
> 导出类(`AsyncExportProgressDialog` / `OrderExportProgressDialog`)由各自的导出 composable 定时关闭。
>
> 示例入口:`order/waveOrder?tab=sandanFallbackOrders` → 「不符合波次策略订单列表」→ 工具栏「快速扫描」→ 波次策略快速扫描进度弹窗。
## 总览
- 共 **9 个组件**、约 **55 处使用**
- 两种形态:
1. **独立进度弹窗**:任务 ID + 进度 + 状态/数量信息(6 个组件)
2. **弹窗表单内嵌进度**:先做表单提交,任务开始后在同一个弹窗里显示进度(3 个组件)
- 只改这 9 个组件即可覆盖全部此类 UI
---
## 一、通用复用组件(影响面最大)
### 1. `src/components/AsyncExportProgressDialog.vue`
- 标题由调用方传入,默认形态:任务 ID、状态、进度百分比、更新时间、提示文案
- 参数摘要:导出范围、导出模式、文件格式、数据量(由提交导出的 payload 自动提取,缺失则不显示)
- 进度:`UnifiedTaskProgressDialog`(猎豹进度条 + 指标区),宽 `min(560px, 92vw)`
- 使用位置(23 个文件 / 25 处):
| 模块 | 文件 |
|---|---|
| 仓库 / 货主 | `views/warehouses/index.vue` |
| 商品 | `views/stock/stock/index.vue`、`views/stock/external_stock/index.vue` |
| 售后 | `views/afterSale/list/index.vue` |
| 数据 | `views/data/packingflow/index.vue` |
| 快递 | `views/express/waybill/index.vue`、`views/express/returnReceived/index.vue`、`views/express/returnUnpack/index.vue`、`views/express/returnUnpack/components/ExportDialog.vue` |
| 入库 | `views/storage/entry/index.vue`、`views/storage/entry_owner/index.vue` |
| 收货 | `views/storage/receiving/index.vue`、`views/storage/receiving_owner/index.vue` |
| 库存 | `views/storage/inventory/index.vue` |
| 盘点 | `views/storage/stockcheck/index.vue`(2 处) |
| 报表 | `views/storage/report/index.vue`、`views/storage/report/store.vue`、`views/storage/generalreport/pages/ExportReportDialog.vue` |
| 商品流水 | `views/storage/productflow/index.vue`、`views/storage/productflow/store/index.vue` |
| 货主店铺 | `views/store/stores/index.vue`(2 处)、`views/store/stores/component/ExportDialog.vue` |
| 基础管理 | `views/system/setting/basicManagement/newview/pages/ExportReportDialog.vue` |
### 2. `src/components/TaskProgressDialog.vue`
- 通用异步任务进度:任务 ID、状态、进度、更新时间、错误/结果
- 实现:`UnifiedTaskProgressDialog`(轮询中禁用关闭,保留原交互)
- 使用位置:
- `views/order/orderManagement/pendingOrder.vue`(分配快递号)
- `views/order/orderManagement/exceptionOrder.vue`(分配快递号)
### 3. `src/views/order/orderManagement/component/OrderExportProgressDialog.vue`
- 订单导出进度:任务状态、任务 ID、进度与完成提示(`UnifiedTaskProgressDialog`)
- 参数摘要:导出模式(如「导出全部(含明细)」)、文件格式(Excel .xlsx)
- 进度明细:`已完成 current_count / total_count`、预计剩余时间
- 指标:已完成、页数、耗时
- 页数优先取后端 `message` 中的 `(a/b页)`,其次取 `sheet_count`,均无时显示 `—`
- 后端 message 中的「已完成 x/y 条 … (a/b页)」会被解析并从提示文案中移除,避免重复展示
- 前置字段设置弹窗 `OrderExportColumnsDialog` 顶部同样展示:导出模式、文件格式、已选字段数
- 使用位置(8 个订单页面):
- `reviewOrder.vue`、`pendingOrder.vue`、`outboundOrder.vue`、`deliveryOrder.vue`
- `exceptionOrder.vue`、`deliveryException.vue`、`archiveOrder.vue`、`entrustWarehouse.vue`
---
## 二、波次模块专用进度弹窗
### 4. `views/order/waveOrder/component/WaveStrategyQuickScanProgressDialog.vue`
- 标题:`波次策略快速扫描`
- 内容:任务 ID、扫描任务进度、提交状态/任务状态/仓库、处理数量、匹配/未匹配、受理时间
- 使用位置(2 处):
- `views/order/waveOrder/FallbackOrderListPanel.vue` ← **`tab=sandanFallbackOrders` 不符合波次策略订单列表**
- `views/order/waveOrder/GroupWaveBatchListPanel.vue` ← `tab=groupWave` 团购波次
- 触发:工具栏「快速扫描」(`wave-config.ts` 中 `label: '快速扫描'`)
- 已改为基于 `UnifiedTaskProgressDialog` 渲染(猎豹进度条);扫描中可「后台运行」关闭弹窗,轮询继续,任务结束后刷新列表。
- **扫描成功后 1.5 秒自动关闭弹窗**(`useAutoCloseOnSuccess`,延迟 1500ms);失败(failed / not_found)不自动关闭,便于查看错误信息。
### 5. `views/order/waveOrder/component/WaveFetchTaskProgressDialog.vue`
- 标题:`抓取任务`
- 实现:`UnifiedTaskProgressDialog`;弹窗显隐由 `taskId` 自动控制,底部操作区常驻(运行中为禁用的「处理中…」,完成后为「关闭」)
- **任务成功后 1.5 秒自动关闭弹窗**(`useAutoCloseOnSuccess`);失败保持打开
- 使用位置(2 处):
- `SandanWaveBatchListPanel.vue`(散单波次)
- `GroupWaveBatchListPanel.vue`(团购波次)
### 6. `views/order/waveOrder/component/WaveBatchTaskProgressDialog.vue`
- 标题由调用方传入,同一组件复用 4 类任务
- 实现:`UnifiedTaskProgressDialog`;弹窗显隐由 `taskId` 自动控制,底部操作区常驻(运行中为禁用的「处理中…」,完成后为「关闭」)
- **任务成功后 1.5 秒自动关闭弹窗**(`useAutoCloseOnSuccess`);失败保持打开
- 使用位置(8 处,散单波次 / 团购波次各 4 处):
| 标题 | 所在文件 |
|---|---|
| `快递号分配任务` | `SandanWaveBatchListPanel.vue`、`GroupWaveBatchListPanel.vue` |
| `储位分配任务` | 同上 |
| `移除异常订单任务` | 同上 |
| `批量取消波次任务` | 同上 |
---
## 三、弹窗表单内嵌进度(提交后原地显示进度)
> 已统一改为基于 `components/task-progress/UnifiedTaskProgressDialog.vue`(猎豹进度条)。
> 下面 3 个表单组件保留原有 props/emits 作为业务包装层,页面调用方式无需改动:
> 无任务 ID 时显示 `mode="form"` 参数区,提交后切到 `mode="progress"` 进度区。
> 任务**成功**后 **1.5 秒自动关闭**(`useAutoCloseOnSuccess`);失败保持打开,便于查看错误。
> 表单态(未提交)不参与自动关闭。
### 7. `views/order/orderManagement/form/SyncOrderIdsForm.vue`
- 表单:同步订单 ID(勾选数量 → 确认同步 → 任务 ID / 状态 / 处理进度 / 总数/已处理/成功/失败)
- 使用位置(3 处):
- `views/order/orderManagement/pendingOrder.vue`
- `views/order/orderManagement/exceptionOrder.vue`
- `views/order/waveOrder/component/PendingOrderListPanel.vue`(散单波次/团购波次的待处理订单列表)
### 8. `views/order/orderManagement/form/StorageAllocateForm.vue`
- 表单:按订单批量分配 / 取消分配储位(允许存储储位开关 → 提交 → 进度)
- 使用位置(3 处):同上(pendingOrder、exceptionOrder、wave 的 PendingOrderListPanel)
### 9. `views/order/orderManagement/form/BatchAsyncTaskForm.vue`
- 表单:订单批量异步任务(拦截 / 解除拦截 / 锁定 / 解锁,配置见 `order-common-config.ts` 的 `PENDING_BATCH_ASYNC_TASK_ACTIONS`)
- 使用位置(2 处):
- `views/order/orderManagement/pendingOrder.vue`
- `views/order/orderManagement/exceptionOrder.vue`
---
## 四、页面内联进度(不是任务弹窗,改造时无需处理)
| 文件 | 用途 |
|---|---|
| `views/warehouse/AreaRacksList.vue` | 库位容量占用条 |
| `views/dashboard/components/StatsCardsWarehouse.vue` | 仪表盘统计卡片进度 |
| `views/dashboard/components/StatsCardsStore.vue` | 仪表盘统计卡片进度 |
| `views/test/index.vue` | 独立测试页的豹子进度条演示 |
---
## 五、统一替换进度(已完成)
以下组件均已改为 `UnifiedTaskProgressDialog`,页面无需再改:
1. `src/components/AsyncExportProgressDialog.vue` → 覆盖 23 个页面 / 25 处
2. `src/components/TaskProgressDialog.vue` → 2 处
3. `src/views/order/orderManagement/component/OrderExportProgressDialog.vue` → 8 个订单页面
4. 波次 3 个专用弹窗 → 12 处
5. 3 个表单内嵌进度 → 8 处
> 说明:以上 9 个组件已全部基于 `UnifiedTaskProgressDialog` 渲染,无需再逐个替换进度条。
---
## 六、「预计剩余时间」怎么显示
后端所有任务进度接口都**不返回**剩余时间,只有 `progress(_percent)` / `processed_count` /
`total_count` / `duration_ms` / `submitted_at` / `update_time`。所以只能前端估算:
```
预计剩余 ≈ 已用时长(duration_ms) × (100 - progress) / progress
```
组件用法:给 `TaskProgressPanel` / `UnifiedTaskProgressDialog` 传 `elapsed-ms`(已用毫秒,
取接口 `duration_ms`;没有该字段的接口可用 `Date.now() - 轮询开始时间`),组件会自动显示
「预计剩余 12秒」:
```vue
<UnifiedTaskProgressDialog
:visible="visible"
title="导出订单数据"
:progress="percent"
:elapsed-ms="progressData.duration_ms"
/>
```
规则(`src/components/task-progress/estimate.ts`):
- `progress` 为 0、`elapsedMs` 为 0 时不显示(无法外推)
- `progress` 到 100 或状态为 `failed` 时不显示
- 文案固定带「预计」前缀;`etaText` 仍可显式覆盖
---
## 七、进度 / 数字平滑动画
后端按轮询间隔(常见 1.5s / 2s)返回阶梯式进度,直接渲染会「跳一下 → 停一段 → 再跳一下」。
`UnifiedTaskProgressDialog` 内置了逐帧补间,页面无需改造:
- 百分比、猎豹位置、进度条宽度由 `src/components/task-progress/smoothing.ts` 用
`requestAnimationFrame` 逐帧驱动,不再依赖 CSS `transition`。
- 动画时长按最近两次接口返回的间隔自适应(取其 85%,320–1700ms),
轮询 2s 就动画约 1.7s,避免中途长时间停顿。
- 进度明细(如「已处理 1,286 / 2,040」)与指标数字(`AnimatedNumber.vue`)同样补间;
文本结构变化(如追加页数)或数值下降(任务重置)时直接吸附。
- 任务进入完成 / 失败状态时立即对齐目标值,避免绿色进度条还在缓慢爬行。
- 尊重系统「减少动态效果」:开启 `prefers-reduced-motion` 时全部直接吸附。
明细里如果含日期/时间(如 `TaskProgressDialog` 的「更新时间」),传 `:animate-detail="false"`,
避免时钟数字被补间。

View File

@ -0,0 +1,83 @@
# 部署-本地打包丢文件问题与修复
## 现象
`npm run deploy` 在本地构建、上传都正常,最后报:
```
❌ 新版本 index.html 缺失或为空,取消切换
```
(来自 `scripts/remote/deploy.sh` 的打包完整性校验,`exit 1`;**线上版本未被切换,站点不受影响**。)
服务器上留下一个残缺版本目录(如 `releases/v20261010_175526_29776/`):
有 `assets/`(743 个文件)、`favicon.ico`、`hikvision/`、`logo/`,**唯独没有 `index.html`**。
## 根因
**本地 `tar` 打包时把 `dist/index.html` 静默丢掉了**,上传的 `dist.tar.gz` 里根本没有它。
Windows 自带的 `tar.exe` 是 bsdtar(libarchive)。libarchive 有一条「不要把归档文件加进归档自己」的保护:
```c
/* libarchive/archive_write_open_filename.c —— 打开输出文件时记录其身份 */
if (S_ISREG(st.st_mode))
archive_write_set_skip_file(a, st.st_dev, st.st_ino);
/* libarchive/archive_write.c —— 写入每条 entry 时比对 */
if (archive_entry_ino_is_set(entry) &&
archive_entry_dev(entry) == (dev_t)a->skip_file_dev &&
archive_entry_ino64(entry) == a->skip_file_ino) {
archive_set_error(&a->archive, EIO, "Can't add archive to itself");
return (ARCHIVE_FAILED); /* 只让这一条 entry 失败,tar 退出码仍是 0 */
}
```
Windows 下这组 `(dev, ino)` 文件身份信息不可靠:当**压缩包与被打包目录同处一个目录/同一个卷**时,
目录里某个普通文件会被误判成「归档自身」而被丢弃。实测丢的正好是 `dist/index.html`。
两个致命放大点:
1. **退出码 0**:只给该 entry 返回 `ARCHIVE_FAILED`,不是致命错误 → `deploy.mjs` 里 `run('tar', ...)` 判不出来。
2. **本地只校验 `dist/`,不校验压缩包** → 坏产物被上传,直到远端校验才失败。
## 复现与证据(本地实测)
```powershell
# 压缩包放在项目目录里(旧写法)——丢文件,但退出码 0
tar -czf dist.tar.gz -C dist .
# stderr: Can't add archive to itself
# 条目 780,无 ./index.html
# 压缩包换到别的位置(或换个不会被误判的名字)——正常
tar -czf "$env:TEMP\x.tar.gz" -C dist .
# 条目 781,含 ./index.html
```
两次归档**只差 `index.html` 一个文件**。
因为是文件身份信息「撞车」,取决于该目录的创建/删除历史(MFT 索引复用等),所以**表现为偶发**:
同样的命令换名/换目录/重跑就可能正常。
## 修复
改 `scripts/deploy.mjs`:
1. **压缩包改放系统临时目录**(`os.tmpdir()`)——跨卷时 `dev` 不同,不可能再被误判;
远端解压用的文件名仍是 `dist.tar.gz`(`TARBALL_NAME`),只是本地路径变了。
2. **打包后回读压缩包校验**(`tar -tzf`),规则与远端 `deploy.sh` 一致:
`index.html` + `index.html` 里引用的所有 `/assets/*.js|css` 必须齐全;缺文件则**重新打包一次**,仍缺才中止。
3. 本地 `index.html` 校验补上「非空」判断。
另外新增两个排查开关(不改线上行为):
```bash
npm run deploy -- --pack-only # 构建 + 打包 + 校验,不上传
npm run deploy -- --pack-only --skip-build # 复用已有 dist,只验证打包
```
## 排查/验证手法
- 看压缩包内容:`tar -tzf <归档> | findstr index.html`(**必须确认有此条目**)
- 看到 `Can't add archive to itself` 警告即为本条问题的特征
- 远端校验失败留下的版本目录可安全删除(脚本会按 KEEP 数量自然淘汰,不影响 `current`)

View File

@ -0,0 +1,191 @@
# 页面切换渲染性能优化方案
> 场景:顶部导航栏 / 页面 tab(tags-view)切换页面时,切换速度慢 + 存在显示渲染 bug
> 状态:**P0 与 P1 部分已实施(2026-08-31)**;P1-方案 5/7 评估后保留;P2 未做
> 日期:2026-08-31
---
## 一、背景与目标
当前通过「顶部导航栏(TopMenu/Navbar)」或「页面 tab(TaskView/tags-view)」切换路由页面时:
- **速度慢**:切换有明显卡顿/等待,重页面尤甚
- **显示 bug**:切换过程白屏闪烁、页面位移跳动、内容被固定表头遮挡、同页参数变化整页重建
目标:在不改变业务功能的前提下,**提升页面切换渲染速度**并**修复切换显示问题**。
---
## 二、现状:页面切换渲染链路
```
顶部导航/页面 tab
│ router.push / router-link
▼
permission.ts router.beforeEach → NProgress.start() + 权限校验
▼
AppMain.vue <router-view v-slot> → 页面渲染核心
│ <transition name="fade-transform">
│ <keep-alive :include="cachedViews">
│ <component :is="Component" :key="route.fullPath" />
▼
router.afterEach → NProgress.done()
▼
TaskView watch(route) → addTags() + moveToCurrentTag()
```
### 关键代码位置
| 文件 | 职责 |
|---|---|
| `src/layout/component/AppMain.vue` | 路由页面渲染容器(transition + keep-alive + key) |
| `src/layout/component/TaskView/index.vue` | 页面 tab 栏(tags-view),`watch(route)` 添加/维护 tab |
| `src/layout/index.vue` | 主布局(fixed-header 固定表头 + task-view + app-main) |
| `src/layout/component/Navbar.vue` / `TopMenu.vue` | 顶部导航栏 / 顶部菜单 |
| `src/stores/modules/tagsView.ts` | `visitedViews` / `cachedViews`(keep-alive include 白名单) |
| `src/permission.ts` | 路由守卫(beforeEach / afterEach,动态路由生成) |
| `src/views/redirect/index.vue` | tab「刷新」用的中转页(`/redirect/:path`) |
---
## 三、问题根因分析
### 3.1 切换慢的原因
#### A1. `AppMain` 的 `:key="route.fullPath"` 导致过度销毁重建
```html
<component :is="Component" :key="route.fullPath" class="app-router-page" />
```
- `fullPath` = `path + query`。**只要 query 变化**(页面内部 `?tab=`、筛选条件 URL 化等),key 就变化 → Vue 视为不同实例 → 即使命中 keep-alive 也会触发「旧实例 deactivated + 新实例 created」→ 整页销毁重建、重复执行 `onMounted`、重复请求。
- 已在 `order/orderManagement`、`order/waveOrder` 用「方案B 去路由化」局部规避(内部 tab 不写回 URL),但**根因仍在 AppMain**,其它带 query 参数的页面同样中招。
#### A2. 路由级 keep-alive 的 `:include="cachedViews"` 与组件 name 不匹配 → 缓存失效
```html
<keep-alive :include="cachedViews">
```
- `cachedViews` 由 `tagsView.addCachedView` 维护:`cachedViews.push(view.name)`,push 的是**路由 name**(如 `order/index`、`stock/stockManagement`)。
- `<keep-alive :include>` 匹配的是**组件 name**(`defineOptions({ name })` 或 SFC 推断名)。
- 项目大量路由页面组件**未定义 `defineOptions({ name })`**(`orderManagement/index.vue`、`waveOrder/index.vue`、`stockManagement/index.vue` 等),组件 name ≠ 路由 name → **include 匹配失败 → 这些页面实际从未被路由级缓存**,每次切换都全新挂载 + 重新请求 + 白屏闪烁。
- 这是"切换慢 + 白屏"的**首要根因**。
#### A3. transition 无 `mode="out-in"` + 0.5s 动画 + 位移
```css
.fade-transform-leave-active, .fade-transform-enter-active { transition: all .5s; }
.fade-transform-leave-active { position: absolute; width: 100%; }
.fade-transform-enter-from { opacity: 0; transform: translateX(-30px); }
.fade-transform-leave-to { opacity: 0; transform: translateX(30px); }
```
- `<transition>` 未设 `mode`(默认 enter/leave 同时进行):切换时**新旧两页同时存在/渲染**,重页面在切换瞬间渲染两份 → 主线程峰值高、感知慢。
- `transition: all .5s`(0.5s)对重型页面过长;`translateX(±30px)` 产生横向位移。
- 且离开页 `position: absolute` 与进入页重叠,易出现布局跳动。
#### A4. 大页面挂载成本高
- `orderManagement` 等重页面 `onMounted` 同步发多个请求(`loadData` + `loadOrderMetaOptions` + `loadStoreOptions` + badge 等),一次渲染大量表格/标签/tooltip 组件。
- 因 A1/A2 缓存失效,每次切换都重复走完整挂载流程 → 慢被放大。
#### A5. cachedViews 无限累积
- 每打开一个新 tab,`cachedViews` 就追加一个 name,keep-alive 缓存实例持续增长 → 内存占用与切换匹配开销上升(无 `:max` 上限)。
### 3.2 显示 bug 的原因
| # | 现象 | 根因 |
|---|---|---|
| B1 | 切换白屏/闪烁 | A2 缓存失效 → 每次切换销毁重建,旧页消失、新页空白等待数据 |
| B2 | 同页 query 变化整页重建 → tab/筛选闪烁 | A1 `:key=fullPath` |
| B3 | 切换时两页叠加、横向位移跳动 | A3 无 `out-in` + `translateX` |
| B4 | 内容被固定表头遮挡/偏移 | `AppMain.vue` `.fixed-header + .app-main { padding-top: 90px }` 为**固定值**,而 `layout/index.vue` 表头实际高度动态为 `97px`(普通)/ `134px`(快捷栏展开)→ 快捷栏展开时内容顶部被遮挡 |
| B5 | tab「刷新」时多跳一次、闪烁 | `TaskView.refreshSelectedTag` = `delCachedView` → `router.replace('/redirect'+fullPath)` → redirect 组件再 `replace` 回原页,**两次跳转** |
| B6 | 缓存复用时数据陈旧/事件重复 | 页面只写 `onMounted`/`onUnmounted`,未处理 `onActivated`/`onDeactivated` |
---
## 四、优化方案(分阶段实施)
> 原则:先低成本高收益(P0),再做治理(P1),最后可选优化(P2)。每阶段独立可上线、可回滚。
### P0 — 核心修复(✅ 已实施)
#### 方案 1:`:key` 从 `fullPath` 收窄为 `path` ✅ 已实施
- 文件:`src/layout/component/AppMain.vue`
- 实际做法:`:key="route.name ?? route.path"`(不含 query)。
- 收益:同页面 query 变化不再触发销毁重建;仅跨路由切换才重建/切换缓存。
- 风险:同页 query 需局部刷新(如筛选参数在 URL 的页面)→ 用页面内 `watch(() => route.query)` 局部刷新,不整页重建。
- 回归点:所有依赖"query 变化自动重载"的页面。
#### 方案 2:修复 keep-alive `:include` 匹配 → 让路由级缓存真正生效 ✅ 已实施(采用 B 路线:包装组件)
- 目标:`cachedViews`(路由 name)与组件 name 对齐。
- **实际做法(B 路线的更优实现)**:动态路由 name 来自后端菜单,前端组件无法保证一一对应,因此改为在 `AppMain.vue` 用 `wrapRouteComponent(Component, route.name)` 将路由组件**包装为 name=路由 name 的组件**,使 `<keep-alive :include="cachedViews">` 真正匹配。
- **关键约束**:keep-alive 必须始终存在(不能放 v-if:访问 Layout 外页面会卸载 KeepAlive 导致全部缓存清零)。
- 收益:切回已打开过的 tab 页面**不重建、不重新请求**,白屏消除(实测切回 orderManagement 列表请求 = 0)。
#### 方案 3:transition 改 `mode="out-in"` + 缩短/简化动画 ✅ 已实施
- 文件:`src/layout/component/AppMain.vue` + `src/styles/transition.scss`
- 实际做法:`fade-transform` 收敛为纯淡入淡出(`opacity .2s`),去掉 `translateX`;AppMain 加 `mode="out-in"`。
- 收益:新旧页面不再同时渲染(内存/主线程峰值下降),无横向位移。
### P1 — 缓存与布局治理
#### 方案 4:cachedViews / keep-alive 实例上限治理 ✅ 已实施
- 文件:`src/layout/component/AppMain.vue`
- 实际做法:`<keep-alive :include="cachedViews" :max="10">`(LRU 上限 10)。
#### 方案 5:统一 `onActivated` / `onDeactivated` 生命周期 ⏸ 评估后保留(长期治理)
- 涉及所有缓存页面(几十个),需逐个评估业务逻辑(数据实时性 vs 缓存),风险高,不适合一次性大改。
- 建议后续按需推进:把"进入需刷新"的数据加载从 `onMounted` 迁到 `onActivated`,清理逻辑迁到 `onDeactivated`。
#### 方案 6:fixed-header 高度动态化 ✅ 已实施
- 文件:`src/layout/index.vue`
- **实际做法**:spacer 高度由 `shortcutExpanded ? '134px' : '84px'` 改为 `'134px' : '97px'`,与 header minHeight 对齐(原 84 比 97 矮 13px → 内容顶部被固定表头遮挡)。实测内容 top 与 header bottom 对齐(gap=0)。
#### 方案 7:tab「刷新」减少一次跳转 ⏸ 评估后保留(`/redirect` 为必要机制)
- `refreshSelectedTag` 的 `/redirect` 中转是 keep-alive 缓存体系下"强制重建"的必要机制:缓存 key 为 `route.name`,直接 replace 到同路径不会重建;必须先删缓存 + 跳转离场再回场才能强制刷新。
- 收益有限且有破坏刷新功能的风险,保留现状。
### P2 — 可选 / 长期(未做)
#### 方案 8:重型页面渲染优化(与切换无关的既有性能债)
- 继续 `UpperTable` 侧优化:列收敛、tooltip 收窄、长期评估 `el-table-v2`(详见 `docs/UpperTable-大列表滚动性能优化方案.md`)。
- 收益:降低单页面板载成本,间接降低切换时的挂载耗时。
#### 方案 9:首屏按需加载评估
- 确认动态 import 分包已生效;对超大页面评估首屏拆块(如详情面板懒渲染、非首屏 tab 懒挂载)。
---
## 五、预期效果
| 指标 | 现状 | P0 后 |
|---|---|---|
| 切回已打开 tab | 重建 + 重请求(白屏) | 缓存命中,瞬时恢复 |
| 同页 query 变化 | 整页销毁重建 | 不重建,局部刷新 |
| 切换动画 | 0.5s + 位移 + 双页叠加 | ~0.2s 淡入淡出,单页 |
| 固定表头内容遮挡 | 快捷栏展开时被挡 | 高度联动,不再遮挡 |
| tab 刷新 | 两次跳转 | 一次跳转 |
---
## 六、实施顺序与回归清单
### 实施顺序
1. **P0-方案 2**(补组件 name)→ 让缓存先真正生效(收益最大、风险集中)
2. **P0-方案 1**(`:key` 收窄)+ **P0-方案 3**(transition)→ 消除重建与叠加
3. **P1**(上限治理 / 生命周期 / fixed-header / 刷新跳转)
4. **P2** 视资源可选
### 回归清单(重点页面)
- `order/orderManagement`(8 tab、query 参数、角标)
- `order/waveOrder`、`stock/stockManagement`(多 tab + 详情 tab)
- 筛选条件 URL 化的页面(验证 query 变化不整页重建、数据仍正确刷新)
- 快捷栏展开/收起时各页面顶部内容不被遮挡
- tab 打开/关闭/刷新/关闭其他/关闭全部 全流程
- 登录态变化(用户/角色切换)后缓存不串数据
---
## 七、风险与备注
- **`:key` 收窄**是行为变更:需确认没有页面依赖"query 变化自动重建"。若有,用页面内 `watch(route.query)` 替代,切勿全局回退。
- **补组件 name** 需与路由 name 一一对应,避免误缓存带草稿/表单态的页面;可在 `meta.noCache` 排除个别页面。
- **transition 改 out-in** 会改变切换视觉,需与 UI 确认动画时长偏好。
- 本方案仅针对「路由级页面切换」;页面**内部** tab(如 orderManagement 8 tab)已有独立 keep-alive 与实验性 tab 缓存设置,与本方案互补,不冲突。

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,621 @@
# 页面缓存下「操作成功后自动刷新列表」设计方案
> 状态:设计稿(仅分析,未改代码)
> 适用范围:所有启用了「页面缓存 / Tab 缓存」的列表页,以 `order/orderManagement` 为落地样例
> 更新日期:2026-09-05
> 审计修订(2026-09-05):按「修改平台后刷新 / 切到 waveOrder 零副作用 / 缓存保持正常」做了代码级复核,修正了“嵌套 keep-alive 会把路由级 `activated` 透传给子页签”的误述(不成立),并补充「脏标记懒刷新」为推荐主方案。修订点见 §2.1.3、§6 方案 A/B、§8、§9、§10。
> 审计修订2(2026-09-05,操作影响范围):按「在待处理订单执行『修改平台』后仅本页刷新、待审核订单等其它页签不受影响」复核——各订单页签按状态互斥、行不重叠(各自查 `orderPendingOrder/orderReviewOrder/orderExpectionOrder/...` 的 list),修改平台只改本列表字段值、不改成员资格,**现状本地 `params.loadData()` 即满足需求,无需跨页 dirty/广播**。此前粗 scope `order.list.changed` 会让不含这些行的页签在切回时被无意义刷新,已废弃,改为「默认局部刷新 + 仅类型②操作对受影响目标桶打细粒度脏」。新增 §3.1 分类,修订 §2.4、§6、§7、§8、§9、§10。
---
## 1. 背景与目标
### 1.1 需求描述
项目已启用两级页面缓存(路由级 keep-alive + 页面内部 Tab 级 keep-alive)。缓存带来「切走再切回不重新挂载、列表数据不刷新」的副作用。
期望行为:**页面内/跨页面执行了会改动列表数据的某个功能后,自动调用与「刷新按钮」相同的刷新接口拉取最新数据**,无需用户手动点刷新。
典型例子:`order/orderManagement` 中执行「建单」「修改平台」等操作后,列表 / 角标应自动保持最新。
### 1.2 术语约定
| 术语 | 含义 |
|---|---|
| 路由级缓存 | `AppMain` 里 `<keep-alive :include="cachedViews">` 对整页路由组件的缓存(`orderManagement` 整页) |
| Tab 级缓存 | `orderManagement/index.vue` 内部 `<KeepAlive :max="tabCacheMax">` 对 8 个子页签(待审核/待处理/…)的缓存 |
| `loadData()` | 每个列表子页「唯一的取数函数」,与表格右上角「刷新按钮」(`UpperTable` 的 `@refresh`)是同一个函数 |
| 全局宿主 | 挂在 Layout 层、不在任何 keep-alive 内的常驻组件(如建单弹窗 `CreateOrderSessionHost`) |
### 1.3 目标与非目标
**目标**
1. 明确「页面缓存 + 列表自动刷新」的完整触发链路与责任划分。
2. 沉淀一套可复用的通用机制(而非每个页面各写一套),兼容本项目已有写法。
3. 以 `orderManagement` 为例给出落地映射与验收点。
**非目标**
- 不改动缓存策略本身(缓存开关/容量由实验性设置控制)。
- 不做通用全局 event-bus 引入(避免引入第三方依赖与全局耦合)。
- 本文只出方案,不落地代码。
---
## 2. 现状分析(基于代码梳理)
### 2.1 两级缓存结构
#### 2.1.1 路由级缓存
`src/layout/component/AppMain.vue`:
```html
<keep-alive :include="pageCacheEnabled ? cachedViews : []" :max="pageCacheMax">
<component :is="wrapRouteComponent(Component, route.name)" :key="route.name ?? route.path" />
</keep-alive>
```
- `cachedViews` 来自 `stores/modules/tagsView.ts`(按路由 `name` 加入/删除)。
- `wrapRouteComponent` 把路由组件包装成 `name = 路由 name`,使 include 真正生效。
- `pageCacheEnabled / pageCacheMax`(默认开、`max=8`,LRU)来自 `stores/modules/experimental.ts`。
结论:`order/orderManagement` 整个页签容器在路由切换时**不会卸载重建**,切回时走的是 `activated` 而非 `mounted`。
#### 2.1.2 页面内 Tab 级缓存
`src/views/order/orderManagement/index.vue`(同样模式还有 `stock/stockManagement/index.vue` 等):
```html
<KeepAlive v-if="tabCacheEnabled" :max="tabCacheMax">
<component :is="activeComponent" />
</KeepAlive>
```
- 8 个子页签组件:`reviewOrder / pendingOrder / exceptionOrder / outboundOrder / entrustWarehouse / deliveryOrder / deliveryException / archiveOrder`。
- `tabCacheEnabled` 默认开、`tabCacheMax` 默认 2(LRU),仍来自 `experimental` store。
- 页签切换走本地状态(`handleTabChange`),不写回 URL,避免触发 AppMain 整页重建(详见 `index.vue` 注释「方案B」)。
结论:切走再切回某子页签,组件不卸载,**不会自动拉取**。超过 2 个页签时最久未用的会被 LRU 淘汰(触发卸载,下次进入重新 `mounted` 拉取)。
#### 2.1.3 关键结论
两级缓存导致两类“不刷新”:
- ① 路由级:从其它菜单/页面回到 `orderManagement` → 不刷新。
- ② Tab 级:在 `orderManagement` 内部切回已缓存子页签 → 不刷新。
##### ⚠️ 重要事实:嵌套 keep-alive 的 `activated` 只作用在“直接子级”
- Vue 的 keep-alive 只对其**直接子组件**触发 `activated/deactivated`。当外层(`AppMain` 路由级)keep-alive 激活/停用 `orderManagement/index.vue` 时,只是把整棵子树移入/移出 DOM,**不会**把 `activated` 透传给容器内部的 Tab 级 keep-alive 子组件(`reviewOrder/pendingOrder/…`)。
- 因此:
- 子页签自己的 `onActivated` **只能**覆盖“在容器内部切回某缓存 Tab”(Tab 级);
- “从其它菜单/页面切回 `orderManagement`”需要**容器(`index.vue`)级的 `onActivated`** 自行向当前激活页签转发刷新,不能指望子页签收到路由级激活(见方案 A-2)。
- 对应地,`waveOrder` 等其它缓存路由同理:给它们加 `onActivated` 只会在“切回 waveOrder 本页”时触发,不会在切走或停留在其它页面时触发任何动作。
### 2.2 列表唯一的刷新入口:`loadData()`
各子页签结构高度一致(以 `pendingOrder.vue` 为例):
```ts
async function loadData() {
if (loading.value) return // ① loading 去重(天然幂等,防并发重复请求)
loading.value = true
const queryParams = { pagination, where: buildExportWhere(), sort } // ② 沿用当前筛选/分页
try {
const res = await orderPendingOrder.list(queryParams)
// ③ 解析后写 list / pagination.total
} finally {
loading.value = false
queryTime.value = Date.now() - start
}
}
```
模板中:
```html
<upper-table ... @refresh="loadData" />
```
- 「刷新按钮」= `UpperTable` 内部刷新图标 → emit `refresh` → `loadData`。
- `loadData` 具备:loading 去重、沿用当前筛选与页码、耗时统计。**“自动刷新”应复用它,语义 = 模拟点了一次刷新按钮**。
### 2.3 已有「操作 → 刷新」机制盘点
#### 2.3.1 同页操作:成功后原地 `loadData()`
集中实现于 `src/views/order/orderManagement/utils/toolbar-actions.ts`(工厂函数注入 `loadData` 作为 `params.loadData` / `reload`):
| 功能 | 入口 | 成功后行为 |
|---|---|---|
| 修改平台 / 修改快递 | `submitUpdateOrderMeta` | 关闭弹窗 → `clearSelection()` → `await params.loadData()` |
| 通用批量动作(改留言/加急/锁单…) | `executeApiAction(... reload: params.loadData)` | 成功 → `reload()` |
| 储位分配 | `submitStorageAllocate`(含异步轮询) | 轮询结束 → `params.loadData()` |
| 批量复制 / 手动运单 / 地址修改 / 同步订单号 / 异常处理等 | 各 `submit*` | 成功后 `await loadData()` |
另外打印链路(`pendingOrder.vue`):
```ts
useOrderBatchPrint({ ..., onPrintSuccess: () => loadData() })
useSubWaybillPrint({ ..., onPrintSuccess: () => loadData() })
```
**共同特征:只刷新“当前这个页签实例自己”。** 若同一条数据在另一个缓存页签里也在展示,那个页签不会自动更新。
#### 2.3.2 全局宿主 + 跨页签刷新:`useCreateOrderSession`(建单场景)
这是项目里**唯一已实现“跨缓存实例自动刷新”的参考实现**,值得重点解剖:
- 全局宿主:`src/layout/component/CreateOrderSessionHost.vue` 挂在 `layout/index.vue` 的 `main-box` 里,位于 `<app-main/>` 旁,**不在任何 keep-alive 内**,生命周期与 Layout 相同。
- 模块级单例 composable:`src/views/order/orderManagement/composables/useCreateOrderSession.ts` 在**模块顶层**持有状态:
```ts
const successCallbacks = shallowRef(new Set<() => void | Promise<void>>())
export function useCreateOrderSession() {
function registerCreateOrderSuccess(cb) { successCallbacks.value.add(cb) }
function unregisterCreateOrderSuccess(cb) { successCallbacks.value.delete(cb) }
async function notifyCreateOrderSuccess() {
const tasks = Array.from(successCallbacks.value).map((cb) => cb())
await Promise.allSettled(tasks)
}
// ...
}
```
- 订阅方(各列表页签):`reviewOrder.vue`、`pendingOrder.vue`、`exceptionOrder.vue` 均
```ts
onMounted(() => { registerCreateOrderSuccess(loadData); loadData(); ... })
onUnmounted(() => { unregisterCreateOrderSuccess(loadData) })
```
- 触发方(建单弹窗 `CreatePendingOrderDialog.vue`,批量建单成功后):
```ts
if (result.success_count > 0) {
emit('success')
void notifyCreateOrderSuccess() // → 所有“存活且已订阅”的页签各自 loadData()
}
```
**要点提炼(这套机制能正确适配缓存的原因)**
1. 注册/注销挂在 `onMounted/onUnmounted` 而非 `onActivated/onDeactivated`。
- keep-alive 缓存中,隐藏页签仍是“已 mounted 未销毁”状态 → 回调保留;
- LRU 淘汰销毁才 `onUnmounted` → 回调注销,**不会产生对已销毁页签的幽灵刷新**。
2. 触发方与页面解耦(建单弹窗活在 Layout 全局宿主,与缓存页不在同一棵组件树),因此必须用模块级(跨组件)通信,而不是组件 props/事件。
3. 事件回调即 `loadData`,天然幂等(loading 去重)+ 沿用筛选条件。
#### 2.3.3 `onActivated` 刷新的既有先例(storage/entry)
`src/views/storage/entry/component/DirectInboundLogs.vue`、`EntryBindingRelations.vue` 已有:
```ts
onActivated(() => { if (props.id) void loadLogs() })
```
说明「keep-alive 实例被再次激活时重新取数」在本项目已被使用过,可作为通用化依据。
### 2.4 现状能力矩阵(orderManagement 子页签)
| 操作 | 是否刷新当前页 | 是否刷新其它缓存页签 | 是否刷新全局宿主/角标 |
|---|---|---|---|
| 建单(批量/识别) | ✅(bus 通知) | ✅(bus 通知,所有已订阅存活页签) | 角标仅在切 tab / 挂载时刷新,建单后不刷 |
| 修改平台 / 修改快递 | ✅ 原地 loadData | ❌ | ❌ |
| 其余 toolbar 动作 | ✅ 原地 loadData | ❌ | ❌ |
| 打印成功 | ✅ | ❌ | ❌ |
| 切回缓存页签 / 切回本菜单 | ❌(无 onActivated) | — | — |
> 缺口即文档第 3 节要解决的问题。注意:矩阵中「刷新其它缓存页签 ❌」对**类型①本页局部操作(如修改平台/快递)是期望行为**,不是缺口——订单各页签按状态互斥、行不重叠,其它页签不含这些行,跨页刷新既无意义又会打扰用户(见 §3.1)。
---
## 3. 问题拆解
在页面缓存前提下,“执行功能后自动刷新”包含四个相互独立的子问题,需分别对待:
| 编号 | 子问题 | 场景示例 | 本质 |
|---|---|---|---|
| P0 | 缓存页**重新被激活**时不刷新 | 在其它菜单处理了订单 → 切回 `orderManagement`;或在本页 8 个页签间来回切换 | 组件没走 `mounted`,走了 `activated`;当前无 `onActivated` 刷新 |
| P1 | 某页签内操作只刷新自己,其它缓存页签不同步 | (仅当同一记录可能同时出现在两个页签时)A 页操作后切到 B 页仍是旧值 | 前提是两页列表**数据重叠**;待审核/待处理等按状态互斥的页签不存在此问题 → 先按 §3.1 判定是否为真的需要跨页的类型②操作 |
| P2 | **Layout 层全局宿主**(非缓存树内)执行操作,页面需要感知 | 全局悬浮「建单」在任意页签创建订单 | 组件树隔离,只能用跨组件通信(模块级单例) |
| P3 | **异步长任务**(打印/批量异步批处理/轮询)结束后才落库 | 打印成功、储位分配轮询结束 | 刷新时机在“任务终态”而非“提交成功” |
| P4 | 操作导致**数量变化**,顶部**角标**不同步 | 建单后待处理数 +N | 角标由容器 `index.vue` 管理,与子页签不在同层 |
### 3.1 操作对列表的影响范围分类(决定要不要跨页刷新)
> 审计补充(2026-09-05):不是所有操作都需要“跨页签同步”。先按“影响范围”分类,**默认只做本页局部刷新**;只有会影响“其它页签数据集成员资格 / 计数”的操作才打脏。订单各页签按状态互斥:待审核(`orderReviewOrder.list`)、待处理(`orderPendingOrder.list`)、待处理异常(`orderExpectionOrder.list`)、待出库(`orderOutboundOrder.list`)、配送(`orderDeliveryOrder.list`)各查各桶,同一订单只落在一个状态桶。
| 类型 | 特征 | 示例 | 建议 |
|---|---|---|---|
| ① 本页局部 | 只改当前列表行的字段值,不改成员资格 | 修改平台/快递(仅 `order.pendingOrder.updateOrderPlatform/Express`,改待处理订单平台字段值)、改留言、改地址/备注 | **只 `params.loadData()`(现状已满足),不打脏、不广播**;其它状态互斥页签不含这些行,无需且不应被刷新 |
| ② 成员迁移/新增 | 让数据“进入/离开/新建于”其它页签,或改变其角标计数 | 建单(新单落入待处理桶)、异常转待处理(`orderExpectionOrder.resolveException`,从异常桶移入待处理桶)、审核通过(审核桶→待处理桶)、库内拦截确定(状态迁移) | 只对“实际受影响的目标桶”打细粒度脏(如 `order.pending.list.changed`),对应页签激活时懒刷新 |
| ③ 不可枚举的外部变更 | 数据可能在别处被改动,来源无法枚举 | 其它端/其它菜单改数据 | 激活兜底(A-1/A-2 + 脏标记) |
> 判定规则:若两个列表**按状态互斥**(同一条记录不可能同时出现在两页),则“改字段值”类操作(类型①)不需要跨页刷新——本页已最新,另一页根本不含该行;此时给另一页打脏反而会在用户切回时触发一次无意义刷新,**违反“其它页面不受影响”**。
---
## 4. 设计目标与约束
1. **“自动刷新”语义必须等于“点一次刷新按钮”**:复用 `loadData`,沿用当前筛选/分页,不跳页、不重置条件。
2. **幂等与防抖**:同一时刻只允许一次在途请求(`loadData` 已有 loading 守卫;跨实例并发时需合并/节流)。
3. **生命周期一致**:订阅生命周期跟随组件真实存活(`mounted`/`unmounted`),避免幽灵刷新与内存泄漏。
4. **事件作用域化**:只刷新“关心该事件”的页面;不得因一次小操作让所有缓存页全部重拉(成本控制)。
5. **不引入全局事件总线依赖**:沿用项目现有的“模块级单例 composable”轻量风格。
6. **不改变缓存开关语义**:缓存关时(`pageCacheEnabled=false` / `tabCacheEnabled=false`)页面走 `mounted` 全量重建,本机制自动退化为“每次进入都拉取”,不应出现重复拉取或负作用。
### 4.1 影响面承诺:其余页面缓存“照旧”
审计复核(2026-09-05):本方案对**未接入页面是零侵入**的,实施时必须守住以下约束:
1. 新增的 `useRefreshBus` / 脏标记是**模块级惰性单例**:不订阅就不产生任何行为;不碰 `experimental` store 的缓存开关/容量,不改 `AppMain` keep-alive 的 include/key/config。
2. 只在目标页面(如 `orderManagement` 各页签/容器)加 `onActivated`,属页面局部改动;`stockManagement`、`waveOrder` 等其它缓存容器与其子页签**不加任何钩子**,其缓存、激活、LRU 行为均不变。
3. 不存在“对所有缓存页统一刷新”的代码路径:`activated` 与订阅都**按页声明**;同一 scope(如 `order.list.changed`)只有真正关心该数据域的页面才订阅。
4. 缓存关闭分支(`tabCacheEnabled=false` / `pageCacheEnabled=false`)下这些钩子自然不触发,行为回到“每次进入全量拉取”,与改造前一致。
5. 不加 `:key`、不改造 keep-alive 标签、不改路由 meta/`noCache`——避免任何破坏缓存实例复用/淘汰逻辑的改动。
---
## 5. 设计方案总览
把「操作后刷新」拆成两条互相补充的链路:
```
触发源(三选一)
├─ 生命周期触发:缓存页再次被激活(activated)
├─ 同页操作触发:本页签内弹窗/按钮提交成功
└─ 跨页/全局操作触发:Layout 全局宿主、其它缓存页签、异步任务终态
↓ 通过「模块级事件(作用域化)」
统一入口:pageRefresher.refresh(scope)
↓ 命中「已订阅该 scope 的存活列表页」
各自 loadData()(沿用当前筛选/分页,loading 幂等)
```
链路图:
```mermaid
flowchart LR
A[功能执行成功] -->|同页操作| B[本页签 loadData]
A -->|全局宿主/其它页签/异步终态| C[触发 pageRefresher.emit scope]
C --> D{各缓存页签是否订阅该 scope}
D -->|是且存活| E[该页签 loadData]
D -->|否| F[忽略]
G[缓存页再次激活 activated] --> E
```
### 5.1 统一刷新抽象(约定层,先行的“软约定”)
不急着造框架,先立规则,让各页面 `loadData` 满足:
- **签名**:`refresh: () => Promise<void>`
- **幂等**:函数体首行 `if (loading.value) return`
- **语义**:沿用当前 `pagination + buildWhere() + sort`(与刷新按钮一致)
- **可选**:返回 `Promise`,便于 `Promise.allSettled` 聚合与调用方 await
> 现状子页签的 `loadData` 基本已满足,无需大改。
---
## 6. 分层方案
### 方案 A(P0 首选落地):两级「激活即刷新」(注意嵌套 keep-alive 语义)
> ⚠️ 审计修订(2026-09-05):原稿“Tab 级与路由级都由 keep-alive 触发同一 activated、一套代码覆盖两种切回”——**不成立**。嵌套 keep-alive 不透传路由级 `activated`(见 §2.1.3),因此 `onActivated` 要分两级挂。
#### A-1 Tab 级(子页签自己挂,覆盖“容器内切回缓存 Tab”)
```ts
// 在子页签(pendingOrder/reviewOrder/…)setup 内
onMounted(() => { registerCreateOrderSuccess(refresh); refresh() })
onActivated(() => { void maybeRefresh() }) // 新增:Tab 级再次被激活时刷新(脏标记见方案 B,无脏则不拉)
onUnmounted(() => { unregisterCreateOrderSuccess(refresh) })
```
- 首次进入:`mounted` 先触发 `refresh()`(同步置 `loading=true` 后 await),keep-alive 直接子组件紧随的 `activated` 再次调用会被 loading 守卫拦下 → **不会双拉**。
- 之后在容器内反复切 Tab:走 `activated` → 拉最新。
#### A-2 路由级(容器 `index.vue` 挂,覆盖“从其它菜单/页面切回本页”)
只有 `AppMain` 路由级 keep-alive 的**直接子组件**(即 `orderManagement/index.vue`)才会收到路由级 `activated`:
```ts
// orderManagement/index.vue
onActivated(() => {
// 转发给“当前激活页签”刷新;建议配合脏标记(无脏则不拉),避免每次返回都请求
refreshActiveTab()
})
```
容器拿到“激活页签刷新句柄”的方式(任选其一):
1. 子页签把 `refresh` 注册进模块级“页签刷新注册表”(`Map<tabName, refresh>`,`mounted` 注册 / `unmounted` 注销),容器遍历注册表刷新当前激活页签(其余缓存 Tab 等用户切到时由 A-1 自行刷新);
2. 或给 `<component :is="activeComponent" ref="activeTabRef">` 加 ref + 子页签 `defineExpose({ refresh })`,容器直接调用。
**成本与取舍**
- 优点:实现成本低、无需事件定义,天然覆盖“任何把数据改旧的外部路径”。
- 缺点:纯“每次激活都拉”会产生冗余请求,且无法区分“本次激活是否真有数据变化”。
- 优化:配合脏标记(懒刷新,见 §6)→ 无脏不拉,副作用最小;这也是满足“切其它页面零打扰 + 缓存正常”的推荐做法。
**适用**:P0 两种“切回”都希望看到最新数据的列表页/页签。
---
### 方案 B(P1/P2/P3 通用化):模块级「作用域事件」总线(轻量、无依赖)
把 `useCreateOrderSession` 的“回调注册”机制**抽取成通用小工具**(仍走模块级单例 + Set,不引入 mitt)。
#### 6.1 新增通用 composable(建议路径 `src/composables/useRefreshBus.ts`)
```ts
// 模块级单例状态(与 useCreateOrderSession 同风格)
type RefreshHandler = () => void | Promise<void>
const scopedListeners = new Map<string, Set<RefreshHandler>>()
function ensureScope(scope: string) {
if (!scopedListeners.has(scope)) scopedListeners.set(scope, new Set())
return scopedListeners.get(scope)!
}
export function useRefreshBus() {
/** 列表页挂载时订阅:只关心该 scope 的刷新事件 */
function registerRefresh(scope: string, handler: RefreshHandler) {
ensureScope(scope).add(handler)
return () => unregisterRefresh(scope, handler)
}
function unregisterRefresh(scope: string, handler: RefreshHandler) {
scopedListeners.get(scope)?.delete(handler)
}
/** 操作成功后广播:通知所有订阅了该 scope 的存活列表页刷新 */
async function notifyRefresh(scope: string) {
const handlers = scopedListeners.get(scope)
if (!handlers?.size) return
await Promise.allSettled(Array.from(handlers).map((h) => h()))
}
return { registerRefresh, unregisterRefresh, notifyRefresh }
}
```
#### 6.1.1 推荐增强:脏标记(懒刷新变体)
> 审计修订(2026-09-05):为同时满足“操作后能拿到最新”与“切到无关页面零打扰 / 不产生冗余请求”,推荐用 **markDirty → 激活时懒刷新** 代替“每次激活都拉 / 每次操作都广播”。
##### 简单版(boolean,仅单个订阅者 / 不关心互相覆盖时可接受)
```ts
const dirtyScopes = new Set<string>()
function markDirty(scope: string) { dirtyScopes.add(scope) }
function isScopeDirty(scope: string) { return dirtyScopes.has(scope) }
function consumeDirty(scope: string) { return dirtyScopes.delete(scope) }
```
> ⚠️ boolean 版缺陷(审计发现):多个缓存页签订阅**同一 scope** 时,“谁激活谁 consume”会清掉脏标记,导致**后激活的页签漏刷**。例:在 `pendingOrder` 修改平台后切到 `reviewOrder`(refresh + consume),但 `exceptionOrder` 里也有同单数据、从未刷过——脏标记已被消费,切到它时不刷新、显示旧数据。
##### 推荐版(epoch 水位,多订阅者各自独立判断,审计建议采用)
```ts
// 全局(模块级):scope -> 单调递增的变更序号
const dirtyEpoch = new Map<string, number>()
let epochSeq = 0
function markDirty(scope: string) {
epochSeq += 1
dirtyEpoch.set(scope, epochSeq)
}
function getDirtyEpoch(scope: string) { return dirtyEpoch.get(scope) ?? 0 }
```
- 操作方:`markDirty('order.list.changed')`——只递增序号,不做任何通知;
- 订阅方(每个缓存页/页签各自持有 `lastSeenEpoch = ref(0)`),在 `activated` 时:
```ts
onActivated(() => {
const cur = getDirtyEpoch('order.list.changed') // 无脏返回 0
if (cur > lastSeenEpoch.value) { // 本页上次刷新之后确实发生过变更
lastSeenEpoch.value = cur // 先追平水位再拉,防重复
void refresh()
}
})
```
- 各订阅者独立比较自己的 `lastSeen` 与全局 `epoch`:A 刷新不影响 B 的判断,**无漏刷、无错刷**;
- 页面被 LRU 淘汰后重建(`mounted`)→ `lastSeen=0` + 全量拉取,天然正确;
- “本页自己刚执行操作并已原地刷新”:操作方本页在 `refresh()` 后把自己的 `lastSeen` 同步到当前 epoch,之后切走再切回不会重复拉。
两种广播语义任选(或组合):
| 语义 | 触发 | 效果 | 取舍 |
|---|---|---|---|
| **eager(主动广播)** | 操作成功即 `notifyRefresh(scope)` | 所有存活订阅页**立即**刷新 | 反应最快;会让订阅页**并发重拉**(订单列表是大请求);切其它页时若页面正处理中也会被打扰 |
| **lazy(脏标记 + 激活时刷新)** | 操作成功只 `markDirty(scope)`(epoch 递增);各页在**被激活**(切回)时 `epoch > lastSeen` → `refresh()` → 水位追平 | 只有用户“实际去看”的页才拉,且每页各自判断、无漏刷 | 无冗余请求、副作用最小;缺点是被激活页看到的不是操作当刻、而是切回当刻的最新(通常可接受) |
> 推荐:默认 lazy(符合“切到 waveOrder 不被触发”的诉求);仅当产品明确要求“操作当下其它页必须立即同步”时才对该 scope 用 eager。
**作用域(scope)设计建议**:
- 按“业务数据域”命名,例如 `stock.list.changed`、`wave.list.changed`。
- **订单管理各页签按状态互斥、行不重叠 → 不要用粗 scope `order.list.changed`**(改平台后会给不含这些行的待审核页签也打脏,切回时被无意义刷新)。改用“目标数据集”粒度,如 `order.pending.list.changed` / `order.review.list.changed` / `order.exception.list.changed`,只被对应桶的页签订阅;操作方标记“它实际改变的桶”。
- 可再加仓库维度 `order.pending.list.changed:{warehouseId?}`(可选,默认全局)以便同仓库才刷新。
- 订阅方决定是否关心;广播方不需要知道“谁在听”。
#### 6.2 列表页侧(订阅方)统一写法
```ts
const refreshBus = useRefreshBus()
onMounted(() => {
const off = refreshBus.registerRefresh('order.list.changed', refresh) // scope 由页面自己声明关心
// 与既有 useOrderListPageCleanup 等叠加
refresh()
})
onUnmounted(() => { off() }) // 或直接 unregisterRefresh
```
> 生命周期挂 `mounted/unmounted`(与 `useCreateOrderSession` 一致):缓存的隐藏页签依然订阅并能被动刷新;被 LRU 淘汰后自动注销。
#### 6.3 操作侧(广播方)统一写法
- 同页弹窗操作成功后,除保留“原地 `loadData`”外,若该改动**会影响其它页签/其它页面**,按所选语义追加:
```ts
await params.loadData() // 当前页签先刷新(现状已如此,必留)
// 懒刷新(推荐):只打脏标记,其它缓存页在切回时自己刷
markDirty('order.list.changed')
// 或 eager(不推荐默认):让其它存活列表页立即同步
// notifyRefresh('order.list.changed')
```
- 全局宿主(Layout 层)操作,如建单弹窗:把 `void notifyCreateOrderSuccess()` 等价替换为 `void markDirty('order.list.changed')`(若沿用建单即时多页签刷新体验,可保留一次 `notifyRefresh('order.list.changed')`);可选新增子 scope(`order.list.changed.pending`)缩小影响面。
**副作用隔离规则(满足“切到其它页面不触发其它操作”)**
- 订阅方 = “数据真的会变”的页面自己决定是否订阅某 scope;广播方不需要知道谁在听。
- **只让相关页面订阅**:`order.list.changed` 只应被订单列表类页面(如订单管理各页签)订阅;`order/waveOrder` 的波次/拣货/回落单面板展示的是波次与拣货任务数据,**不受“修改平台”影响,一律不订阅**(现状亦未订阅,保持即可)。
- `activated` 只在“回到被缓存的本页/页签”时触发:停留在 `waveOrder`、或切去 `waveOrder` 的那一刻,订单页不会触发任何刷新动作。
- lazy 语义下,即便 scope 已脏,只要用户不去那个页面,就不会产生请求。
**成本与取舍**
- 优点:精确、可控;可承载“异步任务终态再广播”的场景(P3);可扩展携带数据(例如 `{ orderIds }`,订阅方决定是否需要局部更新)。
- 缺点:需要人工维护 scope 与订阅点;广播范围过宽会引发多列表并发请求。
#### 6.4 关键场景映射
| 场景 | 触发时机 | 建议 |
|---|---|---|
| P1 修改平台/快递(类型①:本页局部值变更) | `submitUpdateOrderMeta` 成功后 | **只原地 `loadData`**(现状即可,不打脏/不广播);其它状态互斥页签不含这些行、不受影响 |
| P2 建单/状态迁移(类型②:改变其它页签成员资格/计数) | 建单成功 / `resolveException` / 审核通过等 | 按“实际受影响的目标桶”打细粒度 dirty(如 `order.pending.list.changed`),对应页签激活时懒刷新 |
| P3 打印成功 | 打印 composable `onPrintSuccess` | 原地 `loadData` +(如影响它桶)`markDirty` |
| P3 异步批处理/储位分配轮询终态 | 轮询 `success` | 原地 `loadData`(必要时 `markDirty`) |
---
### 方案 C(规模化沉淀,可选后续):统一列表 Composable
若页面数量多、希望“开箱即得”,可再包一层列表组合式封装,把 A+B 收敛:
```ts
// useCachedListPage(options)
// options: { scope?: string[]; loader: () => Promise<void>; registerExtra?: (refresh)=>(()=>void) }
// 内部自动:
// onMounted: refresh() + 订阅各 scope + 返回卸载
// onActivated: refresh()(方案A)
// 幂等 refresh(loading 守卫)
```
价值:新页面一行接入缓存感知的刷新;旧页面可渐进迁移。
代价:侵入现有页面结构较大,建议二期再做,先以方案 A + B 的“软约定”落地。
---
## 7. 决策矩阵
| 场景 | 建议方案 | 理由 |
|---|---|---|
| 回到本菜单/切回缓存 Tab 要最新 | 方案 A 两级激活 + 脏标记 lazy | 路由级返回需容器转发(嵌套 keep-alive 不透传 `activated`);lazy 避免无关切换也拉一次 |
| 操作只改本列表值(类型①,如修改平台) | 无需新机制(现状本地 `loadData` 已够) | 各页签按状态互斥;其它页不含该行,跨页刷新会违背“其它页面不受影响” |
| 操作会改变其它页签数据集/计数(类型②,如建单/状态迁移) | B lazy(细粒度 scope `markDirty` + 激活时刷新) | 只对实际受影响的目标桶打脏,避免并发重拉 |
| 全局宿主(Layout 层)操作 | B lazy(全局宿主不属于缓存树,只能跨组件通信) | 与 `useCreateOrderSession` 一致 |
| 切到无关页面(如 waveOrder)不被触发 | 订阅方按数据域隔离 scope + lazy | waveOrder 不订阅 `order.list.changed`;激活只在返回本页发生 |
| 异步长任务终态 | B lazy(终态回调里 `markDirty`)+ 原地刷新 | 刷新时机在终态;eager 仅当要求操作当下立即同步 |
| 角标/数量 | 容器层订阅同 scope(`loadBadgeCounts` 进回调) | 角标在 `index.vue`,非子页签 |
| 数据变更来源不可枚举的页面 | A 即可 | 不必造事件 |
---
## 8. 落地示例(order/orderManagement)
### 8.1 建单(现状已实现,保留并可作为“标准范式”)
- 已具备:模块级 `useCreateOrderSession` + `mounted/unmounted` 订阅 + `notifyCreateOrderSuccess`。
- 建议演进:
1. 将回调注册语义泛化为 `registerRefresh('order.list.changed', refresh)`(内部仍走同一模块级单例,兼容旧接口或渐进替换)。
2. 建单成功后补一次 `loadBadgeCounts()` 通知(解决 P4:待处理/待审核角标数量)。
### 8.2 修改平台 / 修改快递(类型①:本页局部,默认不跨页)
- 现状:`submitUpdateOrderMeta` 成功后已 `params.loadData()` → **只有当前页签(如待处理订单)触发刷新,待审核订单等其它页签不受影响**——正是需求行为,**无需任何改动**。
- 原因:待审核/待处理/异常/待出库等页签是**按订单状态互斥**的列表(各自查 `orderReviewOrder.list` / `orderPendingOrder.list` / `orderExpectionOrder.list`…),同一订单只落在一个状态桶;修改平台只改本桶内行的字段值、不改变成员资格 → 其它页签不含这些行,跨页刷新既无意义又打扰用户。
- 结论:此类操作**不打脏、不广播**,保持“只刷新本页”。若将来确认确有“同单跨页展示”的桶重叠,再按重叠桶打细粒度 dirty。
### 8.3 其余 toolbar 动作(executeApiAction 等)
- 已在 `reload` 后集中处理当前页;**不要在 `executeApiAction` 末尾统一打脏**——多数批量动作是类型①(本页字段值),统一打脏会波及其它互斥页签。
- 逐项按 §3.1 分类:类型①保持本地刷新(现状即可);只有类型②(会改变其它页签成员资格/计数,如异常转待处理、库内拦截确定等状态迁移)才对受影响的目标桶打细粒度 dirty。
### 8.4 `onActivated` 刷新(两级挂载,配合脏标记)
- Tab 级(A-1):对 8 个列表页签补充 `onActivated(() => maybeRefresh())`(脏才刷),与现有 `onMounted` 注册并存,loading 幂等防双拉。
- 路由级(A-2):`index.vue` 补充 `onActivated(() => refreshActiveTab())`(向当前激活页签转发),覆盖“从 waveOrder 等其它页面切回本页”。**仅靠子页签的 `onActivated` 覆盖不了路由级返回**。
### 8.5 角标(P4)
- `index.vue` 的 `loadBadgeCounts()` 除现有「挂载/切 Tab」外,订阅 `order.list.changed` 广播,在建单/异常处理等导致数量变化的操作后同步刷新角标(带已有 `badgeLoading` 去重)。
---
## 9. 关键细节与坑(务必遵守)
1. **双拉问题**:首次进入时 `mounted + activated` 都会触发;靠 `loadData` 的 `if (loading.value) return` 去重即可,不要在 `onActivated` 里额外做“跳过首次”标记(切回场景仍需刷新)。若担心竞态(极快返回后 activated 再拉一次),可记录 `lastActivatedAt`,同一 tick 内去重(可选优化)。
2. **刷新语义 = 刷新按钮**:自动刷新必须沿用当前筛选/分页;若改成“重置到第一页”会与用户当前查看上下文冲突。
3. **订阅生命周期绑 `mounted/unmounted`**,不要绑 `activated/deactivated`:否则隐藏缓存页会漏刷新、且语义混乱。
4. **作用域按“目标数据集”粒度,不要跨状态桶**:订单各页签按状态互斥,不要用 `order.list.changed` 这种跨桶 scope——一次打脏会让所有订阅订单页签在切回时被刷(大请求且大多无变化)。用 `order.pending.list.changed` / `order.review.list.changed` 等,只被对应桶订阅。
5. **LRU 淘汰**:`tabCacheMax=2` 时,隐藏且久未使用的页签会被销毁(走 `onUnmounted` 自动注销),不会幽灵刷新;这是机制能自洽的关键,注销代码务必补全。
6. **异步任务**:不要在“提交成功”就刷新,要在任务轮询到终态(success/failed)时刷新;现有 `submitStorageAllocate`、`useTaskProgress` 轮询结构可复用。
7. **打印/导出等非列表动作**:仅 `onPrintSuccess` 需要刷新;导出进度类动作不得误触发广播。
8. **重复广播**:同页操作成功后“原地 loadData + 广播”时,广播回调会命中自己 → 被 loading 守卫拦截,不会二次请求;确保 `loadData` 幂等即可放心广播。
9. **角标刷新频控**:角标接口频率敏感,广播回调里合并/节流(复用 `badgeLoading` 去重)。
10. **缓存关闭时**:`pageCacheEnabled=false / tabCacheEnabled=false` 时组件每次进入都 `mounted`,自动刷新天然发生;`onActivated` 不会重复触发(无 keep-alive 时不触发 activated),广播仍安全(`unmounted` 即注销)。
11. **嵌套 keep-alive 不透传 activated**:路由级返回时子页签不会自动收到激活;必须由容器(`index.vue`)的 `onActivated` 显式转发,否则只加 Tab 级 `onActivated` 时“从 waveOrder 切回本页”不会刷新。
12. **scope 隔离是“切其它页面零打扰”的前提**:只让真正相关页面订阅;如 waveOrder 的波次/拣货面板与 `order.list.changed` 无关,一律不订阅,修改平台广播/脏标记就不会波及它们。
13. **同一 scope 多订阅者时不要用“全局 boolean 脏标记 + consume”**:会互相覆盖导致后激活页签漏刷;改用 epoch 水位,每订阅者记录自己的 `lastSeen` 各自判断。
14. **默认局部刷新,跨页同步是例外而非默认**:修改平台等“只改本列表值”的操作不要打脏/广播——其它状态互斥页签不含这些行,切回时触发刷新反而违背“其它页面不受影响”;只有会改变其它页签成员资格/计数的类型②操作(建单、状态迁移)才对受影响目标桶打脏。
---
## 10. 分阶段实施建议
| 阶段 | 内容 | 覆盖问题 | 风险 |
|---|---|---|---|
| 一期(推荐先做,改动小) | ① 子页签补 `onActivated`(Tab 级,A-1);② `index.vue` 补 `onActivated` 转发当前激活页签(路由级,A-2);③ 结合脏标记 lazy 防冗余 | P0 | 低 |
| 一期 | 类型①操作(修改平台/快递等)保持现状“仅本页刷新”,不改代码;仅类型②(建单/状态迁移)对受影响目标桶打细粒度 dirty | P1 | 低 |
| 二期 | 抽取通用 `useRefreshBus`(方案 B),把建单 bus 迁移/兼容到通用层 | P2/P3 | 中(需回归建单链路) |
| 二期 | 角标订阅广播(P4) | P4 | 低 |
| 三期(可选) | 沉淀 `useCachedListPage`(方案 C),新页面开箱即用 | 规模化 | 高(侵入式,谨慎) |
---
## 11. 验收清单(order/orderManagement 样例)
- [ ] 在「待审核/待处理/异常」页签建单成功 → 列表自动刷新且保留筛选条件,无重复请求(Network 中同参数仅一次在途)。
- [ ] 打开待审核 + 待处理两页签,在待处理「修改平台」成功后:**仅待处理页签刷新**;待审核页签不刷新、无任何新请求、数据不受影响。
- [ ] 状态互斥验证:修改平台/快递不改成员资格,其它状态桶列表不含该行;对确需跨桶的操作(建单/异常转待处理等)按 §3.1 判定后仅对目标桶懒刷新。
- [ ] 切走菜单再切回 `orderManagement`、或页签间来回切换 → 列表刷新为最新(路由级返回由容器 A-2 转发,Tab 内切换由子页签 A-1 覆盖)。
- [ ] 停留/切到 `order/waveOrder` 期间:不产生任何由“修改平台/建单”触发的订单或波次列表请求;waveOrder 不被 `order.list.changed` 波及。
- [ ] 建单/异常处理等导致数量变化的操作后,顶部页签角标同步刷新。
- [ ] 打开 ≥3 个页签触发 LRU 淘汰后,被淘汰页签重建时数据正确且无残留回调/幽灵请求。
- [ ] 关闭「页面缓存/Tab 缓存」实验性开关后功能正常,无重复拉取。
- [ ] 刷新中快速切页签、快速重复点按钮:无并发重复请求、无 loading 卡死。
---
## 附:相关代码位置速查
| 位置 | 说明 |
|---|---|
| `src/layout/component/AppMain.vue` | 路由级 keep-alive + 组件包装 |
| `src/layout/index.vue` / `src/layout/component/CreateOrderSessionHost.vue` | 全局宿主(建单弹窗/悬浮)挂载点 |
| `src/views/order/orderManagement/index.vue` | 容器:Tab 级 keep-alive + 角标刷新 |
| `src/views/order/orderManagement/composables/useCreateOrderSession.ts` | 现有模块级回调总线(范式) |
| `src/views/order/orderManagement/{reviewOrder,pendingOrder,exceptionOrder}.vue` | 列表页:mounted 订阅 + loadData |
| `src/views/order/orderManagement/utils/toolbar-actions.ts` | 各操作成功后原地 loadData 的集中实现 |
| `src/views/order/orderManagement/component/CreatePendingOrderDialog.vue` | 建单成功 → notify 的触发点 |
| `src/components/UpperTable/index.vue` | 刷新按钮(emit refresh) |
| `src/stores/modules/experimental.ts` | 缓存开关/容量设置(tab 默认 max2、页面默认 max8) |
| `src/views/storage/entry/component/DirectInboundLogs.vue` | `onActivated` 刷新的既有先例 |

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 级冗余 |

View File

@ -0,0 +1,144 @@
# 项目瘦身 · 未引用页面清单
> 扫描时间:2026-09-22 · 扫描脚本:`scripts/find-unused-modules.mjs` · 原始数据:`unused-report.json`
## 一、判定方法(为什么不能只看 map.ts)
`src/router/index.ts` 里有一段兜底逻辑:
```ts
const viewModules = import.meta.glob('@/views/**/*.vue')
```
这意味着 **`src/views` 下的每一个 `.vue` 都会被 Vite 收集进构建图**(各自一个懒加载 chunk),
运行时后端菜单只要 `component` 字段能拼出路径,就能命中最上面的 glob。
所以"未被引用"必须区分两种情况:
| 口径 | 含义 | 能否直接删 |
|---|---|---|
| **静态不可达** | 从 `src/main.ts` 出发,经 `import / import() / require()` 到不了 | 需先确认后端菜单没有指向它 |
| **完全死代码** | 既静态不可达,也不被任何 glob 模式匹配 | 可以直接删 |
本次扫描结果(`src` 下共 582 个模块):
- 静态可达:**480**
- 仅被 glob 兜底匹配:**80**(全部在 `src/views` 下)
- 完全死代码:**22**
- 待处理合计:**102 个文件**(约 974 KB 源码)
## 二、第一批:整目录废弃(同功能新版已在 map.ts 中生效)
这批是"做了新版没删旧版"的复制目录,**判断依据充分,可优先处理**。
证据:废弃目录的文件修改时间统一停在 `2026-08-11`(模板生成日),而现行目录仍在持续更新。
| 废弃目录/文件 | 文件数 | 现行替代(map.ts 指向) | 备注 |
|---|---|---|---|
| `src/views/order/waveOrder2/` | 9 | `order/waveOrder/`(`order/waveOrder`、`wave/index`) | `waveOrder` 最近更新 09-21,`waveOrder2` 停在 08-11 |
| `src/views/data/newpackingflow/` | 11 | `data/packingflow/`(`data/packingflow`) | `packingflow` 更新 09-16 |
| `src/views/material/packageMaterial2/` | 8 | `material/packageMaterial/`(`material/packageMaterial/index`) | |
| `src/views/system/setting/encoding2/` | 8 | `system/setting/encoding/`(`system/setting/encoding/index`) | |
| `src/views/mode/` | 8 | — | 页面模板脚手架(`【页面模板 v2】`) |
| `src/views/video/camera/` | 3 | `video/newcamara/`(`video/camera/index` 已重指向) | |
| `src/views/video/cameraServer/` | 1 | `video/newcamaraserver/`(`video/cameraServer/index` 已重指向) | |
| `src/views/store/shipperSigning/` | 1 | `Externalwarehouse/shipperSigning/` | 同名页面两份 |
| `src/views/system/setting/workbench/` | 2 | `system/setting/workbench2/` | map.ts 的 key 仍是 `system/setting/workbench/index` |
| `src/views/system/setting/basicManagement/`(旧 `index.vue`、`ApiOpenInterface.vue`) | 2 | `system/setting/basicManagement/newview/` | 旧路径已在 map.ts 里重指向 newview |
| `src/views/warehouse/` 旧三件套 `zone.vue`、`SpaceList.vue`、`SpaceForm.vue` | 3 | `ZoneManagement.vue` / `RackSpaceManagement.vue` | `warehouse/index.vue` 已不再 import 这三个 |
## 三、第二批:页面内孤立组件(页面本身在用,组件已废弃)
| 文件 | 体积 | 说明 |
|---|---|---|
| `order/orderManagement/component/detail.vue` | 0.3 KB | 只 import 了 `OrderDetailPanel.vue` |
| `order/orderManagement/component/orderdetail.vue` | 2.5 KB | |
| `order/orderManagement/component/OrderDetailPanel.vue` | 2.1 KB | 仅被上面的 `detail.vue` 引用(链式死) |
| `order/orderManagement/component/ManualOutboundPanel.vue` | 6.0 KB | |
| `order/orderManagement/component/OrderReviewDialog.vue` | 2.7 KB | |
| `order/waveOrder/component/WaveBatchPrintPreviewDialog.vue` | 10.8 KB | |
| `express/returnUnpack/components/ExportDialog.vue` | 9.7 KB | 已被通用导出弹窗替代 |
| `express/returnUnpack/components/VideoListDialog.vue` | 4.3 KB | 该目录下 `VideoPlayerDialog.vue` 仍在使用 |
| `express/waybill/components/TabArea.vue` | 2.6 KB | |
| `express/waybill/pages/ExampleFormDialog.vue` | 2.7 KB | 模板残留 |
| `store/stores/component/ExportDialog.vue` | 7.6 KB | |
| `storage/entry/component/QuickInboundForm.vue` | 9.2 KB | `storage/entry/index.vue` 未引用 |
| `storage/inventory/component/InventoryStockPickerDialog.vue` | 14.7 KB | |
| `afterSale/detail/HandleDialog.vue` | 4.6 KB | 处理逻辑已内联在 `detail/index.vue` |
| `system/setting/printStation/components/Printer.vue` | 3.2 KB | 该页只 import `info.vue` / `add.vue` |
| `system/setting/printStation/components/expressCompany.vue` | 2.4 KB | 同上 |
| `system/setting/printStation/components/printComputer.vue` | 2.7 KB | 同上 |
| `system/setting/printcomputer/config/components/DetailPanel.vue` | 4.6 KB | |
| `system/setting/printcomputer/config/components/LogPanel.vue` | 5.9 KB | |
| `system/setting/printcomputer/pages/ExampleFormDialog.vue` | 2.7 KB | 模板残留 |
| `system/setting/workbench2/pages/ExampleFormDialog.vue` | 2.7 KB | 模板残留 |
| `system/setting/basicManagement/newview/pages/ExampleFormDialog.vue` | 2.7 KB | 模板残留 |
| `system/setting/basicManagement/newview/pages/ExportReportDialog.vue` | 6.7 KB | |
| `video/newcamaraserver/components/OperationCellRenderer.vue` | 5.1 KB | 该页未 import(`TabArea` / `ColumnCellRenderer` 在用) |
| `video/newcamara/pages/ExampleFormDialog.vue` | 2.7 KB | 模板残留 |
| `afterSale/typelist/pages/ExampleFormDialog.vue` | 2.7 KB | 模板残留 |
| `storage/generalreport/pages/ExampleFormDialog.vue` | 2.7 KB | 模板残留 |
| `views/account/index.vue` | 0.1 KB | 空壳(注意:map.ts 的 `account/index` 指向 `system/setting/account/index.vue`) |
| `views/permission/index.vue` | 0.1 KB | 空壳 |
## 四、第三批:完全死代码(非页面,共 22 个 / 324 KB)
### Vue2 迁移残留(8 个 / 43.4 KB)
- `src/utils/index.js`(2.7 KB)— vue-element-admin 工具集
- `src/utils/warehouseData.js`(20.4 KB)
- `src/utils/zhijian.js`(6.3 KB)+ `src/utils/zhijian.ts`(6.9 KB)— 双份同名,均无引用
- `src/icons/index.js`(0.3 KB)— SVG 图标已改走 `vite-plugin-svg-icons`
- `src/layout/AppMain.vue`(0.1 KB)— 实际使用的是 `src/layout/component/AppMain.vue`
- `src/stores/counter.ts`(0.3 KB)— Pinia 示例
- `src/stores/modules/localCameraServer.ts`(4.9 KB)
### 三维可视化遗留(5 个 / 约 114 KB)
- `src/utils/threeScene.js`(36.2 KB)
- `src/utils/threeUtils.js`(10.8 KB)
- `src/utils/overlookControls.js`(11.3 KB)
- `src/utils/CanvasRenderer.js`(26.6 KB)+ `src/utils/CanvasRenderer.ts`(28.8 KB)— 双份
### 模板配置残留
- `src/views/mode/config/template-config.ts`(24.7 KB)
- `src/views/material/packageMaterial2/config/template-config.ts`(24.6 KB)
- `src/views/system/setting/encoding2/config/template-config.ts`(24.6 KB)
- `src/views/data/newpackingflow/config/packingflow-config.ts`(26.0 KB)
- `src/views/order/waveOrder2/config/waveorder-config.ts`(54.7 KB)
- `src/views/system/setting/workbench/workbench-config.ts`(4.6 KB)
### API 模块(3 个 / 9.3 KB,建议单独确认后再删)
- `src/api/order.packing/packing.ts`(7.6 KB)
- `src/api/config/config.ts`(1.3 KB)
- `src/api/printer.station/printerstation.ts`(0.4 KB)
> 对照:`src/api/waybill.warehouse/index.ts` 一开始被误判为死代码,实际 `express/waybill` 在用,**不要删**。
> (原因是该目录名自带点号,脚本早期用 `path.extname` 判断扩展名导致解析失败,已修复。)
## 五、删除前必须做的核对
因为 `import.meta.glob` 兜底的存在,**静态不可达 ≠ 可以删**。删之前请确认后端菜单
`component` 字段没有指向待删路径:
1. 导出菜单表里所有 `component` 字段值(形如 `order/waveOrder`、`system/setting/role/index`)
2. 与上表路径求交集,**有交集的一律保留**
3. 更省事的做法:直接在浏览器里按后台配的菜单逐个点一遍,确认页面不是待删文件
4. 特别注意 map.ts 里那些**值相同、key 不同的兼容项**,例如:
- `system/setting/basicManagement` / `system/setting/basicManagement/index` / `basicManagement` → 全部指向 `newview`
- `video/camera/index` → `newcamara`;`video/cameraServer/index` → `newcamaraserver`
- `system/setting/workbench/index` → `workbench2`
- `stock/combo_stock` 相关 key 已注释掉(`combo_stock` 现为 `stockManagement` 内的标签页)
## 六、如何复跑
```bash
node scripts/find-unused-modules.mjs # 完整报告
node scripts/find-unused-modules.mjs --views-only # 只看页面
```
脚本会打印分组清单 + 目录级汇总,并把机器可读结果写到 `unused-report.json`。
判定口径:
- 静态可达:从 `src/main.ts` 经 `import` / `import()` / `require()` / SCSS `@use` / `@import` 可达
- glob 兜底:被 `import.meta.glob(...)` 模式匹配
- 死代码:以上都不属于
> 已知盲区:仅覆盖 `src` 目录;不解析 `component` 字段的字符串拼接路径(本项目已确认无此类写法)。

23
env.d.ts vendored
View File

@ -1,12 +1,25 @@
/// <reference types="vite/client" />
interface ImportMetaEnv {
/** frontConfig.getByDomain 品牌豁免域名(逗号分隔多个;显式置空=不豁免,未配置回退主域名 wms.wms.gztbyc.com) */
readonly VITE_FRONT_CONFIG_EXEMPT_HOSTS?: string
/** 本地开发:对象存储直传 CORS 绕过开关(`off` 关闭,默认开启;仅 dev 生效) */
readonly VITE_COS_DEV_PROXY?: string
/** 本地开发:`/cos-proxy` 代理目标存储桶(默认见 src/utils/cosDevProxyConfig.ts) */
readonly VITE_COS_DEV_PROXY_TARGET?: string
}
declare module '@/utils/auth' {
export function getToken(): string | undefined
export function setToken(token: string): void
export function removeToken(): void
}
declare module '@/api/user' {
export function login(data: any): Promise<any>
export function getInfo(data: any): Promise<any>
export function changeRole(data: any): Promise<any>
export function logout(data: any): Promise<any>
declare module 'vue-virtual-scroller' {
export const RecycleScroller: any
}
declare module 'qrcode.vue' {
const QrcodeVue: any
export default QrcodeVue
}

74
eslint.config.js Normal file
View File

@ -0,0 +1,74 @@
import js from "@eslint/js";
import tseslint from "typescript-eslint";
import vueParser from "vue-eslint-parser";
import vuePlugin from "eslint-plugin-vue";
import eslintConfigPrettier from "eslint-config-prettier";
export default [
{
ignores: [
"dist/**",
"node_modules/**",
"coverage/**",
".vite/**",
"workflows/api-doc-sync/data/history/**",
],
},
js.configs.recommended,
...tseslint.configs.recommended,
...vuePlugin.configs["flat/recommended"],
{
files: ["**/*.{ts,tsx,vue,js,mjs,cjs}"],
languageOptions: {
parser: vueParser,
parserOptions: {
parser: tseslint.parser,
ecmaVersion: "latest",
sourceType: "module",
extraFileExtensions: [".vue"],
},
globals: {
fetch: "readonly",
AbortSignal: "readonly",
console: "readonly",
process: "readonly",
},
},
rules: {
"no-console": "off",
"vue/multi-word-component-names": "off",
},
},
{
files: ["src/views/order/orderManagement/**/*.{ts,vue}"],
languageOptions: {
globals: {
window: "readonly",
document: "readonly",
navigator: "readonly",
URL: "readonly",
Blob: "readonly",
File: "readonly",
FileReader: "readonly",
Event: "readonly",
HTMLElement: "readonly",
HTMLInputElement: "readonly",
MouseEvent: "readonly",
WheelEvent: "readonly",
setTimeout: "readonly",
},
},
rules: {
"@typescript-eslint/no-explicit-any": "off",
"@typescript-eslint/no-unused-vars": "off",
"@typescript-eslint/no-unsafe-function-type": "off",
"vue/attributes-order": "off",
"vue/attribute-hyphenation": "off",
"vue/no-template-shadow": "off",
"vue/no-deprecated-v-on-native-modifier": "off",
"no-empty": "off",
"no-undef": "off",
},
},
eslintConfigPrettier,
];

View File

@ -4,7 +4,8 @@
<meta charset="UTF-8">
<link rel="icon" href="/favicon.ico">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Vite App</title>
<!-- 加载前静态兜底:中性“加载中...”,不直接显示仓库/默认品牌;运行时由 frontBrand 决定(主域名→天豹云仓;非主域名成功→品牌名/失败→天豹云仓) -->
<title>加载中...</title>
</head>
<body>
<div id="app"></div>

93
liebao.svg Normal file
View File

@ -0,0 +1,93 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1000 450" width="100%" height="100%">
<!-- 背景 (可选,原图为纯白背景) -->
<rect width="100%" height="100%" fill="#ffffff" />
<!-- 左侧最底部的深蓝色拖尾 -->
<path d="M 150 380
C 220 330, 260 310, 300 300
C 250 285, 200 290, 150 300
C 100 310, 80 330, 50 350
C 80 340, 120 350, 150 380 Z"
fill="#093a75" />
<!-- 左侧中部的深蓝色拖尾与部分身体阴影 -->
<path d="M 55 245
C 150 220, 300 200, 400 220
C 500 240, 600 280, 700 270
C 750 265, 750 285, 720 295
C 650 320, 550 310, 450 280
C 350 250, 250 280, 180 310
C 130 330, 100 310, 75 285
C 65 275, 55 260, 55 245 Z"
fill="#0d4d8c" />
<!-- 主体躯干与左侧中部的蓝色拖尾 -->
<path d="M 250 320
C 350 270, 450 240, 550 230
C 600 220, 650 200, 700 190
C 750 180, 800 160, 840 160
C 840 180, 820 220, 780 240
C 750 260, 710 270, 680 290
C 640 320, 580 330, 520 320
C 480 310, 430 310, 380 330
C 330 350, 280 360, 230 350
C 200 340, 220 330, 250 320 Z"
fill="#196bbd" />
<!-- 头部、背部及最上方的浅蓝色拖尾 -->
<path d="M 830 100
C 840 95, 850 100, 870 110
C 900 125, 920 150, 950 170
C 960 180, 965 190, 950 205
C 940 215, 920 220, 900 230
C 880 240, 850 230, 830 210
C 800 180, 750 180, 700 190
C 650 200, 600 210, 550 220
C 450 240, 350 260, 250 300
C 200 320, 150 320, 100 300
C 150 285, 200 280, 300 250
C 450 200, 600 160, 700 140
C 760 130, 800 115, 830 100 Z"
fill="#2388d9" />
<!-- 前腿和胸部 -->
<path d="M 830 210
C 800 230, 780 250, 760 280
C 750 295, 730 310, 700 320
C 680 330, 690 350, 720 350
C 750 350, 780 330, 810 310
C 850 280, 880 280, 920 295
C 940 305, 960 315, 970 320
C 950 300, 920 270, 880 240
C 860 225, 840 215, 830 210 Z"
fill="#0d4d8c" />
<!-- 前腿内侧的深色阴影 -->
<path d="M 760 280
C 740 300, 720 315, 700 320
C 710 300, 730 280, 750 260
C 755 265, 760 270, 760 280 Z"
fill="#093a75" />
<!-- 嘴巴和下巴的白色镂空区域 -->
<path d="M 925 185
C 920 195, 915 205, 920 215
C 930 220, 945 220, 955 210
C 950 200, 940 190, 925 185 Z"
fill="#ffffff" />
<!-- 下巴下方的白色缝隙 -->
<path d="M 890 225
C 895 235, 905 240, 915 235
C 905 245, 890 245, 880 235
C 885 230, 888 228, 890 225 Z"
fill="#ffffff" />
<!-- 眼睛部位的高光/凹陷细节 (深蓝色小色块) -->
<path d="M 880 180
C 890 175, 900 180, 900 190
C 890 195, 880 195, 870 190
C 875 185, 878 182, 880 180 Z"
fill="#093a75" />
</svg>

After

Width:  |  Height:  |  Size: 3.1 KiB

12
new3.code-workspace Normal file
View File

@ -0,0 +1,12 @@
{
"folders": [
{
"path": ".",
"name": "WEB (WMS前端)"
}
],
"settings": {
"git.autoRepositoryDetection": "subFolders",
"git.repositoryScanMaxDepth": 1
}
}

888
package-lock.json generated

File diff suppressed because it is too large Load Diff

View File

@ -8,16 +8,35 @@
"build": "run-p type-check \"build-only {@}\" --",
"preview": "vite preview",
"build-only": "vite build",
"type-check": "vue-tsc --build"
"type-check": "vue-tsc --build",
"update": "node ./workflows/api-doc-sync/update.mjs",
"apiconfig": "node ./workflows/api-doc-system/scripts/update.mjs",
"apiconfig:clear-pending": "node ./workflows/api-doc-system/scripts/clear-pending.mjs",
"apiconfig:api-list-update": "node ./workflows/api-doc-system/api-list-update.mjs",
"apiconfig:api-interface-update": "node ./workflows/api-doc-system/api-interface-update.mjs",
"apiconfig:api-interface-clean": "node ./workflows/api-doc-system/api-interface-clean.mjs",
"apiconfig:apidata": "node ./workflows/api-doc-system/scripts/apidata.mjs",
"apiconfig:apidata:quick": "node ./workflows/api-doc-system/scripts/apidata.mjs -- --quick",
"apiconfig:apidata:clear": "node ./workflows/api-doc-system/scripts/apidata.mjs -- --clear",
"apiconfig:apidata:help": "node ./workflows/api-doc-system/scripts/apidata.mjs -- --help",
"apiagent": "node ./workflows/api-doc-system/scripts/agent/run.mjs",
"lint": "eslint . --cache",
"lint:fix": "eslint . --cache --fix",
"format": "prettier . --write",
"format:check": "prettier . --check",
"deploy": "node ./scripts/deploy.mjs",
"rollback": "node ./scripts/rollback.mjs"
},
"dependencies": {
"@element-plus/icons-vue": "^2.3.2",
"@types/nprogress": "^0.2.3",
"@vueuse/core": "^14.2.1",
"axios": "^1.13.6",
"china-division": "^2.7.0",
"dayjs": "^1.11.19",
"echarts": "^6.0.0",
"element-plus": "^2.13.3",
"file-saver": "^2.0.5",
"js-cookie": "^3.0.5",
"jsbarcode": "^3.12.3",
"nprogress": "^0.2.0",
@ -25,30 +44,42 @@
"path-to-regexp": "^8.3.0",
"pinia": "^3.0.4",
"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",
"vue-i18n": "^11.2.8",
"vue-router": "^5.0.3"
"vue-router": "^5.0.3",
"vue-virtual-scroller": "^3.0.2",
"xlsx": "^0.18.5"
},
"devDependencies": {
"@eslint/js": "^10.0.1",
"@tsconfig/node24": "^24.0.4",
"@types/js-cookie": "^3.0.6",
"@types/node": "^24.11.0",
"@types/path-browserify": "^1.0.3",
"@types/qrcode": "^1.5.6",
"@types/sortablejs": "^1.15.9",
"@types/spark-md5": "^3.0.5",
"@vitejs/plugin-vue": "^6.0.4",
"@vue/tsconfig": "^0.8.1",
"eslint": "^10.2.0",
"eslint-config-prettier": "^10.1.8",
"eslint-plugin-vue": "^10.8.0",
"fast-glob": "^3.3.3",
"npm-run-all2": "^8.0.4",
"prettier": "^3.8.2",
"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",
"vue-eslint-parser": "^10.4.0",
"vue-tsc": "^3.2.5"
},
"engines": {

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.4 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 148 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 139 KiB

View File

@ -0,0 +1,621 @@
(function() {
var Nr = 10;
// convert two-dimensional indicies to one-dim array indices
var I00 = 0;
var I01 = 1;
var I02 = 2;
var I03 = 3;
var I10 = 4;
var I11 = 5;
var I12 = 6;
var I13 = 7;
var I20 = 8;
var I21 = 9;
var I22 = 10;
var I23 = 11;
var I30 = 12;
var I31 = 13;
var I32 = 14;
var I33 = 15;
// S-Box substitution table
var S_enc = new Array(
0x63, 0x7c, 0x77, 0x7b, 0xf2, 0x6b, 0x6f, 0xc5,
0x30, 0x01, 0x67, 0x2b, 0xfe, 0xd7, 0xab, 0x76,
0xca, 0x82, 0xc9, 0x7d, 0xfa, 0x59, 0x47, 0xf0,
0xad, 0xd4, 0xa2, 0xaf, 0x9c, 0xa4, 0x72, 0xc0,
0xb7, 0xfd, 0x93, 0x26, 0x36, 0x3f, 0xf7, 0xcc,
0x34, 0xa5, 0xe5, 0xf1, 0x71, 0xd8, 0x31, 0x15,
0x04, 0xc7, 0x23, 0xc3, 0x18, 0x96, 0x05, 0x9a,
0x07, 0x12, 0x80, 0xe2, 0xeb, 0x27, 0xb2, 0x75,
0x09, 0x83, 0x2c, 0x1a, 0x1b, 0x6e, 0x5a, 0xa0,
0x52, 0x3b, 0xd6, 0xb3, 0x29, 0xe3, 0x2f, 0x84,
0x53, 0xd1, 0x00, 0xed, 0x20, 0xfc, 0xb1, 0x5b,
0x6a, 0xcb, 0xbe, 0x39, 0x4a, 0x4c, 0x58, 0xcf,
0xd0, 0xef, 0xaa, 0xfb, 0x43, 0x4d, 0x33, 0x85,
0x45, 0xf9, 0x02, 0x7f, 0x50, 0x3c, 0x9f, 0xa8,
0x51, 0xa3, 0x40, 0x8f, 0x92, 0x9d, 0x38, 0xf5,
0xbc, 0xb6, 0xda, 0x21, 0x10, 0xff, 0xf3, 0xd2,
0xcd, 0x0c, 0x13, 0xec, 0x5f, 0x97, 0x44, 0x17,
0xc4, 0xa7, 0x7e, 0x3d, 0x64, 0x5d, 0x19, 0x73,
0x60, 0x81, 0x4f, 0xdc, 0x22, 0x2a, 0x90, 0x88,
0x46, 0xee, 0xb8, 0x14, 0xde, 0x5e, 0x0b, 0xdb,
0xe0, 0x32, 0x3a, 0x0a, 0x49, 0x06, 0x24, 0x5c,
0xc2, 0xd3, 0xac, 0x62, 0x91, 0x95, 0xe4, 0x79,
0xe7, 0xc8, 0x37, 0x6d, 0x8d, 0xd5, 0x4e, 0xa9,
0x6c, 0x56, 0xf4, 0xea, 0x65, 0x7a, 0xae, 0x08,
0xba, 0x78, 0x25, 0x2e, 0x1c, 0xa6, 0xb4, 0xc6,
0xe8, 0xdd, 0x74, 0x1f, 0x4b, 0xbd, 0x8b, 0x8a,
0x70, 0x3e, 0xb5, 0x66, 0x48, 0x03, 0xf6, 0x0e,
0x61, 0x35, 0x57, 0xb9, 0x86, 0xc1, 0x1d, 0x9e,
0xe1, 0xf8, 0x98, 0x11, 0x69, 0xd9, 0x8e, 0x94,
0x9b, 0x1e, 0x87, 0xe9, 0xce, 0x55, 0x28, 0xdf,
0x8c, 0xa1, 0x89, 0x0d, 0xbf, 0xe6, 0x42, 0x68,
0x41, 0x99, 0x2d, 0x0f, 0xb0, 0x54, 0xbb, 0x16);
// inverse S-Box for decryptions
var S_dec = new Array(
0x52, 0x09, 0x6a, 0xd5, 0x30, 0x36, 0xa5, 0x38,
0xbf, 0x40, 0xa3, 0x9e, 0x81, 0xf3, 0xd7, 0xfb,
0x7c, 0xe3, 0x39, 0x82, 0x9b, 0x2f, 0xff, 0x87,
0x34, 0x8e, 0x43, 0x44, 0xc4, 0xde, 0xe9, 0xcb,
0x54, 0x7b, 0x94, 0x32, 0xa6, 0xc2, 0x23, 0x3d,
0xee, 0x4c, 0x95, 0x0b, 0x42, 0xfa, 0xc3, 0x4e,
0x08, 0x2e, 0xa1, 0x66, 0x28, 0xd9, 0x24, 0xb2,
0x76, 0x5b, 0xa2, 0x49, 0x6d, 0x8b, 0xd1, 0x25,
0x72, 0xf8, 0xf6, 0x64, 0x86, 0x68, 0x98, 0x16,
0xd4, 0xa4, 0x5c, 0xcc, 0x5d, 0x65, 0xb6, 0x92,
0x6c, 0x70, 0x48, 0x50, 0xfd, 0xed, 0xb9, 0xda,
0x5e, 0x15, 0x46, 0x57, 0xa7, 0x8d, 0x9d, 0x84,
0x90, 0xd8, 0xab, 0x00, 0x8c, 0xbc, 0xd3, 0x0a,
0xf7, 0xe4, 0x58, 0x05, 0xb8, 0xb3, 0x45, 0x06,
0xd0, 0x2c, 0x1e, 0x8f, 0xca, 0x3f, 0x0f, 0x02,
0xc1, 0xaf, 0xbd, 0x03, 0x01, 0x13, 0x8a, 0x6b,
0x3a, 0x91, 0x11, 0x41, 0x4f, 0x67, 0xdc, 0xea,
0x97, 0xf2, 0xcf, 0xce, 0xf0, 0xb4, 0xe6, 0x73,
0x96, 0xac, 0x74, 0x22, 0xe7, 0xad, 0x35, 0x85,
0xe2, 0xf9, 0x37, 0xe8, 0x1c, 0x75, 0xdf, 0x6e,
0x47, 0xf1, 0x1a, 0x71, 0x1d, 0x29, 0xc5, 0x89,
0x6f, 0xb7, 0x62, 0x0e, 0xaa, 0x18, 0xbe, 0x1b,
0xfc, 0x56, 0x3e, 0x4b, 0xc6, 0xd2, 0x79, 0x20,
0x9a, 0xdb, 0xc0, 0xfe, 0x78, 0xcd, 0x5a, 0xf4,
0x1f, 0xdd, 0xa8, 0x33, 0x88, 0x07, 0xc7, 0x31,
0xb1, 0x12, 0x10, 0x59, 0x27, 0x80, 0xec, 0x5f,
0x60, 0x51, 0x7f, 0xa9, 0x19, 0xb5, 0x4a, 0x0d,
0x2d, 0xe5, 0x7a, 0x9f, 0x93, 0xc9, 0x9c, 0xef,
0xa0, 0xe0, 0x3b, 0x4d, 0xae, 0x2a, 0xf5, 0xb0,
0xc8, 0xeb, 0xbb, 0x3c, 0x83, 0x53, 0x99, 0x61,
0x17, 0x2b, 0x04, 0x7e, 0xba, 0x77, 0xd6, 0x26,
0xe1, 0x69, 0x14, 0x63, 0x55, 0x21, 0x0c, 0x7d);
function cvt_hex8 (val) {
var vh = (val>>>4)&0x0f;
return vh.toString(16) + (val&0x0f).toString(16);
}
function cvt_byte (str) {
// get the first hex digit
var val1 = str.charCodeAt(0);
// do some error checking
if (val1 >= 48 && val1 <= 57) {
// have a valid digit 0-9
val1 -= 48;
} else if (val1 >= 65 && val1 <= 70) {
// have a valid digit A-F
val1 -= 55;
} else if (val1 >= 97 && val1 <= 102) {
// have a valid digit A-F
val1 -= 87;
} else {
// not 0-9 or A-F, complain
console.log( str.charAt(1)+" is not a valid hex digit" );
return -1;
}
// get the second hex digit
var val2 = str.charCodeAt(1);
// do some error checking
if ( val2 >= 48 && val2 <= 57 ) {
// have a valid digit 0-9
val2 -= 48;
} else if ( val2 >= 65 && val2 <= 70 ) {
// have a valid digit A-F
val2 -= 55;
} else if ( val2 >= 97 && val2 <= 102 ) {
// have a valid digit A-F
val2 -= 87;
} else {
// not 0-9 or A-F, complain
console.log( str.charAt(2)+" is not a valid hex digit" );
return -1;
}
// all is ok, return the value
return val1*16 + val2;
}
// conversion function for non-constant subscripts
// assume subscript range 0..3
function I(x,y) {
return (x*4) + y;
}
// remove spaces from input
function remove_spaces(instr) {
var i;
var outstr = "";
for(i=0; i<instr.length; i++) {
if ( instr.charAt(i) != " " )
// not a space, include it
outstr += instr.charAt(i);
}
return outstr;
}
// get the message to encrypt/decrypt or the key
// return as a 16-byte array
function get_value(str, isASCII) {
var dbyte = new Array(16);
var i;
var val; // one hex digit
if (isASCII) {
// check length of data
if (str.length > 16) {
console.log("is too long, using the first 16 ASCII characters" );
}
// have ASCII data
// 16 characters?
if (str.length >= 16) {
// 16 or more characters
for(i=0; i<16; i++) {
dbyte[i] = str.charCodeAt(i);
}
} else {
// less than 16 characters - fill with NULLs
for(i=0; i<str.length; i++) {
dbyte[i] = str.charCodeAt(i);
}
for( i=str.length; i<16; i++) {
dbyte[i] = 0;
}
}
} else {
// have hex data - remove any spaces they used, then convert
//str = remove_spaces(str);
// check length of data
if ( str.length != 32 ) {
//console.log("\tget_value:\tstr = " + str + "\tisASCII = " + isASCII); //isASCII = false
console.log("length wrong: Is " + str.length + " hex digits, but must be 128 bits (32 hex digits)");
dbyte[0] = -1;
return dbyte;
}
for( i=0; i<16; i++ ) {
// isolate and convert this substring
dbyte[i] = cvt_byte( str.substr(i*2,2) );
if( dbyte[i] < 0 ) {
// have an error
dbyte[0] = -1;
return dbyte;
}
}
}
// return successful conversion
return dbyte;
}
//do the AES GF(2**8) multiplication
// do this by the shift-and-"add" approach
function aes_mul(a, b) {
var res = 0;
while(a > 0) {
if((a&1) != 0)
res = res ^ b; // "add" to the result
a >>>= 1; // shift a to get next higher-order bit
b <<= 1; // shift multiplier also
}
// now reduce it modulo x**8 + x**4 + x**3 + x + 1
var hbit = 0x10000; // bit to test if we need to take action
var modulus = 0x11b00; // modulus - XOR by this to change value
while(hbit >= 0x100) {
if ((res & hbit) != 0) {
res ^= modulus; // XOR with the modulus
}
// prepare for the next loop
hbit >>= 1;
modulus >>= 1;
}
return res;
}
// apply the S-box substitution to the key expansion
function SubWord(word_ary) {
var i;
for(i=0; i<16; i++) {
word_ary[i] = S_enc[word_ary[i]];
}
return word_ary;
}
// rotate the bytes in a word
function RotWord(word_ary) {
return new Array(word_ary[1], word_ary[2], word_ary[3], word_ary[0]);
}
// calculate the first item Rcon[i] = { x^(i-1), 0, 0, 0 }
// note we only return the first item
function Rcon(exp) {
var val = 2;
var result = 1;
// remember to calculate x^(exp-1)
exp--;
// process the exponent using normal shift and multiply
while ( exp > 0 )
{
if ( (exp & 1) != 0 )
result = aes_mul( result, val );
// square the value
val = aes_mul( val, val );
// move to the next bit
exp >>= 1;
}
return result;
}
// round key generation
// return a byte array with the expanded key information
function key_expand( key )
{
var temp = new Array(4);
var i, j;
var w = new Array(4*(Nr+1));
// copy initial key stuff
for( i=0; i<16; i++ )
{
w[i] = key[i];
}
// generate rest of key schedule using 32-bit words
i = 4;
while ( i < 4*(Nr+1)) // blocksize * ( rounds + 1 )
{
// copy word W[i-1] to temp
for( j=0; j<4; j++ )
temp[j] = w[(i-1)*4+j];
if ( i % 4 == 0)
{
// temp = SubWord(RotWord(temp)) ^ Rcon[i/4];
temp = RotWord( temp );
temp = SubWord( temp );
temp[0] ^= Rcon( i>>>2 );
}
// word = word ^ temp
for( j=0; j<4; j++ )
w[i*4+j] = w[(i-4)*4+j] ^ temp[j];
i++;
}
return w;
}
// do S-Box substitution
function SubBytes(state, Sbox)
{
var i;
for( i=0; i<16; i++ )
state[i] = Sbox[ state[i] ];
return state;
}
// shift each row as appropriate
function ShiftRows(state)
{
var t0, t1, t2, t3;
// top row (row 0) isn't shifted
// next row (row 1) rotated left 1 place
t0 = state[I10];
t1 = state[I11];
t2 = state[I12];
t3 = state[I13];
state[I10] = t1;
state[I11] = t2;
state[I12] = t3;
state[I13] = t0;
// next row (row 2) rotated left 2 places
t0 = state[I20];
t1 = state[I21];
t2 = state[I22];
t3 = state[I23];
state[I20] = t2;
state[I21] = t3;
state[I22] = t0;
state[I23] = t1;
// bottom row (row 3) rotated left 3 places
t0 = state[I30];
t1 = state[I31];
t2 = state[I32];
t3 = state[I33];
state[I30] = t3;
state[I31] = t0;
state[I32] = t1;
state[I33] = t2;
return state;
}
// inverset shift each row as appropriate
function InvShiftRows(state)
{
var t0, t1, t2, t3;
// top row (row 0) isn't shifted
// next row (row 1) rotated left 1 place
t0 = state[I10];
t1 = state[I11];
t2 = state[I12];
t3 = state[I13];
state[I10] = t3;
state[I11] = t0;
state[I12] = t1;
state[I13] = t2;
// next row (row 2) rotated left 2 places
t0 = state[I20];
t1 = state[I21];
t2 = state[I22];
t3 = state[I23];
state[I20] = t2;
state[I21] = t3;
state[I22] = t0;
state[I23] = t1;
// bottom row (row 3) rotated left 3 places
t0 = state[I30];
t1 = state[I31];
t2 = state[I32];
t3 = state[I33];
state[I30] = t1;
state[I31] = t2;
state[I32] = t3;
state[I33] = t0;
return state;
}
// process column info
function MixColumns(state)
{
var col;
var c0, c1, c2, c3;
for( col=0; col<4; col++ )
{
c0 = state[I(0,col)];
c1 = state[I(1,col)];
c2 = state[I(2,col)];
c3 = state[I(3,col)];
// do mixing, and put back into array
state[I(0,col)] = aes_mul(2,c0) ^ aes_mul(3,c1) ^ c2 ^ c3;
state[I(1,col)] = c0 ^ aes_mul(2,c1) ^ aes_mul(3,c2) ^ c3;
state[I(2,col)] = c0 ^ c1 ^ aes_mul(2,c2) ^ aes_mul(3,c3);
state[I(3,col)] = aes_mul(3,c0) ^ c1 ^ c2 ^ aes_mul(2,c3);
}
return state;
}
// inverse process column info
function InvMixColumns(state)
{
var col;
var c0, c1, c2, c3;
for( col=0; col<4; col++ )
{
c0 = state[I(0,col)];
c1 = state[I(1,col)];
c2 = state[I(2,col)];
c3 = state[I(3,col)];
// do inverse mixing, and put back into array
state[I(0,col)] = aes_mul(0x0e,c0) ^ aes_mul(0x0b,c1)
^ aes_mul(0x0d,c2) ^ aes_mul(0x09,c3);
state[I(1,col)] = aes_mul(0x09,c0) ^ aes_mul(0x0e,c1)
^ aes_mul(0x0b,c2) ^ aes_mul(0x0d,c3);
state[I(2,col)] = aes_mul(0x0d,c0) ^ aes_mul(0x09,c1)
^ aes_mul(0x0e,c2) ^ aes_mul(0x0b,c3);
state[I(3,col)] = aes_mul(0x0b,c0) ^ aes_mul(0x0d,c1)
^ aes_mul(0x09,c2) ^ aes_mul(0x0e,c3);
}
return state;
}
// insert subkey information
function AddRoundKey( state, w, base )
{
var col;
for( col=0; col<4; col++ )
{
state[I(0,col)] ^= w[base+col*4];
state[I(1,col)] ^= w[base+col*4+1];
state[I(2,col)] ^= w[base+col*4+2];
state[I(3,col)] ^= w[base+col*4+3];
}
return state;
}
// return a transposed array
function transpose( msg )
{
var row, col;
var state = new Array( 16 );
for( row=0; row<4; row++ )
for( col=0; col<4; col++ )
state[I(row,col)] = msg[I(col,row)];
return state;
}
// final AES state
var AES_output = new Array(16);
// format AES output
// -- uses the global array DES_output
function format_AES_output(bASCII)
{
var i;
var bits;
var str="";
// what type of data do we have to work with?
if (bASCII)
{
// convert each set of bits back to ASCII
for( i=0; i<16; i++ )
str += String.fromCharCode( AES_output[i] );
}
else
{
// output hexdecimal data (insert spaces)
str = cvt_hex8( AES_output[0] );
for( i=1; i<16; i++ )
{
str += "" + cvt_hex8( AES_output[i] );
}
}
return str;
}
// do encrytion
function aes_encrypt(str, key, bASCII)
{
//console.log(" aes_encrypt:\tstr = " + str + "\tkey = " + key + "\t bASCII = " + bASCII);
var w = new Array( 4*(Nr+1) ); // subkey information
var state = new Array( 16 ); // working state
var round;
//accumulated_output_info = "";
// get the message from the user
// also check if it is ASCII or hex
var msg = get_value(str, bASCII);
// problems??
if ( msg[0] < 0 )
{
return;
}
// get the key from the user
var key = get_value(key, false);
// problems??
if ( key[0] < 0 )
{
return;
}
// expand the key
w = key_expand( key );
// initial state = message in columns (transposed from what we input)
state = transpose( msg );
// display the round key - Transpose due to the way it is stored/used
state = AddRoundKey(state, w, 0);
for( round=1; round<Nr; round++ )
{
state = SubBytes(state, S_enc);
state = ShiftRows(state);
state = MixColumns(state);
// display the round key - Transpose due to the way it is stored/used
// note here the spec uses 32-bit words, we are using bytes, so an extra *4
state = AddRoundKey(state, w, round*4*4);
}
SubBytes(state, S_enc);
ShiftRows(state);
AddRoundKey(state, w, Nr*4*4);
// process output
AES_output = transpose( state );
var szOutput = format_AES_output(!bASCII);
return szOutput;
}
// do decryption
function aes_decrypt(str, key, bASCII)
{
//console.log(" aes_decrypt:\tstr = " + str + "\tkey = " + key + "\tbASCII = " + bASCII);
var w = new Array( 4*(Nr+1) ); // subkey information
var state = new Array( 16 ); // working state
var round;
//accumulated_output_info = "";
// get the message from the user
// also check if it is ASCII or hex
var msg = get_value(str, bASCII);
// problems??
if ( msg[0] < 0 )
{
return;
}
// get the key from the user
var key = get_value(key, false);
// problems??
if ( key[0] < 0 )
{
return;
}
// expand the key
w = key_expand( key );
// initial state = message
state = transpose( msg );
// display the round key - Transpose due to the way it is stored/used
state = AddRoundKey(state, w, Nr*4*4);
for( round=Nr-1; round>=1; round-- )
{
state = InvShiftRows(state);
state = SubBytes(state, S_dec);
// display the round key - Transpose due to the way it is stored/used
// note here the spec uses 32-bit words, we are using bytes, so an extra *4
state = AddRoundKey(state, w, round*4*4);
state = InvMixColumns(state);
}
InvShiftRows(state);
SubBytes(state, S_dec);
AddRoundKey(state, w, 0);
// process output
AES_output = transpose( state );
var szOutput = format_AES_output(!bASCII);
return szOutput;
}
window.aes_encrypt = aes_encrypt;
window.aes_decrypt = aes_decrypt;
window.console = window.console || {
log: function() {}
};
}());

View File

@ -0,0 +1,106 @@
var dbits,canary=244837814094590,j_lm=(canary&16777215)==15715070;function BigInteger(a,b,c){a!=null&&("number"==typeof a?this.fromNumber(a,b,c):b==null&&"string"!=typeof a?this.fromString(a,256):this.fromString(a,b))}function nbi(){return new BigInteger(null)}function am1(a,b,c,d,e,g){for(;--g>=0;){var h=b*this[a++]+c[d]+e,e=Math.floor(h/67108864);c[d++]=h&67108863}return e}
function am2(a,b,c,d,e,g){var h=b&32767;for(b>>=15;--g>=0;){var f=this[a]&32767,o=this[a++]>>15,p=b*f+o*h,f=h*f+((p&32767)<<15)+c[d]+(e&1073741823),e=(f>>>30)+(p>>>15)+b*o+(e>>>30);c[d++]=f&1073741823}return e}function am3(a,b,c,d,e,g){var h=b&16383;for(b>>=14;--g>=0;){var f=this[a]&16383,o=this[a++]>>14,p=b*f+o*h,f=h*f+((p&16383)<<14)+c[d]+e,e=(f>>28)+(p>>14)+b*o;c[d++]=f&268435455}return e}
j_lm&&navigator.appName=="Microsoft Internet Explorer"?(BigInteger.prototype.am=am2,dbits=30):j_lm&&navigator.appName!="Netscape"?(BigInteger.prototype.am=am1,dbits=26):(BigInteger.prototype.am=am3,dbits=28);BigInteger.prototype.DB=dbits;BigInteger.prototype.DM=(1<<dbits)-1;BigInteger.prototype.DV=1<<dbits;var BI_FP=52;BigInteger.prototype.FV=Math.pow(2,BI_FP);BigInteger.prototype.F1=BI_FP-dbits;BigInteger.prototype.F2=2*dbits-BI_FP;var BI_RM="0123456789abcdefghijklmnopqrstuvwxyz",BI_RC=[],rr,vv;
rr="0".charCodeAt(0);for(vv=0;vv<=9;++vv)BI_RC[rr++]=vv;rr="a".charCodeAt(0);for(vv=10;vv<36;++vv)BI_RC[rr++]=vv;rr="A".charCodeAt(0);for(vv=10;vv<36;++vv)BI_RC[rr++]=vv;function int2char(a){return BI_RM.charAt(a)}function intAt(a,b){var c=BI_RC[a.charCodeAt(b)];return c==null?-1:c}function bnpCopyTo(a){for(var b=this.t-1;b>=0;--b)a[b]=this[b];a.t=this.t;a.s=this.s}function bnpFromInt(a){this.t=1;this.s=a<0?-1:0;a>0?this[0]=a:a<-1?this[0]=a+DV:this.t=0}
function nbv(a){var b=nbi();b.fromInt(a);return b}
function bnpFromString(a,b){var c;if(b==16)c=4;else if(b==8)c=3;else if(b==256)c=8;else if(b==2)c=1;else if(b==32)c=5;else if(b==4)c=2;else{this.fromRadix(a,b);return}this.s=this.t=0;for(var d=a.length,e=!1,g=0;--d>=0;){var h=c==8?a[d]&255:intAt(a,d);h<0?a.charAt(d)=="-"&&(e=!0):(e=!1,g==0?this[this.t++]=h:g+c>this.DB?(this[this.t-1]|=(h&(1<<this.DB-g)-1)<<g,this[this.t++]=h>>this.DB-g):this[this.t-1]|=h<<g,g+=c,g>=this.DB&&(g-=this.DB))}if(c==8&&(a[0]&128)!=0)this.s=-1,g>0&&(this[this.t-1]|=(1<<
this.DB-g)-1<<g);this.clamp();e&&BigInteger.ZERO.subTo(this,this)}function bnpClamp(){for(var a=this.s&this.DM;this.t>0&&this[this.t-1]==a;)--this.t}
function bnToString(a){if(this.s<0)return"-"+this.negate().toString(a);if(a==16)a=4;else if(a==8)a=3;else if(a==2)a=1;else if(a==32)a=5;else if(a==64)a=6;else if(a==4)a=2;else return this.toRadix(a);var b=(1<<a)-1,c,d=!1,e="",g=this.t,h=this.DB-g*this.DB%a;if(g-- >0){if(h<this.DB&&(c=this[g]>>h)>0)d=!0,e=int2char(c);for(;g>=0;)h<a?(c=(this[g]&(1<<h)-1)<<a-h,c|=this[--g]>>(h+=this.DB-a)):(c=this[g]>>(h-=a)&b,h<=0&&(h+=this.DB,--g)),c>0&&(d=!0),d&&(e+=int2char(c))}return d?e:"0"}
function bnNegate(){var a=nbi();BigInteger.ZERO.subTo(this,a);return a}function bnAbs(){return this.s<0?this.negate():this}function bnCompareTo(a){var b=this.s-a.s;if(b!=0)return b;var c=this.t,b=c-a.t;if(b!=0)return b;for(;--c>=0;)if((b=this[c]-a[c])!=0)return b;return 0}function nbits(a){var b=1,c;if((c=a>>>16)!=0)a=c,b+=16;if((c=a>>8)!=0)a=c,b+=8;if((c=a>>4)!=0)a=c,b+=4;if((c=a>>2)!=0)a=c,b+=2;a>>1!=0&&(b+=1);return b}
function bnBitLength(){return this.t<=0?0:this.DB*(this.t-1)+nbits(this[this.t-1]^this.s&this.DM)}function bnpDLShiftTo(a,b){var c;for(c=this.t-1;c>=0;--c)b[c+a]=this[c];for(c=a-1;c>=0;--c)b[c]=0;b.t=this.t+a;b.s=this.s}function bnpDRShiftTo(a,b){for(var c=a;c<this.t;++c)b[c-a]=this[c];b.t=Math.max(this.t-a,0);b.s=this.s}
function bnpLShiftTo(a,b){var c=a%this.DB,d=this.DB-c,e=(1<<d)-1,g=Math.floor(a/this.DB),h=this.s<<c&this.DM,f;for(f=this.t-1;f>=0;--f)b[f+g+1]=this[f]>>d|h,h=(this[f]&e)<<c;for(f=g-1;f>=0;--f)b[f]=0;b[g]=h;b.t=this.t+g+1;b.s=this.s;b.clamp()}
function bnpRShiftTo(a,b){b.s=this.s;var c=Math.floor(a/this.DB);if(c>=this.t)b.t=0;else{var d=a%this.DB,e=this.DB-d,g=(1<<d)-1;b[0]=this[c]>>d;for(var h=c+1;h<this.t;++h)b[h-c-1]|=(this[h]&g)<<e,b[h-c]=this[h]>>d;d>0&&(b[this.t-c-1]|=(this.s&g)<<e);b.t=this.t-c;b.clamp()}}
function bnpSubTo(a,b){for(var c=0,d=0,e=Math.min(a.t,this.t);c<e;)d+=this[c]-a[c],b[c++]=d&this.DM,d>>=this.DB;if(a.t<this.t){for(d-=a.s;c<this.t;)d+=this[c],b[c++]=d&this.DM,d>>=this.DB;d+=this.s}else{for(d+=this.s;c<a.t;)d-=a[c],b[c++]=d&this.DM,d>>=this.DB;d-=a.s}b.s=d<0?-1:0;d<-1?b[c++]=this.DV+d:d>0&&(b[c++]=d);b.t=c;b.clamp()}
function bnpMultiplyTo(a,b){var c=this.abs(),d=a.abs(),e=c.t;for(b.t=e+d.t;--e>=0;)b[e]=0;for(e=0;e<d.t;++e)b[e+c.t]=c.am(0,d[e],b,e,0,c.t);b.s=0;b.clamp();this.s!=a.s&&BigInteger.ZERO.subTo(b,b)}function bnpSquareTo(a){for(var b=this.abs(),c=a.t=2*b.t;--c>=0;)a[c]=0;for(c=0;c<b.t-1;++c){var d=b.am(c,b[c],a,2*c,0,1);if((a[c+b.t]+=b.am(c+1,2*b[c],a,2*c+1,d,b.t-c-1))>=b.DV)a[c+b.t]-=b.DV,a[c+b.t+1]=1}a.t>0&&(a[a.t-1]+=b.am(c,b[c],a,2*c,0,1));a.s=0;a.clamp()}
function bnpDivRemTo(a,b,c){var d=a.abs();if(!(d.t<=0)){var e=this.abs();if(e.t<d.t)b!=null&&b.fromInt(0),c!=null&&this.copyTo(c);else{c==null&&(c=nbi());var g=nbi(),h=this.s,a=a.s,f=this.DB-nbits(d[d.t-1]);f>0?(d.lShiftTo(f,g),e.lShiftTo(f,c)):(d.copyTo(g),e.copyTo(c));d=g.t;e=g[d-1];if(e!=0){var o=e*(1<<this.F1)+(d>1?g[d-2]>>this.F2:0),p=this.FV/o,o=(1<<this.F1)/o,q=1<<this.F2,n=c.t,k=n-d,j=b==null?nbi():b;g.dlShiftTo(k,j);c.compareTo(j)>=0&&(c[c.t++]=1,c.subTo(j,c));BigInteger.ONE.dlShiftTo(d,
j);for(j.subTo(g,g);g.t<d;)g[g.t++]=0;for(;--k>=0;){var l=c[--n]==e?this.DM:Math.floor(c[n]*p+(c[n-1]+q)*o);if((c[n]+=g.am(0,l,c,k,0,d))<l){g.dlShiftTo(k,j);for(c.subTo(j,c);c[n]<--l;)c.subTo(j,c)}}b!=null&&(c.drShiftTo(d,b),h!=a&&BigInteger.ZERO.subTo(b,b));c.t=d;c.clamp();f>0&&c.rShiftTo(f,c);h<0&&BigInteger.ZERO.subTo(c,c)}}}}function bnMod(a){var b=nbi();this.abs().divRemTo(a,null,b);this.s<0&&b.compareTo(BigInteger.ZERO)>0&&a.subTo(b,b);return b}function Classic(a){this.m=a}
function cConvert(a){return a.s<0||a.compareTo(this.m)>=0?a.mod(this.m):a}function cRevert(a){return a}function cReduce(a){a.divRemTo(this.m,null,a)}function cMulTo(a,b,c){a.multiplyTo(b,c);this.reduce(c)}function cSqrTo(a,b){a.squareTo(b);this.reduce(b)}Classic.prototype.convert=cConvert;Classic.prototype.revert=cRevert;Classic.prototype.reduce=cReduce;Classic.prototype.mulTo=cMulTo;Classic.prototype.sqrTo=cSqrTo;
function bnpInvDigit(){if(this.t<1)return 0;var a=this[0];if((a&1)==0)return 0;var b=a&3,b=b*(2-(a&15)*b)&15,b=b*(2-(a&255)*b)&255,b=b*(2-((a&65535)*b&65535))&65535,b=b*(2-a*b%this.DV)%this.DV;return b>0?this.DV-b:-b}function Montgomery(a){this.m=a;this.mp=a.invDigit();this.mpl=this.mp&32767;this.mph=this.mp>>15;this.um=(1<<a.DB-15)-1;this.mt2=2*a.t}
function montConvert(a){var b=nbi();a.abs().dlShiftTo(this.m.t,b);b.divRemTo(this.m,null,b);a.s<0&&b.compareTo(BigInteger.ZERO)>0&&this.m.subTo(b,b);return b}function montRevert(a){var b=nbi();a.copyTo(b);this.reduce(b);return b}
function montReduce(a){for(;a.t<=this.mt2;)a[a.t++]=0;for(var b=0;b<this.m.t;++b){var c=a[b]&32767,d=c*this.mpl+((c*this.mph+(a[b]>>15)*this.mpl&this.um)<<15)&a.DM,c=b+this.m.t;for(a[c]+=this.m.am(0,d,a,b,0,this.m.t);a[c]>=a.DV;)a[c]-=a.DV,a[++c]++}a.clamp();a.drShiftTo(this.m.t,a);a.compareTo(this.m)>=0&&a.subTo(this.m,a)}function montSqrTo(a,b){a.squareTo(b);this.reduce(b)}function montMulTo(a,b,c){a.multiplyTo(b,c);this.reduce(c)}Montgomery.prototype.convert=montConvert;
Montgomery.prototype.revert=montRevert;Montgomery.prototype.reduce=montReduce;Montgomery.prototype.mulTo=montMulTo;Montgomery.prototype.sqrTo=montSqrTo;function bnpIsEven(){return(this.t>0?this[0]&1:this.s)==0}function bnpExp(a,b){if(a>4294967295||a<1)return BigInteger.ONE;var c=nbi(),d=nbi(),e=b.convert(this),g=nbits(a)-1;for(e.copyTo(c);--g>=0;)if(b.sqrTo(c,d),(a&1<<g)>0)b.mulTo(d,e,c);else var h=c,c=d,d=h;return b.revert(c)}
function bnModPowInt(a,b){var c;c=a<256||b.isEven()?new Classic(b):new Montgomery(b);return this.exp(a,c)}BigInteger.prototype.copyTo=bnpCopyTo;BigInteger.prototype.fromInt=bnpFromInt;BigInteger.prototype.fromString=bnpFromString;BigInteger.prototype.clamp=bnpClamp;BigInteger.prototype.dlShiftTo=bnpDLShiftTo;BigInteger.prototype.drShiftTo=bnpDRShiftTo;BigInteger.prototype.lShiftTo=bnpLShiftTo;BigInteger.prototype.rShiftTo=bnpRShiftTo;BigInteger.prototype.subTo=bnpSubTo;
BigInteger.prototype.multiplyTo=bnpMultiplyTo;BigInteger.prototype.squareTo=bnpSquareTo;BigInteger.prototype.divRemTo=bnpDivRemTo;BigInteger.prototype.invDigit=bnpInvDigit;BigInteger.prototype.isEven=bnpIsEven;BigInteger.prototype.exp=bnpExp;BigInteger.prototype.toString=bnToString;BigInteger.prototype.negate=bnNegate;BigInteger.prototype.abs=bnAbs;BigInteger.prototype.compareTo=bnCompareTo;BigInteger.prototype.bitLength=bnBitLength;BigInteger.prototype.mod=bnMod;BigInteger.prototype.modPowInt=bnModPowInt;
BigInteger.ZERO=nbv(0);BigInteger.ONE=nbv(1);function bnClone(){var a=nbi();this.copyTo(a);return a}function bnIntValue(){if(this.s<0)if(this.t==1)return this[0]-this.DV;else{if(this.t==0)return-1}else if(this.t==1)return this[0];else if(this.t==0)return 0;return(this[1]&(1<<32-this.DB)-1)<<this.DB|this[0]}function bnByteValue(){return this.t==0?this.s:this[0]<<24>>24}function bnShortValue(){return this.t==0?this.s:this[0]<<16>>16}
function bnpChunkSize(a){return Math.floor(Math.LN2*this.DB/Math.log(a))}function bnSigNum(){return this.s<0?-1:this.t<=0||this.t==1&&this[0]<=0?0:1}function bnpToRadix(a){a==null&&(a=10);if(this.signum()==0||a<2||a>36)return"0";var b=this.chunkSize(a),b=Math.pow(a,b),c=nbv(b),d=nbi(),e=nbi(),g="";for(this.divRemTo(c,d,e);d.signum()>0;)g=(b+e.intValue()).toString(a).substr(1)+g,d.divRemTo(c,d,e);return e.intValue().toString(a)+g}
function bnpFromRadix(a,b){this.fromInt(0);b==null&&(b=10);for(var c=this.chunkSize(b),d=Math.pow(b,c),e=!1,g=0,h=0,f=0;f<a.length;++f){var o=intAt(a,f);o<0?a.charAt(f)=="-"&&this.signum()==0&&(e=!0):(h=b*h+o,++g>=c&&(this.dMultiply(d),this.dAddOffset(h,0),h=g=0))}g>0&&(this.dMultiply(Math.pow(b,g)),this.dAddOffset(h,0));e&&BigInteger.ZERO.subTo(this,this)}
function bnpFromNumber(a,b,c){if("number"==typeof b)if(a<2)this.fromInt(1);else{this.fromNumber(a,c);this.testBit(a-1)||this.bitwiseTo(BigInteger.ONE.shiftLeft(a-1),op_or,this);for(this.isEven()&&this.dAddOffset(1,0);!this.isProbablePrime(b);)this.dAddOffset(2,0),this.bitLength()>a&&this.subTo(BigInteger.ONE.shiftLeft(a-1),this)}else{var c=[],d=a&7;c.length=(a>>3)+1;b.nextBytes(c);d>0?c[0]&=(1<<d)-1:c[0]=0;this.fromString(c,256)}}
function bnToByteArray(){var a=this.t,b=[];b[0]=this.s;var c=this.DB-a*this.DB%8,d,e=0;if(a-- >0){if(c<this.DB&&(d=this[a]>>c)!=(this.s&this.DM)>>c)b[e++]=d|this.s<<this.DB-c;for(;a>=0;)if(c<8?(d=(this[a]&(1<<c)-1)<<8-c,d|=this[--a]>>(c+=this.DB-8)):(d=this[a]>>(c-=8)&255,c<=0&&(c+=this.DB,--a)),(d&128)!=0&&(d|=-256),e==0&&(this.s&128)!=(d&128)&&++e,e>0||d!=this.s)b[e++]=d}return b}function bnEquals(a){return this.compareTo(a)==0}function bnMin(a){return this.compareTo(a)<0?this:a}
function bnMax(a){return this.compareTo(a)>0?this:a}function bnpBitwiseTo(a,b,c){var d,e,g=Math.min(a.t,this.t);for(d=0;d<g;++d)c[d]=b(this[d],a[d]);if(a.t<this.t){e=a.s&this.DM;for(d=g;d<this.t;++d)c[d]=b(this[d],e);c.t=this.t}else{e=this.s&this.DM;for(d=g;d<a.t;++d)c[d]=b(e,a[d]);c.t=a.t}c.s=b(this.s,a.s);c.clamp()}function op_and(a,b){return a&b}function bnAnd(a){var b=nbi();this.bitwiseTo(a,op_and,b);return b}function op_or(a,b){return a|b}
function bnOr(a){var b=nbi();this.bitwiseTo(a,op_or,b);return b}function op_xor(a,b){return a^b}function bnXor(a){var b=nbi();this.bitwiseTo(a,op_xor,b);return b}function op_andnot(a,b){return a&~b}function bnAndNot(a){var b=nbi();this.bitwiseTo(a,op_andnot,b);return b}function bnNot(){for(var a=nbi(),b=0;b<this.t;++b)a[b]=this.DM&~this[b];a.t=this.t;a.s=~this.s;return a}function bnShiftLeft(a){var b=nbi();a<0?this.rShiftTo(-a,b):this.lShiftTo(a,b);return b}
function bnShiftRight(a){var b=nbi();a<0?this.lShiftTo(-a,b):this.rShiftTo(a,b);return b}function lbit(a){if(a==0)return-1;var b=0;(a&65535)==0&&(a>>=16,b+=16);(a&255)==0&&(a>>=8,b+=8);(a&15)==0&&(a>>=4,b+=4);(a&3)==0&&(a>>=2,b+=2);(a&1)==0&&++b;return b}function bnGetLowestSetBit(){for(var a=0;a<this.t;++a)if(this[a]!=0)return a*this.DB+lbit(this[a]);return this.s<0?this.t*this.DB:-1}function cbit(a){for(var b=0;a!=0;)a&=a-1,++b;return b}
function bnBitCount(){for(var a=0,b=this.s&this.DM,c=0;c<this.t;++c)a+=cbit(this[c]^b);return a}function bnTestBit(a){var b=Math.floor(a/this.DB);return b>=this.t?this.s!=0:(this[b]&1<<a%this.DB)!=0}function bnpChangeBit(a,b){var c=BigInteger.ONE.shiftLeft(a);this.bitwiseTo(c,b,c);return c}function bnSetBit(a){return this.changeBit(a,op_or)}function bnClearBit(a){return this.changeBit(a,op_andnot)}function bnFlipBit(a){return this.changeBit(a,op_xor)}
function bnpAddTo(a,b){for(var c=0,d=0,e=Math.min(a.t,this.t);c<e;)d+=this[c]+a[c],b[c++]=d&this.DM,d>>=this.DB;if(a.t<this.t){for(d+=a.s;c<this.t;)d+=this[c],b[c++]=d&this.DM,d>>=this.DB;d+=this.s}else{for(d+=this.s;c<a.t;)d+=a[c],b[c++]=d&this.DM,d>>=this.DB;d+=a.s}b.s=d<0?-1:0;d>0?b[c++]=d:d<-1&&(b[c++]=this.DV+d);b.t=c;b.clamp()}function bnAdd(a){var b=nbi();this.addTo(a,b);return b}function bnSubtract(a){var b=nbi();this.subTo(a,b);return b}
function bnMultiply(a){var b=nbi();this.multiplyTo(a,b);return b}function bnSquare(){var a=nbi();this.squareTo(a);return a}function bnDivide(a){var b=nbi();this.divRemTo(a,b,null);return b}function bnRemainder(a){var b=nbi();this.divRemTo(a,null,b);return b}function bnDivideAndRemainder(a){var b=nbi(),c=nbi();this.divRemTo(a,b,c);return[b,c]}function bnpDMultiply(a){this[this.t]=this.am(0,a-1,this,0,0,this.t);++this.t;this.clamp()}
function bnpDAddOffset(a,b){if(a!=0){for(;this.t<=b;)this[this.t++]=0;for(this[b]+=a;this[b]>=this.DV;)this[b]-=this.DV,++b>=this.t&&(this[this.t++]=0),++this[b]}}function NullExp(){}function nNop(a){return a}function nMulTo(a,b,c){a.multiplyTo(b,c)}function nSqrTo(a,b){a.squareTo(b)}NullExp.prototype.convert=nNop;NullExp.prototype.revert=nNop;NullExp.prototype.mulTo=nMulTo;NullExp.prototype.sqrTo=nSqrTo;function bnPow(a){return this.exp(a,new NullExp)}
function bnpMultiplyLowerTo(a,b,c){var d=Math.min(this.t+a.t,b);c.s=0;for(c.t=d;d>0;)c[--d]=0;var e;for(e=c.t-this.t;d<e;++d)c[d+this.t]=this.am(0,a[d],c,d,0,this.t);for(e=Math.min(a.t,b);d<e;++d)this.am(0,a[d],c,d,0,b-d);c.clamp()}function bnpMultiplyUpperTo(a,b,c){--b;var d=c.t=this.t+a.t-b;for(c.s=0;--d>=0;)c[d]=0;for(d=Math.max(b-this.t,0);d<a.t;++d)c[this.t+d-b]=this.am(b-d,a[d],c,0,0,this.t+d-b);c.clamp();c.drShiftTo(1,c)}
function Barrett(a){this.r2=nbi();this.q3=nbi();BigInteger.ONE.dlShiftTo(2*a.t,this.r2);this.mu=this.r2.divide(a);this.m=a}function barrettConvert(a){if(a.s<0||a.t>2*this.m.t)return a.mod(this.m);else if(a.compareTo(this.m)<0)return a;else{var b=nbi();a.copyTo(b);this.reduce(b);return b}}function barrettRevert(a){return a}
function barrettReduce(a){a.drShiftTo(this.m.t-1,this.r2);if(a.t>this.m.t+1)a.t=this.m.t+1,a.clamp();this.mu.multiplyUpperTo(this.r2,this.m.t+1,this.q3);for(this.m.multiplyLowerTo(this.q3,this.m.t+1,this.r2);a.compareTo(this.r2)<0;)a.dAddOffset(1,this.m.t+1);for(a.subTo(this.r2,a);a.compareTo(this.m)>=0;)a.subTo(this.m,a)}function barrettSqrTo(a,b){a.squareTo(b);this.reduce(b)}function barrettMulTo(a,b,c){a.multiplyTo(b,c);this.reduce(c)}Barrett.prototype.convert=barrettConvert;
Barrett.prototype.revert=barrettRevert;Barrett.prototype.reduce=barrettReduce;Barrett.prototype.mulTo=barrettMulTo;Barrett.prototype.sqrTo=barrettSqrTo;
function bnModPow(a,b){var c=a.bitLength(),d,e=nbv(1),g;if(c<=0)return e;else d=c<18?1:c<48?3:c<144?4:c<768?5:6;g=c<8?new Classic(b):b.isEven()?new Barrett(b):new Montgomery(b);var h=[],f=3,o=d-1,p=(1<<d)-1;h[1]=g.convert(this);if(d>1){c=nbi();for(g.sqrTo(h[1],c);f<=p;)h[f]=nbi(),g.mulTo(c,h[f-2],h[f]),f+=2}for(var q=a.t-1,n,k=!0,j=nbi(),c=nbits(a[q])-1;q>=0;){c>=o?n=a[q]>>c-o&p:(n=(a[q]&(1<<c+1)-1)<<o-c,q>0&&(n|=a[q-1]>>this.DB+c-o));for(f=d;(n&1)==0;)n>>=1,--f;if((c-=f)<0)c+=this.DB,--q;if(k)h[n].copyTo(e),
k=!1;else{for(;f>1;)g.sqrTo(e,j),g.sqrTo(j,e),f-=2;f>0?g.sqrTo(e,j):(f=e,e=j,j=f);g.mulTo(j,h[n],e)}for(;q>=0&&(a[q]&1<<c)==0;)g.sqrTo(e,j),f=e,e=j,j=f,--c<0&&(c=this.DB-1,--q)}return g.revert(e)}
function bnGCD(a){var b=this.s<0?this.negate():this.clone(),a=a.s<0?a.negate():a.clone();if(b.compareTo(a)<0)var c=b,b=a,a=c;var c=b.getLowestSetBit(),d=a.getLowestSetBit();if(d<0)return b;c<d&&(d=c);d>0&&(b.rShiftTo(d,b),a.rShiftTo(d,a));for(;b.signum()>0;)(c=b.getLowestSetBit())>0&&b.rShiftTo(c,b),(c=a.getLowestSetBit())>0&&a.rShiftTo(c,a),b.compareTo(a)>=0?(b.subTo(a,b),b.rShiftTo(1,b)):(a.subTo(b,a),a.rShiftTo(1,a));d>0&&a.lShiftTo(d,a);return a}
function bnpModInt(a){if(a<=0)return 0;var b=this.DV%a,c=this.s<0?a-1:0;if(this.t>0)if(b==0)c=this[0]%a;else for(var d=this.t-1;d>=0;--d)c=(b*c+this[d])%a;return c}
function bnModInverse(a){var b=a.isEven();if(this.isEven()&&b||a.signum()==0)return BigInteger.ZERO;for(var c=a.clone(),d=this.clone(),e=nbv(1),g=nbv(0),h=nbv(0),f=nbv(1);c.signum()!=0;){for(;c.isEven();){c.rShiftTo(1,c);if(b){if(!e.isEven()||!g.isEven())e.addTo(this,e),g.subTo(a,g);e.rShiftTo(1,e)}else g.isEven()||g.subTo(a,g);g.rShiftTo(1,g)}for(;d.isEven();){d.rShiftTo(1,d);if(b){if(!h.isEven()||!f.isEven())h.addTo(this,h),f.subTo(a,f);h.rShiftTo(1,h)}else f.isEven()||f.subTo(a,f);f.rShiftTo(1,
f)}c.compareTo(d)>=0?(c.subTo(d,c),b&&e.subTo(h,e),g.subTo(f,g)):(d.subTo(c,d),b&&h.subTo(e,h),f.subTo(g,f))}if(d.compareTo(BigInteger.ONE)!=0)return BigInteger.ZERO;if(f.compareTo(a)>=0)return f.subtract(a);if(f.signum()<0)f.addTo(a,f);else return f;return f.signum()<0?f.add(a):f}
var lowprimes=[2,3,5,7,11,13,17,19,23,29,31,37,41,43,47,53,59,61,67,71,73,79,83,89,97,101,103,107,109,113,127,131,137,139,149,151,157,163,167,173,179,181,191,193,197,199,211,223,227,229,233,239,241,251,257,263,269,271,277,281,283,293,307,311,313,317,331,337,347,349,353,359,367,373,379,383,389,397,401,409,419,421,431,433,439,443,449,457,461,463,467,479,487,491,499,503,509,521,523,541,547,557,563,569,571,577,587,593,599,601,607,613,617,619,631,641,643,647,653,659,661,673,677,683,691,701,709,719,727,
733,739,743,751,757,761,769,773,787,797,809,811,821,823,827,829,839,853,857,859,863,877,881,883,887,907,911,919,929,937,941,947,953,967,971,977,983,991,997],lplim=67108864/lowprimes[lowprimes.length-1];
function bnIsProbablePrime(a){var b,c=this.abs();if(c.t==1&&c[0]<=lowprimes[lowprimes.length-1]){for(b=0;b<lowprimes.length;++b)if(c[0]==lowprimes[b])return!0;return!1}if(c.isEven())return!1;for(b=1;b<lowprimes.length;){for(var d=lowprimes[b],e=b+1;e<lowprimes.length&&d<lplim;)d*=lowprimes[e++];for(d=c.modInt(d);b<e;)if(d%lowprimes[b++]==0)return!1}return c.millerRabin(a)}
function bnpMillerRabin(a){var b=this.subtract(BigInteger.ONE),c=b.getLowestSetBit();if(c<=0)return!1;var d=b.shiftRight(c),a=a+1>>1;if(a>lowprimes.length)a=lowprimes.length;for(var e=nbi(),g=0;g<a;++g){e.fromInt(lowprimes[Math.floor(Math.random()*lowprimes.length)]);var h=e.modPow(d,this);if(h.compareTo(BigInteger.ONE)!=0&&h.compareTo(b)!=0){for(var f=1;f++<c&&h.compareTo(b)!=0;)if(h=h.modPowInt(2,this),h.compareTo(BigInteger.ONE)==0)return!1;if(h.compareTo(b)!=0)return!1}}return!0}
BigInteger.prototype.chunkSize=bnpChunkSize;BigInteger.prototype.toRadix=bnpToRadix;BigInteger.prototype.fromRadix=bnpFromRadix;BigInteger.prototype.fromNumber=bnpFromNumber;BigInteger.prototype.bitwiseTo=bnpBitwiseTo;BigInteger.prototype.changeBit=bnpChangeBit;BigInteger.prototype.addTo=bnpAddTo;BigInteger.prototype.dMultiply=bnpDMultiply;BigInteger.prototype.dAddOffset=bnpDAddOffset;BigInteger.prototype.multiplyLowerTo=bnpMultiplyLowerTo;BigInteger.prototype.multiplyUpperTo=bnpMultiplyUpperTo;
BigInteger.prototype.modInt=bnpModInt;BigInteger.prototype.millerRabin=bnpMillerRabin;BigInteger.prototype.clone=bnClone;BigInteger.prototype.intValue=bnIntValue;BigInteger.prototype.byteValue=bnByteValue;BigInteger.prototype.shortValue=bnShortValue;BigInteger.prototype.signum=bnSigNum;BigInteger.prototype.toByteArray=bnToByteArray;BigInteger.prototype.equals=bnEquals;BigInteger.prototype.min=bnMin;BigInteger.prototype.max=bnMax;BigInteger.prototype.and=bnAnd;BigInteger.prototype.or=bnOr;
BigInteger.prototype.xor=bnXor;BigInteger.prototype.andNot=bnAndNot;BigInteger.prototype.not=bnNot;BigInteger.prototype.shiftLeft=bnShiftLeft;BigInteger.prototype.shiftRight=bnShiftRight;BigInteger.prototype.getLowestSetBit=bnGetLowestSetBit;BigInteger.prototype.bitCount=bnBitCount;BigInteger.prototype.testBit=bnTestBit;BigInteger.prototype.setBit=bnSetBit;BigInteger.prototype.clearBit=bnClearBit;BigInteger.prototype.flipBit=bnFlipBit;BigInteger.prototype.add=bnAdd;BigInteger.prototype.subtract=bnSubtract;
BigInteger.prototype.multiply=bnMultiply;BigInteger.prototype.divide=bnDivide;BigInteger.prototype.remainder=bnRemainder;BigInteger.prototype.divideAndRemainder=bnDivideAndRemainder;BigInteger.prototype.modPow=bnModPow;BigInteger.prototype.modInverse=bnModInverse;BigInteger.prototype.pow=bnPow;BigInteger.prototype.gcd=bnGCD;BigInteger.prototype.isProbablePrime=bnIsProbablePrime;BigInteger.prototype.square=bnSquare;
(function(a,b,c,d,e,g,h){function f(a){var b,d,e=this,g=a.length,f=0,h=e.i=e.j=e.m=0;e.S=[];e.c=[];for(g||(a=[g++]);f<c;)e.S[f]=f++;for(f=0;f<c;f++)b=e.S[f],h=h+b+a[f%g]&c-1,d=e.S[h],e.S[f]=d,e.S[h]=b;e.g=function(a){var b=e.S,d=e.i+1&c-1,g=b[d],f=e.j+g&c-1,h=b[f];b[d]=h;b[f]=g;for(var k=b[g+h&c-1];--a;)d=d+1&c-1,g=b[d],f=f+g&c-1,h=b[f],b[d]=h,b[f]=g,k=k*c+b[g+h&c-1];e.i=d;e.j=f;return k};e.g(c)}function o(a,b,c,d,e){c=[];e=typeof a;if(b&&e=="object")for(d in a)if(d.indexOf("S")<5)try{c.push(o(a[d],
b-1))}catch(g){}return c.length?c:a+(e!="string"?"\x00":"")}function p(a,b,d,e){a+="";for(e=d=0;e<a.length;e++){var g=b,f=e&c-1,h=(d^=b[e&c-1]*19)+a.charCodeAt(e);g[f]=h&c-1}a="";for(e in b)a+=String.fromCharCode(b[e]);return a}b.seedrandom=function(q,n){var k=[],j,q=p(o(n?[q,a]:arguments.length?q:[(new Date).getTime(),a,window],3),k);j=new f(k);p(j.S,a);b.random=function(){for(var a=j.g(d),b=h,f=0;a<e;)a=(a+f)*c,b*=c,f=j.g(1);for(;a>=g;)a/=2,b/=2,f>>>=1;return(a+f)/b};return q};h=b.pow(c,d);e=b.pow(2,
e);g=e*2;p(b.random(),a)})([],Math,256,6,52);function SeededRandom(){}function SRnextBytes(a){var b;for(b=0;b<a.length;b++)a[b]=Math.floor(Math.random()*256)}SeededRandom.prototype.nextBytes=SRnextBytes;function Arcfour(){this.j=this.i=0;this.S=[]}function ARC4init(a){var b,c,d;for(b=0;b<256;++b)this.S[b]=b;for(b=c=0;b<256;++b)c=c+this.S[b]+a[b%a.length]&255,d=this.S[b],this.S[b]=this.S[c],this.S[c]=d;this.j=this.i=0}
function ARC4next(){var a;this.i=this.i+1&255;this.j=this.j+this.S[this.i]&255;a=this.S[this.i];this.S[this.i]=this.S[this.j];this.S[this.j]=a;return this.S[a+this.S[this.i]&255]}Arcfour.prototype.init=ARC4init;Arcfour.prototype.next=ARC4next;function prng_newstate(){return new Arcfour}var rng_psize=256,rng_state,rng_pool,rng_pptr;
function rng_seed_int(a){rng_pool[rng_pptr++]^=a&255;rng_pool[rng_pptr++]^=a>>8&255;rng_pool[rng_pptr++]^=a>>16&255;rng_pool[rng_pptr++]^=a>>24&255;rng_pptr>=rng_psize&&(rng_pptr-=rng_psize)}function rng_seed_time(){rng_seed_int((new Date).getTime())}
if(rng_pool==null){rng_pool=[];rng_pptr=0;var t;if(navigator.appName=="Netscape"&&navigator.appVersion<"5"&&window.crypto){var z=window.crypto.random(32);for(t=0;t<z.length;++t)rng_pool[rng_pptr++]=z.charCodeAt(t)&255}for(;rng_pptr<rng_psize;)t=Math.floor(65536*Math.random()),rng_pool[rng_pptr++]=t>>>8,rng_pool[rng_pptr++]=t&255;rng_pptr=0;rng_seed_time()}
function rng_get_byte(){if(rng_state==null){rng_seed_time();rng_state=prng_newstate();rng_state.init(rng_pool);for(rng_pptr=0;rng_pptr<rng_pool.length;++rng_pptr)rng_pool[rng_pptr]=0;rng_pptr=0}return rng_state.next()}function rng_get_bytes(a){var b;for(b=0;b<a.length;++b)a[b]=rng_get_byte()}function SecureRandom(){}SecureRandom.prototype.nextBytes=rng_get_bytes;
function SHA256(a){function b(a,b){var c=(a&65535)+(b&65535);return(a>>16)+(b>>16)+(c>>16)<<16|c&65535}function c(a,b){return a>>>b|a<<32-b}a=function(a){for(var a=a.replace(/\r\n/g,"\n"),b="",c=0;c<a.length;c++){var h=a.charCodeAt(c);h<128?b+=String.fromCharCode(h):(h>127&&h<2048?b+=String.fromCharCode(h>>6|192):(b+=String.fromCharCode(h>>12|224),b+=String.fromCharCode(h>>6&63|128)),b+=String.fromCharCode(h&63|128))}return b}(a);return function(a){for(var b="",c=0;c<a.length*4;c++)b+="0123456789abcdef".charAt(a[c>>
2]>>(3-c%4)*8+4&15)+"0123456789abcdef".charAt(a[c>>2]>>(3-c%4)*8&15);return b}(function(a,e){var g=[1116352408,1899447441,3049323471,3921009573,961987163,1508970993,2453635748,2870763221,3624381080,310598401,607225278,1426881987,1925078388,2162078206,2614888103,3248222580,3835390401,4022224774,264347078,604807628,770255983,1249150122,1555081692,1996064986,2554220882,2821834349,2952996808,3210313671,3336571891,3584528711,113926993,338241895,666307205,773529912,1294757372,1396182291,1695183700,1986661051,
2177026350,2456956037,2730485921,2820302411,3259730800,3345764771,3516065817,3600352804,4094571909,275423344,430227734,506948616,659060556,883997877,958139571,1322822218,1537002063,1747873779,1955562222,2024104815,2227730452,2361852424,2428436474,2756734187,3204031479,3329325298],h=[1779033703,3144134277,1013904242,2773480762,1359893119,2600822924,528734635,1541459225],f=Array(64),o,p,q,n,k,j,l,m,s,r,u,w;a[e>>5]|=128<<24-e%32;a[(e+64>>9<<4)+15]=e;for(s=0;s<a.length;s+=16){o=h[0];p=h[1];q=h[2];n=h[3];
k=h[4];j=h[5];l=h[6];m=h[7];for(r=0;r<64;r++)f[r]=r<16?a[r+s]:b(b(b(c(f[r-2],17)^c(f[r-2],19)^f[r-2]>>>10,f[r-7]),c(f[r-15],7)^c(f[r-15],18)^f[r-15]>>>3),f[r-16]),u=b(b(b(b(m,c(k,6)^c(k,11)^c(k,25)),k&j^~k&l),g[r]),f[r]),w=b(c(o,2)^c(o,13)^c(o,22),o&p^o&q^p&q),m=l,l=j,j=k,k=b(n,u),n=q,q=p,p=o,o=b(u,w);h[0]=b(o,h[0]);h[1]=b(p,h[1]);h[2]=b(q,h[2]);h[3]=b(n,h[3]);h[4]=b(k,h[4]);h[5]=b(j,h[5]);h[6]=b(l,h[6]);h[7]=b(m,h[7])}return h}(function(a){for(var b=[],c=0;c<a.length*8;c+=8)b[c>>5]|=(a.charCodeAt(c/
8)&255)<<24-c%32;return b}(a),a.length*8))}var sha256={hex:function(a){return SHA256(a)}};
function SHA1(a){function b(a,b){return a<<b|a>>>32-b}function c(a){var b="",c,d;for(c=7;c>=0;c--)d=a>>>c*4&15,b+=d.toString(16);return b}var d,e,g=Array(80),h=1732584193,f=4023233417,o=2562383102,p=271733878,q=3285377520,n,k,j,l,m,a=function(a){for(var a=a.replace(/\r\n/g,"\n"),b="",c=0;c<a.length;c++){var d=a.charCodeAt(c);d<128?b+=String.fromCharCode(d):(d>127&&d<2048?b+=String.fromCharCode(d>>6|192):(b+=String.fromCharCode(d>>12|224),b+=String.fromCharCode(d>>6&63|128)),b+=String.fromCharCode(d&
63|128))}return b}(a);n=a.length;var s=[];for(d=0;d<n-3;d+=4)e=a.charCodeAt(d)<<24|a.charCodeAt(d+1)<<16|a.charCodeAt(d+2)<<8|a.charCodeAt(d+3),s.push(e);switch(n%4){case 0:d=2147483648;break;case 1:d=a.charCodeAt(n-1)<<24|8388608;break;case 2:d=a.charCodeAt(n-2)<<24|a.charCodeAt(n-1)<<16|32768;break;case 3:d=a.charCodeAt(n-3)<<24|a.charCodeAt(n-2)<<16|a.charCodeAt(n-1)<<8|128}for(s.push(d);s.length%16!=14;)s.push(0);s.push(n>>>29);s.push(n<<3&4294967295);for(a=0;a<s.length;a+=16){for(d=0;d<16;d++)g[d]=
s[a+d];for(d=16;d<=79;d++)g[d]=b(g[d-3]^g[d-8]^g[d-14]^g[d-16],1);e=h;n=f;k=o;j=p;l=q;for(d=0;d<=19;d++)m=b(e,5)+(n&k|~n&j)+l+g[d]+1518500249&4294967295,l=j,j=k,k=b(n,30),n=e,e=m;for(d=20;d<=39;d++)m=b(e,5)+(n^k^j)+l+g[d]+1859775393&4294967295,l=j,j=k,k=b(n,30),n=e,e=m;for(d=40;d<=59;d++)m=b(e,5)+(n&k|n&j|k&j)+l+g[d]+2400959708&4294967295,l=j,j=k,k=b(n,30),n=e,e=m;for(d=60;d<=79;d++)m=b(e,5)+(n^k^j)+l+g[d]+3395469782&4294967295,l=j,j=k,k=b(n,30),n=e,e=m;h=h+e&4294967295;f=f+n&4294967295;o=o+k&4294967295;
p=p+j&4294967295;q=q+l&4294967295}m=c(h)+c(f)+c(o)+c(p)+c(q);return m.toLowerCase()}
var sha1={hex:function(a){return SHA1(a)}},MD5=function(a){function b(a,b){var c,d,e,f,g;e=a&2147483648;f=b&2147483648;c=a&1073741824;d=b&1073741824;g=(a&1073741823)+(b&1073741823);return c&d?g^2147483648^e^f:c|d?g&1073741824?g^3221225472^e^f:g^1073741824^e^f:g^e^f}function c(a,c,d,e,f,g,h){a=b(a,b(b(c&d|~c&e,f),h));return b(a<<g|a>>>32-g,c)}function d(a,c,d,e,f,g,h){a=b(a,b(b(c&e|d&~e,f),h));return b(a<<g|a>>>32-g,c)}function e(a,c,d,e,f,g,h){a=b(a,b(b(c^d^e,f),h));return b(a<<g|a>>>32-g,c)}function g(a,
c,d,e,f,g,h){a=b(a,b(b(d^(c|~e),f),h));return b(a<<g|a>>>32-g,c)}function h(a){var b="",c="",d;for(d=0;d<=3;d++)c=a>>>d*8&255,c="0"+c.toString(16),b+=c.substr(c.length-2,2);return b}var f=[],o,p,q,n,k,j,l,m,a=function(a){for(var a=a.replace(/\r\n/g,"\n"),b="",c=0;c<a.length;c++){var d=a.charCodeAt(c);d<128?b+=String.fromCharCode(d):(d>127&&d<2048?b+=String.fromCharCode(d>>6|192):(b+=String.fromCharCode(d>>12|224),b+=String.fromCharCode(d>>6&63|128)),b+=String.fromCharCode(d&63|128))}return b}(a),
f=function(a){var b,c=a.length;b=c+8;for(var d=((b-b%64)/64+1)*16,e=Array(d-1),f=0,g=0;g<c;)b=(g-g%4)/4,f=g%4*8,e[b]|=a.charCodeAt(g)<<f,g++;e[(g-g%4)/4]|=128<<g%4*8;e[d-2]=c<<3;e[d-1]=c>>>29;return e}(a);k=1732584193;j=4023233417;l=2562383102;m=271733878;for(a=0;a<f.length;a+=16)o=k,p=j,q=l,n=m,k=c(k,j,l,m,f[a+0],7,3614090360),m=c(m,k,j,l,f[a+1],12,3905402710),l=c(l,m,k,j,f[a+2],17,606105819),j=c(j,l,m,k,f[a+3],22,3250441966),k=c(k,j,l,m,f[a+4],7,4118548399),m=c(m,k,j,l,f[a+5],12,1200080426),l=c(l,
m,k,j,f[a+6],17,2821735955),j=c(j,l,m,k,f[a+7],22,4249261313),k=c(k,j,l,m,f[a+8],7,1770035416),m=c(m,k,j,l,f[a+9],12,2336552879),l=c(l,m,k,j,f[a+10],17,4294925233),j=c(j,l,m,k,f[a+11],22,2304563134),k=c(k,j,l,m,f[a+12],7,1804603682),m=c(m,k,j,l,f[a+13],12,4254626195),l=c(l,m,k,j,f[a+14],17,2792965006),j=c(j,l,m,k,f[a+15],22,1236535329),k=d(k,j,l,m,f[a+1],5,4129170786),m=d(m,k,j,l,f[a+6],9,3225465664),l=d(l,m,k,j,f[a+11],14,643717713),j=d(j,l,m,k,f[a+0],20,3921069994),k=d(k,j,l,m,f[a+5],5,3593408605),
m=d(m,k,j,l,f[a+10],9,38016083),l=d(l,m,k,j,f[a+15],14,3634488961),j=d(j,l,m,k,f[a+4],20,3889429448),k=d(k,j,l,m,f[a+9],5,568446438),m=d(m,k,j,l,f[a+14],9,3275163606),l=d(l,m,k,j,f[a+3],14,4107603335),j=d(j,l,m,k,f[a+8],20,1163531501),k=d(k,j,l,m,f[a+13],5,2850285829),m=d(m,k,j,l,f[a+2],9,4243563512),l=d(l,m,k,j,f[a+7],14,1735328473),j=d(j,l,m,k,f[a+12],20,2368359562),k=e(k,j,l,m,f[a+5],4,4294588738),m=e(m,k,j,l,f[a+8],11,2272392833),l=e(l,m,k,j,f[a+11],16,1839030562),j=e(j,l,m,k,f[a+14],23,4259657740),
k=e(k,j,l,m,f[a+1],4,2763975236),m=e(m,k,j,l,f[a+4],11,1272893353),l=e(l,m,k,j,f[a+7],16,4139469664),j=e(j,l,m,k,f[a+10],23,3200236656),k=e(k,j,l,m,f[a+13],4,681279174),m=e(m,k,j,l,f[a+0],11,3936430074),l=e(l,m,k,j,f[a+3],16,3572445317),j=e(j,l,m,k,f[a+6],23,76029189),k=e(k,j,l,m,f[a+9],4,3654602809),m=e(m,k,j,l,f[a+12],11,3873151461),l=e(l,m,k,j,f[a+15],16,530742520),j=e(j,l,m,k,f[a+2],23,3299628645),k=g(k,j,l,m,f[a+0],6,4096336452),m=g(m,k,j,l,f[a+7],10,1126891415),l=g(l,m,k,j,f[a+14],15,2878612391),
j=g(j,l,m,k,f[a+5],21,4237533241),k=g(k,j,l,m,f[a+12],6,1700485571),m=g(m,k,j,l,f[a+3],10,2399980690),l=g(l,m,k,j,f[a+10],15,4293915773),j=g(j,l,m,k,f[a+1],21,2240044497),k=g(k,j,l,m,f[a+8],6,1873313359),m=g(m,k,j,l,f[a+15],10,4264355552),l=g(l,m,k,j,f[a+6],15,2734768916),j=g(j,l,m,k,f[a+13],21,1309151649),k=g(k,j,l,m,f[a+4],6,4149444226),m=g(m,k,j,l,f[a+11],10,3174756917),l=g(l,m,k,j,f[a+2],15,718787259),j=g(j,l,m,k,f[a+9],21,3951481745),k=b(k,o),j=b(j,p),l=b(l,q),m=b(m,n);return(h(k)+h(j)+h(l)+
h(m)).toLowerCase()};function parseBigInt(a,b){return new BigInteger(a,b)}function linebrk(a,b){for(var c="",d=0;d+b<a.length;)c+=a.substring(d,d+b)+"\n",d+=b;return c+a.substring(d,a.length)}function byte2Hex(a){return a<16?"0"+a.toString(16):a.toString(16)}
function pkcs1pad2(a,b){if(b<a.length+11)throw"Message too long for RSA (n="+b+", l="+a.length+")";for(var c=[],d=a.length-1;d>=0&&b>0;){var e=a.charCodeAt(d--);e<128?c[--b]=e:e>127&&e<2048?(c[--b]=e&63|128,c[--b]=e>>6|192):(c[--b]=e&63|128,c[--b]=e>>6&63|128,c[--b]=e>>12|224)}c[--b]=0;d=new SecureRandom;for(e=[];b>2;){for(e[0]=0;e[0]==0;)d.nextBytes(e);c[--b]=e[0]}c[--b]=2;c[--b]=0;return new BigInteger(c)}
function RSAKey(){this.n=null;this.e=0;this.coeff=this.dmq1=this.dmp1=this.q=this.p=this.d=null}function RSASetPublic(a,b){a!=null&&b!=null&&a.length>0&&b.length>0?(this.n=parseBigInt(a,16),this.e=parseInt(b,16)):alert("Invalid RSA public key")}function RSADoPublic(a){return a.modPowInt(this.e,this.n)}function RSAEncrypt(a){a=pkcs1pad2(a,this.n.bitLength()+7>>3);if(a==null)return null;a=this.doPublic(a);if(a==null)return null;a=a.toString(16);return(a.length&1)==0?a:"0"+a}
RSAKey.prototype.doPublic=RSADoPublic;RSAKey.prototype.setPublic=RSASetPublic;RSAKey.prototype.encrypt=RSAEncrypt;function pkcs1unpad2(a,b){for(var c=a.toByteArray(),d=0;d<c.length&&c[d]==0;)++d;if(c.length-d!=b-1||c[d]!=2)return null;for(++d;c[d]!=0;)if(++d>=c.length)return null;for(var e="";++d<c.length;){var g=c[d]&255;g<128?e+=String.fromCharCode(g):g>191&&g<224?(e+=String.fromCharCode((g&31)<<6|c[d+1]&63),++d):(e+=String.fromCharCode((g&15)<<12|(c[d+1]&63)<<6|c[d+2]&63),d+=2)}return e}
function RSASetPrivate(a,b,c){a!=null&&b!=null&&a.length>0&&b.length>0?(this.n=parseBigInt(a,16),this.e=parseInt(b,16),this.d=parseBigInt(c,16)):alert("Invalid RSA private key")}
function RSASetPrivateEx(a,b,c,d,e,g,h,f){a!=null&&b!=null&&a.length>0&&b.length>0?(this.n=parseBigInt(a,16),this.e=parseInt(b,16),this.d=parseBigInt(c,16),this.p=parseBigInt(d,16),this.q=parseBigInt(e,16),this.dmp1=parseBigInt(g,16),this.dmq1=parseBigInt(h,16),this.coeff=parseBigInt(f,16)):alert("Invalid RSA private key")}
function RSAGenerate(a,b){var c=new SeededRandom,d=a>>1;this.e=parseInt(b,16);for(var e=new BigInteger(b,16);;){for(;;)if(this.p=new BigInteger(a-d,1,c),this.p.subtract(BigInteger.ONE).gcd(e).compareTo(BigInteger.ONE)==0&&this.p.isProbablePrime(10))break;for(;;)if(this.q=new BigInteger(d,1,c),this.q.subtract(BigInteger.ONE).gcd(e).compareTo(BigInteger.ONE)==0&&this.q.isProbablePrime(10))break;if(this.p.compareTo(this.q)<=0){var g=this.p;this.p=this.q;this.q=g}var g=this.p.subtract(BigInteger.ONE),
h=this.q.subtract(BigInteger.ONE),f=g.multiply(h);if(f.gcd(e).compareTo(BigInteger.ONE)==0){this.n=this.p.multiply(this.q);this.d=e.modInverse(f);this.dmp1=this.d.mod(g);this.dmq1=this.d.mod(h);this.coeff=this.q.modInverse(this.p);break}}}
function RSADoPrivate(a){if(this.p==null||this.q==null)return a.modPow(this.d,this.n);for(var b=a.mod(this.p).modPow(this.dmp1,this.p),a=a.mod(this.q).modPow(this.dmq1,this.q);b.compareTo(a)<0;)b=b.add(this.p);return b.subtract(a).multiply(this.coeff).mod(this.p).multiply(this.q).add(a)}function RSADecrypt(a){a=this.doPrivate(parseBigInt(a,16));return a==null?null:pkcs1unpad2(a,this.n.bitLength()+7>>3)}RSAKey.prototype.doPrivate=RSADoPrivate;RSAKey.prototype.setPrivate=RSASetPrivate;
RSAKey.prototype.setPrivateEx=RSASetPrivateEx;RSAKey.prototype.generate=RSAGenerate;RSAKey.prototype.decrypt=RSADecrypt;var _RSASIGN_DIHEAD=[];_RSASIGN_DIHEAD.sha1="3021300906052b0e03021a05000414";_RSASIGN_DIHEAD.sha256="3031300d060960864801650304020105000420";var _RSASIGN_HASHHEXFUNC=[];_RSASIGN_HASHHEXFUNC.sha1=sha1.hex;_RSASIGN_HASHHEXFUNC.sha256=sha256.hex;
function _rsasign_getHexPaddedDigestInfoForString(a,b,c){b/=4;for(var a=(0,_RSASIGN_HASHHEXFUNC[c])(a),c="00"+_RSASIGN_DIHEAD[c]+a,a="",b=b-4-c.length,d=0;d<b;d+=2)a+="ff";return sPaddedMessageHex="0001"+a+c}function _rsasign_signString(a,b){var c=_rsasign_getHexPaddedDigestInfoForString(a,this.n.bitLength(),b);return this.doPrivate(parseBigInt(c,16)).toString(16)}
function _rsasign_signStringWithSHA1(a){a=_rsasign_getHexPaddedDigestInfoForString(a,this.n.bitLength(),"sha1");return this.doPrivate(parseBigInt(a,16)).toString(16)}function _rsasign_signStringWithSHA256(a){a=_rsasign_getHexPaddedDigestInfoForString(a,this.n.bitLength(),"sha256");return this.doPrivate(parseBigInt(a,16)).toString(16)}function _rsasign_getDecryptSignatureBI(a,b,c){var d=new RSAKey;d.setPublic(b,c);return d.doPublic(a)}
function _rsasign_getHexDigestInfoFromSig(a,b,c){return _rsasign_getDecryptSignatureBI(a,b,c).toString(16).replace(/^1f+00/,"")}function _rsasign_getAlgNameAndHashFromHexDisgestInfo(a){for(var b in _RSASIGN_DIHEAD){var c=_RSASIGN_DIHEAD[b],d=c.length;if(a.substring(0,d)==c)return[b,a.substring(d)]}return[]}
function _rsasign_verifySignatureWithArgs(a,b,c,d){b=_rsasign_getHexDigestInfoFromSig(b,c,d);c=_rsasign_getAlgNameAndHashFromHexDisgestInfo(b);if(c.length==0)return!1;b=c[1];a=(0,_RSASIGN_HASHHEXFUNC[c[0]])(a);return b==a}function _rsasign_verifyHexSignatureForMessage(a,b){var c=parseBigInt(a,16);return _rsasign_verifySignatureWithArgs(b,c,this.n.toString(16),this.e.toString(16))}
function _rsasign_verifyString(a,b){var b=b.replace(/[ \n]+/g,""),c=this.doPublic(parseBigInt(b,16)).toString(16).replace(/^1f+00/,""),d=_rsasign_getAlgNameAndHashFromHexDisgestInfo(c);if(d.length==0)return!1;c=d[1];d=(0,_RSASIGN_HASHHEXFUNC[d[0]])(a);return c==d}RSAKey.prototype.signString=_rsasign_signString;RSAKey.prototype.signStringWithSHA1=_rsasign_signStringWithSHA1;RSAKey.prototype.signStringWithSHA256=_rsasign_signStringWithSHA256;RSAKey.prototype.verifyString=_rsasign_verifyString;
RSAKey.prototype.verifyHexSignatureForMessage=_rsasign_verifyHexSignatureForMessage;
var aes=function(){var a={Sbox:[99,124,119,123,242,107,111,197,48,1,103,43,254,215,171,118,202,130,201,125,250,89,71,240,173,212,162,175,156,164,114,192,183,253,147,38,54,63,247,204,52,165,229,241,113,216,49,21,4,199,35,195,24,150,5,154,7,18,128,226,235,39,178,117,9,131,44,26,27,110,90,160,82,59,214,179,41,227,47,132,83,209,0,237,32,252,177,91,106,203,190,57,74,76,88,207,208,239,170,251,67,77,51,133,69,249,2,127,80,60,159,168,81,163,64,143,146,157,56,245,188,182,218,33,16,255,243,210,205,12,19,236,
95,151,68,23,196,167,126,61,100,93,25,115,96,129,79,220,34,42,144,136,70,238,184,20,222,94,11,219,224,50,58,10,73,6,36,92,194,211,172,98,145,149,228,121,231,200,55,109,141,213,78,169,108,86,244,234,101,122,174,8,186,120,37,46,28,166,180,198,232,221,116,31,75,189,139,138,112,62,181,102,72,3,246,14,97,53,87,185,134,193,29,158,225,248,152,17,105,217,142,148,155,30,135,233,206,85,40,223,140,161,137,13,191,230,66,104,65,153,45,15,176,84,187,22],ShiftRowTab:[0,5,10,15,4,9,14,3,8,13,2,7,12,1,6,11]};a.Init=
function(){a.Sbox_Inv=Array(256);for(var b=0;b<256;b++)a.Sbox_Inv[a.Sbox[b]]=b;a.ShiftRowTab_Inv=Array(16);for(b=0;b<16;b++)a.ShiftRowTab_Inv[a.ShiftRowTab[b]]=b;a.xtime=Array(256);for(b=0;b<128;b++)a.xtime[b]=b<<1,a.xtime[128+b]=b<<1^27};a.Done=function(){delete a.Sbox_Inv;delete a.ShiftRowTab_Inv;delete a.xtime};a.ExpandKey=function(b){var c=b.length,d,e=1;switch(c){case 16:d=176;break;case 24:d=208;break;case 32:d=240;break;default:alert("my.ExpandKey: Only key lengths of 16, 24 or 32 bytes allowed!")}for(var g=
c;g<d;g+=4){var h=b.slice(g-4,g);if(g%c==0){if(h=[a.Sbox[h[1]]^e,a.Sbox[h[2]],a.Sbox[h[3]],a.Sbox[h[0]]],(e<<=1)>=256)e^=283}else c>24&&g%c==16&&(h=[a.Sbox[h[0]],a.Sbox[h[1]],a.Sbox[h[2]],a.Sbox[h[3]]]);for(var f=0;f<4;f++)b[g+f]=b[g+f-c]^h[f]}};a.Encrypt=function(b,c){var d=c.length;a.AddRoundKey(b,c.slice(0,16));for(var e=16;e<d-16;e+=16)a.SubBytes(b,a.Sbox),a.ShiftRows(b,a.ShiftRowTab),a.MixColumns(b),a.AddRoundKey(b,c.slice(e,e+16));a.SubBytes(b,a.Sbox);a.ShiftRows(b,a.ShiftRowTab);a.AddRoundKey(b,
c.slice(e,d))};a.Decrypt=function(b,c){var d=c.length;a.AddRoundKey(b,c.slice(d-16,d));a.ShiftRows(b,a.ShiftRowTab_Inv);a.SubBytes(b,a.Sbox_Inv);for(d-=32;d>=16;d-=16)a.AddRoundKey(b,c.slice(d,d+16)),a.MixColumns_Inv(b),a.ShiftRows(b,a.ShiftRowTab_Inv),a.SubBytes(b,a.Sbox_Inv);a.AddRoundKey(b,c.slice(0,16))};a.SubBytes=function(a,c){for(var d=0;d<16;d++)a[d]=c[a[d]]};a.AddRoundKey=function(a,c){for(var d=0;d<16;d++)a[d]^=c[d]};a.ShiftRows=function(a,c){for(var d=[].concat(a),e=0;e<16;e++)a[e]=d[c[e]]};
a.MixColumns=function(b){for(var c=0;c<16;c+=4){var d=b[c+0],e=b[c+1],g=b[c+2],h=b[c+3],f=d^e^g^h;b[c+0]^=f^a.xtime[d^e];b[c+1]^=f^a.xtime[e^g];b[c+2]^=f^a.xtime[g^h];b[c+3]^=f^a.xtime[h^d]}};a.MixColumns_Inv=function(b){for(var c=0;c<16;c+=4){var d=b[c+0],e=b[c+1],g=b[c+2],h=b[c+3],f=d^e^g^h,o=a.xtime[f],p=a.xtime[a.xtime[o^d^g]]^f;f^=a.xtime[a.xtime[o^e^h]];b[c+0]^=p^a.xtime[d^e];b[c+1]^=f^a.xtime[e^g];b[c+2]^=p^a.xtime[g^h];b[c+3]^=f^a.xtime[h^d]}};return a}(),cryptico=function(){var a={};aes.Init();
a.b256to64=function(a){var c,d,e,g="",h=0,f=0,o=a.length;for(e=0;e<o;e++)d=a.charCodeAt(e),f==0?(g+="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/".charAt(d>>2&63),c=(d&3)<<4):f==1?(g+="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/".charAt(c|d>>4&15),c=(d&15)<<2):f==2&&(g+="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/".charAt(c|d>>6&3),h+=1,g+="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/".charAt(d&63)),h+=1,f+=1,f==3&&
(f=0);f>0&&(g+="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/".charAt(c),g+="=");f==1&&(g+="=");return g};a.b64to256=function(a){var c,d,e="",g=0,h=0,f=a.length;for(d=0;d<f;d++)c="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/".indexOf(a.charAt(d)),c>=0&&(g&&(e+=String.fromCharCode(h|c>>6-g&255)),g=g+2&7,h=c<<g&255);return e};a.b16to64=function(a){var c,d,e="";a.length%2==1&&(a="0"+a);for(c=0;c+3<=a.length;c+=3)d=parseInt(a.substring(c,c+3),16),e+="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/".charAt(d>>
6)+"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/".charAt(d&63);c+1==a.length?(d=parseInt(a.substring(c,c+1),16),e+="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/".charAt(d<<2)):c+2==a.length&&(d=parseInt(a.substring(c,c+2),16),e+="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/".charAt(d>>2)+"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/".charAt((d&3)<<4));for(;(e.length&3)>0;)e+="=";return e};a.b64to16=function(a){var c="",
d,e=0,g;for(d=0;d<a.length;++d){if(a.charAt(d)=="=")break;v="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/".indexOf(a.charAt(d));v<0||(e==0?(c+=int2char(v>>2),g=v&3,e=1):e==1?(c+=int2char(g<<2|v>>4),g=v&15,e=2):e==2?(c+=int2char(g),c+=int2char(v>>2),g=v&3,e=3):(c+=int2char(g<<2|v>>4),c+=int2char(v&15),e=0))}e==1&&(c+=int2char(g<<2));return c};a.string2bytes=function(a){for(var c=[],d=0;d<a.length;d++)c.push(a.charCodeAt(d));return c};a.bytes2string=function(a){for(var c="",d=0;d<
a.length;d++)c+=String.fromCharCode(a[d]);return c};a.blockXOR=function(a,c){for(var d=Array(16),e=0;e<16;e++)d[e]=a[e]^c[e];return d};a.blockIV=function(){var a=new SecureRandom,c=Array(16);a.nextBytes(c);return c};a.pad16=function(a){var c=a.slice(0),d=(16-a.length%16)%16;for(i=a.length;i<a.length+d;i++)c.push(0);return c};a.depad=function(a){for(a=a.slice(0);a[a.length-1]==0;)a=a.slice(0,a.length-1);return a};a.encryptAESCBC=function(b,c){var d=c.slice(0);aes.ExpandKey(d);for(var e=a.string2bytes(b),
e=a.pad16(e),g=a.blockIV(),h=0;h<e.length/16;h++){var f=e.slice(h*16,h*16+16),o=g.slice(h*16,h*16+16),f=a.blockXOR(o,f);aes.Encrypt(f,d);g=g.concat(f)}d=a.bytes2string(g);return a.b256to64(d)};a.decryptAESCBC=function(b,c){var d=c.slice(0);aes.ExpandKey(d);for(var b=a.b64to256(b),e=a.string2bytes(b),g=[],h=1;h<e.length/16;h++){var f=e.slice(h*16,h*16+16),o=e.slice((h-1)*16,(h-1)*16+16);aes.Decrypt(f,d);f=a.blockXOR(o,f);g=g.concat(f)}g=a.depad(g);return a.bytes2string(g)};a.wrap60=function(a){for(var c=
"",d=0;d<a.length;d++)d%60==0&&d!=0&&(c+="\n"),c+=a[d];return c};a.generateAESKey=function(){var a=Array(16);(new SecureRandom).nextBytes(a);return a};a.generateRSAKey=function(a,c){Math.seedrandom(sha256.hex(a));var d=new RSAKey;d.generate(c,"10001");return d};a.publicKeyString=function(b){return pubkey=b.n.toString(16)};a.publicKeyID=function(a){return MD5(a)};a.publicKeyFromString=function(b){var b=b.split("|")[0],c=new RSAKey;c.setPublic(b,"10001");return c};a.encrypt=function(b,
c,d){var e="";try{var h=a.publicKeyFromString(c);e+=h.encrypt(b)+"?"}catch(f){return{status:"Invalid public key"}};return{status:"success",cipher:e}};a.decrypt=function(b,c){var d=b.split("?"),e=c.decrypt(d[0]);return{status:"success",plaintext:e,signature:"unsigned"}};return a}();

View File

@ -0,0 +1,35 @@
/*
CryptoJS v3.1.2
code.google.com/p/crypto-js
(c) 2009-2013 by Jeff Mott. All rights reserved.
code.google.com/p/crypto-js/wiki/License
*/
var CryptoJS=CryptoJS||function(u,p){var d={},l=d.lib={},s=function(){},t=l.Base={extend:function(a){s.prototype=this;var c=new s;a&&c.mixIn(a);c.hasOwnProperty("init")||(c.init=function(){c.$super.init.apply(this,arguments)});c.init.prototype=c;c.$super=this;return c},create:function(){var a=this.extend();a.init.apply(a,arguments);return a},init:function(){},mixIn:function(a){for(var c in a)a.hasOwnProperty(c)&&(this[c]=a[c]);a.hasOwnProperty("toString")&&(this.toString=a.toString)},clone:function(){return this.init.prototype.extend(this)}},
r=l.WordArray=t.extend({init:function(a,c){a=this.words=a||[];this.sigBytes=c!=p?c:4*a.length},toString:function(a){return(a||v).stringify(this)},concat:function(a){var c=this.words,e=a.words,j=this.sigBytes;a=a.sigBytes;this.clamp();if(j%4)for(var k=0;k<a;k++)c[j+k>>>2]|=(e[k>>>2]>>>24-8*(k%4)&255)<<24-8*((j+k)%4);else if(65535<e.length)for(k=0;k<a;k+=4)c[j+k>>>2]=e[k>>>2];else c.push.apply(c,e);this.sigBytes+=a;return this},clamp:function(){var a=this.words,c=this.sigBytes;a[c>>>2]&=4294967295<<
32-8*(c%4);a.length=u.ceil(c/4)},clone:function(){var a=t.clone.call(this);a.words=this.words.slice(0);return a},random:function(a){for(var c=[],e=0;e<a;e+=4)c.push(4294967296*u.random()|0);return new r.init(c,a)}}),w=d.enc={},v=w.Hex={stringify:function(a){var c=a.words;a=a.sigBytes;for(var e=[],j=0;j<a;j++){var k=c[j>>>2]>>>24-8*(j%4)&255;e.push((k>>>4).toString(16));e.push((k&15).toString(16))}return e.join("")},parse:function(a){for(var c=a.length,e=[],j=0;j<c;j+=2)e[j>>>3]|=parseInt(a.substr(j,
2),16)<<24-4*(j%8);return new r.init(e,c/2)}},b=w.Latin1={stringify:function(a){var c=a.words;a=a.sigBytes;for(var e=[],j=0;j<a;j++)e.push(String.fromCharCode(c[j>>>2]>>>24-8*(j%4)&255));return e.join("")},parse:function(a){for(var c=a.length,e=[],j=0;j<c;j++)e[j>>>2]|=(a.charCodeAt(j)&255)<<24-8*(j%4);return new r.init(e,c)}},x=w.Utf8={stringify:function(a){try{return decodeURIComponent(escape(b.stringify(a)))}catch(c){throw Error("Malformed UTF-8 data");}},parse:function(a){return b.parse(unescape(encodeURIComponent(a)))}},
q=l.BufferedBlockAlgorithm=t.extend({reset:function(){this._data=new r.init;this._nDataBytes=0},_append:function(a){"string"==typeof a&&(a=x.parse(a));this._data.concat(a);this._nDataBytes+=a.sigBytes},_process:function(a){var c=this._data,e=c.words,j=c.sigBytes,k=this.blockSize,b=j/(4*k),b=a?u.ceil(b):u.max((b|0)-this._minBufferSize,0);a=b*k;j=u.min(4*a,j);if(a){for(var q=0;q<a;q+=k)this._doProcessBlock(e,q);q=e.splice(0,a);c.sigBytes-=j}return new r.init(q,j)},clone:function(){var a=t.clone.call(this);
a._data=this._data.clone();return a},_minBufferSize:0});l.Hasher=q.extend({cfg:t.extend(),init:function(a){this.cfg=this.cfg.extend(a);this.reset()},reset:function(){q.reset.call(this);this._doReset()},update:function(a){this._append(a);this._process();return this},finalize:function(a){a&&this._append(a);return this._doFinalize()},blockSize:16,_createHelper:function(a){return function(b,e){return(new a.init(e)).finalize(b)}},_createHmacHelper:function(a){return function(b,e){return(new n.HMAC.init(a,
e)).finalize(b)}}});var n=d.algo={};return d}(Math);
(function(){var u=CryptoJS,p=u.lib.WordArray;u.enc.Base64={stringify:function(d){var l=d.words,p=d.sigBytes,t=this._map;d.clamp();d=[];for(var r=0;r<p;r+=3)for(var w=(l[r>>>2]>>>24-8*(r%4)&255)<<16|(l[r+1>>>2]>>>24-8*((r+1)%4)&255)<<8|l[r+2>>>2]>>>24-8*((r+2)%4)&255,v=0;4>v&&r+0.75*v<p;v++)d.push(t.charAt(w>>>6*(3-v)&63));if(l=t.charAt(64))for(;d.length%4;)d.push(l);return d.join("")},parse:function(d){var l=d.length,s=this._map,t=s.charAt(64);t&&(t=d.indexOf(t),-1!=t&&(l=t));for(var t=[],r=0,w=0;w<
l;w++)if(w%4){var v=s.indexOf(d.charAt(w-1))<<2*(w%4),b=s.indexOf(d.charAt(w))>>>6-2*(w%4);t[r>>>2]|=(v|b)<<24-8*(r%4);r++}return p.create(t,r)},_map:"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/="}})();
(function(u){function p(b,n,a,c,e,j,k){b=b+(n&a|~n&c)+e+k;return(b<<j|b>>>32-j)+n}function d(b,n,a,c,e,j,k){b=b+(n&c|a&~c)+e+k;return(b<<j|b>>>32-j)+n}function l(b,n,a,c,e,j,k){b=b+(n^a^c)+e+k;return(b<<j|b>>>32-j)+n}function s(b,n,a,c,e,j,k){b=b+(a^(n|~c))+e+k;return(b<<j|b>>>32-j)+n}for(var t=CryptoJS,r=t.lib,w=r.WordArray,v=r.Hasher,r=t.algo,b=[],x=0;64>x;x++)b[x]=4294967296*u.abs(u.sin(x+1))|0;r=r.MD5=v.extend({_doReset:function(){this._hash=new w.init([1732584193,4023233417,2562383102,271733878])},
_doProcessBlock:function(q,n){for(var a=0;16>a;a++){var c=n+a,e=q[c];q[c]=(e<<8|e>>>24)&16711935|(e<<24|e>>>8)&4278255360}var a=this._hash.words,c=q[n+0],e=q[n+1],j=q[n+2],k=q[n+3],z=q[n+4],r=q[n+5],t=q[n+6],w=q[n+7],v=q[n+8],A=q[n+9],B=q[n+10],C=q[n+11],u=q[n+12],D=q[n+13],E=q[n+14],x=q[n+15],f=a[0],m=a[1],g=a[2],h=a[3],f=p(f,m,g,h,c,7,b[0]),h=p(h,f,m,g,e,12,b[1]),g=p(g,h,f,m,j,17,b[2]),m=p(m,g,h,f,k,22,b[3]),f=p(f,m,g,h,z,7,b[4]),h=p(h,f,m,g,r,12,b[5]),g=p(g,h,f,m,t,17,b[6]),m=p(m,g,h,f,w,22,b[7]),
f=p(f,m,g,h,v,7,b[8]),h=p(h,f,m,g,A,12,b[9]),g=p(g,h,f,m,B,17,b[10]),m=p(m,g,h,f,C,22,b[11]),f=p(f,m,g,h,u,7,b[12]),h=p(h,f,m,g,D,12,b[13]),g=p(g,h,f,m,E,17,b[14]),m=p(m,g,h,f,x,22,b[15]),f=d(f,m,g,h,e,5,b[16]),h=d(h,f,m,g,t,9,b[17]),g=d(g,h,f,m,C,14,b[18]),m=d(m,g,h,f,c,20,b[19]),f=d(f,m,g,h,r,5,b[20]),h=d(h,f,m,g,B,9,b[21]),g=d(g,h,f,m,x,14,b[22]),m=d(m,g,h,f,z,20,b[23]),f=d(f,m,g,h,A,5,b[24]),h=d(h,f,m,g,E,9,b[25]),g=d(g,h,f,m,k,14,b[26]),m=d(m,g,h,f,v,20,b[27]),f=d(f,m,g,h,D,5,b[28]),h=d(h,f,
m,g,j,9,b[29]),g=d(g,h,f,m,w,14,b[30]),m=d(m,g,h,f,u,20,b[31]),f=l(f,m,g,h,r,4,b[32]),h=l(h,f,m,g,v,11,b[33]),g=l(g,h,f,m,C,16,b[34]),m=l(m,g,h,f,E,23,b[35]),f=l(f,m,g,h,e,4,b[36]),h=l(h,f,m,g,z,11,b[37]),g=l(g,h,f,m,w,16,b[38]),m=l(m,g,h,f,B,23,b[39]),f=l(f,m,g,h,D,4,b[40]),h=l(h,f,m,g,c,11,b[41]),g=l(g,h,f,m,k,16,b[42]),m=l(m,g,h,f,t,23,b[43]),f=l(f,m,g,h,A,4,b[44]),h=l(h,f,m,g,u,11,b[45]),g=l(g,h,f,m,x,16,b[46]),m=l(m,g,h,f,j,23,b[47]),f=s(f,m,g,h,c,6,b[48]),h=s(h,f,m,g,w,10,b[49]),g=s(g,h,f,m,
E,15,b[50]),m=s(m,g,h,f,r,21,b[51]),f=s(f,m,g,h,u,6,b[52]),h=s(h,f,m,g,k,10,b[53]),g=s(g,h,f,m,B,15,b[54]),m=s(m,g,h,f,e,21,b[55]),f=s(f,m,g,h,v,6,b[56]),h=s(h,f,m,g,x,10,b[57]),g=s(g,h,f,m,t,15,b[58]),m=s(m,g,h,f,D,21,b[59]),f=s(f,m,g,h,z,6,b[60]),h=s(h,f,m,g,C,10,b[61]),g=s(g,h,f,m,j,15,b[62]),m=s(m,g,h,f,A,21,b[63]);a[0]=a[0]+f|0;a[1]=a[1]+m|0;a[2]=a[2]+g|0;a[3]=a[3]+h|0},_doFinalize:function(){var b=this._data,n=b.words,a=8*this._nDataBytes,c=8*b.sigBytes;n[c>>>5]|=128<<24-c%32;var e=u.floor(a/
4294967296);n[(c+64>>>9<<4)+15]=(e<<8|e>>>24)&16711935|(e<<24|e>>>8)&4278255360;n[(c+64>>>9<<4)+14]=(a<<8|a>>>24)&16711935|(a<<24|a>>>8)&4278255360;b.sigBytes=4*(n.length+1);this._process();b=this._hash;n=b.words;for(a=0;4>a;a++)c=n[a],n[a]=(c<<8|c>>>24)&16711935|(c<<24|c>>>8)&4278255360;return b},clone:function(){var b=v.clone.call(this);b._hash=this._hash.clone();return b}});t.MD5=v._createHelper(r);t.HmacMD5=v._createHmacHelper(r)})(Math);
(function(){var u=CryptoJS,p=u.lib,d=p.Base,l=p.WordArray,p=u.algo,s=p.EvpKDF=d.extend({cfg:d.extend({keySize:4,hasher:p.MD5,iterations:1}),init:function(d){this.cfg=this.cfg.extend(d)},compute:function(d,r){for(var p=this.cfg,s=p.hasher.create(),b=l.create(),u=b.words,q=p.keySize,p=p.iterations;u.length<q;){n&&s.update(n);var n=s.update(d).finalize(r);s.reset();for(var a=1;a<p;a++)n=s.finalize(n),s.reset();b.concat(n)}b.sigBytes=4*q;return b}});u.EvpKDF=function(d,l,p){return s.create(p).compute(d,
l)}})();
CryptoJS.lib.Cipher||function(u){var p=CryptoJS,d=p.lib,l=d.Base,s=d.WordArray,t=d.BufferedBlockAlgorithm,r=p.enc.Base64,w=p.algo.EvpKDF,v=d.Cipher=t.extend({cfg:l.extend(),createEncryptor:function(e,a){return this.create(this._ENC_XFORM_MODE,e,a)},createDecryptor:function(e,a){return this.create(this._DEC_XFORM_MODE,e,a)},init:function(e,a,b){this.cfg=this.cfg.extend(b);this._xformMode=e;this._key=a;this.reset()},reset:function(){t.reset.call(this);this._doReset()},process:function(e){this._append(e);return this._process()},
finalize:function(e){e&&this._append(e);return this._doFinalize()},keySize:4,ivSize:4,_ENC_XFORM_MODE:1,_DEC_XFORM_MODE:2,_createHelper:function(e){return{encrypt:function(b,k,d){return("string"==typeof k?c:a).encrypt(e,b,k,d)},decrypt:function(b,k,d){return("string"==typeof k?c:a).decrypt(e,b,k,d)}}}});d.StreamCipher=v.extend({_doFinalize:function(){return this._process(!0)},blockSize:1});var b=p.mode={},x=function(e,a,b){var c=this._iv;c?this._iv=u:c=this._prevBlock;for(var d=0;d<b;d++)e[a+d]^=
c[d]},q=(d.BlockCipherMode=l.extend({createEncryptor:function(e,a){return this.Encryptor.create(e,a)},createDecryptor:function(e,a){return this.Decryptor.create(e,a)},init:function(e,a){this._cipher=e;this._iv=a}})).extend();q.Encryptor=q.extend({processBlock:function(e,a){var b=this._cipher,c=b.blockSize;x.call(this,e,a,c);b.encryptBlock(e,a);this._prevBlock=e.slice(a,a+c)}});q.Decryptor=q.extend({processBlock:function(e,a){var b=this._cipher,c=b.blockSize,d=e.slice(a,a+c);b.decryptBlock(e,a);x.call(this,
e,a,c);this._prevBlock=d}});b=b.CBC=q;q=(p.pad={}).Pkcs7={pad:function(a,b){for(var c=4*b,c=c-a.sigBytes%c,d=c<<24|c<<16|c<<8|c,l=[],n=0;n<c;n+=4)l.push(d);c=s.create(l,c);a.concat(c)},unpad:function(a){a.sigBytes-=a.words[a.sigBytes-1>>>2]&255}};d.BlockCipher=v.extend({cfg:v.cfg.extend({mode:b,padding:q}),reset:function(){v.reset.call(this);var a=this.cfg,b=a.iv,a=a.mode;if(this._xformMode==this._ENC_XFORM_MODE)var c=a.createEncryptor;else c=a.createDecryptor,this._minBufferSize=1;this._mode=c.call(a,
this,b&&b.words)},_doProcessBlock:function(a,b){this._mode.processBlock(a,b)},_doFinalize:function(){var a=this.cfg.padding;if(this._xformMode==this._ENC_XFORM_MODE){a.pad(this._data,this.blockSize);var b=this._process(!0)}else b=this._process(!0),a.unpad(b);return b},blockSize:4});var n=d.CipherParams=l.extend({init:function(a){this.mixIn(a)},toString:function(a){return(a||this.formatter).stringify(this)}}),b=(p.format={}).OpenSSL={stringify:function(a){var b=a.ciphertext;a=a.salt;return(a?s.create([1398893684,
1701076831]).concat(a).concat(b):b).toString(r)},parse:function(a){a=r.parse(a);var b=a.words;if(1398893684==b[0]&&1701076831==b[1]){var c=s.create(b.slice(2,4));b.splice(0,4);a.sigBytes-=16}return n.create({ciphertext:a,salt:c})}},a=d.SerializableCipher=l.extend({cfg:l.extend({format:b}),encrypt:function(a,b,c,d){d=this.cfg.extend(d);var l=a.createEncryptor(c,d);b=l.finalize(b);l=l.cfg;return n.create({ciphertext:b,key:c,iv:l.iv,algorithm:a,mode:l.mode,padding:l.padding,blockSize:a.blockSize,formatter:d.format})},
decrypt:function(a,b,c,d){d=this.cfg.extend(d);b=this._parse(b,d.format);return a.createDecryptor(c,d).finalize(b.ciphertext)},_parse:function(a,b){return"string"==typeof a?b.parse(a,this):a}}),p=(p.kdf={}).OpenSSL={execute:function(a,b,c,d){d||(d=s.random(8));a=w.create({keySize:b+c}).compute(a,d);c=s.create(a.words.slice(b),4*c);a.sigBytes=4*b;return n.create({key:a,iv:c,salt:d})}},c=d.PasswordBasedCipher=a.extend({cfg:a.cfg.extend({kdf:p}),encrypt:function(b,c,d,l){l=this.cfg.extend(l);d=l.kdf.execute(d,
b.keySize,b.ivSize);l.iv=d.iv;b=a.encrypt.call(this,b,c,d.key,l);b.mixIn(d);return b},decrypt:function(b,c,d,l){l=this.cfg.extend(l);c=this._parse(c,l.format);d=l.kdf.execute(d,b.keySize,b.ivSize,c.salt);l.iv=d.iv;return a.decrypt.call(this,b,c,d.key,l)}})}();
(function(){for(var u=CryptoJS,p=u.lib.BlockCipher,d=u.algo,l=[],s=[],t=[],r=[],w=[],v=[],b=[],x=[],q=[],n=[],a=[],c=0;256>c;c++)a[c]=128>c?c<<1:c<<1^283;for(var e=0,j=0,c=0;256>c;c++){var k=j^j<<1^j<<2^j<<3^j<<4,k=k>>>8^k&255^99;l[e]=k;s[k]=e;var z=a[e],F=a[z],G=a[F],y=257*a[k]^16843008*k;t[e]=y<<24|y>>>8;r[e]=y<<16|y>>>16;w[e]=y<<8|y>>>24;v[e]=y;y=16843009*G^65537*F^257*z^16843008*e;b[k]=y<<24|y>>>8;x[k]=y<<16|y>>>16;q[k]=y<<8|y>>>24;n[k]=y;e?(e=z^a[a[a[G^z]]],j^=a[a[j]]):e=j=1}var H=[0,1,2,4,8,
16,32,64,128,27,54],d=d.AES=p.extend({_doReset:function(){for(var a=this._key,c=a.words,d=a.sigBytes/4,a=4*((this._nRounds=d+6)+1),e=this._keySchedule=[],j=0;j<a;j++)if(j<d)e[j]=c[j];else{var k=e[j-1];j%d?6<d&&4==j%d&&(k=l[k>>>24]<<24|l[k>>>16&255]<<16|l[k>>>8&255]<<8|l[k&255]):(k=k<<8|k>>>24,k=l[k>>>24]<<24|l[k>>>16&255]<<16|l[k>>>8&255]<<8|l[k&255],k^=H[j/d|0]<<24);e[j]=e[j-d]^k}c=this._invKeySchedule=[];for(d=0;d<a;d++)j=a-d,k=d%4?e[j]:e[j-4],c[d]=4>d||4>=j?k:b[l[k>>>24]]^x[l[k>>>16&255]]^q[l[k>>>
8&255]]^n[l[k&255]]},encryptBlock:function(a,b){this._doCryptBlock(a,b,this._keySchedule,t,r,w,v,l)},decryptBlock:function(a,c){var d=a[c+1];a[c+1]=a[c+3];a[c+3]=d;this._doCryptBlock(a,c,this._invKeySchedule,b,x,q,n,s);d=a[c+1];a[c+1]=a[c+3];a[c+3]=d},_doCryptBlock:function(a,b,c,d,e,j,l,f){for(var m=this._nRounds,g=a[b]^c[0],h=a[b+1]^c[1],k=a[b+2]^c[2],n=a[b+3]^c[3],p=4,r=1;r<m;r++)var q=d[g>>>24]^e[h>>>16&255]^j[k>>>8&255]^l[n&255]^c[p++],s=d[h>>>24]^e[k>>>16&255]^j[n>>>8&255]^l[g&255]^c[p++],t=
d[k>>>24]^e[n>>>16&255]^j[g>>>8&255]^l[h&255]^c[p++],n=d[n>>>24]^e[g>>>16&255]^j[h>>>8&255]^l[k&255]^c[p++],g=q,h=s,k=t;q=(f[g>>>24]<<24|f[h>>>16&255]<<16|f[k>>>8&255]<<8|f[n&255])^c[p++];s=(f[h>>>24]<<24|f[k>>>16&255]<<16|f[n>>>8&255]<<8|f[g&255])^c[p++];t=(f[k>>>24]<<24|f[n>>>16&255]<<16|f[g>>>8&255]<<8|f[h&255])^c[p++];n=(f[n>>>24]<<24|f[g>>>16&255]<<16|f[h>>>8&255]<<8|f[k&255])^c[p++];a[b]=q;a[b+1]=s;a[b+2]=t;a[b+3]=n},keySize:8});u.AES=p._createHelper(d)})();

View File

@ -0,0 +1,111 @@
define(function(require, exports, module) {
var _oCommon, _oUtils, _oBase64;
require("websdk");
_oCommon = require("common");
_oUtils = require("utils");
_oBase64 = require("base64");
function EncryptionFac () {}
EncryptionFac.prototype.encrypt = function (oStr, iRSABits, bBase64Encrypted, cbFun) {
//var that = this;
var iBits = 1024;
if (iRSABits) {
iBits = iRSABits;
}
var szPassPhrase = new Date() + "",
szMattsRSAkey = cryptico.generateRSAKey(szPassPhrase, iBits),
szPublicKeyString = cryptico.publicKeyString(szMattsRSAkey),
szXml = "<?xml version='1.0' encoding='UTF-8'?><PublicKey><key>" + _oBase64.encode(szPublicKeyString) + "</key></PublicKey>",
oXmlDoc = _oUtils.parseXmlFromStr(szXml);
WebSDK.WSDK_Request(_oCommon.m_szHostName, _oCommon.m_iHttpProtocal, _oCommon.m_iHttpPort, {
cmd: "challenge",
type: "POST",
data: oXmlDoc,
success: function (status, xmlDoc) {
var szDecryptionResult = cryptico.decrypt(_oBase64.decode(_oUtils.nodeValue(xmlDoc, "key")), szMattsRSAkey);
if(szDecryptionResult.plaintext != null) {
var szKey,szEncryptPassword;
var aResult = [];
if (iBits === 256) {
szKey = _oUtils.toHex(szDecryptionResult.plaintext);
} else {
szKey = szDecryptionResult.plaintext;
}
szEncryptPassword = aes_encrypt(szDecryptionResult.plaintext.substring(0, 16), szKey, true);
if("function" === typeof cbFun) {
if("string" === typeof oStr) {
bBase64Encrypted && ( oStr = _oBase64.encode(oStr) );
cbFun( _oBase64.encode( szEncryptPassword + _oUtils.encodeAES(oStr, szKey, "", "ecb") ) );
} else if("[object Array]" === Object.prototype.toString.call(oStr)) {
for(var i = 0, iArrayLen = oStr.length; i < iArrayLen; i++) {
bBase64Encrypted && ( oStr[i] = _oBase64.encode(oStr[i]) );
var szTemp = szEncryptPassword + _oUtils.encodeAES(oStr[i], szKey, "", "ecb");
aResult.push( _oBase64.encode(szTemp) );
}
cbFun(aResult);
}
}
}
}
});
};
EncryptionFac.prototype.encryptSync = function (oStr, iRSABits, bBase64Encrypted) {
//var that = this;
var iBits = 1024;
var aResult = [];
if (iRSABits) {
iBits = iRSABits;
}
var szPassPhrase = new Date() + "",
szMattsRSAkey = cryptico.generateRSAKey(szPassPhrase, iBits),
szPublicKeyString = cryptico.publicKeyString(szMattsRSAkey),
szXml = "<?xml version='1.0' encoding='UTF-8'?><PublicKey><key>" + _oBase64.encode(szPublicKeyString) + "</key></PublicKey>",
oXmlDoc = _oUtils.parseXmlFromStr(szXml);
WebSDK.WSDK_Request(_oCommon.m_szHostName, _oCommon.m_iHttpProtocal, _oCommon.m_iHttpPort, {
cmd: "challenge",
type: "POST",
async: false,
data: oXmlDoc,
success: function (status, xmlDoc) {
var szDecryptionResult = cryptico.decrypt(_oBase64.decode(_oUtils.nodeValue(xmlDoc, "key")), szMattsRSAkey);
if(szDecryptionResult.plaintext != null) {
var szKey, szEncryptPassword;
if (iBits === 256) {
szKey = _oUtils.toHex(szDecryptionResult.plaintext);
} else {
szKey = szDecryptionResult.plaintext;
}
szEncryptPassword = aes_encrypt(szDecryptionResult.plaintext.substring(0, 16), szKey, true);
if("string" === typeof oStr) {
bBase64Encrypted && ( oStr = _oBase64.encode(oStr) );
aResult.push( _oBase64.encode( szEncryptPassword + _oUtils.encodeAES(oStr, szKey, "", "ecb") ) );
} else {
for(var i = 0, iArrayLen = oStr.length; i < iArrayLen; i++) {
bBase64Encrypted && ( oStr[i] = _oBase64.encode(oStr[i]) );
var szTemp = szEncryptPassword + _oUtils.encodeAES(oStr[i], szKey, "", "ecb");
aResult.push( _oBase64.encode(szTemp) );
}
}
}
}
});
if("string" === typeof oStr) {
return aResult[0];
} else {
return aResult;
}
};
module.exports = new EncryptionFac();
});

4
public/hikvision/jquery-1.7.1.min.js vendored Normal file

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

View File

@ -0,0 +1 @@
"use strict";var Module={};var initializedJS=false;function threadPrintErr(){var text=Array.prototype.slice.call(arguments).join(" ");console.error(text)}function threadAlert(){var text=Array.prototype.slice.call(arguments).join(" ");postMessage({cmd:"alert",text:text,threadId:Module["_pthread_self"]()})}var err=threadPrintErr;self.alert=threadAlert;Module["instantiateWasm"]=(info,receiveInstance)=>{var module=Module["wasmModule"];Module["wasmModule"]=null;var instance=new WebAssembly.Instance(module,info);return receiveInstance(instance)};self.onunhandledrejection=e=>{throw e.reason??e};function handleMessage(e){try{if(e.data.cmd==="load"){let messageQueue=[];self.onmessage=e=>messageQueue.push(e);self.startWorker=instance=>{Module=instance;postMessage({"cmd":"loaded"});for(let msg of messageQueue){handleMessage(msg)}self.onmessage=handleMessage};Module["wasmModule"]=e.data.wasmModule;for(const handler of e.data.handlers){Module[handler]=(...args)=>{postMessage({cmd:"callHandler",handler:handler,args:args})}}Module["wasmMemory"]=e.data.wasmMemory;Module["buffer"]=Module["wasmMemory"].buffer;Module["ENVIRONMENT_IS_PTHREAD"]=true;if(typeof e.data.urlOrBlob=="string"){importScripts(e.data.urlOrBlob)}else{var objectUrl=URL.createObjectURL(e.data.urlOrBlob);importScripts(objectUrl);URL.revokeObjectURL(objectUrl)}JSPlayerModule(Module)}else if(e.data.cmd==="run"){Module["__emscripten_thread_init"](e.data.pthread_ptr,0,0,1);Module["__emscripten_thread_mailbox_await"](e.data.pthread_ptr);Module["establishStackSpace"]();Module["PThread"].receiveObjectTransfer(e.data);Module["PThread"].threadInitTLS();if(!initializedJS){Module["__embind_initialize_bindings"]();initializedJS=true}try{Module["invokeEntryPoint"](e.data.start_routine,e.data.arg)}catch(ex){if(ex!="unwind"){throw ex}}}else if(e.data.cmd==="cancel"){if(Module["_pthread_self"]()){Module["__emscripten_thread_exit"](-1)}}else if(e.data.target==="setimmediate"){}else if(e.data.cmd==="checkMailbox"){if(initializedJS){Module["checkMailbox"]()}}else if(e.data.cmd){err("worker.js received unknown command "+e.data.cmd);err(e.data)}}catch(ex){if(Module["__emscripten_thread_crashed"]){Module["__emscripten_thread_crashed"]()}throw ex}}self.onmessage=handleMessage;

File diff suppressed because one or more lines are too long

View File

@ -0,0 +1 @@
"use strict";var Module={};var initializedJS=false;function threadPrintErr(){var text=Array.prototype.slice.call(arguments).join(" ");console.error(text)}function threadAlert(){var text=Array.prototype.slice.call(arguments).join(" ");postMessage({cmd:"alert",text:text,threadId:Module["_pthread_self"]()})}var err=threadPrintErr;self.alert=threadAlert;Module["instantiateWasm"]=(info,receiveInstance)=>{var module=Module["wasmModule"];Module["wasmModule"]=null;var instance=new WebAssembly.Instance(module,info);return receiveInstance(instance)};self.onunhandledrejection=e=>{throw e.reason??e};function handleMessage(e){try{if(e.data.cmd==="load"){let messageQueue=[];self.onmessage=e=>messageQueue.push(e);self.startWorker=instance=>{Module=instance;postMessage({"cmd":"loaded"});for(let msg of messageQueue){handleMessage(msg)}self.onmessage=handleMessage};Module["wasmModule"]=e.data.wasmModule;for(const handler of e.data.handlers){Module[handler]=(...args)=>{postMessage({cmd:"callHandler",handler:handler,args:args})}}Module["wasmMemory"]=e.data.wasmMemory;Module["buffer"]=Module["wasmMemory"].buffer;Module["ENVIRONMENT_IS_PTHREAD"]=true;if(typeof e.data.urlOrBlob=="string"){importScripts(e.data.urlOrBlob)}else{var objectUrl=URL.createObjectURL(e.data.urlOrBlob);importScripts(objectUrl);URL.revokeObjectURL(objectUrl)}JSPlayerModule(Module)}else if(e.data.cmd==="run"){Module["__emscripten_thread_init"](e.data.pthread_ptr,0,0,1);Module["__emscripten_thread_mailbox_await"](e.data.pthread_ptr);Module["establishStackSpace"]();Module["PThread"].receiveObjectTransfer(e.data);Module["PThread"].threadInitTLS();if(!initializedJS){Module["__embind_initialize_bindings"]();initializedJS=true}try{Module["invokeEntryPoint"](e.data.start_routine,e.data.arg)}catch(ex){if(ex!="unwind"){throw ex}}}else if(e.data.cmd==="cancel"){if(Module["_pthread_self"]()){Module["__emscripten_thread_exit"](-1)}}else if(e.data.target==="setimmediate"){}else if(e.data.cmd==="checkMailbox"){if(initializedJS){Module["checkMailbox"]()}}else if(e.data.cmd){err("worker.js received unknown command "+e.data.cmd);err(e.data)}}catch(ex){if(Module["__emscripten_thread_crashed"]){Module["__emscripten_thread_crashed"]()}throw ex}}self.onmessage=handleMessage;

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because it is too large Load Diff

View File

@ -0,0 +1,240 @@
importScripts('libSystemTransform.js');
const RECORDRTP = 0; //录制一份未经过转封装的码流原始数据,用于定位问题
let dataType = 1;
// 字母字符串转byte数组
function stringToBytes (str) {
var ch;
var st;
var re = [];
for (var i = 0; i < str.length; i++) {
ch = str.charCodeAt(i); // get char
st = []; // set up "stack"
do {
st.push(ch & 0xFF); // push byte to stack
ch = ch >> 8; // shift value down by 1 byte
}
while (ch);
// add stack contents to result
// done because chars have "wrong" endianness
re = re.concat(st.reverse());
}
// return an array of bytes
return re;
}
// 转封装库回调函数
self.STCallBack = function (fileIndex, indexLen, data, dataLen) {
//stFrameInfo的类型见DETAIL_FRAME_INFO
let stFrameInfo = Module._GetDetialFrameInfo();
let nIsMp4Index = stFrameInfo.nIsMp4Index;
//console.log("FrameType is " , stFrameInfo);
//console.log("nIsMp4Index is " + nIsMp4Index);
//debugger
var pData = null;
pData = new Uint8Array(dataLen);
pData.set(Module.HEAPU8.subarray(data, data + dataLen));
if (dataType === 1) {
postMessage({ type: "outputData",
buf: pData.buffer,
dType: 1,
frameInfo: stFrameInfo }, [pData.buffer]);
dataType = 2;
} else {
if (nIsMp4Index) {
postMessage({ type: "outputData",
buf: pData.buffer,
dType: 6,
frameInfo: stFrameInfo }, [pData.buffer]); //6:索引类型
} else {
postMessage({ type: "outputData",
buf: pData.buffer,
dType: 2,
frameInfo: stFrameInfo }, [pData.buffer]); //2:码流
}
}
//stFrameInfo的类型见DETAIL_FRAME_INFO
//let stFrameInfo = Module._GetDetialFrameInfo();
//let stFrameType = stFrameInfo.nFrameType;
//let nFrameNum = stFrameInfo.nFrameNum;
//let nTimeStamp = stFrameInfo.nTimeStamp;
//let nIsMp4Index = stFrameInfo.nIsMp4Index;
//console.log("FrameType is " + stFrameType);
//console.log("nIsMp4Index is " + nIsMp4Index);
};
// self.Module = { memoryInitializerRequest: loadMemInitFile(), TOTAL_MEMORY: 128*1024*1024 };
// importScripts('SystemTransform.js');
self.Module['onRuntimeInitialized'] = function () {
postMessage({type: "loaded"});
};
onmessage = function (e) {
var data = e.data;
if ("create" === data.type) {
if (RECORDRTP) {
postMessage({ type: "created" });
postMessage({ type: "outputData",
buf: data.buf,
dType: 1 }, [data.buf]);
} else {
var iHeadLen = data.len;
var pHead = Module._malloc(iHeadLen);
if (pHead === null) {
console.log("inputdata malloc failed!!!");
return -1;
}
var iTransType = data.packType;//目标格式
var iRet = 0;
var buf = new Uint8Array(data.buf);
//PS流(只有ps支持探测),并且编码格式异常(正常是265和264,11位和10位 不可能全是0,全0 并且是ps就探测策略)的情况下,使用探测策略
if (buf[9] === 0 && buf[8] === 2 && buf[11] === 0 && buf[10] === 0) {
iRet = Module._CreatHandle(0, iTransType, iHeadLen); //用探测的策略
} else {
self.writeArrayToMemory(buf, pHead);
iRet = Module._CreatHandle(pHead, iTransType, iHeadLen);
//-2147483645代表的是参数错误,此种情况,大概率发生在头信息错误,例如大华设备的情况,此时用 无头探测的策略
//其他情况 按海康标准处理流程,不要做任何特殊处理
if (iRet == -2147483645) {
iRet = Module._CreatHandle(0, iTransType, iHeadLen); //失败了,用探测的策略再试一次
}
}
if (iRet != 0) {
if (iRet == -2147483647) {
postMessage({ type: "outputData",
dType: 1501 }); //标记为格式不支持
} else {
postMessage({ type: "outputData",
dType: 1501 }); //转封装创建失败,也同样提示码流格式不支持,如果后续要细化再区分
}
console.log("_CreatHandle failed!" + iRet);
} else {
if (data.options && typeof data.options.pKeyData !== "undefined" && data.options.pKeyData !== null) {
if ((2 === iTransType && "" === data.options.pKeyData)) {
//转ps的时候,如果密码是空是允许的,即使码流加密了,导出加密后的码流就行
//此时不要设置密码否则反而会提示密码错误
} else {
var secretInfo = data.options;
var keyLen = secretInfo.nKeyLen;
var pKeyData = Module._malloc(keyLen);
if (pKeyData === null) {
console.log("setEncryptKey malloc failed!!!");
return -1;
}
var nKeySize = secretInfo.pKeyData.length;
var bufData = stringToBytes(secretInfo.pKeyData);
let inputData = new Uint8Array(bufData);
Module.writeArrayToMemory(inputData, pKeyData);
inputData = null;
iRet = Module._SysTransSetEncryptKey(secretInfo.nKeyType, pKeyData, keyLen, nKeySize);
if (iRet != 0) {
console.log("_SysTransSetEncryptKey failed!");
}
if (pKeyData != null) {
Module._free(pKeyData);
pKeyData = null;
}
}
}
//带samplingParam参数,代表需要 用到 音频替换功能
if (data.options && typeof data.options.samplingParam !== "undefined") {
var oParam = data.options.samplingParam;
var nCapacityType = 1; //写死1 代表 剔除音频
var nType = 3; //写死3 代表 修改输出目标的海康头配置,内部包含视频参数、音频参数
var nAudioEnable = 1; //音频参数修改使能开关,0=不启用,1=启用
var nAudioFormat = oParam.iAudioType; //音频编码类型 对应关系参考海康媒体头规范,PCM 0x7001 G711_U 0x7110 G711_A 0x7111 AAC 0x2001
var nAudioChannels = oParam.iChannel; //音频通道数直接设置为
var nAudioBitsPerSample = oParam.iAudioBitWidth; //音频位样率
var nAudioSamplesrate = oParam.iAudioSamplingRate; //音频采样率
var nAudioBitrate = oParam.iAudioBitRate; //音频比特率
iRet = Module._SysTransConfig(nCapacityType, nType, nAudioEnable, nAudioFormat,
nAudioChannels, nAudioBitsPerSample, nAudioSamplesrate, nAudioBitrate);
if (iRet != 0) {
console.log("_SysTransConfig Failed:" + iRet);
}
} else {
iRet = Module._SysTransConfig(128, 0, 0, 0, 0, 0, 0, 0); //nCapacityType = 0x00000080 代表开启私有信息回调 解决转mp4后,私有信息丢失问题
if (iRet != 0) {
console.log("_SysTransConfig Failed:" + iRet);
}
}
iRet = Module._SysTransRegisterDataCallBack();
if (iRet != 0) {
console.log("_SysTransRegisterDataCallBack Failed:" + iRet);
}
iRet = Module._SysTransStart(null, null);
if (iRet != 0) {
console.log("_SysTransStart Failed:" + iRet);
}
postMessage({type: "created"});
}
if (pHead != null) {
Module._free(pHead);
pHead = null;
}
}
} else if ("inputData" === data.type) {
if (RECORDRTP) {
var aFileData = new Uint8Array(data.buf); // 拷贝一份
var iBufferLen = aFileData.length;
var szBufferLen = iBufferLen.toString(16);
if (szBufferLen.length === 1) {
szBufferLen = "000" + szBufferLen;
} else if (szBufferLen.length === 2) {
szBufferLen = "00" + szBufferLen;
} else if (szBufferLen.length === 3) {
szBufferLen = "0" + szBufferLen;
}
var aData = [0, 0, parseInt(szBufferLen.substring(0, 2), 16), parseInt(szBufferLen.substring(2, 4), 16)];
for (var iIndex = 0, iDataLength = aFileData.length; iIndex < iDataLength; iIndex++) {
aData[iIndex + 4] = aFileData[iIndex];
}
var dataUint8 = new Uint8Array(aData);
postMessage({type: "outputData",
buf: dataUint8.buffer,
dType: 2});
} else {
let inputMode = 0; //代表输入原始数据
if (data.samplingParam) {
iRet = Module._SysTransInputAudioPara(5, data.samplingParam.iChannel, data.samplingParam.iAudioBitWidth,
data.samplingParam.iAudioSamplingRate, data.samplingParam.iTimeStamp, data.samplingParam.iAudioBitRate); //参数含义和_SysTransConfig类似
if (iRet != 0) {
console.log("_SysTransInputAudioPara Failed:" + iRet);
}
inputMode = 2; //输入替换的音频
}
var pInputDataBuf = Module._malloc(data.len);
var idataLen = data.len;
self.writeArrayToMemory(new Uint8Array(data.buf), pInputDataBuf);
// 输入数据,每次最多2m
let pp = Module._SysTransInputData(inputMode, pInputDataBuf, idataLen);
if (pp == -2147483627) {
//-2147483627 对应十六进制的80000015
postMessage({ type: "outputData",
dType: 1500 }); //标记为密码错误
} else if (pp == -2147483647) {
postMessage({ type: "outputData",
dType: 1501 }); //标记为格式不支持
} else if (pp != 0) {
console.log("InputData Failed:" + pp);
}
Module._free(pInputDataBuf);
}
} else if ("release" === data.type) {
var iRet = Module._SysTransStop();
if (iRet != 0) {
console.log("_SysTransStop failed!");
}
Module._SysTransRelease();
if (iRet != 0) {
console.log("_SysTransRelease failed!");
}
close();
}
};

View File

@ -0,0 +1,180 @@
<!doctype html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta http-equiv="Pragma" content="no-cache" />
<meta http-equiv="Cache-Control" content="no-cache, must-revalidate" />
<meta http-equiv="Expires" content="0" />
<style>
html, body {
margin: 0;
padding: 0;
width: 100%;
height: 100%;
overflow: hidden;
background: #000;
}
#divPlugin {
width: 100%;
height: 100%;
}
</style>
</head>
<body>
<div id="divPlugin"></div>
</body>
<script src="./jquery-1.7.1.min.js"></script>
<script src="./webVideoCtrl.js"></script>
<script src="./encryption/AES.js"></script>
<script src="./encryption/cryptico.min.js"></script>
<script src="./encryption/crypto-3.1.2.min.js"></script>
<script>
(function () {
var g_iWndIndex = 0;
var g_szDeviceIdentify = '';
var g_bInited = false;
// 初始化插件
function initPlugin() {
if (g_bInited) return;
WebVideoCtrl.I_InitPlugin('100%', '100%', {
bWndFull: true,
iWndowType: 1,
bNoPlugin: true,
cbSelWnd: function (xmlDoc) {
g_iWndIndex = parseInt($(xmlDoc).find('SelectWnd').eq(0).text(), 10);
},
cbInitPluginComplete: function () {
WebVideoCtrl.I_InsertOBJECTPlugin('divPlugin');
g_bInited = true;
postMessage({ type: 'ready' });
},
cbEvent: function (iEventType, iParam1, iParam2) {
if (2 === iEventType) {
postMessage({ type: 'playbackEnd', wndIndex: iParam1 });
} else if (-1 === iEventType) {
postMessage({ type: 'networkError', device: iParam1 });
}
},
cbPluginErrorHandler: function (iWndIndex, iErrorCode, oError) {
var errMap = {
1001:'码流传输异常',1002:'回放结束',1003:'取流失败',
1004:'对讲断开',1005:'广播断开',1006:'编码格式不支持',
1007:'WebSocket断开',1008:'首帧超时',1015:'获取播放URL失败',
1017:'密码错误'
};
postMessage({ type: 'error', wndIndex: iWndIndex, code: iErrorCode, msg: errMap[iErrorCode] || ('错误码:'+iErrorCode) });
}
});
}
// 登录设备
function doLogin(data) {
var szIP = data.ip;
var szPort = String(data.port || 80);
var szUsername = data.user || 'admin';
var szPassword = data.pass || '';
var iProtocol = location.protocol === 'https:' ? 2 : 1;
g_szDeviceIdentify = szIP + '_' + szPort;
WebVideoCtrl.I_Login(szIP, iProtocol, szPort, szUsername, szPassword, {
success: function () {
postMessage({ type: 'loginSuccess', device: g_szDeviceIdentify });
},
error: function (status, xmlDoc) {
postMessage({ type: 'loginError', status: status, device: g_szDeviceIdentify });
}
});
}
// 开始预览
function doStartRealPlay(data) {
if (!g_szDeviceIdentify) {
postMessage({ type: 'error', msg: '请先登录设备' });
return;
}
var iChannelID = parseInt(data.channel, 10) || 1;
var iStreamType = parseInt(data.streamType, 10) || 0;
WebVideoCtrl.I_StartRealPlay(g_szDeviceIdentify, {
iStreamType: iStreamType,
iChannelID: iChannelID,
bZeroChannel: false,
success: function () {
postMessage({ type: 'playSuccess', device: g_szDeviceIdentify, channel: iChannelID });
},
error: function (status, xmlDoc) {
postMessage({ type: 'playError', status: status });
}
});
}
// 停止预览
function doStop() {
WebVideoCtrl.I_Stop({
success: function () {
postMessage({ type: 'stopSuccess' });
},
error: function () {
postMessage({ type: 'stopError' });
}
});
}
// 退出登录
function doLogout() {
if (!g_szDeviceIdentify) return;
WebVideoCtrl.I_Logout(g_szDeviceIdentify);
g_szDeviceIdentify = '';
postMessage({ type: 'logoutSuccess' });
}
// 向父窗口发送消息
function postMessage(data) {
if (window.parent && window.parent !== window) {
window.parent.postMessage(JSON.stringify(data), '*');
}
}
// 监听父窗口消息
window.addEventListener('message', function (e) {
var data;
try {
data = typeof e.data === 'string' ? JSON.parse(e.data) : e.data;
} catch (err) {
return;
}
switch (data.type) {
case 'init':
initPlugin();
break;
case 'login':
doLogin(data);
break;
case 'startRealPlay':
doStartRealPlay(data);
break;
case 'stop':
doStop();
break;
case 'logout':
doLogout();
break;
}
});
// 页面加载后自动初始化
$(function () {
initPlugin();
});
// 页面卸载时清理
$(window).on('beforeunload', function () {
doStop();
doLogout();
});
})();
</script>
</html>

File diff suppressed because one or more lines are too long

182
scripts/deploy.mjs Normal file
View File

@ -0,0 +1,182 @@
#!/usr/bin/env node
/**
* 跨平台发布脚本(Windows / macOS / Linux 通用)
*
* 等价于原 deploy.sh,改用 Node.js 实现,使 Windows 开发环境无需安装 sh/bash。
* 依赖本机已安装:ssh、scp、tar(Windows 10 1803+ 自带 OpenSSH 客户端与 bsdtar)。
*
* 用法:npm run deploy
* npm run deploy -- --pack-only (只打包+校验,不上传,用于排查)
* npm run deploy -- --pack-only --skip-build
*/
import { spawnSync } from 'node:child_process';
import { existsSync, readFileSync, rmSync } from 'node:fs';
import os from 'node:os';
import path from 'node:path';
import { fileURLToPath } from 'node:url';
const __dirname = path.dirname(fileURLToPath(import.meta.url));
// --- 配置(读取独立配置文件,该文件不纳入版本控制) ---
const CONFIG_PATH = path.join(__dirname, 'deploy.config.json');
if (!existsSync(CONFIG_PATH)) {
console.error('❌ 缺少配置文件 deploy.config.json');
console.error(' 请复制 scripts/deploy.config.example.json 为 scripts/deploy.config.json 并修改其中参数。');
process.exit(1);
}
const config = JSON.parse(readFileSync(CONFIG_PATH, 'utf8'));
const USER = config.user;
const IP = config.ip; // 服务器 IP
const BASE_PATH = config.basePath; // 项目在服务器上的存放路径
const KEEP_RELEASES = config.keepReleases; // 服务器上保留的最近版本数
const SITE_HOST = config.siteHost; // 发版后健康检查域名
const LOCAL_DIST = path.resolve('dist');
const SSH_KEY = path.isAbsolute(config.sshKey) ? config.sshKey : path.join(os.homedir(), '.ssh', config.sshKey);
const SSH_OPTS = ['-i', SSH_KEY, '-o', 'StrictHostKeyChecking=no'];
const HOST = `${USER}@${IP}`;
// 远端解压用的固定文件名(remote/deploy.sh 里写死了 dist.tar.gz)
const TARBALL_NAME = 'dist.tar.gz';
// ⚠️ 本地压缩包必须放在项目目录之外(这里用系统临时目录)。
// Windows 自带 bsdtar(tar.exe)有一条"不要把自己加进自己"的保护,按 (dev, ino) 判断文件身份;
// 而 Windows 下该身份信息不可靠:当压缩包与被打包目录同处一个目录/卷时,
// 某个普通文件会被误判为"归档自身"而被**静默丢弃**(实测丢 dist/index.html),
// 且 tar 退出码仍为 0,导致坏产物被上传、远端校验才报错。
// 详见 docs/部署-本地打包丢文件问题与修复.md
const TARBALL = path.join(os.tmpdir(), `new3-dist-${process.pid}-${Date.now()}.tar.gz`);
const NPM = process.platform === 'win32' ? 'npm.cmd' : 'npm';
// --pack-only:只做构建+打包+校验,不上传(排查用);配合 --skip-build 复用已有 dist
const PACK_ONLY = process.argv.includes('--pack-only');
const SKIP_BUILD = process.argv.includes('--skip-build');
const RELEASE_NAME = `v${timestamp()}_${process.pid}`; // 版本号(带 PID,避免并发/重复发布冲突)
const REMOTE_RELEASE = `${BASE_PATH}/releases/${RELEASE_NAME}`;
function timestamp() {
const d = new Date();
const p = (n) => String(n).padStart(2, '0');
return `${d.getFullYear()}${p(d.getMonth() + 1)}${p(d.getDate())}_${p(d.getHours())}${p(d.getMinutes())}${p(d.getSeconds())}`;
}
function run(cmd, args, opts = {}) {
// Windows 下 .cmd/.bat(如 npm.cmd)不能直接用 spawnSync 执行(报 EINVAL):
// 优先用 node 直接运行 npm-cli.js(无 shell、无 DEP0190 警告),否则回退到 shell: true
const isWinCmd = process.platform === 'win32' && /\.(cmd|bat)$/i.test(cmd)
let res
if (isWinCmd) {
const npmCli = process.env.npm_execpath
if (npmCli && /npm-cli\.js$/i.test(npmCli)) {
res = spawnSync(process.execPath, [npmCli, ...args], { stdio: 'inherit', ...opts })
} else {
res = spawnSync(cmd, args, { stdio: 'inherit', shell: true, ...opts })
}
} else {
res = spawnSync(cmd, args, { stdio: 'inherit', ...opts })
}
if (res.error) {
console.error(`❌ 无法执行命令 ${cmd}: ${res.error.message}`);
if (res.error.code === 'ENOENT') {
console.error(
' 请确认本机已安装对应命令(ssh/scp/tar)。Windows 10 1803+ 自带 OpenSSH 客户端与 tar。'
);
}
process.exit(1);
}
if (res.status !== 0) process.exit(res.status ?? 1);
}
/**
* 列出压缩包内的条目(去掉 tar 输出的 './' 前缀),失败直接中止。
*/
function tarList(archive) {
const res = spawnSync('tar', ['-tzf', archive], { encoding: 'utf8', maxBuffer: 64 * 1024 * 1024 });
if (res.error || res.status !== 0) {
console.error(`❌ 读取压缩包内容失败: ${res.error ? res.error.message : (res.stderr || '').trim()}`);
process.exit(1);
}
return res.stdout
.split(/\r?\n/)
.filter(Boolean)
.map((name) => name.replace(/^\.\//, ''));
}
/**
* 压缩 dist 并校验压缩包内容。
*
* 不能只看 tar 的退出码:Windows bsdtar 丢文件时仍返回 0(见 TARBALL 处的说明),
* 因此这里按**与远端 deploy.sh 相同的规则**回读压缩包校验,缺文件则重新打包,
* 仍缺则本地中止,绝不把坏产物传上去。
*/
function packDist() {
const html = readFileSync(path.join(LOCAL_DIST, 'index.html'), 'utf8');
const refs = [...html.matchAll(/\/assets\/[A-Za-z0-9._-]+\.(?:js|css)/g)].map((m) => m[0].slice(1));
for (let attempt = 1; attempt <= 2; attempt++) {
rmSync(TARBALL, { force: true });
run('tar', ['-czf', TARBALL, '-C', LOCAL_DIST, '.']);
const entries = new Set(tarList(TARBALL));
const missing = [];
if (!entries.has('index.html')) missing.push('index.html');
for (const ref of refs) if (!entries.has(ref)) missing.push(ref);
if (missing.length === 0) {
console.log(`📦 压缩包校验通过(${entries.size} 个条目,index.html + ${refs.length} 个入口资源齐全)`);
return;
}
console.error(`⚠️ 压缩包缺少文件: ${[...new Set(missing)].join(', ')}(疑似 bsdtar 误判“归档自身”导致丢文件)`);
if (attempt === 2) {
console.error('❌ 重新打包后仍然缺文件,中止发布');
process.exit(1);
}
console.log('🔁 重新打包…');
}
}
console.log(`🚀 开始发布版本: ${RELEASE_NAME}`);
try {
// 1. 本地打包(失败立即中止,防止把坏产物发到线上)
if (!SKIP_BUILD) run(NPM, ['run', 'build']);
// 2. 校验本地产物完整性
const localIndex = path.join(LOCAL_DIST, 'index.html');
if (!existsSync(localIndex) || readFileSync(localIndex, 'utf8').trim() === '' || !existsSync(path.join(LOCAL_DIST, 'assets'))) {
console.error('❌ 本地构建产物不完整(缺少 index.html / assets 或 index.html 为空),中止发布');
process.exit(1);
}
// 3. 压缩 + 校验压缩包(防 bsdtar 静默丢文件)
packDist();
if (PACK_ONLY) {
rmSync(TARBALL, { force: true });
console.log('✅ --pack-only:已完成构建与打包校验,未上传');
process.exit(0);
}
// 4. 上传到独立的新版本目录(全程不触碰当前运行目录)
run('ssh', [...SSH_OPTS, HOST, `mkdir -p '${REMOTE_RELEASE}'`]);
run('scp', [...SSH_OPTS, TARBALL, `${HOST}:${REMOTE_RELEASE}/${TARBALL_NAME}`]);
// 5. 远程:解压 → 校验 → 补齐旧资源 → 原子切换 → 健康检查 → 清理
const remoteScript = readFileSync(path.join(__dirname, 'remote', 'deploy.sh'), 'utf8');
run(
'ssh',
[
...SSH_OPTS,
HOST,
`RELEASE='${REMOTE_RELEASE}' BASE='${BASE_PATH}' KEEP=${KEEP_RELEASES} HOST='${SITE_HOST}' bash -s`,
],
{ input: remoteScript, stdio: ['pipe', 'inherit', 'inherit'] }
);
console.log(`✨ 发布成功!当前版本: ${RELEASE_NAME}`);
} finally {
// 无论成功失败都清理本地临时压缩包
rmSync(TARBALL, { force: true });
}

View File

@ -0,0 +1,318 @@
#!/usr/bin/env node
/**
* 死代码扫描:从入口出发对 src 做模块依赖图可达性分析。
*
* 判定口径
* - 静态可达:从入口(src/main.ts)经 import / export-from / import() / require() 能到达
* - glob 兜底:被 import.meta.glob(...) 模式匹配到(构建期收集,运行时按后端菜单动态取用)
* - 死代码 :以上两类都不属于
*
* 用法:node scripts/find-unused-modules.mjs [项目根目录] [--views-only]
*/
import fs from 'node:fs'
import path from 'node:path'
const args = process.argv.slice(2)
const viewsOnly = args.includes('--views-only')
const rootArg = args.find((a) => !a.startsWith('--'))
const ROOT = rootArg ? path.resolve(rootArg) : process.cwd()
const SRC = path.join(ROOT, 'src')
const ENTRIES = [path.join(SRC, 'main.ts')]
const WALK_EXT = new Set(['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs', '.vue', '.scss', '.css'])
const RESOLVE_EXT = ['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs', '.vue', '.json', '.scss', '.css', '.svg']
const INDEX_EXT = ['.ts', '.js', '.vue']
const SKIP_DIRS = new Set(['node_modules', '.git', 'dist', 'dist-ssr', '.vite'])
/* ---------- 文件遍历 ---------- */
function walk(dir, out = []) {
let entries
try {
entries = fs.readdirSync(dir, { withFileTypes: true })
} catch {
return out
}
for (const e of entries) {
const full = path.join(dir, e.name)
if (e.isDirectory()) {
if (SKIP_DIRS.has(e.name)) continue
walk(full, out)
} else {
const ext = path.extname(e.name)
if (WALK_EXT.has(ext) || e.name.endsWith('.d.ts')) out.push(full)
}
}
return out
}
/* ---------- 注释剥离(保留字符串字面量,避免 https:// 被误删) ---------- */
function stripComments(code) {
let out = ''
let i = 0
const n = code.length
while (i < n) {
const c = code[i]
const next = code[i + 1]
if (c === '/' && next === '/') {
while (i < n && code[i] !== '\n') i++
continue
}
if (c === '/' && next === '*') {
i += 2
while (i < n && !(code[i] === '*' && code[i + 1] === '/')) i++
i += 2
continue
}
if (c === '"' || c === "'" || c === '`') {
const q = c
out += c
i++
while (i < n) {
if (code[i] === '\\') {
out += code[i] + code[i + 1]
i += 2
continue
}
out += code[i]
if (code[i] === q) {
i++
break
}
i++
}
continue
}
out += c
i++
}
return out
}
const SPEC_RES = [
/import\s*\(\s*['"]([^'"]+)['"]\s*\)/g, // 动态 import
/\bfrom\s*['"]([^'"]+)['"]/g, // import ... from / export ... from
/\bimport\s+['"]([^'"]+)['"]/g, // 副作用 import
/\brequire\s*\(\s*['"]([^'"]+)['"]\s*\)/g,
/new\s+URL\s*\(\s*['"]([^'"]+)['"]/g,
/@use\s+['"]([^'"]+)['"]/g, // SCSS
/@forward\s+['"]([^'"]+)['"]/g,
]
const GLOB_RE = /import\.meta\.glob(?:Eager)?\s*\(\s*['"]([^'"]+)['"]/g
function scanFile(file) {
const raw = fs.readFileSync(file, 'utf8')
const code = stripComments(raw)
const specs = new Set()
for (const re of SPEC_RES) {
re.lastIndex = 0
let m
while ((m = re.exec(code))) specs.add(m[1])
}
const globs = []
GLOB_RE.lastIndex = 0
let g
while ((g = GLOB_RE.exec(code))) globs.push(g[1])
return { specs: [...specs], globs }
}
/* ---------- 说明符解析 ---------- */
function resolveSpec(spec, fromFile) {
if (!spec || typeof spec !== 'string') return null
let base = null
const s = spec.split('?')[0].split('#')[0]
if (s.startsWith('@/')) base = path.join(SRC, s.slice(2))
else if (s.startsWith('~@/')) base = path.join(SRC, s.slice(3))
else if (s.startsWith('./') || s.startsWith('../')) base = path.resolve(path.dirname(fromFile), s)
else return null
const candidates = [base]
for (const ext of RESOLVE_EXT) candidates.push(base + ext)
// 注意:目录名可能自带点号(api/order.packing、api/waybill.warehouse),
// 不能用 path.extname 判断,必须比对已知扩展名白名单
const hasKnownExt = RESOLVE_EXT.includes(path.extname(base).toLowerCase())
if (!hasKnownExt) for (const ext of INDEX_EXT) candidates.push(path.join(base, 'index' + ext))
for (const c of candidates) {
try {
if (fs.statSync(c).isFile()) return path.normalize(c)
} catch {
/* ignore */
}
}
return null
}
/* ---------- glob 模式 → 正则 ---------- */
function globToRegExp(pattern) {
let p = pattern
// 统一成相对项目根的路径(@/ 与 / 都指向 src)
if (p.startsWith('@/')) p = 'src/' + p.slice(2)
else if (p.startsWith('~@/')) p = 'src/' + p.slice(3)
p = p.replace(/^\//, '')
let re = ''
for (let i = 0; i < p.length; i++) {
const c = p[i]
if (c === '*' && p[i + 1] === '*') {
re += '[\\s\\S]*'
i++
if (p[i + 1] === '/') i++
continue
}
if (c === '*') {
re += '[^/]*'
continue
}
re += c.replace(/[.+^${}()|[\]\\]/g, '\\$&')
}
return new RegExp('^' + re + '$')
}
/* ---------- 主流程 ---------- */
const allFiles = walk(SRC)
const rel = (f) => path.relative(ROOT, f).replace(/\\/g, '/')
const reachable = new Set()
const globOnly = new Set()
const queue = []
const unresolvedSpecs = []
for (const f of ENTRIES) {
if (!fs.existsSync(f)) {
console.error(`入口不存在: ${f}`)
process.exit(1)
}
reachable.add(path.normalize(f))
queue.push(path.normalize(f))
}
const globMatchers = []
const fileCache = new Map()
while (queue.length) {
const file = queue.pop()
let scanned = fileCache.get(file)
if (!scanned) {
scanned = scanFile(file)
fileCache.set(file, scanned)
}
for (const spec of scanned.specs) {
const resolved = resolveSpec(spec, file)
if (!resolved) {
// 只抱怨“本应能解析”的路径(@/ 与相对路径)
if (spec.startsWith('@/') || spec.startsWith('~/') || spec.startsWith('~@/')) {
unresolvedSpecs.push(`${rel(file)} -> ${spec}`)
}
continue
}
if (!reachable.has(resolved)) {
reachable.add(resolved)
if (WALK_EXT.has(path.extname(resolved).toLowerCase())) queue.push(resolved)
}
}
for (const pattern of scanned.globs) {
globMatchers.push({ from: file, pattern, re: globToRegExp(pattern) })
}
}
for (const f of allFiles) {
if (reachable.has(path.normalize(f))) continue
if (f.endsWith('.d.ts')) continue
const r = rel(f)
if (globMatchers.some((g) => g.re.test(r))) globOnly.add(path.normalize(f))
}
/* ---------- 输出 ---------- */
const sizeOf = (f) => {
try {
return fs.statSync(f).size
} catch {
return 0
}
}
const kb = (n) => (n / 1024).toFixed(1) + ' KB'
const norm = (f) => path.normalize(f)
const dead = allFiles.filter((f) => !reachable.has(norm(f)) && !globOnly.has(norm(f)) && !f.endsWith('.d.ts'))
const deadViews = dead.filter((f) => rel(f).startsWith('src/views/') && f.endsWith('.vue'))
const deadOther = dead.filter((f) => !(rel(f).startsWith('src/views/') && f.endsWith('.vue')))
function groupByDir(files, depth = 3) {
const map = new Map()
for (const f of files) {
const r = rel(f)
const seg = r.split('/').slice(0, depth).join('/')
if (!map.has(seg)) map.set(seg, [])
map.get(seg).push(f)
}
return [...map.entries()].sort((a, b) => b[1].length - a[1].length)
}
console.log('='.repeat(72))
console.log(`扫描根目录:${ROOT}`)
console.log(`src 下模块总数:${allFiles.length} 静态可达:${reachable.size} 仅 glob 兜底:${globOnly.size} 死代码:${dead.length}`)
console.log('='.repeat(72))
if (deadViews.length) {
console.log(`\n## 未被引用的页面 (.vue):${deadViews.length} 个,合计 ${kb(deadViews.reduce((s, f) => s + sizeOf(f), 0))}\n`)
for (const [dir, files] of groupByDir(deadViews)) {
console.log(`● ${dir} (${files.length} 个, ${kb(files.reduce((s, f) => s + sizeOf(f), 0))})`)
for (const f of files.sort()) console.log(` ${rel(f).replace('src/views/', '')} ${kb(sizeOf(f))}`)
}
}
if (globOnly.size) {
const gv = [...globOnly].filter((f) => f.endsWith('.vue'))
console.log(`\n## 仅被 import.meta.glob 兜底匹配的页面:${gv.length} 个(无法静态判定,需核对后端菜单 component 字段)\n`)
for (const [dir, files] of groupByDir(gv)) console.log(` ${dir} (${files.length} 个)`)
}
if (!viewsOnly) {
console.log(`\n## 未被引用的非页面文件:${deadOther.length} 个,合计 ${kb(deadOther.reduce((s, f) => s + sizeOf(f), 0))}\n`)
for (const [dir, files] of groupByDir(deadOther)) {
console.log(`● ${dir} (${files.length} 个, ${kb(files.reduce((s, f) => s + sizeOf(f), 0))})`)
for (const f of files.sort()) console.log(` ${rel(f).replace('src/', '')} ${kb(sizeOf(f))}`)
}
}
if (unresolvedSpecs.length) {
const uniq = [...new Set(unresolvedSpecs)]
console.log(`\n## 无法解析的 @/ 引用:${uniq.length} 条(疑似路径写错或文件已删)\n`)
for (const u of uniq.slice(0, 100)) console.log(' ' + u)
}
/* 机器可读输出 */
const aggregate = (files) => {
const m = {}
for (const f of files) {
const seg = rel(f).split('/').slice(0, 4).join('/')
if (!m[seg]) m[seg] = { count: 0, bytes: 0 }
m[seg].count += 1
m[seg].bytes += sizeOf(f)
}
return m
}
console.log('\n## 目录级汇总(按死代码文件数降序,便于分批删除)\n')
for (const [dir, v] of Object.entries(aggregate([...dead, ...globOnly])).sort((a, b) => b[1].count - a[1].count)) {
console.log(` ${dir} ${v.count} 个 / ${kb(v.bytes)}`)
}
const outFile = path.join(ROOT, 'unused-report.json')
fs.writeFileSync(
outFile,
JSON.stringify(
{
scannedAt: new Date().toISOString(),
totals: { all: allFiles.length, reachable: reachable.size, globOnly: globOnly.size, dead: dead.length },
deadViews: deadViews.map(rel),
deadOthers: deadOther.map(rel),
globOnlyViews: [...globOnly].filter((f) => f.endsWith('.vue')).map(rel),
globOnlyOthers: [...globOnly].filter((f) => !f.endsWith('.vue')).map(rel),
aggregate: aggregate([...dead, ...globOnly]),
unresolvedSpecs: [...new Set(unresolvedSpecs)],
},
null,
2
),
'utf8'
)
console.log(`\n完整结果已写入 ${rel(outFile)}`)

51
scripts/remote/deploy.sh Normal file
View File

@ -0,0 +1,51 @@
set -euo pipefail
cd "$RELEASE"
# 4.1 解压
tar -xzf dist.tar.gz
rm -f dist.tar.gz
# 4.2 完整性校验:新版本必须完整,残缺则取消切换(当前线上版本不受影响)
if [ ! -s index.html ]; then
echo "❌ 新版本 index.html 缺失或为空,取消切换"
exit 1
fi
missing=""
for ref in $(grep -oE '/assets/[A-Za-z0-9._-]+\.(js|css)' index.html | sort -u || true); do
[ -f ".$ref" ] || missing="$missing $ref"
done
if [ -n "$missing" ]; then
echo "❌ 新版本缺少以下资源,取消切换:$missing"
exit 1
fi
# 4.3 补齐旧版本静态资源(无感切换的关键)
# 把最近几个历史版本中、本版本缺失的文件(旧 chunk、hikvision、logo 等)合并进新版本,
# 保证切换后正在使用旧版本页面的用户,动态 import 旧资源依然能找到,不会 404。
for src in $(ls -td "$BASE"/releases/*/ 2>/dev/null | head -n "$((KEEP + 1))" || true); do
[ -d "$src" ] || continue
[ "$(readlink -f "$src" 2>/dev/null)" = "$(pwd)" ] && continue
cp -rn "$src/." "$RELEASE/" 2>/dev/null || true
done
# 4.4 原子切换软链接(先建临时链接再改名,切换瞬间服务不中断)
ln -sfn "$RELEASE" "$BASE/current_new"
mv -Tf "$BASE/current_new" "$BASE/current"
# 4.5 健康检查(仅提示,不阻断发布)
if command -v curl >/dev/null 2>&1; then
code="$(curl -skL -o /dev/null -w '%{http_code}' -H "Host: $HOST" "https://127.0.0.1/" 2>/dev/null || true)"
echo "ℹ️ 新版本首页 HTTP 状态码: ${code:-未知}"
fi
# 4.6 清理旧版本:只保留最近 KEEP 个,且绝不删除 current 指向的版本
CURRENT_TARGET="$(readlink -f "$BASE/current" 2>/dev/null || true)"
count=0
for d in $(ls -t "$BASE/releases" 2>/dev/null || true); do
count=$((count+1))
[ "$count" -le "$KEEP" ] && continue
target="$(readlink -f "$BASE/releases/$d" 2>/dev/null || echo "$BASE/releases/$d")"
[ "$target" = "$CURRENT_TARGET" ] && continue
rm -rf "$BASE/releases/$d"
done

View File

@ -0,0 +1,15 @@
set -euo pipefail
# 获取 releases 目录下按时间排序的倒数第二个版本(当前版本的上一版)
PREVIOUS_VERSION="$(ls -dt "$BASE"/releases/*/ 2>/dev/null | sed -n '2p' || true)"
if [ -z "$PREVIOUS_VERSION" ]; then
echo "❌ 找不到可回滚的历史版本"
exit 1
fi
# 原子切换软链接(与发版脚本一致,切换瞬间服务不中断)
ln -sfn "$PREVIOUS_VERSION" "$BASE/current_new"
mv -Tf "$BASE/current_new" "$BASE/current"
echo "✅ 已回滚至: $PREVIOUS_VERSION"

50
scripts/rollback.mjs Normal file
View File

@ -0,0 +1,50 @@
#!/usr/bin/env node
/**
* 跨平台回滚脚本(Windows / macOS / Linux 通用)
*
* 等价于原 rollback.sh,改用 Node.js 实现,使 Windows 开发环境无需安装 sh/bash。
* 依赖本机已安装:ssh(Windows 10 1803+ 自带 OpenSSH 客户端)。
*
* 用法:npm run rollback
*/
import { spawnSync } from 'node:child_process';
import { existsSync, readFileSync } from 'node:fs';
import os from 'node:os';
import path from 'node:path';
import { fileURLToPath } from 'node:url';
const __dirname = path.dirname(fileURLToPath(import.meta.url));
// --- 配置(读取独立配置文件,该文件不纳入版本控制) ---
const CONFIG_PATH = path.join(__dirname, 'deploy.config.json');
if (!existsSync(CONFIG_PATH)) {
console.error('❌ 缺少配置文件 deploy.config.json');
console.error(' 请复制 scripts/deploy.config.example.json 为 scripts/deploy.config.json 并修改其中参数。');
process.exit(1);
}
const config = JSON.parse(readFileSync(CONFIG_PATH, 'utf8'));
const USER = config.user;
const IP = config.ip; // 服务器 IP
const BASE_PATH = config.basePath; // 项目在服务器上的存放路径
const SSH_KEY = path.isAbsolute(config.sshKey) ? config.sshKey : path.join(os.homedir(), '.ssh', config.sshKey);
const SSH_OPTS = ['-i', SSH_KEY, '-o', 'StrictHostKeyChecking=no'];
const HOST = `${USER}@${IP}`;
console.log('⏪ 正在回滚到上一个版本...');
const remoteScript = readFileSync(path.join(__dirname, 'remote', 'rollback.sh'), 'utf8');
const res = spawnSync(
'ssh',
[...SSH_OPTS, HOST, `BASE='${BASE_PATH}' bash -s`],
{ input: remoteScript, stdio: ['pipe', 'inherit', 'inherit'] }
);
if (res.error) {
console.error(`❌ 无法执行 ssh: ${res.error.message}`);
if (res.error.code === 'ENOENT') {
console.error(' 请确认本机已安装 OpenSSH 客户端(Windows 10 1803+ 自带)。');
}
process.exit(1);
}
process.exit(res.status ?? 1);

View File

@ -3,6 +3,7 @@ import { computed } from 'vue'
import { useI18n } from 'vue-i18n'
import elementEnLocale from 'element-plus/es/locale/lang/en'
import elementZhLocale from 'element-plus/es/locale/lang/zh-cn'
import WaybillTraceWindow from '@/components/waybill/WaybillTraceWindow.vue'
const { locale } = useI18n()
@ -19,6 +20,8 @@ const currentLocale = computed(() => {
<div id="app">
<router-view />
</div>
<!-- 运单轨迹悬浮窗:全局单例,所有运单号共用 -->
<WaybillTraceWindow />
</el-config-provider>
</template>

826
src/api/aftersale/index.ts Normal file
View File

@ -0,0 +1,826 @@
import request from '@/utils/request'
const v = '1.0'
// ============================================================
// 售后模块 V2 API
// ============================================================
// ==================== 类型定义 ====================
/** 售后类型 */
export type AfterSaleType = 'order' | 'receiving' | 'entry' | 'stockout'
/** 售后状态 */
export type AfterSaleStatus = 'pending' | 'pending_feedback' | 'processing' | 'completed' | 'closed' | 'cancelled'
/** 角色组 */
export type AfterSaleRoleGroup = 'customer_service' | 'warehouse' | 'finance'
/** 理赔状态 */
export type ClaimStatus = 'pending' | 'reviewing' | 'approved' | 'paid' | 'monthly' | 'rejected'
/** 步骤状态: 0=待开始 1=进行中 2=已完成 3=已跳过 */
export type StepStatus = 0 | 1 | 2 | 3
/** 售后单对象 */
export interface AfterSale {
id: number
warehouse_id: number
store_id: number | null
after_sale_no: string
type: AfterSaleType
sub_type: string
status: AfterSaleStatus
priority: number
title: string
description: string | null
creator_id: number
inbox_message_id: number | null
role_group: AfterSaleRoleGroup | null
resolution: string | null
resolved_at: string | null
followup_at: string | null
// 仓库理赔
claim_needed: 0 | 1
claim_amount: number | null
claim_status: ClaimStatus | null
// 运方理赔
carrier_claim_needed: 0 | 1
carrier_claim_amount: number | null
carrier_claim_status: ClaimStatus | null
// 关联单据
waybill_id: number | null
waybill_no: string | null
order_delivery_id: number | null
order_delivery_no: string | null
entry_order_id: number | null
entry_order_no: string | null
order_stockout_id: number | null
order_stockout_no: string | null
receiving_id: number | null
receiving_no: string | null
// 关联详情(detail 接口返回)
related?: AfterSaleRelated
created_at: string
updated_at: string
deleted_at: string | null
started_at: string | null
completed_at: string | null
}
// ==================== 关联数据类型 ====================
/** 关联订单 - 收货人 */
export interface RelatedRecipient {
name: string
tel: string
mobile: string
email: string
zip_code: string
country: string
province: string
city: string
district: string
town: string
address: string
}
/** 关联订单 - 商品条码 */
export interface RelatedItemBarcode {
id: number
barcode: string
}
/** 关联订单 - 商品行 */
export interface RelatedOrderItem {
id: number
order_line_no: string
item_code: string
item_name: string
sku_property: string
quantity: number
locked_quantity: number
is_batch_mgmt: string
is_shelf_life_mgmt: string
is_images: string
store_id: number
packing_requirements: string
stock_unit: string
image_url: string[]
barcodes: RelatedItemBarcode[]
plan_qty: number
stock_id: number
order_item_id: number
order_id: number
}
/** 关联订单 */
export interface RelatedOrder {
id: number
delivery_order_code: string
warehouse_id: number
store_id: number
items_weight: number
wave_id: number
wave_no: string
source_platform_code: string
source_platform_name: string
source_order_codes: string
sync_status: string
inspection_status: string
storage_status: string
post_status: string
print_status: string
pick_status: string
pack_status: string
intercept_status: string
items_count: number
items_total: number
recipient: RelatedRecipient | null
sender: any
items: RelatedOrderItem[]
pack_videos: any[]
}
/** 关联运单 */
export interface RelatedWaybill {
id: number
waybill_code: string
order_id: number
logistics_code: string
logistics_name: string
logistics_interface_id: number
logistics_interface_name: string
status: number
is_back: string
is_intercept: string
warehouse_id: number
create_at: string
}
/** 关联店铺合同 */
export interface RelatedStoreContract {
contract_id: number
store_remask: string
warehouse_remask: string
store_use_status: number
warehouse_use_status: number
}
/** 售后关联数据 */
export interface AfterSaleRelated {
order?: RelatedOrder | null
waybill?: RelatedWaybill | null
store_contract?: RelatedStoreContract | null
}
/** 售后步骤对象 */
export interface AfterSaleStep {
/** 步骤ID(虚拟步骤为 null) */
id: number | null
after_sale_id: number
step_status: StepStatus
operator_id: number | null
operator_snapshot: string | null
action: string | null
remark: string | null
started_at: string | null
completed_at: string | null
created_at: string
attachments: FileReference[]
/** 是否虚拟步骤(主表 description 非空时列表第一条,不落库) */
is_virtual?: boolean
}
/** 文件引用 */
export interface FileReference {
id?: number
file_id?: number
file_name?: string
file_url?: string
file_key?: string
file_size?: number
mime_type?: string
}
// ==================== 响应类型 ====================
/** 售后工作列表项(主表字段 + detail_count + store_name) */
export interface AfterSaleWorkListItem extends AfterSale {
/** 售后单关联计数 */
detail_count: number
/** 货主名称:取合约表 store_remask,无合约或备注为空时回退公司全称,无货主时为空字符串 */
store_name: string
}
/** 分页信息 */
export interface AfterSalePagination {
page: number
pageSize: number
total: number
totalPages: number
}
/** afterSale.workList 响应 */
export interface AfterSaleWorkListResponse {
list: AfterSaleWorkListItem[]
pagination: AfterSalePagination
}
/** afterSale.detail 响应 */
export interface AfterSaleDetailResponse {
/** 售后主表完整记录(含格式化时间字段) */
after_sale: AfterSale
/** 售后进度步骤列表(含附件),按创建时间升序 */
steps: AfterSaleStep[]
/** 关联单据详情(订单/运单/货主合约),无关联时为空对象 */
related: AfterSaleRelated
}
// ==================== 请求参数类型 ====================
/** 列表查询参数 */
export interface AfterSaleListParams {
pagination?: { page?: number; pageSize?: number }
where?: Record<string, any>
sort?: { sortField?: string; sortOrder?: 'asc' | 'desc' | 'ASC' | 'DESC' }
}
/** 创建售后单参数 */
export interface AfterSaleCreateParams {
type: AfterSaleType
sub_type: string
title: string
description?: string
priority?: number
store_id?: number
waybill_id?: number
order_id?: number
order_delivery_no?: string
entry_order_id?: number
entry_order_no?: string
order_stockout_id?: number
order_stockout_no?: string
receiving_id?: number
receiving_no?: string
}
/** 更新售后单参数 */
export interface AfterSaleUpdateParams extends Partial<AfterSaleCreateParams> {
id: number
}
/** 转单参数 */
export interface AfterSaleTransferParams {
id: number
role_group: AfterSaleRoleGroup
remark?: string
}
/** 处理工单参数 */
export interface AfterSaleHandleWorkOrderParams {
id: number
status?: AfterSaleStatus
remark?: string
attachment_ids?: number[]
}
/** afterSale.handleWorkOrder 响应 */
export interface AfterSaleHandleWorkOrderResponse {
/** 本次写入的步骤ID(wms_after_sale_detail.id) */
detail_id: number
/** 售后工单ID */
after_sale_id: number
/** 处理备注发送到的货主售后群数量(未填写备注或未找到货主售后群时为0) */
notified_groups?: number
}
/** 登记理赔参数 */
export interface AfterSaleRegisterClaimParams {
id: number
// 仓库理赔
claim_needed?: 0 | 1
claim_amount?: number
claim_status?: ClaimStatus
// 运方理赔
carrier_claim_needed?: 0 | 1
carrier_claim_amount?: number
carrier_claim_status?: ClaimStatus
// 步骤
action: string
remark?: string
attachment_ids?: number[]
}
/** 导出参数 */
export interface AfterSaleExportParams {
where?: Record<string, any>
sort?: { sortField?: string; sortOrder?: 'asc' | 'desc' }
}
/** 导出进度参数 */
export interface AfterSaleExportTaskProgressParams {
task_id?: string
taskId?: string
}
/** 批量设置待反馈参数 */
export interface AfterSaleBatchSetPendingFeedbackParams {
ids: number[]
remark?: string
}
/** 批量设置待反馈结果项 */
export interface AfterSaleBatchSetPendingFeedbackFailedItem {
id: number
reason: string
}
/** 批量关闭/完结参数 */
export interface AfterSaleBatchCloseParams {
ids: number[]
status: 'completed' | 'closed'
resolution?: string
remark?: string
}
/** 批量关闭/完结结果项 */
export interface AfterSaleBatchCloseFailedItem {
id: number
reason: string
}
/** 售后类型/子类型列表分页信息(含 hasPrevious/hasNext) */
export interface AfterSaleMetaPagination {
page: number
pageSize: number
total: number
totalPages: number
hasPrevious?: boolean
hasNext?: boolean
}
/** 售后类型:系统级 warehouse_id=null、is_system=1;仓库自定义 is_system=0 */
export interface AfterSaleTypeItem {
id: number
warehouse_id: number | null
type: string
name: string
is_system: 0 | 1
is_enabled: 0 | 1
sort_order: number
created_at?: string
updated_at?: string
}
/** 售后子类型:系统级 warehouse_id=null、is_system=1;仓库自定义 is_system=0 */
export interface AfterSaleSubTypeItem {
id: number
warehouse_id: number | null
type: string
sub_type: string
name: string
is_system: 0 | 1
is_enabled: 0 | 1
sort_order: number
created_at?: string
updated_at?: string
}
/** 售后子类型按 type 分组项(subTypeList 传 group=true 时返回) */
export interface AfterSaleSubTypeGroup {
type: string
name: string
items: AfterSaleSubTypeItem[]
}
/** 售后类型/子类型列表查询参数 */
export interface AfterSaleMetaListParams {
pagination?: { page?: number; pageSize?: number }
where?: Record<string, any>
sort?: { sortField?: string; sortOrder?: 'asc' | 'desc' | 'ASC' | 'DESC' }
}
/** 售后子类型列表查询参数(额外支持 group 分组) */
export interface AfterSaleSubTypeListParams extends AfterSaleMetaListParams {
/** 是否按 type 分组返回 groups(true 时额外返回 groups 数组) */
group?: boolean
}
/** 创建仓库自定义售后类型参数(warehouse_id 由服务端注入,无需传递) */
export interface AfterSaleTypeCreateParams {
/** 类型编码:仅 /^[a-z0-9_]+$/,长度≤20,不可与系统级编码重复 */
type: string
/** 类型名称,长度≤50 */
name: string
/** 排序值,越小越靠前,默认 0 */
sort_order?: number
/** 是否启用:1=启用(默认),0=停用 */
is_enabled?: 0 | 1
}
/** 更新仓库自定义售后类型参数(type 编码不可变) */
export interface AfterSaleTypeUpdateParams {
id: number
name?: string
is_enabled?: 0 | 1
sort_order?: number
}
/** 创建仓库自定义售后子类型参数(所属 type 必须已存在且启用) */
export interface AfterSaleSubTypeCreateParams {
/** 所属类型编码 */
type: string
/** 子类型编码:仅 /^[a-z0-9_]+$/,长度≤50 */
sub_type: string
/** 子类型名称,长度≤50 */
name: string
sort_order?: number
is_enabled?: 0 | 1
}
/** 更新仓库自定义售后子类型参数(type 与 sub_type 编码均不可变) */
export interface AfterSaleSubTypeUpdateParams {
id: number
name?: string
is_enabled?: 0 | 1
sort_order?: number
}
/** afterSale.typeList 响应 */
export interface AfterSaleTypeListResponse {
list: AfterSaleTypeItem[]
pagination: AfterSaleMetaPagination
}
/** afterSale.subTypeList 响应 */
export interface AfterSaleSubTypeListResponse {
list: AfterSaleSubTypeItem[]
pagination: AfterSaleMetaPagination
/** group=true 时返回:按 type 分组(基于全量过滤结果,不受分页影响) */
groups?: AfterSaleSubTypeGroup[]
}
/** afterSale.typeDelete / afterSale.subTypeDelete 响应 */
export interface AfterSaleMetaDeleteResponse {
id: number
deleted: boolean
}
// ==================== API 方法 ====================
/** 2.1 工作列表 afterSale.workList */
export function afterSaleWorkList(data: AfterSaleListParams = {}): Promise<AfterSaleWorkListResponse> {
return request({
url: '/system',
method: 'post',
params: {
method: 'afterSale.workList',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/** 2.2 审计列表 afterSale.auditList */
export function afterSaleAuditList(data: AfterSaleListParams = {}) {
return request({
url: '/system',
method: 'post',
params: {
method: 'afterSale.auditList',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/** 2.3 售后明细 afterSale.detail */
export function afterSaleDetail(id: number): Promise<AfterSaleDetailResponse> {
return request({
url: '/system',
method: 'post',
params: {
method: 'afterSale.detail',
v,
timestamp: Date.now()
},
data: { id },
isSystemApi: true
} as any)
}
/** 2.4 创建售后单 afterSale.create */
export function afterSaleCreate(data: AfterSaleCreateParams) {
return request({
url: '/system',
method: 'post',
params: {
method: 'afterSale.create',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/** 2.5 更新售后单 afterSale.update */
export function afterSaleUpdate(data: AfterSaleUpdateParams) {
return request({
url: '/system',
method: 'post',
params: {
method: 'afterSale.update',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/** 2.6 转单 afterSale.transfer */
export function afterSaleTransfer(data: AfterSaleTransferParams) {
return request({
url: '/system',
method: 'post',
params: {
method: 'afterSale.transfer',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/** 2.7 处理工单 afterSale.handleWorkOrder */
export function afterSaleHandleWorkOrder(
data: AfterSaleHandleWorkOrderParams
): Promise<AfterSaleHandleWorkOrderResponse> {
return request({
url: '/system',
method: 'post',
params: {
method: 'afterSale.handleWorkOrder',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/** 2.8 登记理赔 afterSale.registerClaim */
export function afterSaleRegisterClaim(data: AfterSaleRegisterClaimParams) {
return request({
url: '/system',
method: 'post',
params: {
method: 'afterSale.registerClaim',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/** 2.9 导出 afterSale.export */
export function afterSaleExport(data: AfterSaleExportParams = {}) {
return request({
url: '/system',
method: 'post',
params: {
method: 'afterSale.export',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/** 2.10 导出进度 afterSale.exportTaskProgress */
export function afterSaleExportTaskProgress(data: AfterSaleExportTaskProgressParams) {
return request({
url: '/system',
method: 'post',
params: {
method: 'afterSale.exportTaskProgress',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/** 2.11 角标快速查询 afterSale.workCount */
export function afterSaleWorkCount(): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'afterSale.workCount',
v,
timestamp: Date.now()
},
data: {},
isSystemApi: true
} as any)
}
/** 2.12 批量设置待反馈 afterSale.batchSetPendingFeedback */
export function afterSaleBatchSetPendingFeedback(data: AfterSaleBatchSetPendingFeedbackParams) {
return request({
url: '/system',
method: 'post',
params: {
method: 'afterSale.batchSetPendingFeedback',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/** 2.13 批量关闭/完结 afterSale.batchClose */
export function afterSaleBatchClose(data: AfterSaleBatchCloseParams) {
return request({
url: '/system',
method: 'post',
params: {
method: 'afterSale.batchClose',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/**
* 2.14 售后类型列表 afterSale.typeList
* 返回系统级(warehouse_id=null、is_system=1)+ 当前仓库自定义(is_system=0)合并列表,
* 默认 sort_order ASC, id ASC;pageSize 上限 500
*/
export function afterSaleTypeList(
data: AfterSaleMetaListParams = {}
): Promise<AfterSaleTypeListResponse> {
return request({
url: '/system',
method: 'post',
params: {
method: 'afterSale.typeList',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/**
* 2.15 创建仓库自定义售后类型 afterSale.typeCreate
* warehouse_id 由服务端从当前仓库上下文注入
*/
export function afterSaleTypeCreate(data: AfterSaleTypeCreateParams): Promise<AfterSaleTypeItem> {
return request({
url: '/system',
method: 'post',
params: {
method: 'afterSale.typeCreate',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/**
* 2.16 更新仓库自定义售后类型 afterSale.typeUpdate
* 仅命中 id + 当前仓库 + is_system=0;type 编码不可变
*/
export function afterSaleTypeUpdate(data: AfterSaleTypeUpdateParams): Promise<AfterSaleTypeItem> {
return request({
url: '/system',
method: 'post',
params: {
method: 'afterSale.typeUpdate',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/**
* 2.17 删除仓库自定义售后类型 afterSale.typeDelete
* 系统级类型禁止删除;该类型下存在当前仓库自定义子类型时拒绝删除
*/
export function afterSaleTypeDelete(id: number): Promise<AfterSaleMetaDeleteResponse> {
return request({
url: '/system',
method: 'post',
params: {
method: 'afterSale.typeDelete',
v,
timestamp: Date.now()
},
data: { id },
isSystemApi: true
} as any)
}
/**
* 2.18 售后子类型列表 afterSale.subTypeList
* group=true 时额外返回 groups(按 type 分组,基于全量过滤结果、不受分页影响)
*/
export function afterSaleSubTypeList(
data: AfterSaleSubTypeListParams = {}
): Promise<AfterSaleSubTypeListResponse> {
return request({
url: '/system',
method: 'post',
params: {
method: 'afterSale.subTypeList',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/**
* 2.19 创建仓库自定义售后子类型 afterSale.subTypeCreate
* 所属 type 必须已存在(系统级或当前仓库自定义)且处于启用状态
*/
export function afterSaleSubTypeCreate(
data: AfterSaleSubTypeCreateParams
): Promise<AfterSaleSubTypeItem> {
return request({
url: '/system',
method: 'post',
params: {
method: 'afterSale.subTypeCreate',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/**
* 2.20 更新仓库自定义售后子类型 afterSale.subTypeUpdate
* 仅命中 id + 当前仓库 + is_system=0;type 与 sub_type 编码均不可变
*/
export function afterSaleSubTypeUpdate(
data: AfterSaleSubTypeUpdateParams
): Promise<AfterSaleSubTypeItem> {
return request({
url: '/system',
method: 'post',
params: {
method: 'afterSale.subTypeUpdate',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/**
* 2.21 删除仓库自定义售后子类型 afterSale.subTypeDelete
* 系统级子类型禁止删除;已被当前仓库售后单引用时拒绝删除
*/
export function afterSaleSubTypeDelete(id: number): Promise<AfterSaleMetaDeleteResponse> {
return request({
url: '/system',
method: 'post',
params: {
method: 'afterSale.subTypeDelete',
v,
timestamp: Date.now()
},
data: { id },
isSystemApi: true
} as any)
}

259
src/api/apiapp/apiapp.ts Normal file
View File

@ -0,0 +1,259 @@
import request from '@/utils/request'
const v = '1.0'
// ============================================================
// 类型定义(匹配实际 API 响应字段)
// ============================================================
/** API 应用列表项 */
export interface ApiAppItem {
id: number
app_name: string
warehouse_id: number
self_app_key: string
self_app_secret: string // 列表返回脱敏后的 Secret(如 "ce4f07a1****")
self_ip_whitelist: string[] | null
callback_url: string | null
/** 承接的出站回调 method 列表(空/未勾选=不承接任何回调) */
callback_functions?: string[] | null
interface_type_id: number
rate_limit: number
sign_method: string
is_enabled: number // 1-启用, 0-停用
created_at: string
updated_at: string
}
/** API 应用详情(含完整 Secret — 仅创建/重新生成时返回) */
export interface ApiAppDetail extends ApiAppItem {
// 创建/重置密钥时 self_app_secret 为完整 64 位 hex(顶层字段)
}
/** create / detail / update / regenerateSecret 的通用扁平响应 */
export interface ApiAppFlatResponse {
flag: string
code: number
message: string
id: number
app_name: string
warehouse_id: number
self_app_key: string
self_app_secret: string // 创建/重置时是完整密钥,列表/详情时脱敏
self_ip_whitelist: string[] | null
callback_url: string | null
/** 承接的出站回调 method 列表(create/update 回显;detail 亦返回) */
callback_functions?: string[] | null
interface_type_id: number
rate_limit: number
sign_method: string
is_enabled: number
created_at: string
updated_at: string
timestamp: number
}
/** 列表查询参数 */
export interface ApiAppListParams {
page?: number
pageSize?: number
app_name?: string
is_enabled?: number
}
/** 列表响应(list 和 pagination 在顶层,非 data 内嵌套) */
export interface ApiAppListResponse {
flag: string
code: number
message: string
list: ApiAppItem[]
pagination: {
page: number
pageSize: number
total: number
totalPages: number
hasNext: boolean
hasPrevious: boolean
}
}
/** 创建参数(sign_method 固定为 md5,无需传参) */
export interface ApiAppCreateParams {
app_name: string
interface_type_id?: number
self_ip_whitelist?: string[]
callback_url?: string
/**
* 承接的出站回调 method 列表,仅允许注册表(apiApp.listCallbackFunctions)中的方法
* (如 notify.reply);空数组/不传 = 不承接任何回调
*/
callback_functions?: string[]
rate_limit?: number
}
/** 更新参数(sign_method 固定为 md5,不允许修改) */
export interface ApiAppUpdateParams {
id: number
app_name?: string
self_ip_whitelist?: string[]
callback_url?: string
/**
* 承接的出站回调 method 列表,仅允许注册表中的方法;
* **空数组 = 清空承接(不承接任何回调)**
*/
callback_functions?: string[]
rate_limit?: number
is_enabled?: number
}
// ============================================================
// API 方法(响应中 list/pagination 在顶层)
// ============================================================
/** 查询 API 应用列表(分页) */
export function apiAppList(
params: ApiAppListParams = {}
): Promise<ApiAppListResponse> {
return request({
url: '/system',
method: 'post',
params: {
method: 'apiApp.list',
v,
timestamp: Date.now()
},
data: params,
isSystemApi: true
} as any)
}
/** 查询单个 API 应用详情 */
export function apiAppDetail(
id: number
): Promise<ApiAppFlatResponse> {
return request({
url: '/system',
method: 'post',
params: {
method: 'apiApp.detail',
v,
timestamp: Date.now()
},
data: { id },
isSystemApi: true
} as any)
}
/** 创建 API 应用 */
export function apiAppCreate(
data: ApiAppCreateParams
): Promise<ApiAppFlatResponse> {
return request({
url: '/system',
method: 'post',
params: {
method: 'apiApp.create',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/** 更新 API 应用 */
export function apiAppUpdate(
data: ApiAppUpdateParams
): Promise<ApiAppFlatResponse> {
return request({
url: '/system',
method: 'post',
params: {
method: 'apiApp.update',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/** 停用 API 应用(软删除) */
export function apiAppDelete(
id: number
): Promise<{ flag: string; code: number; message: string }> {
return request({
url: '/system',
method: 'post',
params: {
method: 'apiApp.delete',
v,
timestamp: Date.now()
},
data: { id },
isSystemApi: true
} as any)
}
/** 重新生成 AppSecret(响应为扁平结构,self_app_secret 为完整密钥) */
export function apiAppRegenerateSecret(
id: number
): Promise<ApiAppFlatResponse> {
return request({
url: '/system',
method: 'post',
params: {
method: 'apiApp.regenerateSecret',
v,
timestamp: Date.now()
},
data: { id },
isSystemApi: true
} as any)
}
// ============================================================
// 出站回调 method 注册表(apiApp.listCallbackFunctions)
// ============================================================
/** 注册表条目:兼容后端返回「字符串数组」或「对象数组」两种形态 */
export type ApiAppCallbackFunction =
| string
| {
/** 回调 method,如 notify.reply */
method: string
/** 展示名称(可选) */
title?: string
/** 说明(可选) */
description?: string
[key: string]: unknown
}
/** 列表响应(list/total 在顶层,与 apiApp.list 口径一致) */
export interface ApiAppListCallbackFunctionsResponse {
flag?: string
code: number
message?: string
list: ApiAppCallbackFunction[]
total: number
timestamp?: number
}
/**
* 拉取出站回调 method 注册表(代码注册,供管理端多选列表使用)
*
* 应用勾选后由服务端按 method 自动路由出站回调;入参无。
*/
export function apiAppListCallbackFunctions(): Promise<ApiAppListCallbackFunctionsResponse> {
return request({
url: '/system',
method: 'post',
params: {
method: 'apiApp.listCallbackFunctions',
v,
timestamp: Date.now()
},
data: {},
isSystemApi: true
} as any)
}

264
src/api/camera/camera.ts Normal file
View File

@ -0,0 +1,264 @@
import request from '@/utils/request'
const v = '1.0'
/** 摄像头列表(仓库隔离,分页+筛选) */
export function list(data?: {
pagination?: { page?: number; pageSize?: number }
where?: { server_id?: number; custom_name?: string; status?: number }
}) {
return request({
url: '/system',
method: 'post',
params: {
method: 'camera.list',
v,
timestamp: new Date().getTime()
},
data: data || {},
isSystemApi: true
} as any)
}
/** 摄像头详情 */
export function detail(data: { id: number }) {
return request({
url: '/system',
method: 'post',
params: {
method: 'camera.detail',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
/** 新增摄像头 */
export function create(data: {
server_id: number
channel_id: number
channel_name?: string
custom_name?: string
status?: number
username?: string
password?: string
remark?: string
ip?: string
port?: number
model?: string
serial_number?: string
stream_type?: string
}) {
return request({
url: '/system',
method: 'post',
params: {
method: 'camera.create',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
/** 更新摄像头 */
export function update(data: {
id: number
server_id?: number
channel_id?: number
channel_name?: string
custom_name?: string
status?: number
username?: string
password?: string
remark?: string
ip?: string
port?: number
model?: string
serial_number?: string
stream_type?: string
}) {
return request({
url: '/system',
method: 'post',
params: {
method: 'camera.update',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
/** 设置摄像头 OSD 文字叠加 */
export function setOsd(data: {
id: number
text: string
x?: number
y?: number
}) {
return request({
url: '/system',
method: 'post',
params: {
method: 'camera.setOsd',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
/** 删除摄像头(软删除) */
export function del(data: { id: number }) {
return request({
url: '/system',
method: 'post',
params: {
method: 'camera.delete',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
/** 云台方向:8 个位置(大小写不敏感,服务端统一转小写校验) */
export type PtzDirection =
| 'up'
| 'down'
| 'left'
| 'right'
| 'upleft'
| 'upright'
| 'downleft'
| 'downright'
/** 云台转速默认值(可选 1-7 的整数) */
export const PTZ_DEFAULT_SPEED = 4
/** 云台转速范围:1-7 的整数 */
export function normalizePtzSpeed(speed?: number): number {
const n = Number(speed)
if (!Number.isFinite(n)) return PTZ_DEFAULT_SPEED
const int = Math.round(n)
if (int < 1) return 1
if (int > 7) return 7
return int
}
/** 云台预置点范围:1-256 的整数 */
export function normalizePtzPresetId(presetId: number): number {
const n = Number(presetId)
if (!Number.isFinite(n)) return 0
const int = Math.round(n)
if (int < 1 || int > 256) return 0
return int
}
/**
* 云台方向控制(按下):按指定方向持续转动摄像头
* 必须配对调用 ptzStop 停止
*/
export function ptzControl(data: {
id: number
action: PtzDirection
speed?: number
}) {
const body: Record<string, unknown> = {
id: Number(data.id),
action: String(data.action || '').toLowerCase()
}
if (data.speed !== undefined && data.speed !== null) {
body.speed = normalizePtzSpeed(data.speed)
}
return request({
url: '/system',
method: 'post',
params: {
method: 'camera.ptzControl',
v,
timestamp: new Date().getTime()
},
data: body,
isSystemApi: true
} as any)
}
/**
* 云台停止(松手):停止转动
* action 必须与按下时(ptzControl)一致
*/
export function ptzStop(data: {
id: number
action: PtzDirection
}) {
return request({
url: '/system',
method: 'post',
params: {
method: 'camera.ptzStop',
v,
timestamp: new Date().getTime()
},
data: {
id: Number(data.id),
action: String(data.action || '').toLowerCase()
},
isSystemApi: true
} as any)
}
/**
* 云台预置点跳转:跳转到指定预置点
* 一次调用即可,无需 ptzStop
*/
export function ptzPresetGoto(data: {
id: number
presetId: number
}) {
return request({
url: '/system',
method: 'post',
params: {
method: 'camera.ptzPresetGoto',
v,
timestamp: new Date().getTime()
},
data: {
id: Number(data.id),
presetId: normalizePtzPresetId(data.presetId)
},
isSystemApi: true
} as any)
}
/**
* 云台预置点设置:把摄像头当前机位保存为指定预置点
* 一次调用即可;已存在的编号会被当前机位覆盖
*/
export function ptzPresetSet(data: {
id: number
presetId: number
}) {
return request({
url: '/system',
method: 'post',
params: {
method: 'camera.ptzPresetSet',
v,
timestamp: new Date().getTime()
},
data: {
id: Number(data.id),
presetId: normalizePtzPresetId(data.presetId)
},
isSystemApi: true
} as any)
}

View File

@ -0,0 +1,106 @@
import request from '@/utils/request'
const v = '1.0'
/** 录像服务器列表(仓库隔离,分页+筛选) */
export function list(data?: {
pagination?: { page?: number; pageSize?: number }
where?: { name?: string; status?: number }
}) {
return request({
url: '/system',
method: 'post',
params: {
method: 'camera_server.list',
v,
timestamp: new Date().getTime()
},
data: data || {},
isSystemApi: true
} as any)
}
/** 录像服务器详情 */
export function detail(data: { id: number }) {
return request({
url: '/system',
method: 'post',
params: {
method: 'camera_server.detail',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
/** 新增录像服务器 */
export function create(data: {
name: string
brand?: string
public_ip?: string
public_port?: number
internal_ip?: string
internal_port?: number
port?: number
username?: string
password?: string
status?: number
remark?: string
}) {
return request({
url: '/system',
method: 'post',
params: {
method: 'camera_server.create',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
/** 更新录像服务器 */
export function update(data: {
id: number
name?: string
brand?: string
public_ip?: string
public_port?: number
internal_ip?: string
internal_port?: number
port?: number
username?: string
password?: string
status?: number
remark?: string
}) {
return request({
url: '/system',
method: 'post',
params: {
method: 'camera_server.update',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
/** 删除录像服务器(软删除) */
export function del(data: { id: number }) {
return request({
url: '/system',
method: 'post',
params: {
method: 'camera_server.delete',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}

View File

@ -0,0 +1,144 @@
/**
* 本地录像服务器 HTTP REST API 列表
*
* 本机端口:17311 → 17312 → 17313
* 所有请求直接发往 localhost,不经过主后端 /system 代理。
*
* 使用方式:
* import { localServerApi } from '@/api/camera_server/localServerApi'
* const res = await localServerApi.getHikvisionChannels(baseUrl, params)
*
* 新增 API 时只需在此文件追加函数即可。
*/
import axios from 'axios'
// ============================================================
// 通用请求工具
// ============================================================
/** 创建针对指定 baseUrl 的 axios 实例(每次调用按需创建,避免共享拦截器) */
function createClient(baseUrl: string) {
return axios.create({
baseURL: baseUrl,
timeout: 15000,
headers: { 'Content-Type': 'application/json' }
})
}
/** 对本地 API 做统一响应解包(兼容多种格式) */
function unwrap<T = any>(res: any): T {
const body = res?.data
if (!body || typeof body !== 'object') return body as T
// 格式1: { success: true, channels: [...] }
if ('success' in body && body.success) {
return (body.channels !== undefined ? body.channels : body.data ?? body) as T
}
// 格式2: { code, data, message }
if ('code' in body) {
if (body.code !== 0 && body.code !== 200) {
throw new Error(body.message || body.msg || `请求失败 (code=${body.code})`)
}
return (body.data !== undefined ? body.data : body) as T
}
return body as T
}
// ============================================================
// API 列表(按模块分组,方便扩展)
// ============================================================
// ---------- 海康威视 ----------
/** 获取海康威视通道列表(通用请求,参数透传) */
export async function getHikvisionChannels(
baseUrl: string,
params?: Record<string, unknown>
) {
const client = createClient(baseUrl)
const res = await client.post('/api/hikvision/channels', params || {})
return unwrap<any[]>(res)
}
// ---------- 连通测试 ----------
export interface CameraServerConnectionParams {
ip: string
port?: number
user: string
pass: string
}
/**
* 测试录像服务器连通性
* 向本地代理服务发送请求,由其转发到目标录像服务器
*/
export async function testConnection(
baseUrl: string,
params: CameraServerConnectionParams
) {
const client = createClient(baseUrl)
const res = await client.post('/api/hikvision/channels', {
ip: params.ip,
port: params.port,
user: params.user,
pass: params.pass
})
return unwrap<any>(res)
}
// ---------- MJPEG 实时流 ----------
const DEFAULT_PROXY_BASE = 'http://localhost:17311'
/**
* 生成 MJPEG 实时流 URL
* 后端 GET /api/hikvision/live-stream 返回 multipart MJPEG 流
* 前端直接用 <img src="..."> 渲染
*
* @example
* getLiveStreamUrl({ ip: '192.168.8.241', user: 'admin', pass: 'ky666888', channel: 9, streamType: 1 })
* // → http://localhost:17311/api/hikvision/live-stream?ip=192.168.8.241&user=admin&pass=ky666888&channel=9&streamType=1
*/
export function getLiveStreamUrl(params: {
ip: string
user: string
pass: string
channel: number
streamType?: number
port?: number
}): string {
const { ip, user, pass, channel, streamType = 0, port } = params
const portParam = port ? `&port=${port}` : ''
return `${DEFAULT_PROXY_BASE}/api/hikvision/live-stream?ip=${encodeURIComponent(ip)}&user=${encodeURIComponent(user)}&pass=${encodeURIComponent(pass)}&channel=${channel}&streamType=${streamType}${portParam}`
}
/**
* 停止实时流(显式通知后端 kill 对应 ffmpeg 进程)
* 后端 POST /api/hikvision/stop-stream
*
* @example
* stopLiveStream({ ip: '192.168.8.241', user: 'admin', pass: 'ky666888', channel: 9, port: 8000 })
*/
export interface LiveStreamTarget {
ip: string
user: string
pass: string
channel: number
port?: number
}
export async function stopLiveStream(params: LiveStreamTarget) {
const client = createClient(DEFAULT_PROXY_BASE)
try {
await client.post('/api/hikvision/stop-stream', params)
} catch {
// 停止失败忽略:后端应在客户端连接断开时兜底回收 ffmpeg
}
}
// ---------- 后续在此追加其他 API ----------
// export async function getSomeOtherApi(baseUrl: string, params?: any) { ... }

View File

@ -0,0 +1,176 @@
import request from '@/utils/request'
const v = '1.0'
export type ComboGoodsListParams = {
pagination?: {
page?: number
pageSize?: number
}
where?: {
combo_code?: string
combo_name?: string
status?: number
warehouse_id?: number
}
}
export type ComboGoodsListItem = Record<string, unknown> & {
id?: number
combo_code?: string
combo_name?: string
custom_code?: string | null
combo_sku_id?: number
status?: number
warehouse_id?: number
remark?: string
items?: unknown[]
simpleNotation?: string
nameNotation?: string
}
export type ComboGoodsListResponse = {
list: ComboGoodsListItem[]
total: number
page: number
pageSize: number
}
export type ComboGoodsCreateItem = {
item_goods_sku_id: number
item_quantity: number
sort_order?: number
}
export type ComboGoodsCreateParams = {
combo_code: string
combo_name: string
warehouse_id?: number
store_id?: number
remark?: string
custom_code?: string
items: ComboGoodsCreateItem[]
}
export type ComboGoodsCreateResponse = {
id: number
combo_code: string
combo_name: string
custom_code?: string | null
}
export type ComboGoodsUpdateParams = {
id: number
combo_name?: string
warehouse_id?: number
store_id?: number | null
remark?: string
custom_code?: string | null
status?: number
items?: ComboGoodsCreateItem[]
}
export type ComboGoodsUpdateResponse = {
id: number
}
export type ComboGoodsDeleteParams = {
id: number
}
export type ComboGoodsDeleteResponse = {
id: number
}
export type ComboGoodsSearchParams = {
keyword: string
limit?: number
}
export type ComboGoodsSearchResponse = {
list: ComboGoodsListItem[]
total: number
}
/** comboGoods.list:组合商品列表查询(分页) */
export function comboGoodsList(data: ComboGoodsListParams = {}): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'comboGoods.list',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/** comboGoods.create:创建组合商品(含明细一次性提交) */
export function comboGoodsCreate(data: ComboGoodsCreateParams): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'comboGoods.create',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/** comboGoods.update:编辑组合商品(含明细替换) */
export function comboGoodsUpdate(data: ComboGoodsUpdateParams): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'comboGoods.update',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/** comboGoods.delete:删除组合商品(软删除) */
export function comboGoodsDelete(data: ComboGoodsDeleteParams): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'comboGoods.delete',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/** comboGoods.search:关键字搜索组合商品(供手工建单选择) */
export function comboGoodsSearch(data: ComboGoodsSearchParams): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'comboGoods.search',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
export const comboGoods = {
list: comboGoodsList,
create: comboGoodsCreate,
update: comboGoodsUpdate,
delete: comboGoodsDelete,
search: comboGoodsSearch
}

View File

@ -0,0 +1,182 @@
import request from '@/utils/request'
const v = "1.0"
export function getDashboardData(method: string, data: any) {
return request({
url: '/system',
method: 'post',
params: {
method,
v,
timestamp: new Date().getTime()
},
data: data,
isSystemApi: true
} as any)
}
/** dashboard.* 通用响应信封(业务字段与信封同级:flag/code/message/data/timestamp) */
export type DashboardEnvelope<T> = {
/** 结果标记,成功为 success */
flag?: string
/** 业务码,成功为 200 */
code?: number
message?: string
/** 服务器时间戳(秒) */
timestamp?: number
data: T
}
/** dashboard.storeStats 的 data(仓库发货统计;货主端自动跨已签约仓库汇总) */
export type DashboardStoreStatsData = {
/** 今日订单数(待处理 + 今日已出库) */
todayOrders: number
/** 今日新增较昨日增长率(%),昨日为 0 时按 100 或 0 计算 */
orderTrend: number
/** 未分配快递号订单数 */
unassignedOrders: number
/** 未打印订单数 */
unprintedOrders: number
/** 未拣货订单数 */
unpickedOrders: number
/** 待发货订单数 */
pendingShipments: number
/** 发货进度(%),(待处理-待发货)/待处理 */
shipmentProgress: number
/** 今日已出库订单数 */
todayOutbound: number
/** 出库完成率(%),今日出库/(待发货+今日出库) */
outboundRate: number
/** 拦截订单数 */
interceptedOrders: number
/** 异常订单数(step=3) */
exceptionOrders: number
/** 已复核订单数 */
recheckedOrders: number
/** 已打包订单数 */
packedOrders: number
}
/**
* dashboard.warehouseStats 的 data(**固定演示数据**,非实时查询结果,仅供前端展示与调试)。
* ⚠️ 字段少于 storeStats:**不含** recheckedOrders / packedOrders。
*/
export type DashboardWarehouseStatsData = {
todayOrders: number
orderTrend: number
unassignedOrders: number
unprintedOrders: number
unpickedOrders: number
pendingShipments: number
shipmentProgress: number
todayOutbound: number
outboundRate: number
interceptedOrders: number
exceptionOrders: number
}
/** dashboard.express_ratio / platform_distribution 的 data 元素(饼图,按订单数降序) */
export type DashboardPieItem = {
/** 快递公司名称(未填写时为「未指定快递」)/ 平台名称(未填写时为「未指定平台」) */
name: string
/** 该名称下的待处理订单数 */
value: number
/** 图表配色 */
itemStyle?: { color?: string }
}
/** dashboard.hot_order_rank 的 data 元素(今日销量 Top10,name 已脱敏) */
export type DashboardHotOrderRankItem = {
/** 排行序号(从 1 开始) */
id: number
/** 脱敏后商品名称(前 2 字符 + *** + 后 2 字符;长度不足 4 字符时为 ***) */
name: string
/** 库存商品ID(stock_warehouse.id);极端情况下回退商品编码字符串 */
sku: number | string
/** 今日销量(件数) */
value: number
/** 环比昨日百分比(1 位小数;昨日为 0 且今日 >0 时为 100) */
trend: number
}
/** dashboard.order_trend 的 data(按小时统计当日 08:00 至当前小时) */
export type DashboardOrderTrendData = {
/** 统计范围,固定为 day */
range: string
/** 统计日期(YYYY-MM-DD) */
date: string
summary: {
/** 当日订单总数 */
total_orders: number
/** 当日发货总数 */
total_shipments: number
/** 发货率(%,1 位小数) */
shipment_rate: number
/** 订单峰值时段(如 08:00) */
peak_hour: string
/** 峰值时段订单数 */
peak_orders: number
}
/** 时段列表(08:00 至当前小时,如 ['08:00','09:00']) */
categories: string[]
/** 各时段订单数(与 categories 一一对应) */
orders: number[]
/** 各时段发货数(与 categories 一一对应) */
shipments: number[]
}
/**
* 获取仓库发货统计(**演示数据**:固定演示值,非实时查询;无业务入参)
*/
export function getWarehouseStats(
data: Record<string, unknown> = {}
): Promise<DashboardEnvelope<DashboardWarehouseStatsData>> {
return getDashboardData('dashboard.warehouseStats', data)
}
/**
* 获取门店/仓库发货统计(真实查询;无业务入参,依据登录用户上下文区分仓库端与货主端)
*/
export function getStoreStats(
data: Record<string, unknown> = {}
): Promise<DashboardEnvelope<DashboardStoreStatsData>> {
return getDashboardData('dashboard.storeStats', data)
}
export type OrderTrendData = DashboardOrderTrendData
export type OrderTrendResponse = DashboardEnvelope<OrderTrendData>
/**
* 获取订单趋势数据(无业务入参,依据当前用户绑定仓库统计)
*/
export function getOrderTrend(data: Record<string, unknown> = {}): Promise<OrderTrendResponse> {
return getDashboardData('dashboard.order_trend', data)
}
/**
* 获取平台分布数据(饼图;无业务入参,货主端跨已签约仓库汇总)
*/
export function getPlatformDist(
data: Record<string, unknown> = {}
): Promise<DashboardEnvelope<DashboardPieItem[]>> {
return getDashboardData('dashboard.platform_distribution', data)
}
/**
* 获取热销商品排行(今日销量 Top10;无业务入参)
*/
export function getHotOrderRank(
data: Record<string, unknown> = {}
): Promise<DashboardEnvelope<DashboardHotOrderRankItem[]>> {
return getDashboardData('dashboard.hot_order_rank', data)
}
/**
* 获取快递占比数据(饼图;无业务入参,货主端跨已签约仓库汇总)
*/
export function getExpressRatio(
data: Record<string, unknown> = {}
): Promise<DashboardEnvelope<DashboardPieItem[]>> {
return getDashboardData('dashboard.express_ratio', data)
}

View File

@ -0,0 +1,251 @@
import request from '@/utils/request'
const v = '1.0'
/** 请求选项:silentError=true 时全局拦截器不弹错误提示(公共品牌拉取失败属预期分支) */
export type FrontConfigRequestOptions = { silentError?: boolean }
/** frontConfig.* 统一 POST 入口(系统标准入口 /system,method 经 params 下发) */
function postFrontConfig<T = Record<string, unknown>>(
method: string,
data: Record<string, unknown> = {},
options: FrontConfigRequestOptions = {}
): Promise<T & { code?: number; message?: string }> {
return request({
url: '/system',
method: 'post',
params: {
method,
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true,
...(options.silentError ? { silentError: true } : {})
} as any)
}
/** 域名验证状态:0 未验证 / 1 已验证 / 2 验证失败 */
export const FRONT_DOMAIN_STATUS = {
/** 未验证(已生成 TXT 校验记录,等待校验) */
unverified: 0,
/** 已验证(唯一可上传证书的状态) */
verified: 1,
/** 验证失败 */
failed: 2
} as const
/** frontConfig.getByDomain 响应:仓库前端公开品牌配置(不含证书/同步等内部字段) */
export type FrontConfigPublicItem = {
/** 仓库自持域名 */
domain?: string
/** 站点标题(未配置为空字符串) */
title?: string
/** Logo 地址(未配置为空字符串) */
logo_url?: string
/** 登录页背景图地址(未配置为空字符串) */
login_bg_url?: string
/** 站点 favicon 图标地址(未配置为空字符串) */
favicon_url?: string
/** 主题配置对象(未配置为 null) */
theme?: Record<string, unknown> | null
/** 未登记域名时为 false(并返回 404) */
configured?: boolean
[key: string]: unknown
}
/** frontConfig.getInfo / saveInfo 响应:当前仓库品牌配置(8 字段,不含证书/私钥/证书路径/同步等内部字段) */
export type FrontConfigInfo = {
warehouse_id?: number
/** 仓库自持域名(未设置为空字符串) */
domain?: string
/** 站点标题(未配置为空字符串) */
title?: string
logo_url?: string
login_bg_url?: string
favicon_url?: string
/** 主题配置对象(未配置为 null) */
theme?: Record<string, unknown> | string | null
updated_at?: string | null
[key: string]: unknown
}
/** frontConfig.saveInfo 入参:仅受理品牌字段,其余(domain/证书相关)由后端白名单静默忽略 */
export type FrontConfigSaveInfoParams = {
/** 站点标题(≤100,空值清空) */
title?: string
/** Logo 地址(≤255,空值清空) */
logo_url?: string
/** 站点 favicon 地址(≤255,空值清空) */
favicon_url?: string
/** 登录页背景图地址(≤255,空值清空) */
login_bg_url?: string
/** 主题配置(合法 JSON 对象或 JSON 字符串;空值清空) */
theme?: Record<string, unknown> | string | null
}
/**
* frontConfig.getDomain / setDomain / checkDomain 响应:域名与 DNS TXT 归属验证状态(16 字段)。
* 分两组:①生效域名组 9 字段(domain/domain_status/verify_host/verify_value/cname/verified_at/attempts/last_error);
* ②待验证域名组 7 字段(pending_*,两阶段域名切换新增)。
* 两阶段语义:domain 始终是「生效域名」,切换期间(pending_active=true)仍为旧域名并继续对外服务,
* 只有 TXT 校验通过被提升后才换成新域名;pending_domain 是用户提交、等待 TXT 校验的待验证域名,
* 从未生效、不参与 frontConfig.getByDomain 放行。
*/
export type FrontConfigDomain = {
warehouse_id?: number
/** 生效域名(未设置为空字符串;变更统一走 frontConfig.setDomain,由待验证组提升而来) */
domain?: string
/** 生效域名验证状态:0 未验证 / 1 已验证 / 2 验证失败 */
domain_status?: number
/** 待添加的 TXT 记录主机名(如 wmsv-xxxxxxxxxx.<domain>);domain_status=1 时返回空字符串 */
verify_host?: string
/** 待添加的 TXT 记录值(32 位 hex);domain_status=1 时返回空字符串 */
verify_value?: string
/** CNAME 目标(前端部署需解析到该地址,由后端配置下发) */
cname?: string
/** 验证通过时间(未验证为 null) */
verified_at?: string | null
/** 校验尝试次数 */
attempts?: number
/** 最近一次校验失败原因(脱敏截断;未失败为空字符串) */
last_error?: string
/** 待验证域名(切换中非空;未发起切换为空字符串)。setDomain 只登记到本字段,校验通过后才提升为 domain */
pending_domain?: string
/** 待验证域名的 TXT 记录主机名(pending_domain 非空时**始终回显**,用户据此配置 TXT 记录) */
pending_verify_host?: string
/** 待验证域名的 TXT 记录值(32 位 hex;pending_domain 为空时返回空字符串) */
pending_verify_value?: string
/** 待验证域名校验尝试次数 */
pending_attempts?: number
/** 待验证域名最近一次校验失败原因(脱敏截断;未失败为空字符串) */
pending_last_error?: string
/** 发起本次域名切换的时间(无待验证域名为 null) */
pending_created_at?: string | null
/** 是否处于域名切换中(等价于 pending_domain 非空;true=待验证域名已登记、等待 TXT 校验) */
pending_active?: boolean
[key: string]: unknown
}
/** frontConfig.checkDomain 响应:getDomain 的 16 字段 + 本次校验结果 */
export type FrontConfigCheckDomainResult = FrontConfigDomain & {
/** 本次校验是否通过 */
verified?: boolean
/** 本次解析到的 TXT 值(最多 5 条,排障用) */
resolved_values?: string[]
}
/** frontConfig.getCert / saveCert 响应:证书与同步元信息(13 字段,不含 cert_path/key_path) */
export type FrontConfigCert = {
warehouse_id?: number
domain?: string
/** 证书 PEM 原文(未配置为空字符串;仅仓库主体 settings 页回显,公共接口 getByDomain 不返回) */
cert_pem?: string
/** 私钥 PEM 原文(读 cert_key 列;仅仓库主体 settings 页回显,禁止外泄或写入日志) */
key_pem?: string
/** 证书到期时间(按证书 validTo 权威写入;未上传为 null) */
cert_expire_at?: string | null
sync_status?: number
sync_attempts?: number
last_sync_error?: string
last_synced_at?: string | null
updated_at?: string | null
/** 是否允许上传证书:仅 domain 非空且 domain_status=1(已验证)时为 true */
can_set_cert?: boolean
/** 不可上传原因(无域名「请先设置域名」/ 未验证「域名待验证」/ 失败「域名验证失败」) */
can_set_cert_reason?: string
/** 域名验证状态(0 未验证 / 1 已验证 / 2 验证失败) */
domain_status?: number
[key: string]: unknown
}
/** frontConfig.saveCert 入参:域名不再作为入参(一律取库内已设置并验证通过的 domain) */
export type FrontConfigSaveCertParams = {
/** 证书 PEM 文本(必填 ≤65536,须可解析 X.509、未过期且 SAN/CN 覆盖库内 domain) */
pem: string
/** 私钥 PEM 文本(必填 ≤65536,须与 pem 成对,SPKI 公钥指纹比对) */
key: string
}
/**
* 按域名拉取仓库前端公开配置(公共接口:免登录、免鉴权、免权限)。
* 仅放行已验证域名(查库条件 domain + domain_status=1):未验证/验证失败的域名一律按未配置返回 404「域名未配置」。
* 未登记/未验证域名属预期分支,**静默失败**(silentError,不弹全局错误提示),由调用方回退默认品牌。
* Redis 缓存 front:config:domain:{domain},命中 TTL 600s;未登记域名写空缓存 60s 防穿透。
*/
export function frontConfigGetByDomain(data: {
/** 待查询域名(必填,≤100 字符) */
domain: string
}): Promise<FrontConfigPublicItem & { code?: number; message?: string }> {
return postFrontConfig<FrontConfigPublicItem>('frontConfig.getByDomain', data, { silentError: true })
}
/** 查询当前仓库前端独立部署品牌配置(settings 页回显;需登录、仅仓库主体可调用;未配置返回默认空值,不 404) */
export function frontConfigGetInfo(): Promise<FrontConfigInfo & { code?: number; message?: string }> {
return postFrontConfig<FrontConfigInfo>('frontConfig.getInfo')
}
/** 保存当前仓库品牌配置(upsert 部分更新;仅受理 title/logo_url/favicon_url/login_bg_url/theme;保存即重置同步状态并清公共缓存) */
export function frontConfigSaveInfo(
data: FrontConfigSaveInfoParams = {}
): Promise<FrontConfigInfo & { code?: number; message?: string }> {
return postFrontConfig<FrontConfigInfo>('frontConfig.saveInfo', data)
}
/** 查询当前仓库域名与 DNS TXT 验证状态(settings 页回显;未设置过返回默认空值,不 404) */
export function frontConfigGetDomain(): Promise<FrontConfigDomain & { code?: number; message?: string }> {
return postFrontConfig<FrontConfigDomain>('frontConfig.getDomain')
}
/**
* 设置或变更当前仓库域名(**两阶段切换的第一阶段**):只登记「待验证域名」pending_domain 并下发一次性
* DNS TXT 校验记录,**不直接改动生效域名**,也不影响既有证书与同步状态——切换期间旧域名页面与
* frontConfig.getByDomain 公共拉取仍正常可用。
* 分支:入参 == 生效域名 → 取消待切换(清空 pending 组);入参 == 现有 pending_domain → 幂等短路/补发校验码;
* 其它 → 查重(其他仓库已占用返回 409)后写入 pending 组。
* TXT 校验通过需再调 frontConfig.checkDomain(或等定时任务),届时 pending_domain 才提升为生效域名,
* **并会清空证书 5 列与重置同步状态**(切换完成后必须重新上传证书)。
* 响应口径同 frontConfig.getDomain(16 字段)。
*/
export function frontConfigSetDomain(data: {
/** 待验证域名(必填,trim 后非空、≤100 字符、全局唯一、形态校验;统一转小写存储) */
domain: string
}): Promise<FrontConfigDomain & { code?: number; message?: string }> {
return postFrontConfig<FrontConfigDomain>('frontConfig.setDomain', data)
}
/**
* 主动校验域名 TXT 归属记录并回写库(两条路径,响应均同 getDomain 的 16 字段 + 本次校验结果):
* ①存在 pending_domain → 校验待验证域名,通过则提升为生效域名(清空 pending 组、旧域名进下线队列、
* 清空证书并重置同步状态)并清理新旧两个公共缓存;不通过仅累加 pending_attempts 并写 pending_last_error。
* ②无 pending_domain → 保持升级前口径:生效域名已验证则短路返回 verified=true(不写库);
* 未设置域名返回 400「请先设置域名」;历史未验证行沿用生效域名的 domain_verify_* 校验并回写。
*/
export function frontConfigCheckDomain(): Promise<
FrontConfigCheckDomainResult & { code?: number; message?: string }
> {
return postFrontConfig<FrontConfigCheckDomainResult>('frontConfig.checkDomain')
}
/** 查询当前仓库证书配置(settings 页回显;含 cert_pem/key_pem 原文与 can_set_cert/can_set_cert_reason/domain_status) */
export function frontConfigGetCert(): Promise<FrontConfigCert & { code?: number; message?: string }> {
return postFrontConfig<FrontConfigCert>('frontConfig.getCert')
}
/** 上传当前仓库证书(域名取库内已验证 domain,不再传参;无域名/未验证返回 400,证书不合法统一 400「证书不合法」) */
export function frontConfigSaveCert(
data: FrontConfigSaveCertParams
): Promise<FrontConfigCert & { code?: number; message?: string }> {
return postFrontConfig<FrontConfigCert>('frontConfig.saveCert', data)
}
export const frontConfig = {
getByDomain: frontConfigGetByDomain,
getInfo: frontConfigGetInfo,
saveInfo: frontConfigSaveInfo,
getDomain: frontConfigGetDomain,
setDomain: frontConfigSetDomain,
checkDomain: frontConfigCheckDomain,
getCert: frontConfigGetCert,
saveCert: frontConfigSaveCert
}

View File

@ -0,0 +1,592 @@
import type { AxiosRequestConfig } from 'axios'
import request from '@/utils/request'
const v = '1.0'
// ============================================================
// 站内信 v2 可配置回信引擎 —— 配置管理 API(inbox.v2.*)
//
// 说明:
// - 所有接口经 /system 网关,method 形如 inbox.v2.type.list;
// - warehouseId 由服务端从登录上下文注入,前端不传;
// - 系统预设数据(is_system=1 / warehouse_id=null)只读,写操作会被后端拒绝;
// - 写操作后端会自动失效该仓库 v2 配置缓存(TTL 300s),无需前端额外处理。
// ============================================================
/** /system 网关统一响应结构 */
export interface InboxV2Response<T = unknown> {
flag?: string
code?: number
message?: string
data?: T
timestamp?: number
}
/** 分页信息 */
export interface InboxV2Pagination {
page: number
pageSize: number
total: number
}
/**
* method → 响应业务数据类型映射。
*
* 调用处直接写 method 字面量(如 `call('inbox.v2.type.list', data)`),
* 泛型由该字面量从本映射自动推断,因此调用处**不再写显式泛型实参**;
* 这样既保留类型安全,也让接口清单脚本能静态识别 method 与文件的归属关系。
*/
interface InboxV2MethodMap {
'inbox.v2.type.list': InboxV2TypeListData
'inbox.v2.type.create': { id: number; message: string }
'inbox.v2.type.update': { message: string }
'inbox.v2.type.delete': { message: string }
'inbox.v2.subType.list': InboxV2SubTypeListData
'inbox.v2.subType.create': { id: number; message: string }
'inbox.v2.subType.update': { message: string }
'inbox.v2.subType.delete': { message: string }
'inbox.v2.keyword.list': InboxV2KeywordListData
'inbox.v2.keyword.create': { id: number; message: string }
'inbox.v2.keyword.update': { message: string }
'inbox.v2.keyword.delete': { message: string }
'inbox.v2.numberRule.list': { list: InboxV2NumberRuleItem[] }
'inbox.v2.function.list': { list: InboxV2FunctionItem[] }
'inbox.v2.function.update': { message: string }
'inbox.v2.reply.merged': InboxV2ReplyMergedData
'inbox.v2.reply.list': InboxV2ReplyListData
'inbox.v2.reply.save': InboxV2ReplySaveResult
'inbox.v2.reply.restore': { message: string }
'inbox.v2.reply.create': { id: number; message: string }
'inbox.v2.reply.update': { message: string }
'inbox.v2.reply.delete': { message: string }
'inbox.v2.relation.function.list': { list: InboxV2SubTypeFunctionItem[] }
'inbox.v2.relation.function.set': { message: string }
'inbox.v2.relation.rule.list': { list: InboxV2SubTypeRuleItem[] }
'inbox.v2.relation.rule.set': { message: string }
'inbox.v2.relation.group.list': { list: InboxV2SubTypeGroupItem[] }
'inbox.v2.relation.group.set': { message: string }
}
function call<M extends keyof InboxV2MethodMap>(
method: M,
data?: Record<string, unknown>
): Promise<InboxV2Response<InboxV2MethodMap[M]>> {
return request({
url: '/system',
method: 'post',
params: {
method,
v,
timestamp: Date.now(),
},
data: data ?? {},
// 自定义标记:request 内部据此走 /system 网关(非 axios 标准字段)
isSystemApi: true,
} as AxiosRequestConfig) as unknown as Promise<InboxV2Response<InboxV2MethodMap[M]>>
}
/**
* 取网关返回的业务数据(服务层返回值)。
* 兼容 data 为空时回退到顶层(便于容错)。
*/
export function unwrapInboxV2Data<T>(res: InboxV2Response<T> | null | undefined): T | null {
if (!res) return null
if (res.data !== null && res.data !== undefined) return res.data
return (res as unknown as T) ?? null
}
// ─────────────────────────── 类型 ───────────────────────────
/** 售后类型(wms_after_sale_type) */
export interface InboxV2TypeItem {
id: number
/** NULL=系统级(全部仓库可见且只读);非 NULL=该仓库自定义 */
warehouse_id: number | null
/** 类型编码(order/receiving/entry/stockout 或仓库自定义编码) */
type: string
name: string
is_system: number
is_enabled: number
sort_order: number
created_at?: string
updated_at?: string
}
export interface InboxV2TypeListParams {
isEnabled?: number
page?: number
pageSize?: number
}
export interface InboxV2TypeListData {
list: InboxV2TypeItem[]
pagination: InboxV2Pagination
}
/** 类型列表(系统级 + 本仓库自定义,分页) */
export function inboxV2TypeList(data: InboxV2TypeListParams = {}) {
return call('inbox.v2.type.list', data as Record<string, unknown>)
}
export interface InboxV2TypeCreateParams {
/** 类型编码(≤20),仓库内唯一 */
type: string
/** 类型名称(≤50) */
name: string
sortOrder?: number
}
/** 创建仓库自定义类型 */
export function inboxV2TypeCreate(data: InboxV2TypeCreateParams) {
return call('inbox.v2.type.create', data as unknown as Record<string, unknown>)
}
export interface InboxV2TypeUpdateParams {
id: number
name?: string
isEnabled?: number
sortOrder?: number
}
/** 更新仓库自定义类型(系统预设拒绝修改) */
export function inboxV2TypeUpdate(data: InboxV2TypeUpdateParams) {
return call('inbox.v2.type.update', data as unknown as Record<string, unknown>)
}
/** 删除仓库自定义类型(有子类型引用时拒绝) */
export function inboxV2TypeDelete(id: number) {
return call('inbox.v2.type.delete', { id })
}
// ─────────────────────────── 子类型 ───────────────────────────
/** 售后子类型(wms_after_sale_sub_type) */
export interface InboxV2SubTypeItem {
id: number
warehouse_id: number | null
/** 所属类型编码 */
type: string
/** 子类型编码 */
sub_type: string
name: string
is_system: number
is_enabled: number
sort_order: number
created_at?: string
updated_at?: string
}
export interface InboxV2SubTypeListParams {
type?: string
isEnabled?: number
page?: number
pageSize?: number
}
export interface InboxV2SubTypeListData {
list: InboxV2SubTypeItem[]
pagination: InboxV2Pagination
}
/** 子类型列表(系统级 + 本仓库自定义,分页) */
export function inboxV2SubTypeList(data: InboxV2SubTypeListParams = {}) {
return call('inbox.v2.subType.list', data as Record<string, unknown>)
}
export interface InboxV2SubTypeCreateParams {
/** 所属类型编码(系统级类型或本仓库自定义类型均可) */
type: string
/** 子类型编码(≤50) */
subType: string
/** 子类型名称(≤50) */
name: string
sortOrder?: number
}
/** 创建仓库自定义子类型 */
export function inboxV2SubTypeCreate(data: InboxV2SubTypeCreateParams) {
return call('inbox.v2.subType.create', data as unknown as Record<string, unknown>)
}
export interface InboxV2SubTypeUpdateParams {
id: number
name?: string
isEnabled?: number
sortOrder?: number
}
/** 更新仓库自定义子类型(系统预设拒绝修改) */
export function inboxV2SubTypeUpdate(data: InboxV2SubTypeUpdateParams) {
return call('inbox.v2.subType.update', data as unknown as Record<string, unknown>)
}
/** 删除仓库自定义子类型(有关联引用时拒绝) */
export function inboxV2SubTypeDelete(id: number) {
return call('inbox.v2.subType.delete', { id })
}
// ─────────────────────────── 关键词 ───────────────────────────
/** 关键词(wms_after_sale_keyword) */
export interface InboxV2KeywordItem {
id: number
warehouse_id: number | null
sub_type_id: number
keyword: string
is_system: number
is_enabled: number
sort_order: number
created_at?: string
updated_at?: string
}
export interface InboxV2KeywordListParams {
subTypeId?: number
isEnabled?: number
page?: number
pageSize?: number
}
export interface InboxV2KeywordListData {
list: InboxV2KeywordItem[]
pagination: InboxV2Pagination
}
/** 关键词列表 */
export function inboxV2KeywordList(data: InboxV2KeywordListParams = {}) {
return call('inbox.v2.keyword.list', data as Record<string, unknown>)
}
export interface InboxV2KeywordCreateParams {
subTypeId: number
/** 关键词(≤100),仓库内唯一 */
keyword: string
sortOrder?: number
}
/** 创建仓库自定义关键词 */
export function inboxV2KeywordCreate(data: InboxV2KeywordCreateParams) {
return call('inbox.v2.keyword.create', data as unknown as Record<string, unknown>)
}
export interface InboxV2KeywordUpdateParams {
id: number
keyword?: string
subTypeId?: number
isEnabled?: number
sortOrder?: number
}
/** 更新仓库自定义关键词(系统预设拒绝修改) */
export function inboxV2KeywordUpdate(data: InboxV2KeywordUpdateParams) {
return call('inbox.v2.keyword.update', data as unknown as Record<string, unknown>)
}
/** 删除仓库自定义关键词 */
export function inboxV2KeywordDelete(id: number) {
return call('inbox.v2.keyword.delete', { id })
}
// ─────────────────────────── 取号规则(全局只读) ───────────────────────────
/** 取号规则(wms_inbox_number_rule,全局资源,仓库侧只读) */
export interface InboxV2NumberRuleItem {
id: number
/** 规则名称 */
name: string
/** 提取目标类型:waybill_no/receiving_no/entry_order_no/stockout_no/order_no/source_order_codes/express_name/plate_no */
target: string
/** 取号正则(JS 正则源字符串) */
regexp: string
sort_order: number
}
/** 取号规则列表(只读,供关联配置选择) */
export function inboxV2NumberRuleList() {
return call('inbox.v2.numberRule.list')
}
// ─────────────────────────── 处理函数 ───────────────────────────
/** 处理函数(wms_after_sale_function,代码同步权威) */
export interface InboxV2FunctionItem {
id: number
function_code: string
name: string
description?: string | null
is_enabled: number
sort_order: number
/** 是否存在于代码注册表(false 表示已下线) */
in_registry?: boolean | null
}
export interface InboxV2FunctionListParams {
isEnabled?: number
keyword?: string
}
/** 处理函数列表 */
export function inboxV2FunctionList(data: InboxV2FunctionListParams = {}) {
return call('inbox.v2.function.list', data as Record<string, unknown>)
}
export interface InboxV2FunctionUpdateParams {
id: number
isEnabled?: number
sortOrder?: number
}
/**
* 更新函数启用开关 / 排序(function_code 不可改)。
*
* 注意:函数是否启用**不在「自动回复设置」页面做配置**(由后台代码注册表/运维控制),
* 本方法仅保留后端接口映射以备他用,页面侧不再调用。
*/
export function inboxV2FunctionUpdate(data: InboxV2FunctionUpdateParams) {
return call('inbox.v2.function.update', data as unknown as Record<string, unknown>)
}
// ─────────────────────────── 回复配置 ───────────────────────────
/** 回复配置(wms_after_sale_reply) */
export interface InboxV2ReplyItem {
id: number
/** NULL=系统级回复(只读兜底);非 NULL=仓库级回复(整条覆盖系统级) */
warehouse_id: number | null
sub_type_id: number
reply: string
/** 1=命中后回复,0=静默(不回复消息) */
is_reply: number
/** 1=执行函数并登记工单(默认),0=函数照常执行但跳过工单登记 */
create_work_order: number
/** 未取到单据号时的引导语 */
no_number_hint: string | null
is_enabled: number
created_at?: string
updated_at?: string
}
export interface InboxV2ReplyListParams {
subTypeId?: number
isEnabled?: number
page?: number
pageSize?: number
}
export interface InboxV2ReplyListData {
list: InboxV2ReplyItem[]
pagination: InboxV2Pagination
}
/** 合并后的生效回复配置(inbox.v2.reply.merged;仓库级整条覆盖系统级,每子类型一条) */
export interface InboxV2MergedReplyItem {
/** 生效行 id(自定义时为仓库级行 id,继承时为系统级行 id) */
id: number
sub_type_id: number
type: string
sub_type: string
sub_type_name: string
/** 自定义时为本仓库 id;继承系统级时为 null */
warehouse_id: number | null
/** 1=本仓库自定义,0=继承系统级 */
is_custom: number
reply: string
is_reply: number
create_work_order: number
/** 无引导语时为空串 */
no_number_hint: string
created_at?: string
updated_at?: string
}
export interface InboxV2ReplyMergedParams {
/** 只看某子类型 */
subTypeId?: number
}
/** 合并后的生效配置列表(全量,无分页) */
export interface InboxV2ReplyMergedData {
/** 每个子类型一条生效配置 */
merged: InboxV2MergedReplyItem[]
total: number
}
/**
* 回复配置列表(合并后的**生效配置**,推荐接口)。
* 每个子类型只返回一条:本仓库有自定义则整条覆盖系统级,读取口径与 v2 引擎一致,前端无需自行合并。
* 返回结构为 `{ merged, total }`,不分页。
*/
export function inboxV2ReplyMerged(data: InboxV2ReplyMergedParams = {}) {
return call('inbox.v2.reply.merged', data as Record<string, unknown>)
}
/**
* 回复配置原始行列表(系统级 + 本仓库级,未合并)。
* @deprecated 页面展示用 {@link inboxV2ReplyMerged}(合并后的生效配置);本接口保留供排查原始行使用。
*/
export function inboxV2ReplyList(data: InboxV2ReplyListParams = {}) {
return call('inbox.v2.reply.list', data as Record<string, unknown>)
}
/**
* 保存(upsert)仓库级回复配置参数 —— **按传入字段保存,未传字段保持原值**;
* 无仓库级配置时按传入字段创建(默认 reply 空、isReply=1、createWorkOrder=1、isEnabled=1)。
* 仓库级与系统级为整条覆盖关系,未配置或停用时回退系统级。
* 注意:createWorkOrder=0 是「函数照常执行、仅跳过工单登记」,不是不执行函数。
*/
export interface InboxV2ReplySaveParams {
subTypeId: number
/** 回复文案,支持 {keyword}/{express}/{sub_type_name}/{back_text} 占位符(≤2000) */
reply?: string
/** 1 回复 0 不回复 */
isReply?: number
/** 1 登记工单 0 不登记工单 */
createWorkOrder?: number
noNumberHint?: string
}
/** 保存结果 */
export interface InboxV2ReplySaveResult {
/** 已有仓库级行的 ID;新建时为 null */
id: number | null
message: string
}
/** 保存仓库级回复配置(upsert,推荐接口;未传字段保持原值) */
export function inboxV2ReplySave(data: InboxV2ReplySaveParams) {
return call('inbox.v2.reply.save', data as unknown as Record<string, unknown>)
}
/**
* 还原仓库级回复配置:删除仓库级行,回退系统级配置(幂等)。
* 无仓库级配置时同样返回成功(message 为「…已是系统级配置」)。
*/
export function inboxV2ReplyRestore(subTypeId: number) {
return call('inbox.v2.reply.restore', { subTypeId })
}
/** @deprecated 见 {@link InboxV2ReplySaveParams} */
export interface InboxV2ReplyCreateParams {
subTypeId: number
/** 回复文案,支持 {keyword}/{express}/{sub_type_name}/{back_text} 占位符 */
reply: string
/** 1 回复 0 静默,默认 1 */
isReply?: number
/** 1 执行函数并登记工单(默认)0 函数照常执行但跳过工单登记 */
createWorkOrder?: number
noNumberHint?: string
isEnabled?: number
}
/**
* 创建仓库级回复配置(每子类型仅一条)。
* @deprecated 后端保留的兼容接口,页面统一改用 {@link inboxV2ReplySave}(upsert)。
*/
export function inboxV2ReplyCreate(data: InboxV2ReplyCreateParams) {
return call('inbox.v2.reply.create', data as unknown as Record<string, unknown>)
}
export interface InboxV2ReplyUpdateParams {
id: number
reply?: string
isReply?: number
createWorkOrder?: number
noNumberHint?: string
isEnabled?: number
}
/**
* 更新仓库级回复配置(系统级回复只读)。
* @deprecated 后端保留的兼容接口,页面统一改用 {@link inboxV2ReplySave}(upsert)。
*/
export function inboxV2ReplyUpdate(data: InboxV2ReplyUpdateParams) {
return call('inbox.v2.reply.update', data as unknown as Record<string, unknown>)
}
/**
* 删除仓库级回复配置(删除后回退系统级)。
* @deprecated 后端保留的兼容接口,页面统一改用 {@link inboxV2ReplyRestore}(幂等还原)。
*/
export function inboxV2ReplyDelete(id: number) {
return call('inbox.v2.reply.delete', { id })
}
// ─────────────────────────── 子类型关联关系 ───────────────────────────
// set 语义:全量替换(items 传全量数组)
/** 子类型-处理函数关联行(wms_after_sale_sub_type_function) */
export interface InboxV2SubTypeFunctionItem {
id: number
sub_type_id: number
function_id: number
sort_order: number
}
/** 子类型-取号规则关联行(wms_after_sale_sub_type_rule) */
export interface InboxV2SubTypeRuleItem {
id: number
sub_type_id: number
number_rule_id: number
sort_order: number
}
/** 子类型-群白名单关联行(wms_after_sale_sub_type_group) */
export interface InboxV2SubTypeGroupItem {
id: number
sub_type_id: number
/** 群类型:store / warehouse / express */
group_type: string
/** 群子类型编码 */
sub_group: string
/** 1=系统预设关联(不可删);0=自定义 */
is_system: number
sort_order: number
}
/** 子类型已关联的处理函数列表 */
export function inboxV2RelationFunctionList(subTypeId: number) {
return call('inbox.v2.relation.function.list', { subTypeId })
}
/** 全量替换子类型的处理函数关联 */
export function inboxV2RelationFunctionSet(
subTypeId: number,
items: Array<{ functionId: number; sortOrder?: number }>
) {
return call('inbox.v2.relation.function.set', {
subTypeId,
items,
} as unknown as Record<string, unknown>)
}
/** 子类型已关联的取号规则列表 */
export function inboxV2RelationRuleList(subTypeId: number) {
return call('inbox.v2.relation.rule.list', { subTypeId })
}
/** 全量替换子类型的取号规则关联 */
export function inboxV2RelationRuleSet(
subTypeId: number,
items: Array<{ ruleId: number; sortOrder?: number }>
) {
return call('inbox.v2.relation.rule.set', {
subTypeId,
items,
} as unknown as Record<string, unknown>)
}
/** 子类型已关联的群白名单列表 */
export function inboxV2RelationGroupList(subTypeId: number) {
return call('inbox.v2.relation.group.list', { subTypeId })
}
/** 替换子类型的群白名单(系统预设行后端自动保留) */
export function inboxV2RelationGroupSet(
subTypeId: number,
items: Array<{ groupType: string; subGroup: string; sortOrder?: number }>
) {
return call('inbox.v2.relation.group.set', {
subTypeId,
items,
} as unknown as Record<string, unknown>)
}

312
src/api/inbox/inbox.ts Normal file
View File

@ -0,0 +1,312 @@
import request from '@/utils/request'
const v = '1.0'
// ============================================================
// 站内信模块 API
// ============================================================
/** 站内信列表查询参数(对齐 inbox.message.list 接口文档,扁平传参) */
export interface InboxListParams {
pagination?: { page?: number; pageSize?: number }
storeId?: string
groupId?: string
groupName?: string
userName?: string
content?: string
sourceType?: string
direction?: string
pushStatus?: number
startDate?: string
endDate?: string
}
/** 站内信消息列表(inbox.message.list) */
export function inboxList(data: InboxListParams = {}) {
return request({
url: '/system',
method: 'post',
params: {
method: 'inbox.message.list',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/** 站内信消息详情(inbox.message.detail) */
export function inboxDetail(id: number) {
return request({
url: '/system',
method: 'post',
params: {
method: 'inbox.message.detail',
v,
timestamp: Date.now()
},
data: { id },
isSystemApi: true
} as any)
}
/** 站内信对话链查询(inbox.message.thread) */
export function inboxThread(id: number) {
return request({
url: '/system',
method: 'post',
params: {
method: 'inbox.message.thread',
v,
timestamp: Date.now()
},
data: { id },
isSystemApi: true
} as any)
}
/** 站内信回信参数 */
export interface InboxReplyParams {
parentId: number // 原消息ID(回信指向的原消息)
targetChannel: string // 目标渠道:wecom / dingtalk / feishu / warehouse_api / webhook
targetType?: string // 目标类型:im / api / webhook,默认继承原消息的 target_type
extData?: Record<string, unknown> // 透传数据,默认继承原消息的 ext_data
flags?: Record<string, unknown> // 处理标记
}
/** 系统回信(inbox.message.reply) */
export function inboxReply(data: InboxReplyParams) {
return request({
url: '/system',
method: 'post',
params: {
method: 'inbox.message.reply',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/** 手动重推失败消息(inbox.message.retry) */
export function inboxRetry(id: number) {
return request({
url: '/system',
method: 'post',
params: {
method: 'inbox.message.retry',
v,
timestamp: Date.now()
},
data: { id },
isSystemApi: true
} as any)
}
/** 站内信推送统计(inbox.message.stats) */
export function inboxStats(direction?: string) {
return request({
url: '/system',
method: 'post',
params: {
method: 'inbox.message.stats',
v,
timestamp: Date.now()
},
data: direction !== undefined ? { direction } : {},
isSystemApi: true
} as any)
}
/** 生成货主绑群码参数 */
export interface InboxBindCodeParams {
storeId: number // 货主ID
subType?: string // 群子类型编码:after_sales(售后) / finance(财务) / receiving(收货)
}
/** 生成货主绑群码(inbox.bindCode) */
export function inboxBindCode(data: InboxBindCodeParams) {
return request({
url: '/system',
method: 'post',
params: {
method: 'inbox.bindCode',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
// ============================================================
// 群组管理 API
// ============================================================
/** 群组列表查询参数 */
export interface InboxGroupListParams {
groupType?: string // 群类型筛选:store(货主) / warehouse(仓库) / express(快递)
keyword?: string // 群名称模糊搜索
page?: number // 页码,默认1
pageSize?: number // 每页条数,默认20,最大100
}
/** 拉取当前仓库的群列表(inbox.group.list) */
export function inboxGroupList(data: InboxGroupListParams = {}) {
return request({
url: '/system',
method: 'post',
params: {
method: 'inbox.group.list',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/** 禁用/解禁群参数 */
export interface InboxGroupDisableParams {
id: number // 群记录主键ID
isBlocked?: number // 是否禁用:1=禁用 0=启用,默认1
}
/** 禁用或解禁群(inbox.group.disable) */
export function inboxGroupDisable(data: InboxGroupDisableParams) {
return request({
url: '/system',
method: 'post',
params: {
method: 'inbox.group.disable',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/** 修改群信息参数 */
export interface InboxGroupUpdateParams {
id: number // 群记录主键ID
groupType?: string // 群类型:store(货主) / warehouse(仓库) / express(快递)
subType?: string // 群子类型,值取决于groupType。store→after_sales/finance/receiving。warehouse→receiving/production/stockout/finance/all/customer_service/exception。express→pickup/after_sales
storeId?: number // 关联货主ID
expressInterfaces?: number[] // 快递接口ID数组,仅groupType=express时生效
systemExpressCode?: string // 系统快递编码,groupType=express时必填。需校验wms_express.code存在
aiEnabled?: number // 是否启用AI自动回复: 0=关闭 1=开启,默认1(所有群类型均支持,用于灰度测试)
templateReplyEnabled?: number // 是否启用模板消息回复: 0=关闭(普通文本回复) 1=开启(模板消息回复),默认0(所有群类型均支持,独立于aiEnabled)
}
/** 修改群信息(inbox.group.update) */
export function inboxGroupUpdate(data: InboxGroupUpdateParams) {
return request({
url: '/system',
method: 'post',
params: {
method: 'inbox.group.update',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/** 清空群类型配置参数 */
export interface InboxGroupResetParams {
id: number // 群记录主键ID
}
/** 清空群类型配置(inbox.group.reset) */
export function inboxGroupReset(data: InboxGroupResetParams) {
return request({
url: '/system',
method: 'post',
params: {
method: 'inbox.group.reset',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/** 按群拉取消息列表参数 */
export interface InboxGroupMessagesParams {
groupId: string // 群ID(必填)
direction?: string // 消息方向筛选:inbound(入站) / outbound(出站)
keyword?: string // 关键词搜索(ext_id / content)
page?: number // 页码,默认1
pageSize?: number // 每页条数,默认20,最大200
}
/** 按群拉取消息列表(inbox.group.messages) */
export function inboxGroupMessages(data: InboxGroupMessagesParams) {
return request({
url: '/system',
method: 'post',
params: {
method: 'inbox.group.messages',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/** 群快速查询参数(下拉选择用,不分页) */
export interface InboxGroupQuickListParams {
/** 货主ID(可选,>0 时按货主过滤;不传返回所有货主的群) */
store_id?: number | string
/** 仓库ID(可选,>0 时按仓库过滤;不传返回所有仓库的群;与 store_id 可单独传或同时传 AND) */
warehouse_id?: number | string
keyword?: string // 关键词,模糊匹配群名称与外部群ID
groupType?: string // 群类型筛选:store(货主) / warehouse(仓库) / express(快递)
limit?: number // 返回条数上限,默认20,最大100(无分页)
}
/** 群快速查询(inbox.group.quickList) */
export function inboxGroupQuickList(data: InboxGroupQuickListParams = {}) {
return request({
url: '/system',
method: 'post',
params: {
method: 'inbox.group.quickList',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/** 查询群成员参数(下拉选择用) */
export interface InboxGroupMembersParams {
/** 群记录主键ID数组(wms_inbox_group.id,必填,非空;每个元素为正整数,支持数字或可解析数字字符串) */
groupIds: Array<number | string>
/** 关键词,模糊匹配 user_name(用户名)与 user_id(用户ID) */
keyword?: string
/** 返回条数上限,默认20,最大100(无分页) */
limit?: number
}
/** 查询多个群的成员列表(inbox.group.members) */
export function inboxGroupMembers(data: InboxGroupMembersParams) {
return request({
url: '/system',
method: 'post',
params: {
method: 'inbox.group.members',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}

View File

@ -1,137 +0,0 @@
import request from '@/utils/request'
export function fastWhereTree(type:any) {
return request({
url: '/system',
method: 'post',
params: {
method: 'index.fastWhereTree',
v: '1.0',
timestamp: new Date().getTime()
},
data: {type},
isSystemApi: true
} as any)
}
export function loadStores(type:any) {
return request({
url: '/system',
method: 'post',
params: {
method: 'index.loadStores',
v: '1.0',
timestamp: new Date().getTime()
},
data: {type},
isSystemApi: true
} as any)
}
export function getCOSUploadConfig(data:any){
return request({
url: '/system',
method: 'post',
params: {
method: 'index.getCOSUploadConfig',
v: '1.0',
timestamp: new Date().getTime()
},
data: {data},
isSystemApi: true
} as any)
}
export function getImages(data:any){
return request({
url: '/system',
method: 'post',
params: {
method: 'index.getImages',
v: '1.0',
timestamp: new Date().getTime()
},
data: data,
isSystemApi: true
} as any)
}
export function uploadSuccessNotify(data:any){
return request({
url: '/system',
method: 'post',
params: {
method: 'index.uploadSuccessNotify',
v: '1.0',
timestamp: new Date().getTime()
},
data: data,
isSystemApi: true
} as any)
}
export function ReferenceFile(data:any){
return request({
url: '/system',
method: 'post',
params: {
method: 'index.ReferenceFile',
v: '1.0',
timestamp: new Date().getTime()
},
data: data,
isSystemApi: true
} as any)
}
export function getMessageDetail(data:any){
return request({
url: '/system',
method: 'post',
params: {
method: 'index.getMessageDetail',
v: '1.0',
timestamp: new Date().getTime()
},
data: data,
isSystemApi: true
} as any)
}
export function getI18nMessage(data:any){
return request({
url: '/system',
method: 'post',
params: {
method: 'index.getI18nMessage',
v: '1.0',
timestamp: new Date().getTime()
},
data: data,
isSystemApi: true
} as any)
}
export function putI18nCollect(data:any){
return request({
url: '/system',
method: 'post',
params: {
method: 'index.putI18nCollect',
v: '1.0',
timestamp: new Date().getTime()
},
data: data,
isSystemApi: true
} as any)
}
export function getExpressList(){
return request({
url: '/system',
method: 'post',
params: {
method: 'index.getExpressList',
v: '1.0',
timestamp: new Date().getTime()
},
isSystemApi: true
} as any)
}

768
src/api/index/index.ts Normal file
View File

@ -0,0 +1,768 @@
import request from '@/utils/request'
export function fastWhereTree(type:any) {
return request({
url: '/system',
method: 'post',
params: {
method: 'index.fastWhereTree',
v: '1.0',
timestamp: new Date().getTime()
},
data: {type},
isSystemApi: true
} as any)
}
export function loadStores() {
return request({
url: '/system',
method: 'post',
params: {
method: 'index.loadStores',
v: '1.0',
timestamp: new Date().getTime()
},
data: {},
isSystemApi: true
} as any)
}
/** 查询仓库列表(无需鉴权,需登录) */
export function loadWarehouses(data?: Record<string, unknown>) {
return request({
url: '/system',
method: 'post',
params: {
method: 'index.loadWarehouses',
v: '1.0',
timestamp: new Date().getTime()
},
data: data ?? {},
isSystemApi: true
} as any)
}
/** 当前仓库下的快递接口下拉列表,可传入 systemExpressCode 过滤 */
export function loadExpressInterfaces(data?: { systemExpressCode?: string }) {
return request({
url: '/system',
method: 'post',
params: {
method: 'index.loadExpressInterfaces',
v: '1.0',
timestamp: new Date().getTime()
},
data: data ?? {},
isSystemApi: true
} as any)
}
export function getCOSUploadConfig(data:any){
return request({
url: '/system',
method: 'post',
params: {
method: 'index.getCOSUploadConfig',
v: '1.0',
timestamp: new Date().getTime()
},
data: {data},
isSystemApi: true
} as any)
}
export function getImages(data:any){
return request({
url: '/system',
method: 'post',
params: {
method: 'index.getImages',
v: '1.0',
timestamp: new Date().getTime()
},
data: data,
isSystemApi: true
} as any)
}
export function uploadSuccessNotify(data:any){
return request({
url: '/system',
method: 'post',
params: {
method: 'index.uploadSuccessNotify',
v: '1.0',
timestamp: new Date().getTime()
},
data: data,
isSystemApi: true
} as any)
}
export function ReferenceFile(data:any){
return request({
url: '/system',
method: 'post',
params: {
method: 'index.ReferenceFile',
v: '1.0',
timestamp: new Date().getTime()
},
data: data,
isSystemApi: true
} as any)
}
export function getMessageDetail(data:any){
return request({
url: '/system',
method: 'post',
params: {
method: 'index.getMessageDetail',
v: '1.0',
timestamp: new Date().getTime()
},
data: data,
isSystemApi: true
} as any)
}
/** 生成 IM 单点登录一次性 code(有效期 5 分钟) */
export function loginToIm(data?: Record<string, unknown>) {
return request({
url: '/system',
method: 'post',
params: {
method: 'index.loginToIm',
v: '1.0',
timestamp: new Date().getTime()
},
data: data ?? {},
isSystemApi: true
} as any)
}
export function getI18nMessage(data:any){
return request({
url: '/system',
method: 'post',
params: {
method: 'index.getI18nMessage',
v: '1.0',
timestamp: new Date().getTime()
},
data: data,
isSystemApi: true
} as any)
}
export function putI18nCollect(data:any){
return request({
url: '/system',
method: 'post',
params: {
method: 'index.putI18nCollect',
v: '1.0',
timestamp: new Date().getTime()
},
data: data,
isSystemApi: true
} as any)
}
export type GetExpressListParams = {
systemOnly?: boolean | number | string
express_code?: string
}
export function getExpressList(data?: GetExpressListParams) {
return request({
url: '/system',
method: 'post',
params: {
method: 'index.getExpressList',
v: '1.0',
timestamp: new Date().getTime()
},
data: data ?? {},
isSystemApi: true
} as any)
}
export function tryAutoTranslateNewKeys(data?: Record<string, unknown>) {
return request({
url: '/system',
method: 'post',
params: {
method: 'index.tryAutoTranslateNewKeys',
v: '1.0',
timestamp: new Date().getTime()
},
data: data ?? {},
isSystemApi: true
} as any)
}
export type GetPlatformListParams = {
systemOnly?: boolean | number | string
platform_code?: string
}
export function getPlatformList(data?: GetPlatformListParams) {
return request({
url: '/system',
method: 'post',
params: {
method: 'index.getPlatformList',
v: '1.0',
timestamp: new Date().getTime()
},
data: data ?? {},
isSystemApi: true
} as any)
}
export function getPrintPlatformTemplateList(data?: {
platform_code?: string
express_code: string
shopId?: string | number
shop_id?: string | number
}) {
return request({
url: '/system',
method: 'post',
params: {
method: 'index.getPrintPlatformTemplateList',
v: '1.0',
timestamp: new Date().getTime()
},
data: data ?? ({} as any),
isSystemApi: true
} as any)
}
/** 公共无参查询淘宝菜鸟标准模板列表 */
export function getCainiaoStfTemplates(data?: Record<string, unknown>) {
return request({
url: '/system',
method: 'post',
params: {
method: 'index.getCainiaoStfTemplates',
v: '1.0',
timestamp: new Date().getTime()
},
data: data ?? {},
isSystemApi: true
} as any)
}
/** 生成菠萝派授权链接(无请求参数) */
export function polyapiAuthorizeUrl(data?: Record<string, unknown>) {
return request({
url: '/system',
method: 'post',
params: {
method: 'index.polyapiAuthorizeUrl',
v: '1.0',
timestamp: new Date().getTime()
},
data: data ?? {},
isSystemApi: true
} as any)
}
/** 获取平台授权链接(当前仅支持 PDD) */
export function getPlatformOauthLink(data?: {
code?: string
platform_code?: string
platformCode?: string
}) {
return request({
url: '/system',
method: 'post',
params: {
method: 'index.getPlatformOauthLink',
v: '1.0',
timestamp: new Date().getTime()
},
data: data ?? {},
isSystemApi: true
} as any)
}
/** 获取当前登录仓库下的店铺列表(可按平台编码过滤) */
export function getShopList(data?: {
platform_code?: string
platformCode?: string
code?: string
}) {
return request({
url: '/system',
method: 'post',
params: {
method: 'index.getShopList',
v: '1.0',
timestamp: new Date().getTime()
},
data: data ?? {},
isSystemApi: true
} as any)
}
/** 快递产品类型(非 PDD 平台由服务端按 sys_express_code 匹配 wms_express_product_type 补充;PDD 平台不返回) */
export type ShopExpressProductType = {
code?: string
name?: string
[key: string]: unknown
}
/** 店铺可用快递列表项(各平台字段有差异:前端按需取值 + 索引签名兜底) */
export type ShopExpressListItem = {
/** 电子面单快递编码(淘宝系 wp_code;其次 express_code / code) */
wp_code?: string
wp_name?: string
express_code?: string
express_name?: string
code?: string
name?: string
label?: string
/** 系统快递编码(与本系统 wms_express.express_code 对齐) */
sys_express_code?: string
/** 快递公司编号(部分平台用 providerid / provider_id / providerId) */
providerid?: string | number
provider_id?: string | number
providerId?: string | number
/** 产品类型列表:**非 PDD 平台**服务端会补充;PDD 平台不返回该字段 */
product_types?: ShopExpressProductType[]
/** 签约网点/账号(含面单余量、地址、增值服务;字段随平台差异) */
accounts?: Record<string, any>[]
[key: string]: unknown
}
/**
* index.getShopExpressList 响应
*
* ⚠️ 该接口响应形如 `{ code, message, data }`(**无 flag / timestamp**),业务数据在 `data` 内。
*/
export type ShopExpressListResponse = {
/** 业务状态码,成功 200 */
code?: number
/** 业务提示信息,成功 ok */
message?: string
data?: {
/** 当前店铺ID */
shop_id?: number
/** 店铺所属平台编码(服务端已转大写) */
platform_code?: string
/** 服务端按平台收敛后的可用快递列表;未接入的平台返回空数组 */
list?: ShopExpressListItem[]
}
}
/**
* 获取指定店铺可用快递列表
*
* 入参 `shop_id` / `shopId` 二选一至少传一个(服务端按 shop_id、shopId 顺序读首个非空值)。
*/
export function getShopExpressList(data?: {
shop_id?: string | number
shopId?: string | number
}): Promise<ShopExpressListResponse> {
return request({
url: '/system',
method: 'post',
params: {
method: 'index.getShopExpressList',
v: '1.0',
timestamp: new Date().getTime()
},
data: data ?? {},
isSystemApi: true
} as any)
}
/** 快递公司产品类型列表(可选按快递公司编码筛选) */
export function getExpressProductTypeList(data?: { express_code?: string }) {
return request({
url: '/system',
method: 'post',
params: {
method: 'index.getExpressProductTypeList',
v: '1.0',
timestamp: new Date().getTime()
},
data: data ?? {},
isSystemApi: true
} as any)
}
/** 查询所有已启用的接口类型列表(无需权限,仅需登录) */
export function listInterfaceTypes() {
return request({
url: '/system',
method: 'post',
params: {
method: 'index.listInterfaceTypes',
v: '1.0',
timestamp: new Date().getTime()
},
data: {},
isSystemApi: true
} as any)
}
/** 获取奇门 ERP 应用列表(用于选择 ERP / AppKey) */
export function getQimenAppList(data?: Record<string, unknown>) {
return request({
url: '/system',
method: 'post',
params: {
method: 'index.getQimenAppList',
v: '1.0',
timestamp: new Date().getTime()
},
data: data ?? {},
isSystemApi: true
} as any)
}
export function searchSpace(data:any){
return request({
url: '/system',
method: 'post',
params: {
method: 'index.searchSpace',
v: '1.0',
timestamp: new Date().getTime()
},
data: data,
isSystemApi: true
} as any)
}
/** 按当前仓库上下文批量搜索库位(keywords 与返回 data 分组一一对应) */
export function searchSpaces(data: any) {
return request({
url: '/system',
method: 'post',
params: {
method: 'index.searchSpaces',
v: '1.0',
timestamp: new Date().getTime()
},
data: data,
isSystemApi: true
} as any)
}
export function recognizeLicensePlate(data:any){
return request({
url: '/system',
method: 'post',
params: {
method: 'index.recognizeLicensePlate',
v: '1.0',
timestamp: new Date().getTime()
},
data: data,
isSystemApi: true
} as any)
}
export function getLocationTypeList(data?: Record<string, unknown>) {
return request({
url: '/system',
method: 'post',
params: {
method: 'index.getLocationTypeList',
v: '1.0',
timestamp: new Date().getTime()
},
data: data ?? {},
isSystemApi: true
} as any)
}
export type IndexToOrderWave = {
wave_id: number
wave_no: string
order_ids: number[]
}
export type IndexToOrderParams = {
/** 运单号 */
waybill_code: string
}
export type IndexToOrderResponse = {
code?: number
message?: string
order_id?: number
waves?: IndexToOrderWave[]
data?: {
order_id?: number
waves?: IndexToOrderWave[]
}
}
/** 根据运单号快速查询订单ID及其所属波次下所有订单ID列表 */
export function toOrder(data: IndexToOrderParams): Promise<IndexToOrderResponse> {
return request({
url: '/system',
method: 'post',
params: {
method: 'index.toOrder',
v: '1.0',
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
// ============ index.uploadClientErrorLog ============
/**
* 客户端错误日志上报条目(字段命名兼容 snake_case 与 camelCase 别名)。
* ⚠️ `error_message` 与 `error_stack` **至少一项有值**,否则该条被判为无效(计入 rejected)。
*/
export type ClientErrorLogItem = {
/** 客户端类型:android/ios/web 等(表宽 32,超出截断);别名 clientType */
client_type?: string
/** 客户端版本号(表宽 64,超出截断);别名 appVersion */
app_version?: string
/** 设备唯一标识(表宽 128,超出截断);别名 deviceId */
device_id?: string
/** 操作系统版本(表宽 64,超出截断);别名 osVersion */
os_version?: string
/** 设备型号(表宽 128,超出截断);别名 deviceModel */
device_model?: string
/** 错误类型/等级(表宽 64,超出截断);别名 errorType */
error_type?: string
/** 错误信息(与 error_stack 至少一项有值;超出截断至 5000 字符);别名 errorMessage */
error_message?: string
/** 错误堆栈(与 error_message 至少一项有值;超出截断至 65535 字符);别名 errorStack */
error_stack?: string
/** 附加上下文(字符串或对象,对象序列化为 JSON 字符串;超出截断至 65535 字符) */
extra?: string | Record<string, unknown>
/** 上报幂等ID(唯一索引 uk_report_uuid;重复上报静默成功、不产生重复行;缺失时服务端生成 srv-{uuid},不保证幂等) */
report_uuid?: string
/** 客户端错误发生时间(仅参考,不作为记录时间):毫秒/秒时间戳或日期字符串,非法值存 null */
client_time?: string | number
}
/**
* index.uploadClientErrorLog 入参:支持三种形态(三选一)
* - 单条对象:`{ client_type, error_message, ... }`
* - 数组:`[ { ... }, { ... } ]`
* - 包裹形态:`{ logs: [ { ... }, ... ] }`
* 单次最多 50 条(超出报 400)。
*/
export type ClientErrorLogUploadParams =
| ClientErrorLogItem
| ClientErrorLogItem[]
| { logs: ClientErrorLogItem[] }
/** index.uploadClientErrorLog 响应(方法级错误为 HTTP 200 + flag=failure,code=400/500) */
export type ClientErrorLogUploadResponse = {
/** 结果标记:success */
flag?: string
/** 业务码:200 成功;400 入参形状错误/空数据/超 50 条/全部条目无效;500 查询或写入失败 */
code?: number
/** 提示文案(成功为「上报成功」) */
message?: string
/** 服务处理结果标记(400/500 失败响应无此字段) */
success?: boolean
/** 本次上报条数 */
total?: number
/** 新入库条数 */
accepted?: number
/** 幂等去重条数(report_uuid 已存在,静默成功、不产生重复行) */
duplicated?: number
/** 校验失败条数 */
rejected?: number
/** 拒绝明细(最多 10 条) */
rejected_reasons?: { index: number; reason: string }[]
/** 服务端响应时间戳(秒) */
timestamp?: number
}
/**
* 上报客户端错误日志(免登录、免权限、免鉴权,保留系统日志):批量写入服务端暂存表 wms_client_error_log。
* 入参支持单条对象 / 数组 / `{ logs: [...] }` 三种形态,单次最多 50 条。
* `report_uuid` 幂等去重(重复上报静默成功);`client_time` 仅参考。
*/
export function uploadClientErrorLog(
data: ClientErrorLogUploadParams
): Promise<ClientErrorLogUploadResponse> {
return request({
url: '/system',
method: 'post',
params: {
method: 'index.uploadClientErrorLog',
v: '1.0',
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
// ============ index.getWarehousePanelData ============
/** index.getWarehousePanelData 入参 */
export type GetWarehousePanelDataParams = {
/** 最后一次更改的时间戳(Unix 秒);常规调用(force 非真)必填,小于服务端缓存时间戳时返回 is_change=true;force=true 时可选,缺省视为 0 */
last_change_at?: number
/** 是否强制输出数据(true/1/'true'):前端首次拉取时传 true,is_change 强制为 true,last_change_at 可不传 */
force?: boolean | number | string
}
/** index.getWarehousePanelData 响应 data.fulfillment 中的一个履约环节 */
export interface WarehousePanelFulfillmentStage {
/** 环节标识(如 receiving/shelf/pick/recheck/pack;items 末尾两项为今日退件 / 今日拆包) */
key?: string
/** 环节名称 */
name?: string
/** 未完成数量 */
undone?: number
/** 已完成数量(打包环节用订单状态存量口径,保证已复核 ≥ 已打包) */
done?: number
[key: string]: unknown
}
/** index.getWarehousePanelData 响应 data.fulfillment(订单履约链路 6 环节未/已) */
export interface WarehousePanelFulfillment {
/** 今日总单量(与 data.trend.total 同口径:待处理订单池 + 配送表今日出库) */
total?: number
/** 6 个履约环节;各环节未/已均含配送表今日出库按环节状态拆分补数 */
items?: WarehousePanelFulfillmentStage[]
[key: string]: unknown
}
/** index.getWarehousePanelData 响应 data.stageOverview.stages 中的一张阶段卡 */
export interface WarehousePanelStageCard {
/** 今日数量;pack 卡 = 今日真实打包订单数(散单任务数 + 团购波次真实订单数) */
today?: number
/** 进行中(任务数) */
doing?: number
/** 异常(任务数) */
abnormal?: number
[key: string]: unknown
}
/** index.getWarehousePanelData 响应 data.stageOverview(阶段概览 5 卡) */
export interface WarehousePanelStageOverview {
totalOrders?: number
interceptOrders?: number
/** 5 张卡:receiving / shelf / pick / recheck / pack */
stages?: WarehousePanelStageCard[] | Record<string, WarehousePanelStageCard>
[key: string]: unknown
}
/** 订单/商品/件数 统计块 */
export interface WarehousePanelVolume {
/** 订单数 */
orders?: number
/** 商品数 */
goods?: number
/** SKU 数 */
sku?: number
[key: string]: unknown
}
/** 拣货/打包区块(groupPicking / scatterPicking / groupPacking / scatterPacking) */
export interface WarehousePanelPickingBlock extends WarehousePanelVolume {
/** 波次数 */
wave?: number
/** Top5(按波次范围 wave_scope 区分:团购块按打包台、散单块按打包员) */
top5?: Array<Record<string, unknown>>
[key: string]: unknown
}
/** index.getWarehousePanelData 响应 data.trend 中的一个点位 */
export interface WarehousePanelTrendPoint {
/** 点位标签(从仓库自然日开始时间 day_start_time 起、按小时累计) */
label?: string
/** 该点位累计下单量(业务日窗口内下单量,池内待处理 + 配送表今日出库) */
created_count?: number
[key: string]: unknown
}
/** index.getWarehousePanelData 响应 data.trend(业务日 24 点下单趋势) */
export interface WarehousePanelTrend {
max?: number
/** 业务日内下单总量(与 data.fulfillment.total 同口径) */
total?: number
points?: WarehousePanelTrendPoint[]
[key: string]: unknown
}
/** index.getWarehousePanelData 响应 data.weeklyEfficiency(近 7 天拦截效率) */
export interface WarehousePanelWeeklyEfficiency {
/** 近 7 天(含各天拦截数等) */
days?: Array<Record<string, unknown>>
[key: string]: unknown
}
/**
* index.getWarehousePanelData 响应 data(面板数据对象)。
* ⚠️ `is_change=false` 时为空对象(节约流量);`is_change=true` 时按「已填充有数据源」的字段输出,
* 故所有字段均可选(无数据源的字段暂不输出)。
*/
export interface WarehousePanelData {
/** 仓库名 */
title?: string
/** 订单履约链路(6 环节未/已 + total + items 末尾两项:今日退件/今日拆包) */
fulfillment?: WarehousePanelFulfillment
/** 阶段概览 */
stageOverview?: WarehousePanelStageOverview
/** B2B(orders/goods/sku) */
b2b?: WarehousePanelVolume
/** 团购拣货(orders/goods/sku/wave/top5) */
groupPicking?: WarehousePanelPickingBlock
/** 散单拣货(orders/goods/sku/wave/top5) */
scatterPicking?: WarehousePanelPickingBlock
/** 团购打包(orders/goods/sku/wave/top5) */
groupPacking?: WarehousePanelPickingBlock
/** 散单打包(orders/goods/sku/wave/top5) */
scatterPacking?: WarehousePanelPickingBlock
/** 业务日 24 点下单趋势 */
trend?: WarehousePanelTrend
/** 近 7 天效率 */
weeklyEfficiency?: WarehousePanelWeeklyEfficiency
[key: string]: unknown
}
/** index.getWarehousePanelData 响应 */
export type GetWarehousePanelDataResponse = {
/** 是否已改变:force 为真时恒为 true;否则传入时间戳小于缓存最后时间戳时为 true,反之为 false(缓存无最后时间时恒为 true) */
is_change?: boolean
/** 服务端缓存最后更改时间戳(Unix 秒,缓存未命中为 0),前端保存后作为下次轮询的 last_change_at 入参回传 */
last_change_at?: number
/**
* 面板数据对象;`is_change=false` 时为空对象(节约流量),`is_change=true` 时按已填充字段输出。
* 字段说明见 `WarehousePanelData`
*/
data?: WarehousePanelData
}
/**
* 仓库面板数据接口:按仓库做增量变更检测,返回 is_change / last_change_at 与面板数据 data。
* ⚠️ 常规调用(force 非真)必须传 `last_change_at`;首次拉取传 `force: true`。
* ⚠️ `is_change=false` 时 `data` 为空对象,勿据此清空面板。
*/
export function getWarehousePanelData(
data?: GetWarehousePanelDataParams
): Promise<GetWarehousePanelDataResponse> {
return request({
url: '/system',
method: 'post',
params: {
method: 'index.getWarehousePanelData',
v: '1.0',
timestamp: new Date().getTime()
},
data: data ?? {},
isSystemApi: true
} as any)
}

View File

@ -0,0 +1,76 @@
import request from '@/utils/request'
const v = '1.0'
export type { OrderWorkbenchListResponse, OrderListPagination } from '@/api/order.index/orderindex'
export type OrderWhere = Record<string, any>
export type OrderSort = {
sortField?: string
sortOrder?: 'asc' | 'desc' | 'ASC' | 'DESC'
field?: string
order?: 'asc' | 'desc' | 'ASC' | 'DESC'
}
export type OrderPagination = {
page?: number
pageSize?: number
}
export type ArchiveOrderListParams = {
pagination?: OrderPagination
/**
* 统一 where 条件对象;禁止传入 warehouse_id / warehouseId(后端按登录仓库上下文注入)。
* create_channel 订单来源渠道筛选(按订单表 create_channel 列过滤;枚举:MANUAL=手工单、API=接口、QM=奇门、STOCKOUT=出库转单):
* {"create_channel":"MANUAL"} 单值精确;{"create_channel":["QM","API"]} 裸数组按 in 多选;
* {"create_channel":{"operator":"in","value":["QM","API"]}} 标准结构多选;{"create_channel":{"operator":"ne","value":"MANUAL"}} 排除指定渠道。
* 注意:列表响应中的 create_channel 已格式化为中文标签,查询条件须传英文枚举值。
* 默认排除 B2B 订单(is_b2b='Y',NULL 存量行视为非 B2B)——服务端固定条件,前端无法通过 where 覆盖;
* 需要查询 B2B 订单请使用 order.pendingOrder2b.list / order.deliveryOrder2b.list。
*/
where?: OrderWhere
sort?: OrderSort
}
export type ArchiveOrderDetailParams = {
ids?: Array<number | string> | string | number
id?: number | string
order_id?: number | string
orderId?: number | string
tableType?: string
tablePosition?: string
type?: string
moduleName?: string
}
export function orderArchiveOrderList(data: ArchiveOrderListParams = {}): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.archiveOrder.list',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
export function orderArchiveOrderDetail(data: ArchiveOrderDetailParams): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.archiveOrder.detail',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
export const orderArchiveOrder = {
list: orderArchiveOrderList,
detail: orderArchiveOrderDetail
}

View File

@ -0,0 +1,76 @@
import request from '@/utils/request'
const v = '1.0'
export type { OrderWorkbenchListResponse, OrderListPagination } from '@/api/order.index/orderindex'
export type OrderWhere = Record<string, any>
export type OrderSort = {
sortField?: string
sortOrder?: 'asc' | 'desc' | 'ASC' | 'DESC'
field?: string
order?: 'asc' | 'desc' | 'ASC' | 'DESC'
}
export type OrderPagination = {
page?: number
pageSize?: number
}
export type DeliveryExpectionOrderListParams = {
pagination?: OrderPagination
/**
* 统一 where 条件对象;禁止传入 warehouse_id / warehouseId(后端按登录仓库上下文注入)。
* create_channel 订单来源渠道筛选(按订单表 create_channel 列过滤;枚举:MANUAL=手工单、API=接口、QM=奇门、STOCKOUT=出库转单):
* {"create_channel":"MANUAL"} 单值精确;{"create_channel":["QM","API"]} 裸数组按 in 多选;
* {"create_channel":{"operator":"in","value":["QM","API"]}} 标准结构多选;{"create_channel":{"operator":"ne","value":"MANUAL"}} 排除指定渠道。
* 注意:列表响应中的 create_channel 已格式化为中文标签,查询条件须传英文枚举值。
* 默认排除 B2B 订单(is_b2b='Y',NULL 存量行视为非 B2B)——服务端固定条件,前端无法通过 where 覆盖;
* 需要查询 B2B 订单请使用 order.pendingOrder2b.list / order.deliveryOrder2b.list。
*/
where?: OrderWhere
sort?: OrderSort
}
export type DeliveryExpectionOrderDetailParams = {
ids?: Array<number | string> | string | number
id?: number | string
order_id?: number | string
orderId?: number | string
tableType?: string
tablePosition?: string
type?: string
moduleName?: string
}
export function orderDeliveryExpectionOrderList(data: DeliveryExpectionOrderListParams = {}): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.deliveryExpectionOrder.list',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
export function orderDeliveryExpectionOrderDetail(data: DeliveryExpectionOrderDetailParams): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.deliveryExpectionOrder.detail',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
export const orderDeliveryExpectionOrder = {
list: orderDeliveryExpectionOrderList,
detail: orderDeliveryExpectionOrderDetail
}

View File

@ -0,0 +1,362 @@
import request from '@/utils/request'
const v = '1.0'
export type { OrderWorkbenchListResponse, OrderListPagination } from '@/api/order.index/orderindex'
export type OrderWhere = Record<string, any>
export type OrderSort = {
sortField?: string
sortOrder?: 'asc' | 'desc' | 'ASC' | 'DESC'
field?: string
order?: 'asc' | 'desc' | 'ASC' | 'DESC'
}
export type OrderPagination = {
page?: number
pageSize?: number
}
export type DeliveryOrderListParams = {
pagination?: OrderPagination
/**
* 统一 where 条件对象;禁止传入 warehouse_id / warehouseId(后端按登录仓库上下文注入)。
* create_channel 订单来源渠道筛选(按订单表 create_channel 列过滤;枚举:MANUAL=手工单、API=接口、QM=奇门、STOCKOUT=出库转单):
* {"create_channel":"MANUAL"} 单值精确;{"create_channel":["QM","API"]} 裸数组按 in 多选;
* {"create_channel":{"operator":"in","value":["QM","API"]}} 标准结构多选;{"create_channel":{"operator":"ne","value":"MANUAL"}} 排除指定渠道。
* 注意:列表响应中的 create_channel 已格式化为中文标签,查询条件须传英文枚举值。
* 默认排除 B2B 订单(is_b2b='Y',NULL 存量行视为非 B2B)——服务端固定条件,前端无法通过 where 覆盖;
* 需要查询 B2B 订单请使用 order.pendingOrder2b.list / order.deliveryOrder2b.list。
*/
where?: OrderWhere
sort?: OrderSort
}
export type DeliveryOrderDetailParams = {
ids?: Array<number | string> | string | number
id?: number | string
order_id?: number | string
orderId?: number | string
tableType?: string
tablePosition?: string
type?: string
moduleName?: string
}
/** order.deliveryOrder.list 单条 raw 行(dispatch 模型) */
export type DeliveryOrderListItem = {
id: number
delivery_order_code: string
pre_delivery_order_code?: string
pre_delivery_order_id?: string
order_type?: string
order_flag?: string
source_order_codes?: string
sys_platform_code?: string
sys_platform_name?: string
create_at?: string | null
place_order_time?: string | null
pay_time?: string | null
pay_no?: string
service_code?: string | null
operator_name?: string | null
operate_time?: string | null
delivery_time?: string | null
shop_nick?: string
seller_nick?: string | null
buyer_nick?: string | null
buyer_message?: string
seller_message?: string
remark?: string
/** 货主备注 */
store_remark?: string
total_amount?: string
item_amount?: string
discount_amount?: string
freight?: string
ar_amount?: string
got_amount?: string
service_fee?: string | null
logistics_name?: string
delivery_type?: string | null
/** 重量类型 */
weight_type?: string | number | null
is_urgency?: string
/** 是否含 SN(序列号) 商品原始列(后端订单分表 has_sn_item,enum Y/N;旧版基表存量恒为 N) */
has_sn_item?: 'Y' | 'N'
/** 是否含 SN(序列号) 商品归一化字段(与 has_sn_item 同义,筛选与展示统一用它) */
is_sn_order?: 'Y' | 'N'
invoice_flag?: string
status?: string
name?: string
zip_code?: string
tel?: string
mobile?: string
email?: string
province?: string
city?: string
area?: string
town?: string
detail_address?: string
id_type?: string | null
id_number?: string | null
sync_status?: string
items?: string
items_count?: number
items_total?: number
/** 订单商品总重量(g) */
items_weight?: string
wave_id?: number
wave_no?: string
/** 波次内序号 */
wave_index?: number | string
wave_strategy_version?: number
wave_scan_result?: number
post_status?: string
storage_status?: string
pick_status?: string
pack_status?: string
inspection_status?: string
print_status?: string
claim_status?: string
outbound_status?: string
lock_status?: string
intercept_status?: string
basket_number?: string | null
recheck_status?: string
sys_logistics_name?: string | null
express_numbers?: string[]
waybill_codes?: string[]
}
/** order.deliveryOrder.detail 订单头(detail / order) */
export type DeliveryOrderDetailHeader = DeliveryOrderListItem & {
warehouse_code?: string | null
extend_props?: Record<string, unknown> | null
source_platform_code?: string
source_platform_name?: string
create_channel?: string
delete_at?: string | null
updated_at?: string
logistics_code?: string
sys_logistics_code?: string
express_code?: string
logistics_area_code?: string
country_code?: string
oaid?: string | null
store_id?: number
warehouse_id?: number
from_key?: string | null
items_hash?: string
items_crc?: number
sended_status?: string
recheck_time?: string | null
step?: number
print_lock_status?: string
dispatch_lane?: string
}
/** order.deliveryOrder.detail 商品明细项 */
export type DeliveryOrderDetailItem = {
id: number
order_id: number
actual_price?: string
retail_price?: string
ext_code?: string
inventory_type?: string
item_code?: string
item_id?: number
item_name?: string
order_line_no?: string
owner_code?: string
plan_qty?: number
source_order_code?: string
sub_source_order_code?: string
extend_props?: Record<string, unknown> | null
stock_id?: number
item_snapshot?: Record<string, unknown>
created_at?: string
updated_at?: string
createdAt?: string
updatedAt?: string
images?: string[]
}
/** order.deliveryOrder.detail 运单信息项 */
export type DeliveryOrderDetailExpressItem = {
waybill_code?: string
/** 称重重量(g) */
weighing_weight?: number | null
sys_logistics_code?: string
sys_logistics_name?: string
logistics_code?: string
logistics_name?: string
logistics_interface_id?: number | null
business_key?: string
created_at?: number | null
package_material_id?: number | null
package_material_name_snapshot?: string | null
}
/** order.deliveryOrder.detail 日志项 */
export type DeliveryOrderDetailLogItem = {
id: number
operation_code: string
operator_name?: string
created_at: string
external_log_type?: string | null
external_log_id?: number | string | null
platform_code?: string
message?: string
operation_name?: string
platform_name?: string
}
/** order.deliveryOrder.detail 响应 data */
export type DeliveryOrderDetailPayload = {
detail?: DeliveryOrderDetailHeader
order?: DeliveryOrderDetailHeader
items?: DeliveryOrderDetailItem[]
orderItems?: DeliveryOrderDetailItem[]
expresses?: DeliveryOrderDetailExpressItem[]
logs?: DeliveryOrderDetailLogItem[]
waybill_codes?: string[]
}
export function orderDeliveryOrderList(data: DeliveryOrderListParams = {}): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.deliveryOrder.list',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
export function orderDeliveryOrder2bList(data: DeliveryOrderListParams = {}): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.deliveryOrder2b.list',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
export function orderDeliveryOrderDetail(data: DeliveryOrderDetailParams): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.deliveryOrder.detail',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/**
* order.deliveryOrder.quickSearch:按关键词跨表联合搜索(运单号/发货单号/外部订单号/平台交易单号)
* 工单页「发起售后单-关联订单-选择订单」使用;联合查询较慢,超时时间延长至 20 秒(axios 默认 10 秒)
*/
/**
* order.deliveryOrder.summary:配送订单每日汇总
*
* - 以自然日为维度统计订单量 / 迁入配送表订单量 / 发货量 / 拦截 / 取消
* - 仓库取自登录上下文;可选 store_id 按货主过滤
* - 默认最近 7 个自然日(含今天),单次最多 90 天,区间内无数据的日期补 0
*/
export type DeliveryOrderSummaryParams = {
/** 开始日期 yyyy-MM-dd,缺省为结束日往前 6 天 */
start_date?: string
/** 结束日期 yyyy-MM-dd,缺省为今天 */
end_date?: string
/** 货主ID过滤,不传或 <=0 表示不按货主过滤 */
store_id?: number
}
/** 每日汇总中的一天统计行 */
export type DeliveryOrderSummaryItem = {
/** 统计日期 yyyy-MM-dd */
date: string
/** 当日订单量 */
order_count: number
/** 当日迁入配送表订单量 */
dispatch_count: number
/** 当日发货订单数 */
shipped_count: number
/** 当日发货商品件数 */
shipped_items_total: number
/** 当日发货金额 */
shipped_amount: number
/** 当日拦截数量 */
intercepted_count: number
/** 当日库内确定拦截数量 */
intercepted_at_warehouse_count: number
/** 当日取消数量 */
cancelled_count: number
}
/** 区间合计(字段口径与 list 中对应字段相同) */
export type DeliveryOrderSummaryTotals = Omit<DeliveryOrderSummaryItem, 'date'>
/** order.deliveryOrder.summary 响应(data 位于顶层) */
export type DeliveryOrderSummaryPayload = {
warehouse_id: number
store_id: number | null
start_date: string
end_date: string
day_count: number
list: DeliveryOrderSummaryItem[]
summary: DeliveryOrderSummaryTotals
}
export function orderDeliveryOrderSummary(data: DeliveryOrderSummaryParams = {}): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.deliveryOrder.summary',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
export function orderDeliveryOrderQuickSearch(keyword: string): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.deliveryOrder.quickSearch',
v,
timestamp: Date.now()
},
data: { keyword },
isSystemApi: true,
// 联合搜索耗时较长,单独放宽超时时间至 20 秒
timeout: 60000
} as any)
}
export const orderDeliveryOrder = {
list: orderDeliveryOrderList,
detail: orderDeliveryOrderDetail,
quickSearch: orderDeliveryOrderQuickSearch,
summary: orderDeliveryOrderSummary,
}
export const orderDeliveryOrder2b = {
list: orderDeliveryOrder2bList
}

View File

@ -0,0 +1,76 @@
import request from '@/utils/request'
const v = '1.0'
export type { OrderWorkbenchListResponse, OrderListPagination } from '@/api/order.index/orderindex'
export type OrderWhere = Record<string, any>
export type OrderSort = {
sortField?: string
sortOrder?: 'asc' | 'desc' | 'ASC' | 'DESC'
field?: string
order?: 'asc' | 'desc' | 'ASC' | 'DESC'
}
export type OrderPagination = {
page?: number
pageSize?: number
}
export type EntrustOrderListParams = {
pagination?: OrderPagination
/**
* 统一 where 条件对象;禁止传入 warehouse_id / warehouseId(后端按登录仓库上下文注入)。
* create_channel 订单来源渠道筛选(按订单表 create_channel 列过滤;枚举:MANUAL=手工单、API=接口、QM=奇门、STOCKOUT=出库转单):
* {"create_channel":"MANUAL"} 单值精确;{"create_channel":["QM","API"]} 裸数组按 in 多选;
* {"create_channel":{"operator":"in","value":["QM","API"]}} 标准结构多选;{"create_channel":{"operator":"ne","value":"MANUAL"}} 排除指定渠道。
* 注意:列表响应中的 create_channel 已格式化为中文标签,查询条件须传英文枚举值。
* 默认排除 B2B 订单(is_b2b='Y',NULL 存量行视为非 B2B)——服务端固定条件,前端无法通过 where 覆盖;
* 需要查询 B2B 订单请使用 order.pendingOrder2b.list / order.deliveryOrder2b.list。
*/
where?: OrderWhere
sort?: OrderSort
}
export type EntrustOrderDetailParams = {
ids?: Array<number | string> | string | number
id?: number | string
order_id?: number | string
orderId?: number | string
tableType?: string
tablePosition?: string
type?: string
moduleName?: string
}
export function orderEntrustOrderList(data: EntrustOrderListParams = {}): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.entrustOrder.list',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
export function orderEntrustOrderDetail(data: EntrustOrderDetailParams): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.entrustOrder.detail',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
export const orderEntrustOrder = {
list: orderEntrustOrderList,
detail: orderEntrustOrderDetail
}

View File

@ -0,0 +1,97 @@
import request from '@/utils/request'
const v = '1.0'
export type { OrderWorkbenchListResponse, OrderListPagination } from '@/api/order.index/orderindex'
export type OrderWhere = Record<string, any>
export type OrderSort = {
sortField?: string
sortOrder?: 'asc' | 'desc' | 'ASC' | 'DESC'
field?: string
order?: 'asc' | 'desc' | 'ASC' | 'DESC'
}
export type OrderPagination = {
page?: number
pageSize?: number
}
export type ExpectionOrderListParams = {
pagination?: OrderPagination
/**
* 统一 where 条件对象;禁止传入 warehouse_id / warehouseId(后端按登录仓库上下文注入)。
* create_channel 订单来源渠道筛选(按订单表 create_channel 列过滤;枚举:MANUAL=手工单、API=接口、QM=奇门、STOCKOUT=出库转单):
* {"create_channel":"MANUAL"} 单值精确;{"create_channel":["QM","API"]} 裸数组按 in 多选;
* {"create_channel":{"operator":"in","value":["QM","API"]}} 标准结构多选;{"create_channel":{"operator":"ne","value":"MANUAL"}} 排除指定渠道。
* 注意:列表响应中的 create_channel 已格式化为中文标签,查询条件须传英文枚举值。
* 默认排除 B2B 订单(is_b2b='Y',NULL 存量行视为非 B2B)——服务端固定条件,前端无法通过 where 覆盖;
* 需要查询 B2B 订单请使用 order.pendingOrder2b.list / order.deliveryOrder2b.list。
*/
where?: OrderWhere
sort?: OrderSort
}
export type ExpectionOrderDetailParams = {
ids?: Array<number | string> | string | number
id?: number | string
order_id?: number | string
orderId?: number | string
tableType?: string
tablePosition?: string
type?: string
moduleName?: string
}
export type ExpectionOrderResolveExceptionParams = {
ids: number[]
}
export function orderExpectionOrderList(data: ExpectionOrderListParams = {}): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.expectionOrder.list',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
export function orderExpectionOrderResolveException(
data: ExpectionOrderResolveExceptionParams
): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.expectionOrder.resolveException',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
export function orderExpectionOrderDetail(data: ExpectionOrderDetailParams): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.expectionOrder.detail',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
export const orderExpectionOrder = {
list: orderExpectionOrderList,
detail: orderExpectionOrderDetail,
resolveException: orderExpectionOrderResolveException
}

View File

@ -0,0 +1,385 @@
import request from '@/utils/request'
const v = '1.0'
export type OrderListParams = {
pagination?: {
page?: number
pageSize?: number
currentPage?: number
page_size?: number
size?: number
}
/**
* 统一 where 条件对象(推荐 { operator, value, type } 标准结构,历史简写自动标准化)。
* - 禁止传入 warehouse_id / warehouseId(由后端根据当前登录仓库上下文自动注入)。
* - 虚拟字段:buyer_message_has(覆盖 buyer_message/seller_message/remark 三个字段,任一有值即为有留言,value=true/false)、
* express_numbers / waybill_codes(运单号筛选)、
* wave_index(波次内序号筛选,联查 wms_order_wave_index,支持 eq/in/gt/lt/ge/le/between/notbetween,
* between 要求 value 为长度 2 的数组,如 {"wave_index":{"operator":"between","value":[1,50]}})、
* wave_scope(波次范围筛选,直接按订单表 wave_scope 列过滤;取值 0=未分配、1=大团购、2=散单、3=小团购、4=单品单件。
* 支持 {"wave_scope":0} 单值、{"wave_scope":[1,3]} 裸数组、{"wave_scope":{"operator":"in","value":[1,3]}} 标准结构)。
* - create_channel 订单来源渠道筛选(按订单表 create_channel 列过滤;枚举:MANUAL=手工单、API=接口、QM=奇门、STOCKOUT=出库转单):
* {"create_channel":"MANUAL"} 单值精确;{"create_channel":["QM","API"]} 裸数组按 in 多选;
* {"create_channel":{"operator":"in","value":["QM","API"]}} 标准结构多选;{"create_channel":{"operator":"ne","value":"MANUAL"}} 排除指定渠道。
* 注意:列表响应中的 create_channel 已格式化为中文标签,查询条件须传英文枚举值。 * - is_sn_order 是否含 SN(序列号) 商品筛选(后端订单分表 has_sn_item enum Y/N 归一化后输出):
* {"is_sn_order":"Y"} 仅含 SN 商品订单;{"is_sn_order":"N"} 仅无 SN 商品订单。
* 响应行同时返回 has_sn_item(原始列)与 is_sn_order(归一化),前端筛选/展示统一用 is_sn_order。
* - sn_code / snCode / sn_codes / snCodes 按 SN 码反查订单(先查 wms_order_item_sn 拿 order_id 再回填,订单表结构不变):
* 值支持单个字符串、逗号/空格/分号分隔多个码、字符串数组或 { value } 结构,按完整 SN 码精确匹配。
* - 默认排除 B2B 订单(is_b2b='Y',NULL 存量行视为非 B2B)——服务端固定条件,前端无法通过 where 覆盖;
* 需要查询 B2B 订单请使用 order.pendingOrder2b.list / order.deliveryOrder2b.list。 */
where?: Record<string, any>
sort?: {
sortField?: string
sortOrder?: 'asc' | 'desc' | 'ASC' | 'DESC'
field?: string
order?: 'asc' | 'desc' | 'ASC' | 'DESC'
}
}
export type OrderListPagination = {
page?: number
pageSize?: number
total?: number
totalPages?: number
hasPrevious?: boolean
hasNext?: boolean
}
/** 订单工作台 / 各订单模块 list 响应 data 结构
* - list 每条 raw 行数据新增 store_remark(货主备注)字段、wave_index(波次内序号,联查 wms_order_wave_index,无记录时为 0)
* - list 每条 raw 行数据包含 confirm_print_status(确认打印状态,none/fin)与 claim_status(领料状态,none/padding/fin/error)
* - list 每条 lock_status 统一输出为 Y/N:none(含空值)→ 'N',其余值(如 warehouse/store)→ 'Y'
* - 各模块响应描述以各自 module.json 为准(部分模块 list 仅含 wave_index)
* - 列表运单号回填为服务端修复项(wms_order_express 按「订单ID + 订单所属仓库ID」隔离读取,禁止跨仓串读),前端无需处理
*/
export type OrderWorkbenchListResponse = {
list: any[]
pagination: OrderListPagination
/** 复核状态:none=未复核,fin=已复核 */
recheck_status?: string
}
export type ManualOutboundParams = {
warehouseId?: number
warehouse_id?: number
warehouseIds?: number[]
queryTimeoutMs?: number
executionTimeoutMs?: number
}
export type QueryOrderLogsParams = {
id: string
page?: number
pageSize?: number
}
/** order.queryOrderLogList 请求(id / order_id / orderId 择一即可) */
export type QueryOrderLogListParams = {
id?: string | number
order_id?: string | number
orderId?: string | number
}
/** order.updateExpressWeighingWeight 请求参数 */
export type UpdateExpressWeighingWeightParams = {
/** 订单 ID;正整数为订单模式,0 为运单号模式(需配合 waybill_code) */
order_id: number | string
/** 订单仅一个运单时可不传;多运单时必填;order_id=0 时必填 */
waybill_code?: string
/** 称重重量(g),必须大于 0,最多 3 位小数 */
weighing_weight: number | string
}
/** order.updateExpressWeighingWeight 团购拆单明细项(splits 数组元素) */
export type UpdateExpressWeighingWeightSplitItem = {
business_key: string
weighing_weight: number
waybill_code: string
}
/** order.updateExpressWeighingWeight 响应 data(散单/订单模式或团购批量模式) */
export type UpdateExpressWeighingWeightResponse = {
/** 订单 ID;订单模式及运单号散单模式返回 */
order_id?: number
/** 写入重量的运单号;订单模式及运单号散单模式返回 */
waybill_code?: string
/** 已写入的称重重量(g) */
weighing_weight: number
/** 波次号;团购批量模式返回 */
wave_no?: string
/** 业务键;运单号团购批量模式返回 */
business_key?: string
/** 波次 ID;团购批量模式返回 */
wave_id?: number
/** 所有拆单重量累加(g);团购批量模式返回 */
total_weight?: number
/** waybill_code 非空的 business_key 数量;团购批量模式返回 */
split_count?: number
/** 按 business_key 分组的拆单明细;团购批量模式返回 */
splits?: UpdateExpressWeighingWeightSplitItem[]
/** 货主名称(订单 shop_nick);团购批量模式返回 */
store_name?: string
/** 系统快递名称;团购批量模式返回 */
sys_logistics_name?: string
}
/** order.detail 请求参数 */
export type OrderDetailParams = {
ids?: Array<number | string> | string | number
id?: number | string
order_id?: number | string
orderId?: number | string
tableType?: string
tablePosition?: string
type?: string
moduleName?: string
}
/** order.detail 运单信息项 */
export type OrderDetailExpressItem = {
waybill_code?: string
weighing_weight?: number | null
sys_logistics_code?: string
sys_logistics_name?: string
logistics_code?: string
logistics_name?: string
logistics_interface_id?: number | null
business_key?: string
created_at?: number | null
package_material_id?: number | null
package_material_name_snapshot?: string | null
}
/** order.detail 响应 data */
export type OrderDetailPayload = {
order?: Record<string, any>
detail?: Record<string, any>
orderItems?: any[]
items?: any[]
expresses?: OrderDetailExpressItem[]
waybill_codes?: string[]
}
export type BindExpressPackageMaterialParams = {
order_id: number | string
waybill_code: string
package_material_code: string
}
/** order.export 导出模式:waybill=不含明细(默认),item=含明细 */
export type OrderExportMode = 'waybill' | 'item'
export type OrderExportParams = {
/**
* 导出表类型,枚举:current / history / dispatch / outsourced;
* 兼容订单模块别名(order / revieworder / reviewOrder / pendingorder 等);支持 table_type 与 tableType 两种写法。
*/
table_type?: string
tableType?: string
module?: string
module_name?: string
/** 查询条件,语义与 order.list 的 where 一致;⚠️ 禁止传入 warehouse_id / warehouseId(服务端从登录态注入,前端须 sanitize) */
where?: Record<string, any>
sort?: OrderListParams['sort']
/** 导出模式,默认 waybill */
export_mode?: OrderExportMode
exportMode?: OrderExportMode
/**
* 导出表头字段白名单(中文表头字符串数组,如 ["系统订单号","外部订单号"]);不传或空数组时输出全部列。
* 支持 export_columns 与 exportColumns 两种写法。
*
* 文档枚举共 57 个(校验不区分导出模式,选中当前模式不存在的表头时该列自动忽略;传入非法表头会报错并列出非法值):
* 系统订单号、外部订单号、平台单号、订单ID、订单号、外部单号、订单状态、拦截状态、抓取波次号、波次号、波次序号、
* 货主、平台、来源、店铺昵称、收件人、收件人电话、省、市、区、镇、详细地址、商品明细、仓库商品名称、
* 商品条码、商品图片、数量、物流公司、运单号、业务类型、运单接口、包材ID、包材编码、包材名称、分配时间、
* 订单商品总类数、订单商品总数、SN码数量、SN码、SN码汇总、商品重量、称重重量(g)、订单金额、实收金额、创建时间、支付时间、发货时间、
* 出库状态、复核状态、复核完成状态、复核时间、配货状态、打包状态、备注、买家留言、卖家留言、归档时间。
* 其中仅 waybill 输出:系统订单号、外部订单号、平台单号、抓取波次号、商品明细、SN码汇总;
* 仅 item 输出:订单ID、订单号、外部单号、波次号、仓库商品名称、商品条码、商品图片、数量、SN码。
* 「SN码数量」(sn_quantity)= 启用序列号管理商品(stock_warehouse.is_sn_mgmt='Y')的 plan_qty 合计;
* waybill 模式仅主单号行输出合计(子单号行为 0),item 模式按商品明细行输出(非 SN 商品行为 0)。
* 「SN码」(sn_codes, item):该商品行复核时登记的 SN 码列表(状态限定 BOUND/VERIFIED/REISSUED,排除退回/作废);
* 「SN码汇总」(sn_codes_summary, waybill):整单全部已登记 SN 码汇总,仅主单号行输出。
* ⚠️ 白名单不含「领料状态」「确认打印状态」(列表页有该状态列,但导出不支持,传入会报错)。
* ⚠️ **一旦传入白名单,服务端只输出白名单内的列**:新增列必须同步加入前端可选清单,否则不会出现在导出表头中。
* 前端字段清单见 views/order/orderManagement/config/order-common-config.ts 的 ORDER_EXPORT_ALL_COLUMNS。
*/
export_columns?: string[]
exportColumns?: string[]
}
export type OrderExportTaskProgressParams = {
task_id?: string
taskId?: string
}
/** order.queryOrderLogList 单条日志 */
export type OrderLogListItem = {
id: number
operation_code: string
operation_name?: string | null
operator_name?: string | null
created_at: string
external_log_type?: string | null
external_log_id?: number | string | null
platform_code?: string | null
platform_name?: string | null
message?: string | null
}
export function orderList(data: OrderListParams = {}): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.list',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
export function orderManualOutboundOrder(data: ManualOutboundParams = {}): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.manualOutboundOrder',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
export function orderBadgeCount(): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.badgeCount',
v,
timestamp: new Date().getTime()
},
data: {},
isSystemApi: true
} as any)
}
export function orderQueryOrderLogs(data: QueryOrderLogsParams): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.queryOrderLogs',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
/** 订单操作日志(order.queryOrderLogList),响应多为顶层 list / total / code / flag */
export function orderQueryOrderLogList(data: QueryOrderLogListParams): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.queryOrderLogList',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
export function orderUpdateExpressWeighingWeight(data: UpdateExpressWeighingWeightParams): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.updateExpressWeighingWeight',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
export function orderBindExpressPackageMaterial(data: BindExpressPackageMaterialParams): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.bindExpressPackageMaterial',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
export function orderExport(data: OrderExportParams = {}): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.export',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
export function orderExportTaskProgress(data: OrderExportTaskProgressParams): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.exportTaskProgress',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
/** order.detail:查询单个订单详情,返回订单头、商品明细和运单信息 */
export function orderDetail(data: OrderDetailParams = {}): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.detail',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
export const order = {
list: orderList,
manualOutboundOrder: orderManualOutboundOrder,
badgeCount: orderBadgeCount,
queryOrderLogs: orderQueryOrderLogs,
queryOrderLogList: orderQueryOrderLogList,
updateExpressWeighingWeight: orderUpdateExpressWeighingWeight,
bindExpressPackageMaterial: orderBindExpressPackageMaterial,
export: orderExport,
exportTaskProgress: orderExportTaskProgress,
detail: orderDetail
}

View File

@ -0,0 +1,99 @@
import request from '@/utils/request'
const v = '1.0'
export type { OrderWorkbenchListResponse, OrderListPagination } from '@/api/order.index/orderindex'
export type OrderWhere = Record<string, any>
export type OrderSort = {
sortField?: string
sortOrder?: 'asc' | 'desc' | 'ASC' | 'DESC'
field?: string
order?: 'asc' | 'desc' | 'ASC' | 'DESC'
}
export type OrderPagination = {
page?: number
pageSize?: number
}
export type OutboundOrderListParams = {
pagination?: OrderPagination
/**
* 统一 where 条件对象;禁止传入 warehouse_id / warehouseId(后端按登录仓库上下文注入)。
* create_channel 订单来源渠道筛选(按订单表 create_channel 列过滤;枚举:MANUAL=手工单、API=接口、QM=奇门、STOCKOUT=出库转单):
* {"create_channel":"MANUAL"} 单值精确;{"create_channel":["QM","API"]} 裸数组按 in 多选;
* {"create_channel":{"operator":"in","value":["QM","API"]}} 标准结构多选;{"create_channel":{"operator":"ne","value":"MANUAL"}} 排除指定渠道。
* 注意:列表响应中的 create_channel 已格式化为中文标签,查询条件须传英文枚举值。
* 默认排除 B2B 订单(is_b2b='Y',NULL 存量行视为非 B2B)——服务端固定条件,前端无法通过 where 覆盖;
* 需要查询 B2B 订单请使用 order.pendingOrder2b.list / order.deliveryOrder2b.list。
*/
where?: OrderWhere
sort?: OrderSort
}
export type OutboundOrderDetailParams = {
ids?: Array<number | string> | string | number
id?: number | string
order_id?: number | string
orderId?: number | string
tableType?: string
tablePosition?: string
type?: string
moduleName?: string
}
export type ManualOutboundParams = {
warehouseId?: number
warehouse_id?: number
warehouseIds?: number[]
queryTimeoutMs?: number
executionTimeoutMs?: number
}
export function orderOutboundOrderList(data: OutboundOrderListParams = {}): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.outboundOrder.list',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
export function orderOutboundOrderManualOutboundOrder(data: ManualOutboundParams = {}): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.outboundOrder.manualOutboundOrder',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
export function orderOutboundOrderDetail(data: OutboundOrderDetailParams): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.outboundOrder.detail',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
export const orderOutboundOrder = {
list: orderOutboundOrderList,
detail: orderOutboundOrderDetail,
manualOutboundOrder: orderOutboundOrderManualOutboundOrder
}

View File

@ -0,0 +1,336 @@
import request from '@/utils/request'
const v = '1.0'
/** 打包任务列表分页参数 */
export type PackingListPagination = {
page?: number
pageSize?: number
}
/** 打包任务列表查询参数 */
export type PackingListParams = {
/** 仓库ID(按仓库维度查询;后端会从登录态注入,前端可不传) */
warehouse_id?: number | string
pagination?: PackingListPagination
where?: PackingListWhere
sort?: PackingListSort
}
/** 打包任务列表 where 条件 */
export type PackingListWhere = {
/** 任务状态:0=待处理 1=打包中 2=已完成 3=异常 */
status?: number | string
/** 打包模式:1=散单 2=团购 */
pack_mode?: number | string
/** 运单号(模糊匹配) */
waybill_code?: string
/** 波次号(模糊匹配) */
wave_no?: string
/** 订单ID(精确匹配) */
order_id?: number | string
/** 打包员名称(对应响应 operator_text,支持模糊/包含/精确) */
operator_text?: string
/** 工作台ID(精确匹配) */
workbench_id?: number | string
/** 快捷搜索:运单号/波次号模糊匹配 */
quickWhere?: string
/** 开始打包时间范围-起始 */
start_time_start?: string
/** 开始打包时间范围-结束 */
start_time_end?: string
[key: string]: any
}
/** 打包任务列表排序 */
export type PackingListSort = {
sortField?: string
sortOrder?: 'ASC' | 'DESC' | 'asc' | 'desc'
}
/** 打包任务录像项 */
export type PackingVideoItem = {
id?: number
video_url?: string
status?: string
[key: string]: any
}
/** 打包任务运单关联项 */
export type PackingExpressItem = {
id?: number
express_id?: number
waybill_code?: string
logistics_name?: string
[key: string]: any
}
/** 打包任务列表项 / 详情对象(get/list 同构,字段以最新接口为准) */
export type PackingTaskItem = {
id?: number
order_id?: number | string
warehouse_id?: number | string
workbench_id?: number | string
wave_id?: number | string
wave_no?: string
waybill_code?: string
/** 打包数量 */
pack_quantity?: number
/** 商品数量 */
item_quantity?: number
/** SKU 数 */
sku_count?: number
/** 打包模式:1=散单 2=团购 */
pack_mode?: number | string
/** 任务状态:0=待处理 1=打包中 2=已完成 3=异常 */
status?: number | string
start_time?: string
end_time?: string
/** 打包员(展示文本) */
operator_text?: string
/** 关联设备ID列表 */
device_ids?: number[]
remark?: string
/** 扩展元信息 */
meta?: Record<string, unknown> | null
create_time?: string
update_time?: string
/** 工作台名称(关联展示) */
workbench_name?: string
/** 工作台类型 */
workbench_type?: string
/** 是否含录像 */
has_video?: boolean | number
/** 录像是否可用 */
video_enable?: boolean | number
/** 录像列表 */
videos?: PackingVideoItem[]
/** 关联运单列表 */
expresses?: PackingExpressItem[]
[key: string]: any
}
/** 打包任务列表响应 */
export type PackingListResponse = {
list: PackingTaskItem[]
pagination: PackingListPagination & {
total?: number
totalPages?: number
}
}
/**
* 打包任务列表查询(仓库侧)
* 按仓库维度查询 wms_pack_task 表,支持分页、筛选、排序
*/
export function packingList(data: PackingListParams = {}): Promise<{
code: number
message: string
data: PackingListResponse
}> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.packing.list',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
/**
* 打包任务详情查询(仓库侧)
* 按打包任务ID + 仓库维度查询单条打包任务记录
*/
export function packingGet(id: number): Promise<{
code: number
message: string
data: PackingTaskItem
}> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.packing.get',
v,
timestamp: new Date().getTime()
},
data: { id },
isSystemApi: true
} as any)
}
/** order.packing.setEndTime 请求参数 */
export type PackingSetEndTimeParams = {
/** 打包任务ID(必填) */
id: number
/** 结束时间(ISO 8601 格式,如 2026-07-27T11:00:00.000Z,必填) */
end_time: string
}
/** order.packing.setEndTime 响应 */
export type PackingSetEndTimeResponse = {
id: number
end_time: string
status: number
}
/**
* 设置打包任务结束时间
* 若任务状态不是已完成(2),则同步更新状态为已完成
*/
export function packingSetEndTime(data: PackingSetEndTimeParams): Promise<{
code: number
message: string
data: PackingSetEndTimeResponse
}> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.packing.setEndTime',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
/** order.packing.forceRecord 请求参数 */
export type PackingForceRecordParams = {
/** 打包任务ID(必填) */
id: number
}
/** order.packing.forceRecord 响应 */
export type PackingForceRecordResponse = {
pack_task_id: number
computer_id: number
/** 录制电脑的打印服务地址(后端返回,便于排查) */
print_service_url?: string
/** 推送给打印服务的请求体 */
print_service_request?: { pack_task_id: number }
/** 打印服务响应 */
print_service_response?: {
status: number
headers: Record<string, unknown>
data: unknown
}
/** 打印服务调用失败时的错误信息 */
print_service_error?: string | null
}
/**
* 强制重新录制打包任务视频
* 将任务推送到录制电脑,通过打印服务触发重新录制
*/
export function packingForceRecord(data: PackingForceRecordParams): Promise<{
code: number
message: string
data: PackingForceRecordResponse
}> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.packing.forceRecord',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
/** order.packing.export 请求参数(where/sort 语义与 order.packing.list 一致;warehouse_id 由服务端注入,禁止前端传入) */
export type PackingExportParams = {
/** 查询条件,语义与 order.packing.list 的 where 一致;禁止传 warehouse_id/warehouseId(服务端注入) */
where?: Record<string, any>
/** 排序参数:sortField + sortOrder(asc/desc) */
sort?: PackingListSort
}
/** order.packing.export 响应(提交成功即返回任务受理信息) */
export type PackingExportResponse = {
/** 任务 ID(后端生成,格式 packing_export_{warehouseId}_{timestamp}_{random}) */
task_id: string
/** 任务状态:submitted/running/success/failed/not_found(提交成功时为 submitted) */
status: string
/** 当前进度百分比(0-100),提交时返回 0 */
progress: number
/** 当前已处理记录数(打包任务条数) */
current_count: number
/** 总记录数 */
total_count: number
/** 任务提示信息 */
message: string
/** 任务执行结果(提交时为 null;完成后为上传信息对象) */
result: Record<string, unknown> | null
/** 失败时的错误信息 */
error: string
/** 任务更新时间(Unix 毫秒时间戳) */
update_time: number
}
/**
* order.packing.export:提交打包任务导出任务(异步,立即返回 task_id)
* 后台异步生成单 Sheet Excel 并上传,导出进度/下载经 order.packing.exportTaskProgress 查询;免权限免日志口径与 order.export 一致
*/
export function packingExport(data: PackingExportParams = {}): Promise<{
code: number
message: string
data: PackingExportResponse
}> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.packing.export',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
/** order.packing.exportTaskProgress 请求参数 */
export type PackingExportTaskProgressParams = {
/** 任务 ID(下划线写法,兼容) */
task_id?: string
/** 任务 ID(驼峰写法,兼容) */
taskId?: string
}
/** order.packing.exportTaskProgress 响应(提交态字段 + 上传完成后的 download_url) */
export type PackingExportTaskProgressResponse = PackingExportResponse & {
/** 任务完成后下载链接(从 result.url/cdnUrl/cosUrl/fileKey 兜底取);未完成或不存在时为空字符串 */
download_url: string
}
/**
* order.packing.exportTaskProgress:按 task_id 查询打包任务导出任务进度
* 上传完成后返回 download_url;task_id 缺失或缓存未命中时 status=not_found(正常响应);免权限免日志口径与 order.exportTaskProgress 一致
* 状态口径 submitted → running → 数据拉取(10~30) → 关联拉取(30~55) → Excel(55~90) → 上传(92) → success(100),失败 failed + error
*/
export function packingExportTaskProgress(data: PackingExportTaskProgressParams): Promise<{
code: number
message: string
data: PackingExportTaskProgressResponse
}> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.packing.exportTaskProgress',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}

File diff suppressed because it is too large Load Diff

View File

@ -0,0 +1,116 @@
import request from '@/utils/request'
const v = '1.0'
/** 接口文档:summary / wave_list / ext;wave_list 单项结构由后端定义 */
export type WavePrintDataPayload = {
summary?: Record<string, unknown>
wave_list?: Record<string, unknown>[]
ext?: Record<string, unknown>
}
export type GetWavePlatformPrintDataParams = {
warehouse_id: number
wave_ids: Array<number | string>
}
export type UnlockWavePlatformPrintGroupItem = {
wave_id: number | string
platform?: string
sys_logistics_code?: string
order_ids?: Array<number | string>
}
export type UnlockWavePlatformPrintDataByGroupParams = {
warehouse_id: number
wave_ids: Array<number | string>
group_type?: 'platform' | 'platform_express' | 'order'
unlock_scope?: 'group' | 'wave'
groups: UnlockWavePlatformPrintGroupItem[]
}
/** 接口文档:summary / wave_ids / waveGroups(主)/ locked_wave_groups(锁定)/ platform_groups、order_list(兼容)/ ext */
export type WavePlatformPrintDataPayload = {
summary?: Record<string, unknown>
wave_ids?: Array<number | string>
/** 主返回:波次 → 平台 → 订单 */
waveGroups?: unknown[]
/** 锁定波次:结构与 waveGroups 一致 */
locked_wave_groups?: unknown[]
locked_orders?: Record<string, unknown>[]
locked_count?: number
platform_groups?: unknown[]
order_list?: Record<string, unknown>[]
ext?: Record<string, unknown>
}
/** 按波次 IDs 获取平台打印中间态数据(order.print.getWavePlatformPrintData) */
export function getWavePlatformPrintData(data: GetWavePlatformPrintDataParams) {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.print.getWavePlatformPrintData',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
/** 按分组解锁波次平台打印锁(order.print.unlockWavePlatformPrintDataByGroup) */
export function unlockWavePlatformPrintDataByGroup(data: UnlockWavePlatformPrintDataByGroupParams) {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.print.unlockWavePlatformPrintDataByGroup',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
export type GetOrderPrintDataParams = {
order_ids: Array<number | string>
}
/** 按订单 ID 拉取平台打印中间态数据(order.print.getOrderPrintData)
* 返回结构与 getWavePlatformPrintData 一致,不限制打印锁定状态 */
export function getOrderPrintData(data: GetOrderPrintDataParams) {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.print.getOrderPrintData',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
export type GetPrintDataByWaybillCodesParams = {
/** 运单号数组(字符串数组,内部自动去重与归一化,必须为非空数组) */
waybill_codes: string[]
}
/** 按运单号数组拉取平台打印中间态数据(order.print.getPrintDataByWaybillCodes)
* 返回结构与 getOrderPrintData 一致 */
export function getPrintDataByWaybillCodes(data: GetPrintDataByWaybillCodesParams) {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.print.getPrintDataByWaybillCodes',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}

View File

@ -0,0 +1,663 @@
import request from '@/utils/request'
import {
orderUpdateExpressWeighingWeight,
type UpdateExpressWeighingWeightParams,
type UpdateExpressWeighingWeightResponse,
type UpdateExpressWeighingWeightSplitItem
} from '@/api/order.index/orderindex'
const v = '1.0'
/** 扫描关键词;支持 keyword、value、运单号、波次号与车号别名(见 order.recheckorder module.json) */
export type RecheckScanOrderParams = {
keyword?: string
value?: string
waybill_no?: string
waybillCode?: string
waybill_code?: string
wave_no?: string
waveNo?: string
cart_code?: string
cartCode?: string
}
const SCAN_ORDER_FIELD_KEYS: (keyof RecheckScanOrderParams)[] = [
'keyword',
'value',
'waybill_no',
'waybillCode',
'waybill_code',
'wave_no',
'waveNo',
'cart_code',
'cartCode'
]
function pickScanOrderBody(data: RecheckScanOrderParams): Record<string, string> {
for (const key of SCAN_ORDER_FIELD_KEYS) {
const raw = data[key]
if (raw !== undefined && raw !== null && String(raw).trim() !== '') {
return { [key]: String(raw).trim() }
}
}
throw new Error(
'扫描关键词不能为空(keyword / value / waybill_no / waybillCode / waybill_code / wave_no / waveNo / cart_code / cartCode)'
)
}
/** 散单 list 项(有波次时的扁平订单) */
export type ScanOrderSingleListItem = {
order_id?: number
delivery_order_code?: string
waybill_no?: string
pick_status?: string
is_printed?: boolean | number | string
is_reviewed?: boolean | number | string
shop_nick?: string
items_count?: number
wave_index?: number | string
recheck_status?: string
order_type?: string
status?: string
logistics_name?: string
store_remark?: string
intercept_status?: string
stock?: unknown[]
/** 订单商品总重量(g) */
items_weight?: number | string
/** 推荐包材信息,无推荐时为 null */
suggested_package_material?: Record<string, unknown> | null
/** 无波次时单订单详情模式 */
detail?: Record<string, unknown>
items?: unknown[]
expresses?: unknown[]
logs?: unknown[]
}
/** 团购 list 项(波次视图) */
export type ScanOrderGroupListItem = {
wave_id?: number
wave_no?: string
wave_type?: number
wave_status?: string
total_orders?: number
processed_orders?: number
creator?: string
create_time?: string
update_time?: string
order_count?: number
pick_mode?: number
box_no?: string
order_ids?: Array<number | string>
orders_detail?: unknown[]
orders?: unknown[]
stocks?: unknown[]
recheck_status?: string
is_reviewed?: boolean | number | string
}
/** scanOrder / scanTask 成功时服务端字段(与 order.recheckOrder.scanOrder 响应对齐) */
export type ScanOrderResultShape = {
match_type?: 'waybill' | 'wave' | 'cart' | 'task' | string
list_type?: 'single' | 'group' | string
waybill_no?: string
task_id?: number | null
picker_id?: number | null
picker_name?: string
wave_id?: number
wave_no?: string
wave_type?: number
pick_mode?: number
strategy_id?: number | null
strategy_name?: string
total_orders?: number
reviewed_count?: number
unreviewed_count?: number
list?: Array<ScanOrderSingleListItem | ScanOrderGroupListItem | Record<string, unknown>>
/** 历史兼容:车号命中旧结构 */
cart_match_view?: Record<string, unknown> | null
order_id?: number | string
order?: Record<string, unknown>
items?: unknown[]
expresses?: unknown[]
logs?: unknown[]
}
export function isRecheckApiSuccess(res: unknown) {
const r = res as { code?: number; flag?: string } | null | undefined
return Boolean(r && (r.code === 1 || r.code === 200 || r.flag === 'success'))
}
/** 解包 scanOrder / scanTask 响应 data */
export function unwrapScanOrderResponse(res: unknown): ScanOrderResultShape {
if (!res || typeof res !== 'object') return {}
const r = res as Record<string, unknown>
const d = r.data
if (d && typeof d === 'object' && !Array.isArray(d)) return d as ScanOrderResultShape
return r as ScanOrderResultShape
}
function asRecord(v: unknown): Record<string, unknown> | null {
return v && typeof v === 'object' && !Array.isArray(v) ? (v as Record<string, unknown>) : null
}
function normalizeStockRows(raw: unknown): Record<string, unknown>[] {
if (!Array.isArray(raw)) return []
return raw
.filter((item) => item && typeof item === 'object' && !Array.isArray(item))
.map((item) => {
const row = item as Record<string, unknown>
const barcodes = Array.isArray(row.barcodes)
? row.barcodes
: row.barcode
? [row.barcode]
: []
return {
...row,
item_name: row.item_name || row.name || '',
barcode: barcodes[0] || row.item_code || row.barcode || '',
barcodes,
plan_qty: row.plan_qty ?? row.qty ?? row.quantity,
images: Array.isArray(row.images) ? row.images : [],
has_shared_barcode: !!row.has_shared_barcode
}
})
}
/** 是否为无波次时的单订单详情 list 项(含 detail/items/expresses/logs) */
export function isScanOrderDetailListItem(item: unknown): boolean {
const row = asRecord(item)
if (!row) return false
return Boolean(row.detail || row.items || row.expresses || row.logs)
}
/** 将 scanOrder list 项规范化为面板订单行 */
export function normalizeScanOrderPanelRow(item: unknown): Record<string, unknown> {
const row = asRecord(item) || {}
if (isScanOrderDetailListItem(row)) {
const detail = asRecord(row.detail) || row
const items = Array.isArray(row.items) ? row.items : detail.items
const stock = normalizeStockRows(items ?? detail.stock)
return {
...detail,
order_id: detail.order_id ?? detail.id ?? row.order_id,
waybill_no: String(
detail.waybill_no ?? detail.waybillCode ?? detail.waybill_code ?? row.waybill_no ?? ''
).trim(),
stock,
expresses: Array.isArray(row.expresses) ? row.expresses : detail.expresses,
logs: Array.isArray(row.logs) ? row.logs : detail.logs
}
}
const stock = normalizeStockRows(row.stock ?? row.stocks)
return {
...row,
order_id: row.order_id ?? row.id,
waybill_no: String(row.waybill_no ?? row.waybillCode ?? row.waybill_code ?? '').trim(),
stock: stock.length ? stock : normalizeStockRows(row.stocks)
}
}
/** 将 scanOrder 团购波次 list 项规范化为面板行 */
export function normalizeScanOrderGroupWaveRow(wave: unknown): Record<string, unknown> {
const w = asRecord(wave) || {}
const stocks = normalizeStockRows(w.stocks)
const totalOrders = Number(w.total_orders ?? w.order_count ?? 0)
const processedOrders = Number(w.processed_orders ?? 0)
const recheckStatus = String(
w.recheck_status ?? (processedOrders >= totalOrders && totalOrders > 0 ? 'fin' : '')
).trim()
return {
...w,
_is_wave: true,
waybill_no: String(w.wave_no ?? '').trim(),
id: w.wave_id,
order_id: w.wave_id,
order_ids: Array.isArray(w.order_ids) ? w.order_ids : [],
orders_detail: Array.isArray(w.orders_detail) ? w.orders_detail : w.orders,
stock: stocks,
recheck_status: recheckStatus,
is_reviewed: w.is_reviewed ?? (processedOrders >= totalOrders && totalOrders > 0)
}
}
export function isOrderRecheckFinished(row: Record<string, unknown>) {
const status = String(row.recheck_status ?? row.is_reviewed ?? '').trim()
return status === 'fin' || status === 'true' || row.is_reviewed === true
}
/** confirmRecheck 成功时服务端常用字段 */
export type ConfirmRecheckResultShape = {
order_id?: number
waybill_no?: string
recheck_status?: string
recheck_time?: string
review_no?: string
reviewNo?: string
/** 是否含序列号管理商品:Y/N */
has_sn_item?: 'Y' | 'N'
/** 本次提交并校验通过的 SN 数量(非 SN 订单为 0) */
sn_count?: number
/** 本次提交涉及的序列号管理明细数(非 SN 订单为 0) */
sn_item_count?: number
}
/** order.recheckOrder.scanOrder:扫码查询订单(运单号或车号) */
export function scanOrder(data: RecheckScanOrderParams): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.recheckOrder.scanOrder',
v,
timestamp: Date.now()
},
data: pickScanOrderBody(data),
isSystemApi: true
} as any)
}
/** @deprecated 接口已下线,请使用 scanOrder */
export function scanWaybill(data: RecheckScanOrderParams): Promise<any> {
return scanOrder(data)
}
export type RecheckScanTaskParams = {
task_id: number
}
/** order.recheckOrder.scanTask:按拣货任务 ID 拉取复核扫描视图 */
export function scanTask(data: RecheckScanTaskParams): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.recheckOrder.scanTask',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/** 订单 ID;优先 order_id,兼容 id、orderId;团购模式支持 wave_id */
export type ConfirmRecheckParams = {
order_id?: string | number
id?: string | number
orderId?: string | number
wave_id?: string | number
/**
* SN 码提交(唯一格式,SN 订单必填):{ "stock_id": ["sn_code", ...] }
* - key = 仓库商品ID(订单明细里的 stock_id)
* - value = 该商品的 SN 码列表(也兼容逗号/换行分隔的字符串)
* - 数量必须等于该商品在订单内的 plan_qty 合计;非 SN 商品不允许提交
*/
sn_map?: Record<string, string[] | string>
}
function coerceOrderId(v: string | number): string | number {
if (typeof v === 'number' && Number.isFinite(v)) return v
const s = String(v).trim()
const n = Number(s)
if (Number.isFinite(n) && String(n) === s) return n
return s
}
function pickConfirmRecheckBody(data: ConfirmRecheckParams): Record<string, unknown> {
const body: Record<string, unknown> = {}
// 团购波次模式:优先使用 wave_id
if (data.wave_id !== undefined && data.wave_id !== null && `${data.wave_id}`.trim() !== '') {
body.wave_id = coerceOrderId(data.wave_id)
} else {
const raw =
data.order_id !== undefined && data.order_id !== null && `${data.order_id}`.trim() !== ''
? data.order_id
: data.id !== undefined && data.id !== null && `${data.id}`.trim() !== ''
? data.id
: data.orderId !== undefined && data.orderId !== null && `${data.orderId}`.trim() !== ''
? data.orderId
: undefined
if (raw === undefined) {
throw new Error('订单 ID 不能为空(order_id / id / orderId / wave_id)')
}
body.order_id = coerceOrderId(raw)
}
// SN 订单必填:sn_map(key=仓库商品 stock_id)透传给服务端;非 SN 订单不传
if (data.sn_map && Object.keys(data.sn_map).length) {
body.sn_map = data.sn_map
}
return body
}
/** order.recheckOrder.confirmRecheck:按订单 ID 确认复核并记录复核任务 */
export function confirmRecheck(data: ConfirmRecheckParams): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.recheckOrder.confirmRecheck',
v,
timestamp: Date.now()
},
data: pickConfirmRecheckBody(data),
isSystemApi: true
} as any)
}
/** order.recheckOrder.batchQuickRecheck 请求参数 */
export type BatchQuickRecheckParams = {
ids: number[] | string
}
/** order.recheckOrder.batchQuickRecheck 响应 data */
export type BatchQuickRecheckResponse = {
success: unknown[]
failed: unknown[]
success_count: number
failed_count: number
}
/** order.recheckOrder.batchQuickRecheck:批量快捷复核 */
export function batchQuickRecheck(data: BatchQuickRecheckParams): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.recheckOrder.batchQuickRecheck',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
export type QueryRecheckOrderSingleListWhere = {
/** 运单号/订单号模糊搜索 */
keyword?: string
/** 波次号精确匹配 */
wave_no?: string
recheck_status?: string
pick_status?: string
/** 波次内序号范围筛选,如 {"operator":"between","value":[起,止]};或使用 wave_index_min / wave_index_max */
wave_index?: { operator?: string; value?: [number, number] | number[] } | number
wave_index_min?: number
wave_index_max?: number
}
export type QueryRecheckOrderSingleListParams = {
where?: QueryRecheckOrderSingleListWhere
pagination?: {
page?: number
pageSize?: number
}
}
export type RecheckOrderSingleListItem = {
order_id?: number
delivery_order_code?: string
order_type?: string
wave_id?: number
wave_no?: string
wave_index?: number | string
pick_status?: string
recheck_status?: string
shop_nick?: string
logistics_name?: string
items_count?: number
items_total?: number
items_weight?: number | string
weight_type?: string
waybill_code?: string
status?: string
create_at?: string
pick_time?: string
recheck_time?: string
/** 是否含序列号管理商品:Y/N(SN 订单复核必须提交 SN 码) */
has_sn_item?: 'Y' | 'N'
}
export type QueryRecheckOrderSingleListResponse = {
list: RecheckOrderSingleListItem[]
pagination: {
page?: number
pageSize?: number
total?: number
totalPages?: number
hasPrevious?: boolean
hasNext?: boolean
}
}
/** order.recheckOrder.queryRecheckOrderSingleList:散单模式复核列表查询 */
export function queryRecheckOrderSingleList(
data: QueryRecheckOrderSingleListParams = {}
): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.recheckOrder.queryRecheckOrderSingleList',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/** order.recheckOrder.batchQuickRecheckByWave 请求参数 */
export type BatchQuickRecheckByWaveParams = {
wave_ids: number[] | string
waveIds?: number[] | string
wave_id?: number
}
/** order.recheckOrder.batchQuickRecheckByWave 响应 data */
export type BatchQuickRecheckByWaveResponse = {
success: unknown[]
failed: unknown[]
success_count: number
failed_count: number
}
function pickWaveIdsBody(data: BatchQuickRecheckByWaveParams): Record<string, number[] | string> {
if (Array.isArray(data.wave_ids) && data.wave_ids.length > 0) {
return { wave_ids: data.wave_ids }
}
if (typeof data.wave_ids === 'string' && data.wave_ids.trim() !== '') {
return { wave_ids: data.wave_ids.trim() }
}
if (Array.isArray(data.waveIds) && data.waveIds.length > 0) {
return { wave_ids: data.waveIds }
}
if (typeof data.waveIds === 'string' && data.waveIds.trim() !== '') {
return { wave_ids: data.waveIds.trim() }
}
if (data.wave_id !== undefined && data.wave_id !== null) {
return { wave_ids: [data.wave_id] }
}
throw new Error('波次 ID 不能为空(wave_ids / waveIds / wave_id)')
}
/** order.recheckOrder.batchQuickRecheckByWave:按波次批量快捷复核 */
export function batchQuickRecheckByWave(data: BatchQuickRecheckByWaveParams): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.recheckOrder.batchQuickRecheckByWave',
v,
timestamp: Date.now()
},
data: pickWaveIdsBody(data),
isSystemApi: true
} as any)
}
/** order.recheckOrder.confirmIntercept 请求参数:订单 ID 列表,支持数组或以逗号分隔的字符串;兼容 id / order_id / orderId 单值写法 */
export type ConfirmInterceptParams = {
/** 订单 ID 列表,支持数组或以逗号分隔的字符串 */
ids?: Array<number | string> | string
/** 单值兼容写法 */
id?: number | string
order_id?: number | string
orderId?: number | string
}
/** order.recheckOrder.confirmIntercept 响应 data */
export type ConfirmInterceptResponse = {
/** 拦截成功的订单列表 */
success: unknown[]
/** 拦截失败的订单列表 */
failed: unknown[]
/** 成功数量 */
success_count: number
/** 失败数量 */
failed_count: number
}
function pickConfirmInterceptBody(
data: ConfirmInterceptParams
): Record<string, Array<number | string> | string> {
if (data.ids !== undefined && data.ids !== null && String(data.ids).trim() !== '') {
return { ids: data.ids }
}
const single =
data.order_id !== undefined && data.order_id !== null && `${data.order_id}`.trim() !== ''
? String(data.order_id).trim()
: data.id !== undefined && data.id !== null && `${data.id}`.trim() !== ''
? String(data.id).trim()
: data.orderId !== undefined && data.orderId !== null && `${data.orderId}`.trim() !== ''
? String(data.orderId).trim()
: undefined
if (single === undefined) {
throw new Error('订单 ID 不能为空(ids / id / order_id / orderId)')
}
return { ids: single }
}
/** order.recheckOrder.confirmIntercept:库内拦截确定,入参 ids 批量匹配订单并标记拦截 */
export function confirmIntercept(data: ConfirmInterceptParams): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.recheckOrder.confirmIntercept',
v,
timestamp: Date.now()
},
data: pickConfirmInterceptBody(data),
isSystemApi: true
} as any)
}
/** order.recheckOrder.interceptScan 请求参数 */
export type InterceptScanParams = {
waybill_code: string
}
/** order.recheckOrder.interceptScan 响应 data */
export type InterceptScanResponse = {
waybill_code: string
is_back: string
after_sale?: Record<string, unknown> | null
order?: {
order_id?: number
order_no?: string
intercept_status?: string
} | null
}
/** order.recheckOrder.interceptScan:拦截扫描,通过运单号标记退回并处理关联售后工单 */
export function interceptScan(data: InterceptScanParams): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.recheckOrder.interceptScan',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
/** order.recheckOrder.recheckOrderList 请求参数 */
export type RecheckOrderListParams = {
/** 列表模式:single(散单模式,默认)/ group(团购模式) */
list_type?: 'single' | 'group'
/** 筛选条件。散单模式支持 keyword(运单号/订单号模糊搜索)、wave_no(精确匹配)、recheck_status、pick_status、wave_index(波次内序号范围筛选,如 {"operator":"between","value":[起,止]},或 wave_index_min / wave_index_max);团购模式支持 wave_no(模糊搜索)、wave_type、wave_status */
where?: {
keyword?: string
wave_no?: string
recheck_status?: string
pick_status?: string
/** 波次内序号范围筛选(散单模式),如 {"operator":"between","value":[起,止]};或使用 wave_index_min / wave_index_max */
wave_index?: { operator?: string; value?: [number, number] | number[] } | number
wave_index_min?: number
wave_index_max?: number
wave_type?: number
wave_status?: string
}
pagination?: {
page?: number
pageSize?: number
}
}
/** order.recheckOrder.recheckOrderList 响应 data */
export type RecheckOrderListResponse = {
/** 散单模式(list_type=single):订单数组,每项含 order_id、delivery_order_code、order_type、wave_id、wave_no、pick_status、recheck_status、shop_nick、logistics_name、items_count、items_total、wave_index、status、create_at、pick_time、recheck_time。团购模式(list_type=group):波次汇总数组,每项含 wave_id、wave_no、wave_type、wave_status、total_orders、processed_orders、creator、create_time、update_time、order_count、reviewed_count、unreviewed_count、review_assignment_status(unreviewed/partially_reviewed/reviewed) */
list: Array<Record<string, unknown>>
pagination: {
page?: number
pageSize?: number
total?: number
totalPages?: number
hasPrevious?: boolean
hasNext?: boolean
}
}
/** order.recheckOrder.recheckOrderList:复核订单列表查询(散单/团购模式) */
export function recheckOrderList(data: RecheckOrderListParams = {}): Promise<any> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.recheckOrder.recheckOrderList',
v,
timestamp: Date.now()
},
data,
isSystemApi: true
} as any)
}
export const orderRecheckOrder = {
scanOrder,
batchQuickRecheck,
batchQuickRecheckByWave,
confirmRecheck,
confirmIntercept,
interceptScan,
queryRecheckOrderSingleList,
recheckOrderList
}
export type {
UpdateExpressWeighingWeightParams,
UpdateExpressWeighingWeightResponse,
UpdateExpressWeighingWeightSplitItem
}
/** @deprecated 请使用 orderUpdateExpressWeighingWeight from @/api/order.index/orderindex */
export function updateExpressWeighingWeight(data: UpdateExpressWeighingWeightParams) {
return orderUpdateExpressWeighingWeight(data)
}

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