liufumingren
|
3b1c13492c
|
fix(send): 发货回传用取号记录的分区,别用模板记录的 dbname
线上「意洁」整批回传失败固定报 `店管家发货同步失败:12;ErrorCode=500`。对同一单、同一
fxdd 域名、同一模板只改 dbname 做对照(该单平台侧已发货,正确报文只会回「不是待发货」):
- dbname=y/2wUDWCZOk=(模板记录 external_print_express_interfaces.dbname)→ 12 / ErrorCode=500
- dbname=''(host 默认区) → 「存在不是待发货的商品」(业务类,正常)
- dbname=dzh93a8…(取号记录 dbname) → 同上,正常
根因:resolveTarget 把模板记录的 dbname 当成订单分区去发 OnlineSend / 回读订单行,
而那个值是「模板接口」的区(同账号所有模板相同),平台在错的区里解析 Orders → 抛 500,
Message 只回一串数字,看起来像报文缺字段(连带 §9f067c1 的实时行重试也拿不到行)。
- resolveTarget:dbname 改取 waybill_fetch_records.dbname(取号就在那一区成功),无取号记录时 ''
- 模板同步/查询仍用模板记录的 dbname,两者不混用
- recordFailure:报文类失败的备注里附平台原始返回(先 500 字内),订单页即可看到真实返回
- 报文类失败但回读不到实时订单行时,备注里明确写出来(原来静默按首次错误落库)
- 单测 externalSendDbname.test.js 2 例;文档补 §2.1.2(对照表 + 口径表)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 22:48:33 +08:00 |
|
liufumingren
|
4501ca3922
|
fix(send): 批量重试也节流并给出续跑提示
「同步异常」是 3 次失败后自动落的状态,定时任务只捞「待同步/待重试」,不会自愈,
要靠配送异常视图的「重试同步外部发货」人工重排。重试原本是一次性把所有单顺序打完、
没有间隔也没有上限,异常单多时容易把平台打成高频访问。
- externalSendSync.retry:逐单之间留 EXTERNAL_SEND_INTERVAL_MS(默认 300ms,与定时任务一致);
单次立刻同步上限 limit(默认 200),超出部分重置为「待同步」交给定时任务续跑,不会丢
- 返回值补 synced / remaining
- 前端重试提示带上「本次同步 N 条」与续跑说明
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 22:10:58 +08:00 |
|
liufumingren
|
349f7f2949
|
feat(pull): 「新增 0、更新 N」时说明这些单为什么不在待审核
拉单结果只报「新增 0 / 更新 N」,用户会以为「拉到 8 单却没落库」。
实际是拉单按平台单号(老表 orders.order_no = 平台code-平台单号)去重:
已在系统里的单只刷新平台状态与收件人,不会重复新增,也不会把已审核过的单退回待审核。
- externalPrintOrder.buildRefreshHint:created=0 且 updated>0 时给出说明
(已在「待推送 / 配送 / 历史」,或因平台侧已发货被自动作废,可按平台单号搜索)
- 接进 syncOrders 的 hint 链(零单/补查/兜底都不命中时才用)
- 单测补 1 例(含「有新增不提示」「0 更新不提示」)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 22:08:31 +08:00 |
|
liufumingren
|
9f067c1b58
|
fix(send): 发货回传遇平台 500 时改用实时订单行重发
线上「意洁」全部订单发货回传失败,文案只有 `店管家发货同步失败:12;ErrorCode=500`。
用同一账号对平台做对照实验(真实订单)确认:同一个单用**平台实时订单行**发送
`IsSuccess:true`;用本地快照行但清空 `SubOrders` 则回
`{"Success":false,"ErrorCode":"500","Message":"服务器繁忙,请稍会儿再试."}`。
即 500 是「平台没解析订单报文」,与订单业务状态无关。
- 新增 lib/platformError.isPayloadRejected:ErrorCode>=500 / 服务器繁忙 / 系统异常 /
Message 只有一串数字 → 报文类失败;业务类(不是待发货、都没打印、风控拦截、请先勾选)与限流不算
- resolveSendRow:本地快照拼出的行若 SubOrders 为空则不使用,改回读平台实时订单行(warn 留痕)
- syncOrder:命中报文类失败时用 forceRemote 回读订单行重发一次,成功即置「已同步」
- recordFailure:把平台原始返回写进日志,便于下次直接定位缺了哪个字段
- 单测 platformError.test.js;文档补 §2.1.1(对照实验表 + 兜底三步)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 22:04:37 +08:00 |
|
liufumingren
|
176e0c0f97
|
fix(order): 明细解析只认本单店铺,防跨店铺串号
线上出现「订单明细绑到了别家店铺的商品」:旧解析接口(`POST /api/order-items/{id}/parse`
与 `POST /api/orders/{id}/parse-items`)匹配店铺商品时只按 `principal_id + 平台商品ID +
规格ID` 查,同一个平台商品被多个店铺采集时(同款分销、多店铺同源)会命中别家店铺的行,
把别家的规格与绑定关系套到本单上,出库会发错货。
- 新增 lib/shopProductMatch.shopProductScope:匹配条件的唯一口径 —— 有店铺信息时只认本店铺,
只有无店铺信息的手工明细才退回主体范围;拉单(externalPrintOrder)与重解析共用它
- 解析逻辑下沉到 service/orderItemParse(`findShopProduct` / `isStaleShopProduct` /
`resolveItem` / `parseOrderItems`)。原来 order.js 里用的 `ctx.controller.orderItem`
在 Egg 里并不存在(controller 只挂到 app.controller),该接口一直是 500
- 失效关联自愈:明细指向别家店铺或已被删除的店铺商品时,重解析会连带清空
product_id/combo_product_id/item_type,不再沿用错误的系统商品;批量解析不再跳过这类脏数据
- 单测补 shopProductScope 4 例(本店铺 / 手工退回主体 / 空规格 / 缺商品ID)
实测(真实库,插入即回滚):shop 18 有、shop 19 没有时解析结果 shop_product_id=null、
product_id 同时被清空;补上 shop 19 的商品后命中 shop_product_id=1077、parse_status=1。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 21:38:03 +08:00 |
|
liufumingren
|
c73cc826d7
|
fix(order): 商品同步/补拉后自动重匹配未采集的订单明细
问题:拉单早于商品入库(新店铺第一次拉单,或商品是事后才补拉的)时,明细会停在
shop_product_id=null(parse_msg「未采集到该店铺商品」),之后商品补齐也不会自动
变化 —— 订单页一直显示未绑定,还被「仅已绑定」过滤掉,看起来像「有商品却匹配不上」。
另外「重新解析」旧接口只回写 order_items,改不动订单页读的状态明细表。
- 新增 lib/shopProductMatch:把「店铺 + 平台商品ID + 平台规格ID」等值匹配抽成纯函数,
明细带规格ID时必须精确命中同规格,不退化按商品ID乱取(避免不同规格绑成一行)
- orderItemResolve.rematchUnboundItems:商品写入后在同一事务里补匹配该店铺
shop_product_id 为空的明细,并重建命中订单(只动待审核/异常,已审核随审核锁定)
- saveShopProducts 调用它并返回 rematched;同步/单品补拉两个接口与前端提示都带上
- 文档补 §4.2.5:明细 → 店铺商品 → 系统商品的匹配口径、两种 parse_status=2 的区别
- 单测 shopProductMatch.test.js(精确命中 / 不退化 / 无规格取首行 / 空输入)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 21:30:29 +08:00 |
|
liufumingren
|
8e2419c870
|
feat(order): 待审核列表提示被隐藏的未绑定商品订单数
拉单提示「成功 9 单」但列表只显示 3 单,实际是明细商品未采集/未绑定的订单被
默认过滤(exclude_unbound=1)掉了,界面上看不到任何线索,容易误判为漏拉。
- service/orderStatus.list:exclude_unbound=1 时额外统计未过滤总数,返回 hiddenUnbound
- controller/orderStatus.index:输出 hidden_unbound
- contract.orderStatusPage:补 hidden_unbound 字段
- 前端 StatusPanel:工具栏显示「另有 N 单未显示」(hover 说明原因),点击即切到「含未绑定」
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 21:15:01 +08:00 |
|
liufumingren
|
d179cd3993
|
fix(pull): 一区(老分区)声明缺失时补扫 + 退化全量时提示可能漏单
用户报「抖音/抖店一区的 5 单拉不到」。按平台单号定位:5 单全部在
`fxdd.dgjapp.com(抖店-186,即一区)`,`ErpState=waitsellersend`、
`UpFxUserId=953516`、`ShopId=4500493`,新系统区/精选区里没有它们。
一区能拉到的前提是「待发货」过滤生效(`Contract` 必须是单个 `=`)。
- dgj.listOrders:把分区扫描抽成 scanArea;声明里没有老分区时不再直接跳过,
而是先挂起(deferredLegacy),新系统分区一单都没拉到时回头补扫老分区
(rescueHosts),命中会记 warn;确实有单时仍跳过并在 skippedLegacy 里列出
- externalPrintOrder:buildSupplementHint 兼容「补扫老分区」与「补查其它域名」两类;
新增 buildFallbackHint —— 有分区退化为「时间窗全量」时提示
「平台全量列表不含待发货单,可能漏拉,请检查后端版本(订单过滤 Contract 需为单个等号)」
- 单测:pullOrderHint.test.js 补 2 例(补扫老分区提示、退化兜底提示),
test/app/lib 75 passing
实测(本地库,同账号):只声明「抖店-二区」时 listOrders 仍能拿到
6931208417510390802 / 6931197358224080335 / 6931209886018010885 /
6919330748987944687 / 6931230754941796036 这 5 单(待处理 7 单)。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 21:03:14 +08:00 |
|
liufumingren
|
f47d8ccdec
|
fix(pull): 声明分区过期时补查其它域名 + 商家ID失效按名称重绑
用户现象:意洁点「拉取订单」0 单,但店管家 UI(精选-二区)有单;「同步商品」
同样 0 条,而「按商品ID补拉」能拿到 —— 说明不是没有数据,是**全量拉取只查了店铺
声明的域名/分区声明**(external_data.DbAreas)里那几块,声明过期就永远拉不到。
- dgj.listOrders:声明域名一单都没拉到(且没有平台已发货登记)时,补查账号其它域名
(FALLBACK_PRODUCT_HOSTS 里未声明的),命中记入 supplementHosts 并 warn;
「按商品ID补拉」本来就是这个兜底策略,现在全量拉取也一致
- dgj.listProducts:声明域名一个商品都没有时同样补查其它域名
- externalPrintOrder:新增 buildSupplementHint —— 靠补查才拉到单时提示
「店铺声明的分区 X 没拉到单,已自动补查 Y 并拉到 N 单;建议刷新店铺所在区/商家」
- shopAreaSync:商家ID在平台已不存在时,先按店铺名称在商家列表里找**唯一**候选并
重新绑定(rebound,写 warn 日志);同名多候选/已被别的店铺占用/无名称时不猜,
保持原有「标记已解绑并自动禁用」逻辑
→ 修掉「重新授权/换绑后商家ID变了,店铺被当成已解绑而禁用,拉单一律 0」
验证:
- 单测 shopAreaSync.test.js(唯一命中 / 同名多候选 / 已占用 / 空名称)、
pullOrderHint.test.js 补 3 例(补查提示与边界),test/app/lib 73 passing
- 真实库:把意洁店铺的 extId 改坏后 refreshAccount → 按名称重绑回 3966847、
FxUserId 恢复 953516、状态未被禁用;再刷新 5 个店铺 missing/disabled 均为空;
声明域名只保留 toutiao 时应能靠补查把抖店 6 单拉回来(已单测覆盖提示口径)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 19:40:33 +08:00 |
|
liufumingren
|
61a9587851
|
feat(pull): 拉单 0 单时给出「商家对不上」的排查提示
抖音平台订单拉不到排查结论:平台侧数据本身能拉到(意洁的 1688→抖店分销单
11-07 16:27 已入库 6 单 DYXD),问题出在「店铺声明的商家 FxUserId 与平台不一致」时
只回 0 单、看不出原因。本次让这种情况自己说话:
- dgj.listOrders:全量兜底扫描时记录平台实际出现的商家(UpFxUserId → 单量/店铺名),
返回 merchantSeen / otherMerchants
- externalPrintOrder:新增 buildZeroOrderHint —— 0 单且本店商家没出现过时,
输出「近 N 天没有出现 FxUserId=xxx(分区…),实际出现的是 意洁(953516,450 单)…」,
并提示刷新店铺所在区/商家
- 自动拉取的 last_order_sync_msg、手动拉取响应 hint / 前端提示都带上该说明
- 单测 pullOrderHint.test.js(2 例:有提示/无误报,含分区去重)
排查记录(本地账号 1 实测):
- 意洁(953516):15 天待处理 10 单 = DYXD 6 + TB 3 + PDD 1,抖音分销单正常
- 抖店分区(fxdd) 近 90 天 1099+154 单全部已发货/关闭,0 条待发货 → 平台侧确实没得拉
- 两家「奇迹商贸」店铺绑的商家 1921984 / 1844767 在全部分区 90 天内 0 单;
平台上真正有单的奇迹商贸商家是 401499 → 需要在 OMS 重新同步店铺
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 18:44:02 +08:00 |
|
liufumingren
|
9e1c476a55
|
perf(dgj): 平台请求节流 + 限流退避重试
线上取号/发货遇到服务商级限流:
`isv.request-limited 请求太频繁…配置限流QPS:600, 当前访问QPS:687`。
QPS 额度是整个 ISV 共享的,单靠降我们的并发压不住,所以两手都做:
削自己峰值 + 被限流时退避重试而不是直接判失败。
- dgj.request():所有平台调用的唯一出口,统一排队,相邻请求至少间隔
DGJ_REQUEST_INTERVAL_MS(默认 100ms,单进程约 10 请求/秒)
- postPlatformForm():命中 isv.request-limited / 请求太频繁 / 访问QPS 时
指数退避重试(DGJ_RATE_LIMIT_RETRY 默认 3 次、DGJ_RATE_LIMIT_BACKOFF_MS 默认 1000ms),
仍限流则抛「店管家接口限流:…已自动退避重试 N 次仍被限流,请稍后重试」并保留原始返回
- waybillGet:批量取号并发 4 → 2(WAYBILL_CONCURRENCY 可调),
每单 3 次平台调用(回读订单 + 模板校验 + ExpressPrint),并发越大突发越猛
- externalSendSync.recordFailure:平台限流不算这单的错,
保持「待重试」且不累加 external_send_times,避免批量重试时一批单被打成「异常」
- 单测 dgjRateLimit.test.js(4 例):限流识别、退避后成功、重试耗尽报错、全局间隔生效
- 文档:请求量控制一节补 QPS 限流口径与全部节流开关
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 09:46:45 +08:00 |
|
liufumingren
|
da468f6cb2
|
fix(send): 取号记录必须与本单运单号匹配,不再取最近一条
上一版按「最近一次成功取号记录」取快递编码与面单标识,但同一单可能取过多次号
(每次分配新号,本地库里 dgj-10000267890142_1 就有 4 条不同运单号的记录)。
随便取一条会让发货模板(快递)和 WaybillCodes 面单标识与真正发出的运单号错位,
甚至把别的运单号发到平台。
- externalSendSync.findLatestFetchRecord:按配送单的运单号
(express_codes / express_code)逐条匹配取号记录的 waybill_code / waybill_codes,
主运单优先;运单号对不上返回 null 并 warn,报文宁可不带面单标识也不拿别人的;
订单号 LIKE 前缀匹配转义下划线,避免 `..._1` 误匹配 `..._10`
- dgjSendRow:新增 parseOrderWaybills / parseFetchWaybills;
pickWaybillFromFetchRecord(raw, waybills) 只取与订单运单号一致的那张;
buildSendRow 的 WaybillCodes 只保留本单运单号,LastWaybillCode 以本单运单号为准
- 单测:dgjSendRow 补 3 例(按号选面单 / 对不上不回填 / 运单号清单解析),
externalSendTemplate 补 3 例(按号挑记录 / 无匹配返回 null / 多包裹主运单优先)
- 文档补匹配口径与实测表
真实库实测:配送单运单 772085332374413 → 记录 #14;改成 772085215446719 → 记录 #13
(不再取最新那条);改成不存在的号 → null + warn。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 09:22:16 +08:00 |
|
liufumingren
|
8a38b7a1f3
|
fix(send): 发货模板按运单实际快递定位,修抖音风控拦截
线上报 `10000280844951: 风控拦截#CONSIGN_RISK_CONTROL_BLOCK#NOT_MATCH_SEGMENT_CHANNEL#
此运单号非抖音的运单号`。
根因:发货模板取的是「账号 + 平台」下 id 最小的那条快递接口(抖音小店第一条是中通),
而运单是申通。店管家把 TemplateId / ExpressCompanyId / ExpressCompanyCode 透传给平台,
抖音按模板的电子面单渠道校验运单号,运单不在该渠道号池里就判风控。
- externalSendSync.resolveTarget:运单快递取最近一次成功取号记录的 express_code
(兜底配送表 logistics_code;注意 express_code 列存的是运单号),
再用与取号同口径的 resolveByCode 定位模板;未绑定时按模板自带快递编码匹配,
仍无命中才退回第一条并打 warn
- externalSendSync.resolveSendRow:取号记录只查一次,供模板与报文复用;
WaybillCodes 为空时打 warn(平台校验渠道依赖该字段)
- dgjSendRow.buildSendRow:面单 ExpressCpCode 优先取号记录的快递编码,模板编码只做兜底
- dgj.sendOrders:风控/渠道类失败追加处理提示(需用对应平台+该快递的电子面单模板重新取号)
- 单测:新增 externalSendTemplate.test.js(4 例);dgjSendRow.test.js 补「快递编码不被模板覆盖」
本地库真实数据验证:快手单 dgj-10000267890142_1 运单 772085332374413 属申通,
旧逻辑命中模板 #17/YUNDA,修正后命中 #29/STO;抖音四张模板按快递分别命中
(STO→10776786、ZTO→13987231、YUNDA→12360764、POSTB→12712711)。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 09:13:58 +08:00 |
|
liufumingren
|
6facd9c6f3
|
perf(log): 日志表按天分区,只保留 10 天
callback_logs / api_outbound_logs / request_logs 只增不减,DELETE 只标记删除、
磁盘不还。改为按 TO_DAYS(created_at) 做天分区,用 DROP PARTITION 物理删除。
- 迁移 20261107080000:三张日志表主键改为 (id, created_at)(MySQL 要求分区键
包含在主键里),分区布局 p_old + 最近 10 天 + 未来 2 天 + pmax
- 新增 logRetention service:补未来分区(REORGANIZE pmax)→ DROP 过期分区;
表若未分区则退化为分批 DELETE + OPTIMIZE 兜底
- 新增每日任务 purgeApiLogs(03:30):clean_request_logs 改为 disable,
避免两条清理逻辑抢同一张表
- 保留天数默认 10 天,可用 LOG_RETENTION_DAYS 覆盖
- 文档补分区口径、为什么要 DROP PARTITION、上线注意
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 08:43:16 +08:00 |
|
liufumingren
|
498543b9d7
|
perf(external-send): 控制回传平台的请求量,避免被判刷单
全部回读订单行在批量场景会被平台当成高频访问,补齐三处节流:
- syncPending:同批相邻两单之间留 EXTERNAL_SEND_INTERVAL_MS(默认 300ms)
- resolveTraceId:按账号缓存,批量内只调一次 getUserInfo(原来每单一次)
- dgj.resolveTraceId():实例级缓存 5 分钟的 traceId,
取号(fetchWaybillNo)与重打(waybillPrintData)改用它,批量取号不再逐单 getUserInfo
配合上一版的「快照拼报文」,发货每单只有 1 次 POST,不再回读订单行。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 08:14:12 +08:00 |
|
liufumingren
|
bcca0075be
|
feat(external-send): 发货回传改用本地快照拼报文,不再回读平台订单行
拉单时已把平台整行存进 orders.external_data(实测 113 字段,含 PathFlowCode /
ShippingType / OrderTags / SubOrders[].OrderItemId 这些状态表没有的内部字段),
发货报文其实就是这一行,所以没必要再回读平台。
- 新增 lib/dgjSendRow.js#buildSendRow:快照(静态内部字段)
+ 状态表(收件人/平台单号/运单号,可能晚于快照更新)
+ 最近一次成功取号记录(WaybillCodeId / Pid / ExpressCpCode / CreateDate)
拼成订单行;PrintState/ExpressPrintTime 用取号记录覆盖(快照里恒为 0/空)
- externalSendSync.resolveSendRow:快照可用就不访问平台;缺快照(历史单)才回读兜底
- dgj 暴露 buildSendOrder 静态方法,供脚本/单测复用同一口径
实测(本地真实单 dgj-10000279877231):拼出的 Orders[0] 覆盖抓包全部 47 个关键字段
(163 个顶层键),面单块含 WaybillCodeId=10000298258339、Pid=ced304e7c1ffd618_0_1。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 08:12:54 +08:00 |
|
liufumingren
|
01ab1ccdab
|
fix(external-send): 发货回传改用 /NewOrder/OnlineSend 并按抓包补全报文
生产报错「店管家发货同步失败:请先勾选要发货的订单」= 平台没把提交的 Orders 当成有效选中项。
实测对比(2026-11-07):
- 空 Orders → 「当前选中的订单都不是待发货状态,已取消发货」
- 我们的旧报文 → 「请先勾选要发货的订单」
- 抓包页面真实请求:`POST /NewOrder/OnlineSend`(不是 OnlineSendBatch),
顶层带 TemplateId / ExpressCompanyId / ExcludeOrders / RequestBatchNumber,
Orders[0] 带整行模型(ShopId、PlatformTypeName、UpFxUserId≠FxUserId、OrderTags、
ShippingType 加密串、ExpressPrintTime、WaybillCodes、Items、OrderItemStrList 等)
改动:
- ONLINE_SEND_PATH 改为 /NewOrder/OnlineSend
- 新增 buildSendOrder:按抓包字段组装 Orders[i];再补 TemplateId/ExpressCompanyId 等顶层参数
- externalSendSync 把模板 ID / 快递公司ID / 快递编码传给 sendOrders
- 响应改为「整包 Success + Data.Orders[] 逐单结果」判定:
逐单 IsSuccess=false 时,除「不是待发货状态/已发货/已取消/已关闭」(幂等)外都算失败
实测:新报文被平台接受(整包 Success=true, ErrorCode=200),
测试单返回逐单 ErrorMessage「订单不是待发货状态,请检查」(该单 08:06 已在平台手工发货),
按幂等口径视为已同步。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 08:09:56 +08:00 |
|
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
|
ba0d03414a
|
feat(order): 电商平台筛选可遍历实际平台,数据库店铺与手工单默认淘宝
- 订单筛选项新增 platforms:系统预设 ∪ 当前主体订单里实际出现过的编码(带数量,
未收录进预设的标记 preset=false),下拉按用量排序,店管家新增平台类型时不会「筛不到」
- 手工单默认 source_platform_code=TB(淘宝),新建/编辑弹窗新增「电商平台」下拉;
编辑改平台时按系统预设同步名称;外部打单平台拉取的订单该字段置灰不可改
- 数据库店铺拉单按店铺配置的平台落库(未配置时默认淘宝),待审核订单可见可筛
- 迁移 20261107010000:把「数据库店铺订单(extend_props.source=shop_database)」与
「手工单(extend_props.labels 含手工单)」里为空的电商平台回填为 TB/淘宝
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 01:18:21 +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
|
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
|
f5b717f612
|
perf(print): 店管家拉单按「待发货+商家」过滤,时间窗对齐平台 15 天
- NewOrder/List 带上 ErpState=waitsellersend 与商家 FxUserId 过滤,只拉待发货单
- 老分区不支持过滤(返回「服务器繁忙」)时退化为按时间窗全量,窗口封顶 15 天;
分区能力用进程内缓存记住,避免每小时反复撞接口
- 按商家分区声明 DbAreas[].IsNewSystem 跳过该平台的老分区,不再白拉迁移前的历史数据
- 首次拉单回看天数 7 → 15 天(对齐平台「待发货订单」页默认下单时间范围),
一键拉单/单店拉单前端下拉新增「最近 15 天(平台默认)」并默认选中
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 00:18:53 +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
|
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 |
|