31 Commits

Author SHA1 Message Date
liufumingren
adfc48d8bf fix(order-sync): 一键拉单查询店铺时补上 external_data,修复提示缺少商家 FxUserId
resolveShops 的字段白名单漏了 external_data,导致异步拉单任务拿到的店铺实例没有商家原始结构(店管家 FxUserId / 分区 DbAreas),逐店拉单统一报「店铺缺少商家 FxUserId」;单店手动拉取与定时拉单用全字段查询,故不受影响。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-06 19:56:31 +08:00
liufumingren
e49c25cd19 feat: 主体停用后下拉置灰不可切换、数据只读、定时任务跳过
- principalCheck 中间件加载主体状态:停用主体只放行读请求(GET/HEAD/OPTIONS)与导出任务提交,
  其余写操作(新建/编辑/推送/删除)一律 403「主体已停用,仅可查看与导出」
- 可选主体列表包含停用主体并按「启用优先」排序;/api/auth/profile 返回 status/disabled
- 顶栏主体下拉显示「xxx(已停用)」且不可选择;当前主体停用时在顶栏下方显示只读提示条
- 定时任务跳过停用主体:自动拉单、订单推送 WMS、发货推送、出库推送、发货结果回传平台、一键拉单任务
- 主体自身的 GET/PUT 未加主体状态校验,运维仍可通过接口重新启用

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 23:31:45 +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
797bbbcd82 feat(shop): 数据库店铺商品表/订单表支持拉取状态过滤(可填多个状态值)
- shop_database_configs 增加 product_filter_column/values、order_filter_column/values
- 配置弹窗在商品表、订单表下新增「状态字段 + 状态值」:状态字段选源表列,状态值可填多个(回车追加)
- 拉取时按状态列 IN (多个状态值) 过滤,订单表与时间窗条件同时生效;未配置状态列表示不过滤
- 保存时校验状态列存在、填了状态列必须至少填一个状态值(最多 100 个)
- 修复 DATASETS 数据集缺失 key 导致过滤校验窜到订单明细表的问题

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 16:54:36 +08:00
liufumingren
23a7715dc9 feat(shop): 数据库店铺新增回传单号设置,发货确认后把运单号写回客户库
- shop_database_configs 增加回传设置:方式(不回传/写回字段/写回行)、目标表、运单号字段、定位字段、间隔符、写回行字段映射
- 配置弹窗新增「回传单号」区块:写回字段选表+字段+定位字段+间隔符;写回行按回传值(订单号/运单号/快递公司编码/快递公司名称/回传时间)逐项选列
- 保存时校验回传表与列在客户库中存在,回传行必填项(订单号、运单号)
- 发货确认(WMS 回推运单号)后自动回传:写回字段按间隔符合并写单值,写回行按订单号先删后插保证幂等;失败只记日志不影响发货确认

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 16:33:15 +08:00
liufumingren
c7a3a01faf feat(shop): 数据库店铺支持拉取商品与订单,一键拉单纳入数据库店铺并收紧货主范围
- 新增 shopDatabaseSync 服务:按商品表/订单表/明细表字段映射读取客户库,写入店铺商品与待审核订单(含明细重建、幂等更新、无明细跳过、已流转单只刷新平台侧数据)
- shop_database 控制器新增 pull-products / pull-orders 接口与路由、contract
- 一键拉单任务新增 database / all 范围,resolveShops 支持按货主收窄,runShop 走数据库店铺分支
- 店铺列表新增「拉取商品」「拉取订单」,订单页一键拉单可按范围选择店铺

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 16:20:50 +08:00
liufumingren
d68ee9905d feat(order): 建单仓库/商品按店铺货主限制并校验防注入
- create:仓库必须与店铺同货主;新增 _assertItemsOwner 校验明细商品/组合货主
  (兼容 item_id / product_id 两种明细口径)
- update:先处理店铺变更并推导生效货主(越权换店铺 403),仓库与明细按生效货主校验,
  货主变更同步 order_index;subsidiary_id 禁止接口直写
- saveItems / changeWarehouse:补充同货主校验
- filters:货主权限下仓库下拉同步收窄,店铺/仓库下拉返回 subsidiary_id
- 前端:建单弹窗仓库按店铺货主过滤、切店铺自动回落并清空跨货主商品,
  ProductSelect 新增 subsidiaryId 透传商品搜索与查询弹窗
- 契约:店铺/仓库下拉项补 subsidiary_id,建单店铺/仓库字段说明同货主约束
2026-11-05 03:09:34 +08:00
liufumingren
baa89a7509 feat(dashboard): 首页看板按货主收窄 + 店铺货主创建后不可变更
- dashboard 服务新增货主范围(_ownerScope/_scopeBillWhere),概览、趋势、库存流水、
  Top 商品、最近流水均按当前账号所属货主收窄;首页加货主范围标签
- 店铺编辑禁止修改所属货主(历史无货主可补齐一次并联动店铺商品),详情返回 subsidiary_name
- 更新店铺契约描述
2026-11-05 03:09:26 +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
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
b4b7c56729 feat: 权限范围收束与员工档案规则
- 新增 access 服务与 /api/access/context:按角色组权限判定集团 / 所在公司范围
- 菜单树按范围裁剪:所在公司范围仅保留「员工档案」,其余系统管理菜单隐藏
- 员工档案:角色组与所属公司必填;所在公司范围仅可见、仅可关联自己所属公司
- 创建者(所有者)行禁止编辑与解绑,且不可被移出主体;禁止新建所有者
- 所在公司范围禁止修改自己或他人的角色组、所属公司
- 新增员工时邮箱已注册则复用既有账号(reused),不再报「该邮箱已注册」
- 迁移:将所有者 role_id 统一指向系统管理员角色组

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 00:50:42 +08:00
liufumingren
e1e3bb638f feat(order): 拉单任务、外部发货同步与取号记录
- 拉单任务:新增 order_sync_tasks 异步任务池,按店铺逐店拉取外部打单平台订单,前端轮询进度
- 外部发货同步:配送后把发货结果同步回店管家,提供数量统计与批量重试(externalSendSync)
- 取号:新增 waybill_fetch_records 记录取号过程,外部快递接口补充菜鸟授权信息
- 补齐相关迁移、订单页同步入口/状态展示,并新增对接说明文档

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-04 20:53:35 +08:00
liufumingren
eaf957ed14 feat(express): 外部打单快递接口、自定义快递编码与回 OMS 取号
- 外部打单平台快递接口:按账号同步平台模板、绑定快递编码、查看模板明细;打开列表只读库,仅「从平台同步数据」时拉取
- 系统管理新增自定义快递编码字典,订单改快递 / 物流下拉合并系统与自定义编码,推送奇门沿用订单上的编码
- 新增 OpenAPI deliveryorder.getwaybill:WMS 批量回取号(单次≤100、并发4、逐单结果),快递编码只取 WMS 报文,取消/作废/归档返回失败,已取号直接复用
- 新增 openapi_request_idempotency 请求级幂等:request_id 回放、报文摘要校验、30 分钟 stale 接管、7 天定时清理
- 外部打单平台订单按平台 fetch_waybill_no 下发 need_oms_waybill,推送时实时判定并回写单据
- 店铺、打单账号平台配置与「平台+编码→模板」绑定走 Redis 缓存,绑定/账号变更主动失效,避免批量推送与取号逐单查库

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-04 04:10:37 +08:00
liufumingren
581fa926df feat: add batch courier update for pending orders
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-03 20:34:47 +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
69b26bf7cc feat(platform): 统一系统预设平台编码,外部平台标识按预设转换
- 新增 app/lib/platformCode.js:17 个预设平台(1688/DW/DYCS/DYGX/DYXD/JD/KS/MAOCHAO/
  MTYYJK/OFFLINE/OTHER/PDD/SPH/TB/TGC/TM/XHS)+ 别名表(中英文、大小写)+ 未知落 OTHER
- 店管家硬编码 PlatformType → 预设映射(Pinduoduo→PDD、TouTiao→DYXD、WxVideo→SPH、
  Alibaba→1688、Taobao→TB、KuaiShou→KS、Tmall→TM、JingDong→JD…)
- 拉单落库统一:orders.platform_type、order_status_*.source_platform_code/name
  写预设编码与本系统中文名(推 WMS 的 sourcePlatformCode/Name 同源)
- 店铺商品 platform_type 同样落预设编码
- 新增 scripts/migrate-platform-codes.js(npm run platforms:migrate):
  按同一口径迁移历史数据,默认 dry-run;已执行迁移 14 类(订单 27 / 店铺商品 44 / 状态表 15+13)
- 前端新增 constants/platform.ts(code→中文名):店铺商品「平台类型」列显示中文名,
  订单详情新增「来源平台」行
- 新增 platformCode 单测(5 项,含未知平台落 OTHER)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-03 17:31:44 +08:00
liufumingren
e6d3f1ba8d fix(external-print): 来源订单号改用店管家系统编号(LogicOrderId)
问题:外部打单平台订单的来源订单号 / 去重键取的是 PlatformOrderId(平台单号),
但平台单号并不唯一(同一平台单可拆成多条逻辑单),唯一标识是店管家的「系统编号」LogicOrderId。
例如 订单编号 261023-105376715090914 的系统编号是 695351624597601813。

- normalizeOrder:external_order_id / order_no 改用 LogicOrderId(缺失时回落平台单号),
  平台单号以 platform_order_no 单独带出
- 订单表 extend_props 增加 platform_order_no,便于按店管家「订单编号」对账
- 订单详情抽屉新增「平台订单号」一行(有值才显示)
- 新增 scripts/migrate-logic-order-id.js(npm run orders:migrate-logic-id):
  把历史订单的来源订单号从平台单号迁移到系统编号,同时改写 orders / order_index /
  各状态表 / order_status_items / 配送单,并补写 extend_props.platform_order_no;默认 dry-run
- 修正 orders.external_order_id、order_index.parent_order_no、orderFields 的字段注释

已执行迁移 20 条(备份见会话 files/backup-before-logic-order-id-migration.json),
迁移后重新拉单 created=0 / updated=14,确认不会产生重复订单。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-03 04:36:14 +08:00
liufumingren
107b81bb6a feat(external-print): 支持「全部待处理」拉单,修复订单分页 500 条截断
背景:店管家「待发货」页的条件是 ErpState=waitsellersend(+ IsPdd/OrderByField),
但实测该 Filters 仅 fxali 域名接受,fxdd / fxpdd 会返回「登录信息过期,请重新登录」,
无法直接复用服务端过滤;改为「宽时间窗拉取 + 本地按平台发货状态过滤」,结果与平台一致。

- 手动拉单新增「全部待处理(不限下单时间)」(days=0):覆盖店铺历史积压的未发货订单
- 修复分页截断:平台不返回 PageCount(多为 null),原逻辑只取第一页,
  任何分区超过 500 单时会被静默截断;改为以 Total + 满页判断翻页
- 拉单遇「登录信息过期 / token is invalid」自动重新登录并重试一次,
  避免定时任务因会话到期整天失败
- 契约与头部注释同步更新

实测店铺 19(意洁):全部待处理 → 未发货 18 单(PDD 11 / Alibaba 4 / KuaiShou 1 / Taobao 2),
跳过平台已发货 3637 单;与逐分区直连平台的统计完全一致(18 单)。
DB 待审核合计 20 单(含店铺 18 的 2 单 WxVideo)。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-03 04:32:57 +08:00
liufumingren
a4213bfd0d fix(external-print): 拉单只取平台未发货订单,已发货/已终结不再进待审核
问题:店管家 /NewOrder/List 只支持按时间窗查询,不提供发货状态过滤,
原实现仅按 UpFxUserId 归属就整批入库,导致 sended/success/close 的订单
全部堆进「待审核」(实测店铺 19 近 7 天平台返回 385 单,真正待发货只有 11 单)。

- dgj 新增 isOrderFinished():ErpState∈sended/success/close(及各平台等价状态)、
  有 OnlineSendTime、面单 IsSended=true、LogisticStatus>0 任一命中即视为已处理;
  PrintState/ExpressPrintTime 仅表示已打印面单,不作为判定依据
- listOrders 过滤未发货订单,返回 skipped 与 finished 列表
- externalPrintOrder.syncOrders 新增 voidFinishedOrders():本地仍处于待审核、
  平台侧已发货的副本自动作废(写 void_at/void_reason + 操作日志),已审核订单不动
- orderStatus.voidOrder 支持 principalId(定时任务无登录态)
- 手动/自动拉单消息、接口返回、接口契约、前端提示补充「跳过已发货 / 自动作废」统计
- 新增 scripts/cleanup-shipped-pending-orders.js(npm run orders:cleanup-shipped):
  按同一口径清理历史脏单,默认 dry-run,--apply 才删除
- 新增 isOrderFinished 单测(7 项)

已清理历史脏单 103 条(备份见会话 files/backup-shipped-pending-orders.json),
清理后待审核仅剩 2 单真实的平台待发货订单。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-03 04:14:02 +08:00
liufumingren
2d98d5e7eb fix(order): 待审核 / 待推送 / 异常视图不再提供删除,删除仅限已取消订单
- 行内动作:待审核、异常去掉「删除」;待推送原本就没有;删除仅保留在「已取消」视图
- 后端 DELETABLE_STATUSES 收窄为仅 canceled,接口层同样拒绝(原来允许
  待审核 / 异常,与状态机设计冲突,可绕过流程把单据直接抹掉)
- 拒绝文案改为「仅「已取消」的订单允许删除(其余请先取消再删除)」
- 同步更新面板顶部动作说明

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-03 03:48:29 +08:00
liufumingren
81855f2cab fix(order): 修复状态表存在无索引记录的订单导致「列表可见但详情提示非本主体」
现象:异常/委外中/配送/已作废/已取消/历史等视图里能看到订单,
点「查看」却报「存在 1 条订单不存在或不属于当前主体」。

根因不是主体过滤缺失,而是数据不一致:
列表按状态表查询,详情按 order_index 校验主体;
历史迁移留下 25 条「状态表有行、order_index 无记录」的脏数据
(异常 8 / 委外中 5 / 配送 3 / 已作废 1 / 已取消 1 / 历史 7),
于是列表看得到、详情必然失败,报错文案又让人以为是跨主体。

改动:
- orderStatus.list:加 EXISTS(order_index) 条件,只返回索引表存在且主体一致的订单,
  杜绝同类脏数据再次「列表可见、点不开」
- 新增 scripts/repair-order-index(npm run order-index:repair):扫描各状态表补写缺失的
  索引记录(支持 --dry-run),已执行修复上述 25 条

验证:7 个视图列表与详情全部一致(pending 105 / exception 8 / outsourcing 5 / delivery 3 /
void 1 / canceled 1 / history 7,详情失败均为 0);principal=6 各视图均为 0 条;
人为插入孤儿行后列表不再显示该行。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-03 03:46:00 +08:00
liufumingren
a9cca6aa6f feat(log): 新增操作日志(店铺商品/系统商品/组合商品),并修正明细口径
操作日志:
- 新增 operation_logs 表与 model/service/controller,接口 GET /api/operation-logs
  (按 target_type + target_id 分页查询,主体隔离,按时间倒序)
- 店铺商品:采集进系统、平台已无此商品被移出/下架、绑定/解绑均留痕(含原绑定与受影响订单数)
- 系统商品:新增 / 修改(记录变更字段与前后值)/ 删除
- 组合商品:新增 / 修改(含子商品构成前后值)/ 删除
- 日志为旁路能力:写入失败只告警,不影响业务操作

明细口径修正:
- 已审核订单(待推送及之后)的明细在审核时已锁定,重算时按状态过滤,
  重新拉单与改绑定都不再波及(原先会覆盖老表 order_items 的解析结果)
- 组合商品构成/系统商品资料变更后,重建绑定方的待审核订单明细与商品摘要;
  并修正重建时读不到同事务内未提交构成的问题(loadBindings/loadComboItems 传事务)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-03 03:43:30 +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
489563a4b2 feat(backend): 仪表盘报表接口、配置裁剪、单号 5 位与账号名称/头像
- 仪表盘报表:新增 app/service/dashboard.js + app/controller/dashboard.js +
  app/lib/billStatus.js,注册 GET /api/dashboard/report(jwtAuth + principalCheck),
  一次聚合返回概览指标、发货单/入库单/出库单状态分布与待办、近 N 天单据量与
  出入库数量趋势、库存 Top 商品、最近出入库流水;warehouse_id 只过滤单据与流水
  (product_stocks 无仓库维度);契约 dashboard* 同步到 swagger
- 接口配置裁剪:仓库接口配置只保留 api_version 与 item_name_with_spec;
  历史 warehouse_apis.extra 冗余键、owner_code 配置、递交/回传设置一并清理
  (迁移 20260915002400~02800)
- 入库/出库/发货单报文与字段对齐 WMS 标准:去掉 ownerCode、operatorCode 等多余字段,
  入库明细补 itemId;发货单明细去掉无意义的 owner_code(迁移 20260915002600)
- 单号 5 位起:四张单据表 AUTO_INCREMENT 提到 10000(迁移 20260915002900)
- 账号名称/头像按主体维护:principal_users 增 name/avatar 并回填(迁移 20260915003000/03100),
  新增 app/lib/accountProfile.js(关联表名称/头像 → users 兜底);审核人写入 operator/operator_name;
  register 不再写 nickname、updateProfile 仅接受邮箱/手机号
- 出库单推送/锁库存链路的配套调整(outboundOrderPush、订单与发货单控制器)

Co-Authored-By: GitHub Copilot <noreply@github.com>
2026-09-14 16:09:35 +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
77da5e1c69 feat(backend): 发货单批量操作与店铺必填/推送校验
- 新增批量审核 audit-batch、批量推送 push-batch、切换发货仓库 change-warehouse、设置所属店铺 change-shop

  统一由 _buildScope 解析范围(scope_by=ids 按勾选 / filter 按筛选条件),支持 dry_run 预览影响范围

- 手工单必须选店铺:create/update 必填且不允许清空、audit 校验、pushOne 无店铺直接跳过;shop_nick 为空时按 shop_id 兜底补齐并回写快照

- 修复范围解析与「目标店铺」字段重名导致命中 0 条:店铺筛选取 from_shop_id,changeShop 前剔除 shop_id

- 契约新增 changeDeliveryWarehouseRequest/changeDeliveryShopRequest/orderDeliveryBatchRequest 等,createOrderDeliveryRequest 的 warehouse_id/shop_id 改为必填
2026-09-13 02:42: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
8597cf5ac9 feat(backend): 用户鉴权、菜单权限、主体与系统基础模块
- 登录/邮箱验证码/密码流程(controller/auth.js、lib/emailCode.js、middleware/jwt_auth.js)
- 主体(principal)隔离与主体用户、对外接口配置模块及 principalCheck 中间件
- 菜单、用户、文件上传、快递公司字典(express_companies)等基础模块
- 通用工具:分页(lib/pagination.js)、缓存(service/cache.js)
- 全量接口契约(contract/index.js)与路由注册(router.js)、config.default.js 配置
- 相关迁移:菜单组件调整与菜单种子、创建 files 表
2026-09-13 02:23:34 +08:00