|
|
fe195114e4
|
feat(wle): 钉钉推送明细按仓聚集，并给每个仓保底 1 条
业务要求：推送明细「按照仓库来，相同仓库排序在一起」，方便各仓在群里只看自己那一段。
改动：
1. 明细按仓分桶后连续输出（groupRowsByWarehouse / bucketRowsByWarehouse）
- 组间：按该仓异常包裹数降序，与上面「按仓（异常包裹）」块顺序一致；数量相同按首次出现顺序
- 组内：保持服务层原顺序（已按 pendingHours 降序，压得最久的排最前），不重新排序
- 仓名缺失的行统一归到「未知仓」一组，不会被拆成散行
2. 取前 N 条改为按仓配额（pickDetailRows）
- 真数据验证时发现：140 条异常里山东青岗集仓占大头，直接 slice(0,40) 会让
40 条明细全是同一个仓、其它 6 个仓一条都看不到
- 规则：仓数 >= 额度时每仓 1 条（砍掉异常最少的仓）；否则每仓先保底 1 条，
剩余额度按各仓剩余条数比例分（最大余数法，总数正好等于额度）
3. 明细仍是 4 段「仓｜快递单号｜快递｜异常类型」，编号全局连续，不带时间/时长
验证：
- 单测 19/19 通过（新增 4 条：同仓相邻+组内不乱序、未知仓归组、大仓不吃满额度、额度少于仓数）
- 本地真数据干跑（140 条异常 / 列 40 条 / 4219 字节）：明细覆盖 7 个仓，
同仓全部相邻、无任何仓被拆散；明细段数集合 [4]
各仓条数：青岗集 31 / 崔桥 2 / 洛宁 2 / 睢宁 2 / 山东品牌 1 / 新苏北 1 / 崔桥品牌 1
- backend check-syntax：194 文件通过
风险与回退：只改推送正文的组装顺序与取数配额，不动查询、不动页面列表；
页面仍按时长降序展示全部明细。回退只需 revert 本提交。
|
2026-10-22 14:02:43 +08:00 |
|
|
|
7939816b64
|
fix(wle): 推送明细再去掉末尾「待处理小时数」
业务三次要求（2026-10-22）：明细最后面的超时时间也不要。
- buildDetailLine 现在是 4 段：仓｜快递单号｜快递｜异常类型
- 删除仅此处使用的 formatHours()（不留死代码）
- 「无快递单号时退回内部单号」的兜底按业务确认保留
- 文件头/函数注释补第三条口径，单测断言正好 4 段且不含 17.3h 这类时长
|
2026-10-22 11:56:11 +08:00 |
|
|
|
b223db7961
|
fix(wle): 推送明细第二列改为快递单号
业务二次要求（2026-10-22）：明细里显示快递单号，不要内部单号。
- buildDetailLine 第二段从 `oId` 改为 `trackingNo`（上游 `logistic_id`）
- 未揽收 / 无物流单的包裹本来就没有快递单号 → 退回 `oId`，
否则这条在群里无法定位（不让它变成「无单号」）
- 单测：样例带 trackingNo 并断言内部单号不出现；补「无 trackingNo 时退回 oId」用例
- 文件头与函数注释同步口径
|
2026-10-22 11:46:06 +08:00 |
|
|
|
57debbe022
|
fix(wle): 钉钉推送明细去掉发货时间列
业务反馈（2026-10-22）：推送明细里不需要发货时间。
- buildDetailLine 从「仓｜内部单号｜快递｜异常类型｜发货时间｜待处理」
改为「仓｜内部单号｜快递｜异常类型｜待处理小时数」
- 删除仅此处使用的 shortTime() 及其导出，不留死代码
- 文件头补口径说明，防止以后把 sendTime 加回去
- 单测同步：断言新列序，并显式断言消息里不出现 sendTime（传了也不能渲染）
|
2026-10-22 11:40:11 +08:00 |
|
|
|
bdc2cf9fd6
|
feat(wle): 仓储转运异常每天定点推文本到钉钉群
在「仓储中心物流转运异常」页新增「异常通知」：每天 09:10（可改）把当天核验批次
的异常情况以**文本消息**推到钉钉群，0 条也推（用来确认任务没挂）。
为什么是 text 而不是 Excel 附件：钉钉群自定义机器人 webhook 只支持
text/markdown/link/actionCard，发文件必须走企业内部应用（AppKey/AppSecret/
robotCode/openConversationId 四项凭据 + 应用权限 + 机器人进群）。业务确认
「群里看文本就够，要明细点链接去页面导出」，于是走最轻的 webhook。
后端
- 新增 services/dingtalkRobotWebhookSender.js：POST /robot/send + msgtype=text
· 加签 urlEncode(base64(HmacSHA256(secret, "timestamp\nsecret")))，timestamp 毫秒
· text.content 按 UTF-8 **字节**截断到 20000（钉钉硬上限），不切半个汉字
· webhook 严格匹配 ^/robot/send$ 且必须有 access_token；errcode/errmsg 原样抛
- 新增 services/warehouseLogisticsExceptionNotifySettings.js：
· webhookUrl 存在 system_config（完整回显，业务要核对）；加签密钥走
resilientSecretStore，接口只回 configured + 掩码，留空=沿用已存
· sendTime 非法退回 09:10；maxDetailRows 0~50 默认 30
· 状态 lastSentDate（按推送日去重）等存 system_config
- 新增 jobs/warehouseLogisticsExceptionNotifyJob.js：
· buildNotifyText：抬头【仓储物流转运异常】→ 发货/包裹/异常/异常率 → 分类型
→ 剔除数 → 按仓（只列有异常的仓）→ 明细前 N 条 → 页面链接（带 date）
· 明细行「仓｜内部单号｜快递｜异常类型｜发货时间｜待处理」，字段内换行压平
· 超长从明细末尾逐条砍并标记 truncated（truncated 只表示被字节上限砍过，
不表示「按配置只列前 N 条」）
· 每分钟 tick 比对北京时间 HH:mm == 配置 sendTime，改时间不用重启
- api：GET/PUT /notify/settings、GET /notify/state、POST /notify/run
（dryRun 预览不校验凭据；probe 只发一句测试文本、不查业务数据）
前端
- 「导出」右侧新增「异常通知」（铃铛）弹窗：开关、推送时间、Webhook、加签密钥、
明细条数、@所有人、页面链接、上次推送结果、三段帮助说明
- 「测试通道」「预览正文」「保存」「立即推送到群」
- 预览改成弹窗内受控区块：本项目跑 React 19 + antd v5，Modal.info 静态方法
拿不到 context 会**静默不渲染**（只留一行 warning，看着像后端没返回）
同步与兼容
- 新配置首次读取为空 → ready=false，页面提示「Webhook 地址还没配」，不影响页面其它功能
- 定时任务只在 enabled=true 时生效；本地 ENABLE_BACKGROUND_JOBS=false 不跑，用页面按钮验
验证
- backend/test/warehouseLogisticsExceptionNotify.test.js 15/15：正文结构与数字、
0 条平安消息、条数上限、字节精简、Webhook 校验、加签 crypto 手算对齐、errcode 透传
- 后端全量 465 项 / 463 过（2 项既有环境失败：Windows 权限位、负缓存需隧道故障态）
- 前端 eslint 0、build 成功
- 真数据干跑：144 条异常 / 列 30 条 / 3768 字节 / 20s，按仓包裹数合计 144 对得上
- playwright 真渲染：弹窗字段 Webhook/加签密钥/明细条数/@所有人/页面链接，
旧字段 AppKey/AppSecret/robotCode/群会话 ID 零残留；预览内联渲染出正文
风险与回退
- 钉钉侧失败只会记 lastState.lastError 并在页面展示，不影响页面取数
- 回退：删除 index.js 里的 startWarehouseLogisticsExceptionNotifyScheduler 注册即可停推送
|
2026-10-22 11:00:10 +08:00 |
|
