Files
order-notification-automation/docs/order-rules-guide.md
T

4.6 KiB

分类通知规则首版

入口:侧栏“分类通知规则”。六个页签为工作台、通知规则、待发批次、订单记录、发送记录、设置。

收单范围

按节点收到时间(不是流程发起时间)和北京时间计算,包含起点、不包含终点。

批次 以11:00和17:00为例
正常工作日上午 当天00:00至11:00
正常工作日下午 当天11:00至17:00
周一上午 上个工作日最后截止时点至周一11:00,通常为周五17:00开始

业务日历决定实际工作日。更早历史不归档、不补发,过期未发送批次取消。历史发送结果不明保留人工核验,不自动重发。具体发送时间在“发送计划”维护。

每个有效类别在一个时段内汇总为一封邮件,普通通知和更改分开,不按产品线误分类。缺必需PDF或归档证据会阻塞本类别;不会静默漏掉本时段订单。超过邮箱容量限制时阻塞整类并提示。

配置和对应关系

Excel15个类别已建立。选择类别后维护适用流程、节点、字段适配器、归档共享路径、文件名日期来源、主题、正文引导语、签名及主送/抄送名单。

Excel只有归档分类目录名,完整服务器共享路径与“日期”具体来源仍需业务确认。不会凭目录名猜服务器地址。

保存产生草稿,原发布版本继续服务已有任务。字段对应面板显示中文业务字段、xdatabind来源及样本值。高级选项可替换真实业务样本;校验展示命中原因、缺失字段和多重规则冲突。预置演示样本仅帮助理解,不能作为发布依据。

发布要求当前草稿经过真实结构样本校验、所有适用流程具备已核验字段适配、业务配置完整且无启用规则冲突。当前只核对了备损更改v1.4和海外返工更改v1.1表单结构,其余需补充适配。若只验证一个流程,可明确缩小适用流程范围。

未入批次的任务可由管理员填写依据后重新核对,应用当前规则并清除旧归档准备结果。已发送或已固定批次不会被规则修改覆盖。

标题生成邮件正文

标题按每个“订单号:”拆成独立段落,只保留订单号、机芯号、产品型号、客户简称、总数量、订单类别,去除客户等级、毛利、订单类型和业务模式。中文冒号、换行和<br>可识别;第二段HA订单不会遗漏,也不会只凭HA前缀推断工厂。原始标题保留在加密事件中以便追溯。

在规则的样本试运行面板粘贴“BPM 原始标题”,可对照原文与正文结果。真实接入使用样本的title字段;旧brief包含订单号标签时同样执行提取,未提供标题的现有更改摘要继续兼容。显式标题中没有订单段落或有空订单号时校验阻塞,不能静默丢掉订单。

标题的业务模式或客户简称出现“惠州”时只标注额外通知待核实。工厂额外邮件的主送、抄送、附件及触发条件尚需历史已发送邮件佐证,不自动生成第二封。

只读核对历史邮件

正式工作台的“邮箱管理”提供“只读查阅已发送邮件”入口。管理员可添加仅含IMAP配置的邮箱,授权码在本机表单输入并加密保存,不需要SMTP配置。保存不会连接邮箱;点击“连接并列出已发送文件夹”后再按日期和主题查询。

一次最多查询31天,显示最近20封(服务端上限50封);逐封打开正文、主送/抄送和附件名称。读取使用只读文件夹与UID,不标已读、不删除、不移动、不更新模板收信游标。正文以转义文本显示,不加载远程图片;正文截断和10MB容量限制明确提示。文件夹UID有效期变化时必须重新查询。

需要邮箱开通IMAP,且历史邮件已同步至服务器。仅有SMTP授权码或仅保存在Foxmail本地的已发送邮件无法通过此入口读取。真实邮箱尚未配置,当前已验证的是本地接口和模拟服务器流程,不代表已读取真实历史邮件。

接入边界

首版已实现本地规则维护、精确匹配、字段追踪、状态和版本存储、按时段类别组批、受控SMTP调度和异常核验。

实时待办、自动PDF导出和归档执行器尚未完成联调,页面明确显示“待联调”,默认暂停且禁止启用生产发送。现有待阅扫描不会冒充待办接入。BPM的提交/结束始终由人工办理。

正式工作台

运行 npm start,访问本机18766端口,使用管理员分配的账号登录。演示空间与免登录入口已移除。