回调重试说明

编写人：刘洋

适用：行政协同平台外出通知

日期：0000-00-00

状态：生产已按本说明执行

一、适用范围

员工提交请假、预订成功、访客到达后，平台要给企业微信或前台屏送出通知。对方一时收不到时，按本文重试。单据本身已经保存，重试只补通知。总部 420 人的这三类通知都走同一套间隔。生产从 v1.2.4 起按本文执行，陈静于 9月10日对照过发送日志。

二、重试间隔

四次都用同一个 eventId。对方应按 eventId 去重，避免主管收到四条一样的待办。9月18日有 23 条文本待办在队列恢复后一次送达，没有因为重试变成 46 条。

三、成功与放弃

1. 对方在 3 秒内返回成功码，记为送达，不再重试。
2. 四次都失败后，状态改为待人工，页面上员工仍能看到单据已提交。
3. 待人工的条目进入值班群，工作日 18:00 前由当天值班人补发。
4. 补发仍用原 eventId。9月至今人工补发 2 条，都是前台屏样机重启期间的访客到达。

四、观察

陈静每周一统计上一周的重试次数。9月16日至 9月20日共发送 186 条，第一次就成功 179 条，重试后成功 5 条，待人工 2 条。待人工比例 1.1%，低于张伟定的 3% 关注线。若连续两周高于 3%，刘洋要检查对方地址和超时是否仍为 3 秒。下一次统计日是 9月23日。统计时按事件种类分开：请假待办、预订结果、访客到达。9月16日至 20 日三类分别是 92、71、23 条。待人工的 2 条都属访客到达，补发人是刘洋，补发后屏上只新增 1 次弹窗。186 条里第一次成功的占 96%。陈静把 3% 的关注线画在周报里，本周 1.1% 用绿色标注，无需升级张伟。五条重试成功的间隔都落在 30 秒或 2 分钟，没有用到第 4 次的 10 分钟。刘洋认为当前间隔够用，10 月前不调整。