24 Commits

Author SHA1 Message Date
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
6c03a20364 feat(backend): 订单状态分表、WMS 推送与归档
- 新增 order_index 索引表 + 6 张同构状态表(待审核/异常/委外中/配送/已作废/已取消)与历史表,
  订单 ID 全局唯一,状态由业务事务推动:审核、驳回、取消、作废、恢复、归档
- 明细表 order_status_items、收件人文本智能解析、批量切换仓库/店铺并刷新快照
- WMS deliveryorder.create 推送(单条/批量)、推送失败定时重试、订单归档定时任务
- 迁移:建表、旧发货单数据迁入新表、菜单合并与迁移记录清理
- routes / swagger contract 补充订单状态接口

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-30 23:06:18 +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
liufumingren
39c19a4de7 feat(backend): 出入库记录与库存锁定链路、出库单快递/收件人与推送队列
- 出入库记录(库存流水):新增 stock_records 表/模型/只读接口(列表 + 业务动作选项)与「出入库记录」菜单;
  库存变动统一收敛到 app/utils/stockRecord.js#applyStockChange,与流水写入同事务(含变动前后总/锁定/可用数量)
- 发货单:审核(1→2) 按明细锁定库存、发货确认(3→4) 扣减、推送失败退回/驳回/取消/作废释放(新增 stock_locked 列);
  恢复(9→1) 时曾推送过的单据换号(WMS 取消后原单号仍被占用,沿用旧号重推会被判「订单已存在」)
- 出库单:新增快递(express_code/express_name)、收件人(receiver_*) 与多运单号(express_codes) 字段;
  推送报文补齐 logisticsCode/receiverInfo;新增出库单推送服务与定时任务
- 快递:多运单号回填、仓库快递映射(warehouse_express_mappings) 与快递字典补录等迁移
- 契约:补充出入库记录、出库单快递/收件人等定义(swagger.json 为本地生成、不入库)
2026-09-14 00:59:23 +08:00
liufumingren
11e7b26ced feat(backend): 发货单模块与 WMS 定时推送队列
- 发货单主表/明细表(order_deliveries / order_delivery_items)控制器与模型
- 表头金额与明细派生字段重算(utils/recalcOrderDelivery.js)
- 状态流转:审核/驳回/取消/恢复/作废、批量审核、批量切换仓库
- 审核入队 + 定时推送:service/orderDeliveryPush.js(乐观锁 CAS 防重、失败重试上限 3 次、业务失败退回待审核)+ schedule/orderDeliveryPush.js
- 收件人 AI 智能识别(service/ai.js,DeepSeek)
- 相关迁移:建表、站内字段、明细表、订单类型默认值、快递字典、菜单种子、历史数据搬迁
2026-09-13 02:23:47 +08:00
liufumingren
ec81f8b3cd feat(backend): 入库单/出库单全流程与 WMS 对接
- 入库单、出库单控制器与模型(状态流转、审核、驳回换号、作废、删除约束)
- 明细共用 stock_items:应/已数量、行级库存类型 ZP/CC、明细锁定
- lib/wms:单据类型常量(orderTypes)、奇门/openapi 客户端(qimenClient)、签名(sign)
- 库存联动:utils/stock.js、utils/completeInbound.js(入库完成加库存,幂等)
- 驳回换号:utils/rejectBillNo.js;旧 orders 模块同步调整
- 相关迁移:入库单 WMS 字段/审核/推送结果、明细计划与实际数量、单据类型落 WMS 编码、出库库存扣减标记等
2026-09-13 02:23:44 +08:00
liufumingren
cbd16752a5 feat(backend): 商品、店铺、组合商品、仓库与库存模块
- 商品/商品图片、店铺、店铺商品、组合商品及明细
- 仓库、仓库商品(WMS itemId 映射)、仓库接口配置与字段定义(warehouseApi/warehouseApiField)
- 库存:stock_items、product_stocks(ZC/CC 双维度)与库存重算工具(utils/recalcStock.js)
- 库存单据与对接日志:stock orders、api_outbound_logs
- 相关迁移:shops/shop_products/stock_orders/warehouses/warehouse_apis/warehouse_products/product_stocks/files-images 等表与字段
2026-09-13 02:23:39 +08:00