cangku

lunanting/cangku

Fork 1

Commit Graph

Author	SHA1	Message	Date
yanhui	85e2db9f92	feat: 仓储中心物流转运异常页新增「导出异常明细」（Excel / CSV） - 后端新增 GET /api/warehouse-logistics-exception/export：复用列表同一套口径（getLogisticsExceptions），只把明细上限从列表 2000 放宽到 5000，不分页，判定/剔除逻辑一行未改，避免「导出与页面两套口径」。 - 结果缓存由单槽改为按 `核验日\|明细上限` 分键的 Map（上限 8 条）：页面按默认条数取、导出按 5000 取，单槽会互相踢掉 —— 导出一次，页面下次自动刷新就得重查库（20~40s）。分键后两者互不影响。 - 前端把明细过滤抽成 filterDetailOrders，表格与导出共用同一个函数，保证「导出的就是页面看到的」。 - 导出列单独定义 EXPORT_COLUMNS（13 列纯文本标题）：页面列用了 Tooltip，直接复用列定义会把表头导出成 [object Object]；运单号/物流状态/最后轨迹为空时导出为「无运单号 / 无状态 / 无轨迹」，Excel 里不留空格。 - 导出跟随当前核验日 + 选中仓 + 选中异常类型；文件名带核验日与筛选范围（仓储物流转运异常_<核验日>_<仓>_<类型>）；0 行时提示且不生成空文件；超过 5000 行时如实提示「已截断」。导出按钮做 loading，防重复点。 - 测试：新增 2 个用例 —— ①导出行数等于异常包裹数、字段齐全、带剔除口径； ②缓存按 limit 分键（页面 1000 条那份不被导出 5000 条顶掉）。 warehouseLogisticsException.test.js 26/26 通过。口径未变：承运商剔除（顺丰系全剔、京喜京东、睢宁中通按仓、武进安能/中铁/ 壹米滴答/自提/线下/商家配送）、订单终止与刷单信誉单剔除、异常 5 类判定，全部沿用 #71 已合并版本。	2026-10-22 09:58:22 +08:00
yanhui	db1ba79416	feat: 新增「仓储中心物流转运异常」页面（12 发货仓 · 每日 09:00 核验前一日已发货物流） - 后端新增 warehouse-logistics-exception 模块（Registry / Service / Api），挂载 /api/warehouse-logistics-exception；前端新增独立页面并接入左侧栏「仓储中心物流转运异常」（排在「仓储中心 24 小时发货时效」下面）。 - 核验口径：核验日 09:00 看前一日已发货订单的物流记录；12 个发货仓按仓库名最长匹配归口（子仓并入主仓，「京仓-横林二仓京东云仓」排除）。只统计揽收前的卡点：无物流单 / 未揽收 / 已揽收未中转 / 快递报异常 / 退回；运输中、派送中、已签收一律正常（干线与中转轨迹本就不回传，不再按 24h 判停滞）。明细按包裹、汇总按内部单号去重；结果缓存 5 分钟，force=1 可绕过。 - 剔除口径（业务 2026-10-21 / 10-22 定版，剔掉的既不算异常也不算发货分母）： · 承运商：顺丰系全部（唯品顺丰 / 顺丰干配 / 顺丰大件各账号）、武进安能、中铁、壹米滴答、京喜京东（快递·快运）、自提、线下、商家配送； · 有条件剔除：睢宁中通只在睢宁仓考核，其它仓异地打单的剔出； · 订单已终止：状态含取消/作废，或标签含「发货后取消」「作废」「拦截」； · 刷单 / 信誉单：订单标签含「刷单」「转空包」。「武进安能」「京喜京东」均按精确粒度匹配，不泛化成「安能」「京东」，避免误剔常州安能新、京东自营快递亿家达等正常账号。 - 时区：模块内统一用 Asia/Shanghai 取「今天」，避免生产容器 Etc/UTC 导致核验批次错位。 - 页面：分仓统计卡 + 异常类型筛选 + 明细（承运商 / 运单号 / 物流状态 / 异常标签 / 最后轨迹 / 发货时间 / 待处理小时），页脚展示剔除口径与本批剔除量；物流快照停更按黄/红两级告警，并标注「历史批次按当前物流快照重算」。验证（本地隔离环境，非生产库）： - node --test backend/test/warehouseLogisticsException.test.js → 24/24 通过 - npm --prefix frontend run check → 通过 - 本地真实数据接口实测：顺丰系、睢宁中通（异地仓）明细 0 条残留	2026-10-22 09:07:49 +08:00

Author

SHA1

Message

Date

yanhui

85e2db9f92

feat: 仓储中心物流转运异常页新增「导出异常明细」（Excel / CSV）

- 后端新增 GET /api/warehouse-logistics-exception/export：复用列表同一套口径
  （getLogisticsExceptions），只把明细上限从列表 2000 放宽到 5000，不分页，
  判定/剔除逻辑一行未改，避免「导出与页面两套口径」。
- 结果缓存由单槽改为按 `核验日|明细上限` 分键的 Map（上限 8 条）：
  页面按默认条数取、导出按 5000 取，单槽会互相踢掉 —— 导出一次，页面下次
  自动刷新就得重查库（20~40s）。分键后两者互不影响。
- 前端把明细过滤抽成 filterDetailOrders，表格与导出共用同一个函数，
  保证「导出的就是页面看到的」。
- 导出列单独定义 EXPORT_COLUMNS（13 列纯文本标题）：页面列用了 Tooltip，
  直接复用列定义会把表头导出成 [object Object]；运单号/物流状态/最后轨迹
  为空时导出为「无运单号 / 无状态 / 无轨迹」，Excel 里不留空格。
- 导出跟随当前核验日 + 选中仓 + 选中异常类型；文件名带核验日与筛选范围
  （仓储物流转运异常_<核验日>_<仓>_<类型>）；0 行时提示且不生成空文件；
  超过 5000 行时如实提示「已截断」。导出按钮做 loading，防重复点。
- 测试：新增 2 个用例 —— ①导出行数等于异常包裹数、字段齐全、带剔除口径；
  ②缓存按 limit 分键（页面 1000 条那份不被导出 5000 条顶掉）。
  warehouseLogisticsException.test.js 26/26 通过。

口径未变：承运商剔除（顺丰系全剔、京喜京东、睢宁中通按仓、武进安能/中铁/
壹米滴答/自提/线下/商家配送）、订单终止与刷单信誉单剔除、异常 5 类判定，
全部沿用 #71 已合并版本。

2026-10-22 09:58:22 +08:00

yanhui

db1ba79416

feat: 新增「仓储中心物流转运异常」页面（12 发货仓 · 每日 09:00 核验前一日已发货物流）

- 后端新增 warehouse-logistics-exception 模块（Registry / Service / Api），
  挂载 /api/warehouse-logistics-exception；前端新增独立页面并接入左侧栏
  「仓储中心物流转运异常」（排在「仓储中心 24 小时发货时效」下面）。
- 核验口径：核验日 09:00 看**前一日已发货**订单的物流记录；12 个发货仓按仓库名
  最长匹配归口（子仓并入主仓，「京仓-横林二仓京东云仓」排除）。
  只统计揽收前的卡点：无物流单 / 未揽收 / 已揽收未中转 / 快递报异常 / 退回；
  运输中、派送中、已签收一律正常（干线与中转轨迹本就不回传，不再按 24h 判停滞）。
  明细按包裹、汇总按内部单号去重；结果缓存 5 分钟，force=1 可绕过。
- 剔除口径（业务 2026-10-21 / 10-22 定版，剔掉的既不算异常也不算发货分母）：
  · 承运商：顺丰系全部（唯品顺丰 / 顺丰干配 / 顺丰大件各账号）、武进安能、中铁、
    壹米滴答、京喜京东（快递·快运）、自提、线下、商家配送；
  · 有条件剔除：睢宁中通只在睢宁仓考核，其它仓异地打单的剔出；
  · 订单已终止：状态含取消/作废，或标签含「发货后取消」「作废」「拦截」；
  · 刷单 / 信誉单：订单标签含「刷单」「转空包」。
  「武进安能」「京喜京东」均按精确粒度匹配，不泛化成「安能」「京东」，避免误剔
  常州安能新、京东自营快递亿家达等正常账号。
- 时区：模块内统一用 Asia/Shanghai 取「今天」，避免生产容器 Etc/UTC 导致核验批次错位。
- 页面：分仓统计卡 + 异常类型筛选 + 明细（承运商 / 运单号 / 物流状态 / 异常标签 /
  最后轨迹 / 发货时间 / 待处理小时），页脚展示剔除口径与本批剔除量；
  物流快照停更按黄/红两级告警，并标注「历史批次按当前物流快照重算」。

验证（本地隔离环境，非生产库）：
- node --test backend/test/warehouseLogisticsException.test.js → 24/24 通过
- npm --prefix frontend run check → 通过
- 本地真实数据接口实测：顺丰系、睢宁中通（异地仓）明细 0 条残留

2026-10-22 09:07:49 +08:00

2 Commits