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

6.6 KiB

分类通知规则首版

入口:业务设置顶部横栏“分类通知规则”;相邻“字段映射”维护真实字段目录。订单执行、通知订单、待发批次和发送记录迁至一级“订单通知管理”;发送计划、日历、模板和发送设置统一在其“通知配置”中。原页面地址仍有效。

收单范围

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

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

业务日历决定实际工作日。更早历史不自动归档/补发。已生成的失败批次可由管理员填写依据逐批补发;结果不明先人工核验,绝不自动重发。具体发送时间在“发送计划”维护。

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

配置和对应关系

Excel 15 类已建立。左侧分类卡片显示流程数、收件人数、待完善项和启停拨动开关;支持搜索与筛选。开关只控制已发布版本,恢复启用不会发布后来修改的草稿;首次启用必须先检查并发布。全局自动通知开关独立维护。

右侧分四步:

  1. 哪些订单归到这里:从 BPM 流程和节点成对选择,任一完整配对命中即可。旧版数组规则仍保持原组合含义。
  2. 自动识别 BPM 订单信息:系统自动关联已有识别配置,展示缺失的流程。未知版本和缺少信息会受阻;程序字段对应仅在“字段映射”维护。
  3. 归类后怎样处理:选择已确认的邮件模板、已配置存储服务器及服务器内文件夹。支持浏览子目录、返回上级、使用当前文件夹;读取失败保留输入。收件人、抄送、日期和 PDF 附件要求仍按类别维护。旧目录和旧模板关联保留,不猜测服务器或类别。
  4. 检查订单识别结果:选取服务器已从 BPM 采集的真实订单,展示中文订单信息、标题拆分、归档路径和邮件预览。不提供 JSON 编辑,不创建订单、文件、批次,不连接发信或办理节点。

保存只生成草稿,旧发布版本继续服务。只有当前已保存规则结合真实采集订单检查通过、业务配置完整且无启用冲突才能发布。检查单个订单不等于全部流程版本、真实目录与邮箱已完成现场验收。新表单需在字段映射核验后再发布。更新已使用映射会暂停关联分类,须重新检查发布,详见字段映射说明。

Excel 导入:支持原始 .xls(合并单元格按明确范围继承)和下载的 .xlsx 当前规则。原表底部示例和其他采购单工作表不导入;公式拒绝,文件限 2 MiB,分类工作表限 200 行、20 列。已知类别用编号或准确名称匹配,未知类别、重复行和无效邮箱逐行提示,不猜测类别。流程节点配对列使用“流程名 → 节点名”每行一对;原表多个流程共用多个节点时显示组合提示。

先预览变更,再确认保存全部草稿;任何行出错或期间规则被修改都整次拒绝。确认幂等,重复提交同次预览不重复生成版本;预览30分钟有效且仅创建者可确认。导入不改变已发布版本或邮件开关。Excel 只有文件夹名称时,需在第03步选择真实服务器补成共享路径;模板关联与日期不凭文字推断。

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

标题生成邮件正文

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

在第04步选择实际采集的 BPM 订单,可对照原始标题与识别结果。真实接入使用样本的title字段;旧brief包含订单号标签时同样执行提取,旧读取保留兼容;新建或更新的映射必须检查标题订单提取,不能使用表单摘要代替。显式标题中没有订单段落或有空订单号时校验阻塞,不能静默丢掉订单。

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

只读核对历史邮件

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

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

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

接入边界

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

执行协调器复用真实待办、只读快照、PDF、归档与邮件模块。实际接口检查产生能力状态;V4短期SSO与只读表单数据读取已核验,但每个类别的真实通知字段仍须现场核验,不能把门户登录成功当成全部类别已就绪。默认暂停且禁止未核验能力启用生产发送。现有待阅扫描保留历史用途。BPM的提交/结束始终由人工办理。

正式工作台

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