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

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

正式工作台

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