yanhui
bdc2cf9fd6
在「仓储中心物流转运异常」页新增「异常通知」：每天 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 注册即可停推送
60 lines
2.5 KiB
JavaScript
60 lines
2.5 KiB
JavaScript
import request from './request';
|
||
|
||
// 转运异常要扫一遍「昨日发货」的物流宽表（rpt 下全是视图），冷启动实测 20 秒左右，
|
||
// 超时放大到 3 分钟，避免前端先断开、后端还在跑。
|
||
const TIMEOUT_MS = 3 * 60 * 1000;
|
||
|
||
// 仓储中心物流转运异常：12 个发货仓的异常单量 + 明细
|
||
// params.date 核验日 'YYYY-MM-DD'（默认：已过 09:00 用今天，否则用昨天）
|
||
// params.limit 明细条数上限
|
||
// params.force 1 = 绕过 5 分钟结果缓存
|
||
export const getWarehouseLogisticsExceptions = (params = {}) => request.get(
|
||
'/api/warehouse-logistics-exception/list',
|
||
{
|
||
params,
|
||
timeout: TIMEOUT_MS,
|
||
headers: { 'Cache-Control': 'no-cache' },
|
||
}
|
||
);
|
||
|
||
// 口径元数据（12 个仓、异常类型、回看天数），不打库，秒回
|
||
export const getWarehouseLogisticsExceptionMeta = () => request.get(
|
||
'/api/warehouse-logistics-exception/meta',
|
||
{ timeout: 30000 }
|
||
);
|
||
|
||
// 导出用：同一套口径、不分页（明细上限放到 5000），比列表更慢，超时再放大
|
||
export const getWarehouseLogisticsExceptionExportRows = (params = {}) => request.get(
|
||
'/api/warehouse-logistics-exception/export',
|
||
{
|
||
params,
|
||
timeout: 5 * 60 * 1000,
|
||
headers: { 'Cache-Control': 'no-cache' },
|
||
}
|
||
);
|
||
|
||
// ── 每天定点推文本到钉钉群 ────────────────────────────────────────────────
|
||
// 通道 = 群自定义机器人 webhook（不发 .xlsx，只发 text；加签密钥可选）
|
||
// 读配置：加签密钥只回掩码（webhookSecretConfigured + webhookSecretPreview）
|
||
export const getWarehouseLogisticsExceptionNotifySettings = () => request.get(
|
||
'/api/warehouse-logistics-exception/notify/settings',
|
||
{ timeout: 30000, headers: { 'Cache-Control': 'no-cache' } }
|
||
);
|
||
|
||
// 保存配置：加签密钥留空 = 沿用已存的，不必每次重填
|
||
export const saveWarehouseLogisticsExceptionNotifySettings = (payload = {}) => request.put(
|
||
'/api/warehouse-logistics-exception/notify/settings',
|
||
payload,
|
||
{ timeout: 30000 }
|
||
);
|
||
|
||
// 立即推送 / 预览正文 / 测试通道
|
||
// dryRun=true 只组装消息不发送（返回正文全文）
|
||
// probe=true 只发一句通道测试，不查业务数据
|
||
// 冷启动要全量扫一遍物流宽表（生产实测 3~4 分钟），超时给足
|
||
export const runWarehouseLogisticsExceptionNotify = (payload = {}) => request.post(
|
||
'/api/warehouse-logistics-exception/notify/run',
|
||
payload,
|
||
{ timeout: 10 * 60 * 1000 }
|
||
);
|