11 KiB
订单通知自动化:当前设计要求
更新:2026-10-20。与早期调研冲突时,以本文、已批准的设置与执行方案和 Excel 分类为准。
界面与权限
沿用 Tabler 1.6.1,侧栏七项:工作总览、订单通知管理、订单与导出记录、异常待办、助手、业务设置、系统设置。顶部接入原生 nav-segmented 圆角分段横栏:灰底、白色选中项、SVG图标、清晰焦点。390px 单行滚动且选中项自动进入横栏视口。所有页签为真实 hash 链接,默认首项,刷新及浏览器前后退继续有效。
订单通知管理:通知总览、订单执行、通知订单、待发批次、发送记录、通知配置。通知配置卡片内为发送计划、业务日历、邮件模板、发送设置;规则收件人在业务设置维护。通知总览显示真实时段、下一计划时点、待发数及阻塞原因;通知订单关联冻结批次及归档证据,导出记录仍独立查询采集/PDF。顶部通知状态以服务端为准,查询失败为待确认,不猜测暂停或启用。
业务横栏:分类通知规则、字段映射。系统横栏:BPM连接、邮箱管理、存储服务器、助手设置、系统健康、团队账号、操作记录。团队账号仅管理员可见;个人改密在右上角。助手主页面只保留对话和授权操作卡片。
订单与导出记录采用用户确认的A台账方案:顶部流程到达记录/PDF导出记录复用同一Tabler分段导航,对应#records/#records-pdf。到达记录默认现有连接、订单相关流程及全部到达类型,统一表格每页25条;来源与日期放更多筛选,长标题和完整来源信息在详情侧栏。历史是累计到达台账,不宣称当前待办。删除BPM连接在同一事务保留安全来源档案,关联记录进入历史归档;停用仍属现有来源,旧孤立来源保留ID且不猜账号。PDF导出状态、本地文件可下载与实际存储归档回执分别显示,无连接关联时不按订单号猜测归属。详见台账设计及验收。
表单离开保护提供保存并继续/放弃/留下;密码、新建账号等敏感或不可自动提交表单只允许放弃或留下。刷新受浏览器原生 beforeunload 保护,不可能自定义其三个按钮。提交禁重、错误保留输入;持久保存与刷新失败分别提示;旧页/旧登录响应不得覆盖当前页面。
唯一业务分类与窗口
Excel 的15类规则是唯一业务分类。流程名称、版本、配置节点必须精确对应;知会/待阅状态不能代替通知书节点。通知与更改分开,收件人和附件要求取对应分类规则。每个有效时段同类别汇总一封;空类不发,受阻类别不漏单发送。
北京时间每天两个配置时点。正常首封当天零点起;下午从上午截止起。周一或休息日后首封从上个发送工作日最后截止起,例如周五17:00到周一11:00。采用公司日历和半开区间[起点,终点),不以扫描时间代替接收时间。更早历史不自动处理,不自动追补错过时段。
标题按每个订单号拆段,只保留订单号、机芯号、产品型号、客户简称、出货方式、总数量、订单类别;原始标题保留。惠州线索只提示待确认,不生成额外邮件。BPM提交、结束、审批仍人工办理。
字段、执行与冻结
字段映射按流程及表单版本维护,左侧流程目录、右侧四步配置。主订单来自表单,摘要固定提取标题全部订单;待办元数据只读。真实样本采集独立于执行;草稿保存、统一引擎检查、确认使用分离。参考配置不能授权真实执行。确认更新后关联已发布分类暂停,须重新检查发布;冻结批次保留。详见字段映射说明及实施方案。
字段映射维护同流程/表单版本的标准业务数据接口,默认选真实订单核对候选,仅在该页维护来源、检查和生效。分类通知规则维护适用流程节点、To/Cc、模板、附件与归档目录;只显示简要接口状态,字段问题链接字段映射,不嵌入字段编辑。分类第04步用真实通知验证当前业务分发方案,调用已生效接口,不能用映射草稿/推荐值冒充生效配置。保存草稿、业务检查和发布仍分离,选单本身不写配置;详细页面职责见业务流程评审稿。
采样可从全部授权待办和明确选择的已办/历史补充字段证据,不能将旧订单入队。历史保留来源、未知节点及发起时间含义,仅可核对字段,分类发布仍要求真实通知待办。字段采集不证明PDF排版就绪。ZCode通过项目固定技能和受控卡片辅助采样、草稿与检查,不能自动生效或发布,不能接收完整表单值或任意脚本。
独立 order-execution 模块协调现有 BPM、规则、PDF、存储和邮件。真实待办包括任务、实例、修订、节点接收时间、流程版本。采集目录保存实际字段路径、中文标签、值及来源证据。管理员从目录选择映射,固定到流程版本;不能手工设置接入已就绪,不能将客户端提交路径/摘要当归档证据。未知版本、缺字段和冲突进入受阻状态并指向修复入口。
执行步骤持久化:识别、导出、归档读回校验、入队、批次冻结、发送、人工核验。归档记录文件路径、字节数、SHA256,名称按订单号/所选日期/流水号;浏览器扩展的原有四字段命名契约不变。SMB 操作限已配置共享内,禁止越界、链接、覆盖不同内容;有界worker超时退出后才释放操作。
规则保存产生草稿。发布须完整字段适配、真实样本试跑、收件人和目录齐备且无冲突。规则、收件人、正文模板、附件在批次生成时冻结,后续配置不篡改已有批次。模板保留收取、预览、确认、历史;类别须显式关联,旧产品线和群组不猜分类。
明确发送前失败可修复后重试。SMTP发出后断线、部分收件人拒绝或重启前sending均为结果待核验,禁止自动重复发信。已生成失败批次可由管理员填写依据、携带版本和幂等标识逐批补发,新尝试关联原批次和审计;已发送不可补发,unknown先核验。后台调度从不补历史。
执行失败关联异常并去重,保留负责人、失败原因和可用恢复动作;恢复成功留待人工核验,不伪造核验完成。任务查询和受控重试/补发复用现有API模块。
保留与退役
分类规则采用左侧可搜索分类卡片和拨动开关、右侧按适用通知、通知内容、归档要求、验证与发布四区配置。BPM 信息自动识别,程序字段仅在字段映射维护;模板和服务器文件夹从已有配置选择。第04步检查真实订单,移除技术样本侧栏。Excel 支持原始 .xls 合并单元格及标准 .xlsx,预览后原子保存草稿,不自动发布或启用。启停只作用已发布版本,未知版本、缺失字段和冲突仍阻塞;批次冻结、发送窗口、现场门槛保持。详见分类业务配置验收。
保留账号、BPM与只读到达历史、分类通知、导出归档、日历、模板与邮箱历史、异常协作、助手、服务健康、审计。旧监管草稿、重复连接汇总页、与Excel并行的通用通知写入/调度和逐单/产品线选项已退役。旧数据、邮件记录与模板保留查询,旧写入返回410并指出新入口,旧hash重定向。收件人仅在Excel分类规则维护。
旧到达记录扫描读取inform接口,仅供到达历史查询;订单执行独立读取实际todo接口,绝不将inform改名当todo。
海外订单通知书默认正文采用类别引导语、多条订单摘要、统一实际归档目录和签名;机芯号、型号、客户简称、出货方式、数量从标题段落独立提取。一个事件多个摘要不自动拆成多个PDF任务。其他类别格式保持兼容,附件仍按类别规则;旧模板变量保持原义,新增订单明细、存放地址、类别名称变量。已冻结批次不重新生成正文。
BPM接入与到达监听
连接以管理员启用/停用按钮控制,携带版本;停用保留账号、会话和历史,删除为独立清除动作。停用先发布状态、阻止新请求并关闭活动浏览器上下文,再排空在途工作;迟到响应不能复活连接。
连接页分别显示登录、真实待办接口与监听状态。复用近期业务HTTP成功证据,手工/后台检查合并,优先轻量请求;明确认证失效才走既有续登,权限不足、网络故障和未知跳转不重复提交凭据。
原生SignalR变化事件触发只读同步,初始/重连和配置间隔执行完整对账;断线退避,通道不可用显示轮询兜底。待办与待阅分别存储查询、分别核验,不能用计数或推送内容代替完整列表。监听遵守公司日历,不绕过PDF/归档/发送门控;自然事件覆盖仍须现场核验。详见BPM本轮验收。
安全、运维与上线
状态保存在部署机 %LOCALAPPDATA%/OrderNotificationAutomation,BPM身份/会话、邮箱、存储、助手敏感配置用本机加密身份保护;日志不包含密码、Cookie和授权码。密钥、数据库、原邮件、业务PDF、截图不提交Git。30天工作台会话、活动续期,改密撤销旧会话;仅管理员管理团队,操作员仅连接负责人范围,viewer只读。
远程登录保留精确域白名单、认证互斥、禁止任意外部导航和下载。只读订单采集另建禁脚本上下文,禁止审批/保存/提交请求及未经核验的重定向。新版门户登录成功不等于旧版表单会话就绪。
上线前备份正式SQLite、WAL及加密密钥,保持同一Windows身份,更新后检查18765/18766双端口、登录、横栏和配置状态。正式自动发信保持暂停,直到相应类别真实字段、旧版会话、共享目录、邮箱与预览完成现场核验。未核验能力显示具体阻塞,不能手动勾选ready。