25 Commits

Author SHA1 Message Date
liufumingren
dbca49c3fa fix(export): 序列号改为导出后按 chunk 补齐,兼容 MySQL 5.7
生产 MySQL 5.7 下订单导出报 Unknown column 't.id' in 'where clause':
根因是 SN 聚合用了「派生表 + 相关子查询 + 嵌套派生表(JSON_ARRAYAGG)」,
5.7 在派生表合并后会丢失外层别名 t。

修复:
- SQL 不再查 order_sn_codes(去掉 JSON_ARRAYAGG / 相关子查询),避免方言差异与 GROUP_CONCAT 截断
- 新增 EXPORT_TYPES.order.decorateRows:每个 chunk 查完后按订单ID批量取 SN,
  订单行模式填 sn_count/sn_codes,含明细模式填 item_sn_count/item_sn_codes(行号匹配,行号空按商品编码兜底)
- buildResult 支持 selectColumns(导出列可多于 SQL 查询列)
- 单测覆盖 decorateRows 两种模式;已用生产库(5.7.44)只读验证 5 种 SQL 组合均可执行

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-14 01:14:18 +08:00
liufumingren
44b8b09e0e fix(export): 订单导出子查询补齐筛选列,修复 Unknown column 't.*'
导出订单时,筛选条件作用于外层包装表((inner) AS t),
但内层只投影了导出列,「电商平台」筛选引用的 source_platform_code
等列不在包装表里,导致:
  Unknown column 't.source_platform_code' in 'where clause'

修复:
- 内层各状态分支固定补齐 t.principal_id / t.source_platform_code(不输出到导出表)
- 覆盖所有筛选项 × 订单行/含明细两种模式的组合校验,均通过
- 单测补充平台筛选的内层列断言

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-14 01:02:42 +08:00
liufumingren
b7010921c9 feat(export): 订单导出区分范围与内容,并带出序列号数量/列表
- 导出范围:支持 ids(导出选中,最多 500 条)或按筛选条件全部
- 导出内容:export_mode=order(默认,一行一个订单,不含明细)/ item(一行一个商品明细,订单字段重复)
- 订单导出新增「序列号数量」「序列号列表」列;含明细时按行号取该行 SN(行号为空按商品编码兜底)
- 前端导出按钮:订单类型弹窗选择「导出选中 / 按条件全部」与「订单行 / 含明细」,其余类型行为不变
- 导出任务页隐藏 ids 这类由页面自动携带的筛选字段(filters[].hidden)
- 补充 exportDefs 订单导出单测(两种模式、选中、权限、参数顺序)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-14 00:48:56 +08:00
liufumingren
61309c430f feat(order): 留存 WMS 回传的 SN 列表并支持按 SN 反查订单
- 新增 order_sn_codes 关联表(order_id = order_index.id,一行一个 SN,唯一键兜底去重)
- deliveryorder.confirm 解析 orderLines[].snList / 包裹内商品 snList,幂等写入(仅委外中/已配送的订单)
- 订单列表新增 sn_codes 多值筛选(逗号/换行分隔,最多 200 个,精确匹配反查)
- 订单详情返回 sn_codes;订单导出支持「序列号」筛选
- 前端订单页新增「序列号」批量筛选与详情序列号明细
- 补充 WMS 回传报文说明与 lib 单测

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-13 22:42:57 +08:00
liufumingren
62df580393 feat(product): 商品增加「订单唯一赠品」,明细解析整单只落一行
赠品类商品在平台上会随购买数量重复出现(数量 3 就是 3 件),也可能同时出现在多个组合里
(两份组合、不同组合都含同一赠品)。业务上赠品每单只送一份,需要按商品维度收敛。

- 迁移 add-unique-gift-to-products:products.is_order_unique_gift TINYINT 默认 0 + 索引
  (已在本机执行)
- 模型/契约/列表接口:字段透传;列表支持 is_order_unique_gift=1/0 筛选
- 明细解析:rebuildOrderItems 展开成最小单位后调用 collapseUniqueGifts
  → collapseUniqueGiftRows 收敛:同一赠品只保留第一行、数量固定 1
  (多数量 / 同一组合多份 / 不同组合都含该赠品,均只落一行);重复重建不会涨回数量
- 系统商品页:新增「订单唯一赠品」开关(带说明)、列表「唯一赠品」标记、筛选下拉;
  导出(exportDefs.product)同步加筛选与列
- 单测:orderItemUniqueGift.test.js(纯函数 5 例)+ orderItemUniqueGiftRebuild.test.js
  (真实库事务内验证两条明细数量 3 → 1 行数量 1,跑完回滚)
- 顺带修 model/product.js 里重复定义的 brand_name(eslint no-dupe-keys,两行内容相同)
- 文档 §6.1.1 补「组合拆分 + 订单唯一赠品」口径

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-08 11:28:18 +08:00
liufumingren
28adc28ea6 feat(shop-product): 店铺商品支持按平台商品ID / 规格ID 筛选
排查「某件商品/某个规格拉没拉全、绑定到哪」时只能靠关键词模糊搜,容易漏(关键词只匹配标题/商家编码/商品ID)。

- 后端 shopProduct.index:新增 outer_item_ids / outer_sku_ids 多值精确筛选(IN),
  与 outer_codes 同口径(英文逗号分隔);keyword 增加 outer_sku_id 模糊匹配,
  与导出关键词口径对齐
- 前端店铺商品页:搜索栏加「商品ID」「规格ID」两个多值输入;
  重置/查询/导出条件同步带上
- 导出(exportDefs.shop_product):补 outer_item_ids / outer_sku_ids 筛选与 whereIn,
  导出抽屉里同样能按 ID 过滤

验证:真实库按 outer_item_id=3835275595751752044、outer_sku_id IN (…) 命中 2 行;
vue-tsc / eslint / vite build 通过;test/app 139 passing(request_log 既有失败)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-08 11:04:30 +08:00
liufumingren
6b320a94b2 feat(external-api): 接口类型改为下拉「天豹云WMS」,选中自动带出基础地址
- 接口类型从只读文案改成下拉,选项为「天豹云WMS」(值仍为 qimen,服务端照旧固定写入)
- 选中后自动填基础地址 https://qimen.wms.gztbyc.com/openapi,不用手填;
  已手工改过的地址不会被覆盖
- 新增配置时默认就是天豹云WMS + 对应基础地址
- 列表「接口类型」列按类型显示中文;导出同口径(qimen → 天豹云WMS)
- contract / api 注释同步改成「天豹云WMS(类奇门JSON接口)」

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 08:25:57 +08:00
liufumingren
bc2aa988ae perf(delivery): 配送表补回传相关索引,导出补回传状态与失败原因列
明确口径:发货回传失败**不转表**——进了配送说明仓库已打包发货,是既成事实,
必须在配送表可见/可导出,只在表内标记 external_send_status,由「配送异常」视图处理。

- 迁移 20261107060000:加 `idx_delivery_send_scan (external_send_status, external_send_at)`,
  覆盖定时任务 `status IN (0,2) AND times < 3 ORDER BY external_send_at`;
  列表筛选沿用已有的 `(principal_id, external_send_status)`,EXPLAIN 确认两条都命中索引
- 订单导出补三列:回传平台状态(中文)、回传重试次数、回传失败原因
- 文档记录「不转表 + 索引 + 归档」的口径

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 08:21:35 +08:00
liufumingren
91e90cc7e2 feat(order): 新增「配送异常」视图,回传平台失败可看原因并重试
订单页左侧「配送」下面新增「配送异常」tab:
- 数据 = 配送表 + external_send_status IN (2 待重试, 3 同步异常),不用再进配送页自己筛
- 新增「回传失败原因」列(红色 + tooltip 全文),状态列保留「第 N 次」
- 行内「重试」按钮(单条重试),批量重试仍走原 resend_external
- tab 上带红色数量徽标(待重试 + 同步异常),重试后自动刷新
- 导出:配送异常视图导出时按 2,3 过滤;导出面板新增「回传平台状态」多选

后端导出补充 external_send_status 过滤(与列表接口同口径)。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 08:18:34 +08:00
liufumingren
cf0d984224 fix(shop-product): 「待绑定」只统计待审核/异常的订单,避免绑定后数字清不掉
现象:店铺商品已绑定系统商品,列表仍显示「N 单待绑定」。

原因:「待处理订单数」把 order_status_items 里所有 parse_status=2 的订单都算进去了,
但绑定只对「待审核 / 异常」的订单重建明细(syncOrderItemsOf → rebuildOrderItems 的状态白名单),
已流转(待推送/委外中/配送/历史/作废)的明细不会跟着变 → 数字永远清不掉。

- attachUnboundOrderCount:只统计 current_status ∈ (pending, exception) 的订单
- 「有订单未绑定」筛选(列表 + 导出)同口径,保证筛选结果与徽标一致
- 抽出 editableOrderIdsSql 复用

本地验证:店铺商品 59 的未绑定单从 8 → 7(其中 1 单已作废);其余不变。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 07:57:23 +08:00
liufumingren
9a944be886 feat(order): 订单列表展示电商平台,支持按电商平台筛选与平台单号批量查询
- 列表新增「电商平台」列(优先用落库的平台名称,缺失时按编码映射中文名),详情面板同口径展示
- 筛选新增电商平台多选(platform_codes)与平台单号批量精确匹配(platform_order_nos,最多 200 个)
- 平台单号批量查询复用 MultiValueFilter:收起时英文逗号拼接、展开后一行一个,与店铺商品的商家编码一致
- 订单导出同步支持这两个筛选,并新增「电商平台」导出列

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 00:28:42 +08:00
liufumingren
fe97be2893 feat(shop-product): 店铺商品支持店铺/平台类型/商家编码多值筛选
- 列表接口支持 shop_ids / platform_types / outer_codes(逗号分隔或数组,去重、上限 200),店铺与平台类型为 IN 条件,商家编码为多值精确匹配;保留单值 shop_id 与关键词模糊查询

- 前端:店铺改为多选虚拟下拉、新增平台类型多选、新增商家编码多值控件(收起英文逗号拼接、展开一行一个)

- 导出同步支持多值筛选(多选控件按 CSV 提交)并补上「平台类型」列

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-06 22:22:41 +08:00
liufumingren
739506da58 feat: 仓库接口配置一仓库一份、员工微信绑定管理、停用员工不再展示主体
1) 仓库接口配置
- 新增时校验同一仓库只允许一份接口配置(含唯一索引兜底,迁移会先清理历史重复数据)
- 接口配置页在有配置时禁用「新增配置」并提示

2) 员工档案微信绑定
- 列表返回 wechat_bound / 脱敏 openid / 绑定时间,页面新增「微信」列
- 新增员工微信绑定码、轮询结果、解绑接口(按员工系统账号绑定,绑定码仅操作人可轮询)
- 导出增加「微信绑定」列

3) 停用员工后不再展示该主体
- 主体ID列表与可选主体列表只取启用(status=1)的关联,停用后登录不显示该主体且无该主体权限
- 权限解析对停用关联直接返回空权限兜底

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 18:11:11 +08:00
liufumingren
9774ee1414 feat(stock): 出入库单/记录增加货主并按货主隔离,创建人显示员工名称
- 迁移:inbound_orders / outbound_orders 增加 subsidiary_id 与索引,按仓库回填
- 单据货主由仓库决定:创建写入、改仓库同步,接口不接受直写 subsidiary_id
- 入库单/出库单列表返回 subsidiary_name 并新增货主筛选;详情/编辑/删除/审核/
  推送/完成/取消/恢复/作废/驳回与明细接口统一加货主越界 403
- 出入库记录按仓库归属货主:列表与导出收窄、返回 subsidiary_id/subsidiary_name、
  新增货主列与筛选
- 导出:入库单/出库单/出入库记录新增货主列并按所在公司权限收窄
- 新增 resolveAccountNameMap:列表/详情返回 creator_name/auditor_name/voider_name,
  创建人展示员工名称(principal_users.name),不再回退成邮箱账号
- 前端:三个列表新增货主列与筛选,创建人/作废人展示改为员工名称

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 15:13:22 +08:00
liufumingren
2d2f781f09 feat(order): 订单关联货主与越界操作拦截
- order_index 与各订单状态表新增 subsidiary_id(跟随店铺货主),历史数据按店铺回填
- 订单列表/详情/导出按货主范围过滤,货主权限仅可见自己所属公司的订单
- 订单 id 级操作统一在 _loadIndexRows 校验货主:审核/推送/驳回/取消/作废/恢复/改仓库物流/删除/明细维护越界返回 403
- 新建订单货主跟随店铺,货主权限只能为自己公司店铺建单;平台拉单写入时同步店铺货主
- 内部任务/平台回调无登录态时按系统操作处理,不受货主范围限制
- 订单列表与导出新增货主列

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 02:15:46 +08:00
liufumingren
7c8e531362 feat(shop): 店铺/店铺商品关联货主与打单平台权限限制
- shops、shop_products 新增 subsidiary_id,店铺商品货主跟随店铺并按店铺回填历史数据
- 店铺列表/详情/新增/编辑/删除按货主范围隔离:货主权限仅可见/可维护自己所属公司的店铺,
  新增必须选货主,货主下拉仅自己所属公司;集团改店铺货主时店铺商品同步跟随
- 外部打单平台导入的店铺(type=2)在货主权限下只读:仅保留拉取订单、同步商品,不可编辑/删除
- 打单平台相关接口(平台资料、账号、商家、快递接口、外部发货)加集团权限门禁;添加店铺必须指定货主
- 货主权限菜单隐藏「外部打单平台」;店铺商品列表/绑定按货主范围隔离
- 店铺与店铺商品导出新增货主列并按范围收窄

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 02:15:42 +08:00
liufumingren
e8e83c714b feat(combo): 组合商品关联货主与同货主明细约束
- combo_products 新增 subsidiary_id(由组合明细的商品货主推导),列表展示货主
- 组合明细只允许来自同一货主的系统商品,混货主直接拒绝(接口 + 页面提示)
- 组合商品按货主范围隔离:货主权限仅可见/可维护自己所属公司的组合,创建也不能越界
- 组合编码可留空,由系统生成 ZH + 时间戳 + 随机数(主体内唯一);更新不可清空
- 组合导出新增货主列并按范围收窄;商品选择列表带出货主,选定货主后候选商品自动收窄

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 02:15:38 +08:00
liufumingren
d8539c0e3a feat(product): 商品按货主隔离与货主不可变更
- 商品列表/搜索按货主范围过滤:货主权限仅可见自己所属公司的商品,可按货主筛选
- 详情/编辑/删除对越权商品返回 403;新增只能建到自己所属公司下
- 商品创建后不可更改所属货主(历史无货主商品允许补齐一次,导入时忽略变更并提示)
- 批量导入按货主范围校验,不能导入或修改其它公司的商品
- 删除限制:被组合商品引用、或仍有库存(正品/残次品数量 > 0)时禁止删除
- 导出新增货主列并按范围收窄;商品表单货主下拉仅在新建时可选

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 02:15:32 +08:00
liufumingren
9c9a81f168 feat: 商品属性(分类/品牌/单位)关联货主
- product_categories / product_brands / product_units 新增 subsidiary_id(NULL 表示主体级、全集团共用)
- 列表与下拉按货主范围过滤:货主权限仅可见「主体级 + 自己所属公司」,并支持按货主筛选
- 新增/编辑支持选择货主,货主权限只能选主体或自己所属公司;同货主范围内名称唯一
- 详情/更新/删除对越权属性返回 403;导出新增货主列并收窄到可见范围

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 02:15:25 +08:00
liufumingren
839b81f661 feat: 商品与外部仓库关联所属货主(下属公司)
- products、warehouses 新增 subsidiary_id(下属公司),创建/更新必填并校验归属当前主体
- 商品批量导入新增「所属货主」列,按下属公司名称匹配,缺失时报错
- 商品、外部仓库列表与导出新增所属货主列、筛选与下拉控件
- 仓库下拉与详情接口返回 subsidiary_id / subsidiary_name

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 00:50:27 +08:00
liufumingren
85938c81ec feat: 组织架构、权限管理与员工档案
- 组织架构:主体管理改为组织架构页(左侧 tab:集团设置 / 下属公司),主体列表仅保留顶部下拉切换
  - 新增下属公司表 principal_subsidiaries、接口与页面,按当前主体隔离
  - 集团设置读取/编辑当前主体基础信息,补所属主体校验与更新字段白名单
- 权限管理:新增 permissions / roles / role_permissions 表
  - 权限以现有顶级菜单为分类,每个菜单两种范围:集团全部 / 所在公司
  - 系统预设角色:系统管理员(全部集团权限)、货主权限(全部所在公司权限)
  - 权限管理页只展示角色组,支持按菜单勾选权限;系统预设角色只读
- 员工档案:账号菜单改为员工档案
  - 新增员工-下属公司多对多关联(principal_user_companies)
  - 创建/编辑员工必须选择角色组;除所有者外必须至少关联一家公司
- 菜单重命名与旧地址重定向;账号导出新增角色组、所属公司

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-04 20:52:43 +08:00
liufumingren
5376dff3de feat(order): 平台订单号落库 oaid_order_source_code 并在订单列表展示
- 拉单写入状态表时,把店管家「订单编号」(PlatformOrderId)落 oaid_order_source_code
  (来源订单号仍是平台「系统编号」),随单推 WMS 的 deliveryOrder.oaidOrderSourceCode
- 新增迁移 20261103000300:把历史行 extend_props.platform_order_no 回填到
  oaid_order_source_code(已执行:pending 17 条 / void 12 条)
- 订单列表新增「平台订单号」列(手工单显示 -),订单详情、导出列同步使用该字段
- 前端 OrderStatusItem 补充 oaid_order_source_code 类型

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-03 18:01:02 +08:00
liufumingren
ab630e7c01 feat(external-print): 订单拉取与定时同步,组合商品拆分为最小单位
后端能力:
- 接入店管家订单接口(/NewOrder/List),明细归一化后按店铺商品匹配系统商品/组合商品
- 新增 service/externalPrintOrder:手动与定时拉单共用入库逻辑,同时写入待审核状态分表
- 新增 schedule/fetchExternalShopOrders:按店铺配置的间隔自动拉单(最小 3 分钟,起点重叠 10 分钟)
- 新增 lib/orderItemExpand + service/orderItemResolve:平台行与最小单位行互转;
  绑定组合商品时按「数量 = 平台数量 x 组合内数量、单价取子商品零售价」拆成子商品行,解绑可还原
- 明细新增 platform_snapshot,保留平台原样(编码/名称/规格/图片/原行号/原数量/原单价)
- 店铺商品列表支持 has_unbound_order 筛选,订单列表支持 exclude_unbound(均已同步导出定义)
- 店铺商品只读化:移除新增/编辑/删除动作,仅保留查询与绑定;
  同步商品时平台已不存在的商品自动清理(未绑定且未被订单引用直接删除,已绑定或被引用仅下架)
- 新增 scripts/rebuild-order-items 存量明细重建脚本,新增 orderItemExpand 单测(8 项)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-03 03:29:09 +08:00
liufumingren
4343bcdd17 feat(backend): 导出任务按类型声明筛选字段与导出模板
- exportDefs 为每种导出类型声明可传筛选字段与导出列模板,前端据此动态渲染提交表单
- /api/export-tasks/types 返回类型 + 字段 schema;提交时按 schema 过滤参数(cleanFilters)
- 扩充订单/商品等导出列定义与格式化规则

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-30 23:06:26 +08:00
liufumingren
fc58f79b42 feat(backend): 新增商品导出任务
- 新增 export_tasks 表与模型(迁移 20260916000000),记录导出类型、状态、进度、
  文件名与错误信息
- app/service/exportTask.js:生成 CSV(exceljs)并落盘到 upload/exports/<主体>/<年>/<月>/<日>
- app/schedule/exportWorker.js 定时执行待处理任务,cleanupExport.js 清理过期文件
- 接口:POST /api/export-tasks 提交、GET /api/export-tasks 列表与进度、
  GET /api/export-tasks/:id/download 下载
- app/utils/exportDefs.js 定义各导出类型的数据源;warehouseProduct / stockRecord 补充
  库存相关数据
- 契约补 exportTask 系列与 apikey 安全定义;.eslintrc 放行相关文件与 apikey 标签
- package-lock 同步
2026-09-14 22:14:23 +08:00