liufumingren
|
6ffe7cc889
|
fix(waybill): 1688 分销单换算后按原始平台回读订单(域名回退)
平台换算只用于「选对模板」,订单行仍留在店管家原始平台分区,域名必须按
extend_props.original_platform_code 推导,否则会用错域名被判「平台已查不到」。
- fetchWaybillNo:新增 originalPlatformCode,用原始平台算订单域名;waybillGet 从 extend_props 透传
- fetchRowsForVerify:拉单核对/自动作废按原始平台选域名,并给候选行补 extend_props
- checkPlatformFinished:审核前已发货校验按原始平台选域名
- externalSendSync.resolveTarget:发货回传 PlatformType 优先按原始平台
实测同一条 1688 分销单:fxali 命中(ErpState=waitsellersend),fxdd 查不到。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 05:44:57 +08:00 |
|
liufumingren
|
0e222789dd
|
feat(order): 1688 单按分销渠道换算电商平台(抖音小店/淘宝/其他)
店管家侧没有 Alibaba(1688)面单模板,1688 单实际要用下游渠道的电子面单,
按平台 1688 找模板必然取号失败。拉单落库时按硬规则换算(dgj.normalizeOrder):
| 原始平台 | 判定(Tags / OrderTags) | 落库平台 |
|---|---|---|
| 1688(PlatformType=Alibaba) | Tag=OutChannel 且 TagValue=douyin | 抖音小店 DYXD |
| 1688 | 有 OutChannel 但渠道未映射 | 其他 OTHER(渠道留痕,等后续映射) |
| 1688 | 无 OutChannel(非分销单) | 淘宝 TB |
| 其它平台 | —— | 原平台不变 |
- 原始报文完整保留:orders.external_data 仍存店管家整包(含 Tags),platform_type 保留 Alibaba
- 状态表 extend_props 增加 original_platform_code='1688' 与 distribute_channel=<渠道原值>,便于追溯
- 历史数据由迁移 20261107020000-convert-1688-orders-to-real-waybill-platform 按同一规则换算
(8 张状态表 + orders 镜像表,迁移不做反向)
- 新增单测覆盖:抖音分销→DYXD、非分销→TB、未知渠道→OTHER(并断言原始报文保留)、其它平台不受影响
- 文档 店管家取号-旧系统提取.md §4.2.1 补充规则表与留痕字段说明
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 05:40:37 +08:00 |
|
liufumingren
|
3a4eebb71d
|
feat(shop): 店铺所在区刷新与解绑自动禁用,禁用时作废待审核订单
- 新增 shopAreaSync:按账号拉一次商家列表(同账号多店铺共享,PageSize=200 翻页),
把最新商家结构(FxUserId、分区声明 DbAreas)写回 shops.external_data;
商家已不在合作列表时自动把店铺置为禁用,并写明原因
- 手动刷新入口:POST /api/shops/{id}/refresh-area(货主权限)、
POST /api/external-print-accounts/{id}/refresh-shops-area(集团权限)
- 新增定时任务 refreshExternalShopAreas:每小时巡检,按账号 6 小时刷新一次
(DGJ_AREA_REFRESH_HOURS 可调),自动禁用店铺后不再参与自动拉单与一键拉单
- 新增 shopOrderGuard:店铺禁用立即作废该店铺待审核订单
(void_reason 前缀「店铺已禁用,暂停处理」),重新启用时只恢复因此暂停的订单;
禁用店铺再拉单直接拒绝,避免又拉回待审核单
- externalPrintOrder 待审核单核对改用 LogicOrderId 批量回读(50 单/批,最多 300 单)
- orderStatus.restore 支持显式 principalId,供无登录态的系统任务调用
- 前端:店铺列表新增「所在区」列与行内/详情「刷新所在区」按钮,
系统自动禁用的店铺状态带原因提示,启停与刷新后提示作废/恢复了多少订单
- 文档:新增 §4.2.2「所在区」刷新、§4.2.3 店铺禁用/启用与待审核订单
(原 LastWaybillCode 小节顺延为 §4.2.4,WMS 对接文档引用同步)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 00:19:02 +08:00 |
|
liufumingren
|
74ddeca3c0
|
feat(shop): 店铺支持设置默认发货仓库,拉单与未审核订单自动带仓库
- shops 新增 default_warehouse_id(迁移 + 模型 + 契约),仓库须存在、启用且属于店铺货主
- 新增 PUT /api/shops/:id/default-warehouse 单独维护该字段,外部打单平台店铺的货主权限也可配置
- 新增 shopWarehouse 服务:保存后把该店铺待审核订单中仓库为空或是旧默认值的订单回填为新仓库(手工改过的不覆盖)
- 打单平台与数据库店铺拉单落待审核时自动带上默认仓库(含 warehouse_code 快照);一键拉单店铺查询补 default_warehouse_id
- 前端:店铺列表新增「默认仓库」列与配置弹窗,新增/编辑表单增加默认发货仓库下拉(按货主过滤),详情面板展示
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-06 22:23:23 +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
|
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
|
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
|
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 |
|