Files
order-notification-automation/docs/unattended-system-design.md
T

8.9 KiB
Raw Blame History

订单通知书无人值守系统:目标与实施边界

历史调研或分阶段记录;当前能力与设计要求见 设计要求。本文件中的订单标识样例已替换为虚构值,旧站点记录不构成兼容要求。

更新:2026-10-23(Asia/Shanghai)。本文件保留目标与历史边界;当前本机处于受限测试,正式生产部署与全业务验收尚未完成。当前业务权威是 source/订单通知书邮件发送信息.xls 的原始 15 类精确流程/节点(不含“生效”别名、不含 BOM;海外 4 个流程仅 订单专员(订单通知书))。原生 OrderExecutionCoordinator/OrderRuleDispatcher 已通过最终全量验证并完成本机切换;旧根目录 pipeline 未启动。

当前测试约束:BPM 只读,不已阅、不审批、不保存;仅在本机 Desktop 测试目录归档。PDF 归档是通知前置条件,To 固定 2639266652@qq.com、Cc 为空、附件为空。模板直接绑定类别,listVersion/formVersion 分开,源 brief 原样保留,展示层一单一行且保留问候/说明/签名。当前允许清单必须有服务端新鲜扫描证据,effective admittedAt 不覆盖 raw receivedAt;冻结和发送前都重新复核任务存在。

产品线和模板 ID 由类别配置显式指定,Excel 不提供这些字段;测试产品线暂用 rule.name,并明确标为测试标签。固定 QQ、空 Cc、Desktop 目录是受控测试覆盖值,不是原 Excel 的正式目的地;正式原始目的地不提交 Git。

当前本机已更新为Excel规则执行桥版本,原数据与输出路径保留,正式服务机未更新。本轮核心回归29项全部通过,约74秒;此前基础整合全量990项为历史验收记录,并非本轮全量结果。13:03/13:09的17条待办快照均未匹配,不代表当天没有应通知任务。当天邮件反查已确认两笔试产类订单在11:24/11:25办理Excel确切通知节点,另有一笔海外返工节点名称与Excel不同,用户已选择继续按Excel保持阻断。当前只扫描待办,尚无已办通知任务补偿读取;历史步骤只提供完成时间而缺少通知任务ID/到达时间,不能伪造执行事件或自动补发。仍按Excel分类分批,不照抄人工邮件的跨类合并。PDF及归档运行能力待首笔合格任务实检,计划意图已启用,页面仍显示受阻。15类真实闭环未验收,零售国内返工订单更改评审仍缺适配器。详细证据和待确认项以本轮整合验证为准。

最终验收目标

工具常驻运行,自动发现符合业务规则的订单,按模板整理通知书、归档并上传 210 服务器,按产品线选择收件群组,每天在两个约定时间自动发送邮件。日常运行不要求用户逐张打开订单、点击扩展或确认打印。保留浏览器操作能力,以兼容 BPM 页面和接口。

2026-10-16 历史阶段只具备基础 PDF 导出与手动扩展。当时接口线索不构成可用性证明;当前代码与本机启动恢复已有全量测试和实机回执,逐类真实业务及正式存储仍须验收,不能用模块存在代替闭环证据。

历史目标链路(受顶部当前权威约束)

  1. 扫描与识别:按配置访问实际业务列表,分页读取候选订单;按流程类型、完成状态、产品线等规则筛选。区分扫描发现时间和业务更新时间,保存扫描位置并回查一段重叠窗口,避免分页变化或延迟造成漏单。
  2. 详情与导出:浏览器自动进入匹配订单详情,读取命名和模板字段,调用现有静态 PDF 排版模块;不再依赖 activeTab 或用户点击。经过核实的接口可辅助获取列表与数据,浏览器操作作为兼容路径。
  3. 整理与归档:按订单号、项目编号、型号、通知书编号命名;保存结构化字段及模板版本。附件是否下载、是否合并 PDF 由业务规则决定,不能默认把附件条目当作已归档文件。
  4. 上传:通过确认的协议写入 210 服务器指定目录,核实上传结果后记录地址。服务器完整地址、协议、目录和访问方式需要配置。
  5. 匹配模板与群组:根据产品线映射发件配置、收件人/抄送和标题正文模板;缺少映射的订单进入待处理列表,不发送到猜测的群组。
  6. 每天两次发送:调度采用 Asia/Shanghai。按约定时间截取本批次待发订单,按产品线汇总或逐单发送;记录批次、订单版本、收件群组、模板版本与发送结果。
  7. 恢复与异常:进程重启后从持久记录继续。登录失效时提示重新登录;失败任务可重试。邮件超时或连接断开导致结果不明确时标记“待核实”,查询发送方记录或人工核实后再决定是否重发,不承诺邮件链路的严格 exactly-once。

运行架构

  • 常驻本地程序:负责周期扫描、任务状态、模板、归档、上传、发送调度及日志。调度属于本工具,不能以对话中的提醒代替实际业务运行。
  • 浏览器执行端:保持可访问 BPM 的浏览器会话,按任务自动打开/检查订单标签页。现有扩展需要增加后台任务入口与就绪判断,不能把手动导出扩展宣称为无人值守版本。
  • 持久状态库:按当前权威以 source + portalSource + taskId 识别处理单位;业务修订缺失不补 0,旧 ID、冻结回执及已知 sent/unknown 保留并禁止自动重放;新任务独立处理,同任务字段变化或旧版本重复记录进入人工核对。分别记录发现、导出、上传、待发、发送成功、失败、结果待核实。现有内存中最近 20 个导出任务仅适用于手动版,不能充当无人值守状态库。
  • 配置与运行面板:编辑筛选条件、两个发送时间、模板、产品线群组、服务器和邮件渠道;查看当前登录状态、上次扫描、待发量、发送记录及异常。运行账户与敏感配置不写入源码或普通日志。
  • 常驻条件:需要一台在发送时段运行且可访问 BPM、210 服务器和邮件服务的机器。若使用浏览器会话,还需明确公司登录过期策略;没有合法自动续期方式时,不能保证永久不需人工登录。

去重与发送语义

  • 已处理的同一通知任务不重复加入待发队列;新 taskId 独立处理,已知 sent/unknown 不自动重放。
  • 默认首次部署不补发全部历史订单,先预览候选范围,再设置起始时间。
  • 多次启动和定时触发通过互斥锁/批次记录防止并行重复处理。
  • 正常失败可按限制退避重试;发送结果不明确时停止自动重发该项。
  • 发送固定为北京时间 11:00、17:00;停机或迟到不即时追赶/回填,无新增不发空报。不自动回填历史窗口:仅有提供器证明且已纳入不可变清单的待办,可保留到下一合法 11:00/17:00 窗口;非纳入历史任务保持 missedWindow 人工核验。已冻结 prepared 批次只有 30 分钟发送宽限,超时不得自动发送。

2026-10-16 历史业务配置清单

其中精确 Excel 范围、任务身份、测试目的地、附件和 11:00/17:00 发送窗口已有顶部权威;以下旧选项不能覆盖当前设置。

配置 所需信息
订单识别 实际 BPM 列表入口、流程/产品线、通知触发状态、新单/更改单范围
两次发送 两个北京时间、周末规则、按产品线汇总还是逐单、错过时段的补发策略
整理模板 现成模板路径或示例、必需字段、附件与链接形式
收件群组 产品线对应收件人/抄送,以及没有匹配项时的处理人
210 上传 完整地址、协议、归档目录、文件命名/权限和访问方式
邮件渠道 企业邮箱/SMTP/邮件接口等实际渠道、发件身份与允许的鉴权方式
运行环境 常驻机器、网络访问、开机启动、浏览器登录有效期

推荐实施顺序

  1. 核实业务列表和筛选规则,做只读自动扫描,输出“会处理哪些订单”的清单。
  2. 将浏览器自动进入详情、字段采集、现有 PDF 排版接成无需逐单点击的流程,建立持久去重与恢复。
  3. 按确认的模板整理并对接 210;生成完整待发邮件预览,验证产品线群组映射。
  4. 对接实际邮件渠道及本工具的两个每日时段,验证测试邮件、失败恢复和去重,再启用目标群组的正式自动发送。

当前合并代码已通过最终全量测试,实际切换未完成且尚未部署。19 条当前未匹配候选只记录、不归档、不发信;1 条隔离 SMTP 测试邮件曾被用户收到,但不代表 15 类真实闭环。零售国内返工订单更改评审 适配器缺失仍阻断;两条历史样本无历史通知节点证据。