订单通知自动化工作台
面向团队的 BPM 订单工作台,提供业务日历、异常待办与转交、连接管理和运行监管配置;保留 Chrome 已登录订单页导出本地 PDF 的能力。
项目最终目标:无人值守识别匹配订单、按模板整理、上传 210、按产品线群组每天两次自动发送邮件。当前实现团队工作台与 BPM Web 登录、会话保存,订单处理规则后续确定;BPM 知会不自动处理。已接入新版门户只读扫描;上传、ZCode 和业务自动通知仍待接入。完整流程背景见 无人值守系统设计,登录实现见 BPM 登录设计。
设计与部署入口
- 设计要求(当前基准):功能范围、架构、数据存储、权限、验收和实施顺序。
- 部署说明:安装、HTTPS、状态目录及备份。
- 扫描验证记录:最近验证及实际范围。
Web 看板
- 启动工具后,在部署机打开 http://127.0.0.1:18766 ,自行创建管理员账号(至少 12 位密码)。没有默认账号或默认密码。
- 管理员在“团队账号”中创建同事账号;同事使用启动窗口打印的局域网地址访问。默认监听 0.0.0.0:18766,能否跨机器访问取决于路由和 Windows 防火墙;本工具不自动修改防火墙。
- 业务日历支持月历、公司工作日/休息日/停发覆盖,采集与发送分别设置;可恢复每周默认规则,并预览发送时段。保存配置不会执行采集或发送。
- 异常待办支持创建、认领、转交、提交验证、填写人工核验依据后关闭和重新打开;显示负责人和流转记录,防止多人同时覆盖。operator 可处理异常,viewer 只读,admin 可管理全部配置。
- BPM 连接支持创建、账号托管、网页登录、检查保存、重启复用和停用。每个连接独立保存会话,由负责人或管理员操作。运行监管目前保存默认负责人、通知方式和重试上限草稿,不调用 ZCode、不执行恢复、不发送通知。
- 邮箱管理支持公司 SMTP / IMAP、模板邮件收取、预览确认和历史版本;原 PDF 记录、每日两次时间、产品线群组、团队账号和操作记录继续可用。新版 BPM 扫描结果按流程到达日期分区;自动批量发信等待业务规则联调。
界面复用 Tabler 免费开源版(@tabler/core 1.6.1),CSS/JS 全部在本机提供;MIT 原文见 licenses/Tabler-MIT.txt。青龙已有独立部署准备和 CLI,尚未接通业务,本次不启动它或复制其内部源码。
工作台账号、群组设置和原 PDF 记录保存在 %LOCALAPPDATA%\OrderNotificationAutomation\dashboard\state.json;业务日历、异常、连接与监管草稿保存在同级 workspace 目录的 SQLite 数据库中。邮箱、模板版本、原邮件、收信游标和测试发送记录保存在 mail\mail.sqlite,密码、原邮件和完整正文附件加密保存。BPM 会话加密保存在 bpm-sessions,主密钥经 Windows 当前运行用户 DPAPI 保护。数据留在运行机本地磁盘,不放项目所在的 Z: 共享盘。备份前停止服务并保护整个本地状态目录。工作台登录有效期为 30 天,每日活动自动续期;令牌哈希保存在 dashboard\auth.sqlite,服务重启后继续有效,退出登录立即撤销。已保存的 BPM 会话在同一 Windows 运行账号下恢复。
邮箱与邮件模板
- 管理员进入 邮箱管理 → 添加邮箱,填写邮箱地址、SMTP / IMAP 服务器、端口、加密方式、登录账号和密码或授权码。支持 SSL/TLS 和必须升级加密的 STARTTLS,证书正常校验;不会猜测公司服务器参数。新邮箱默认暂停收信。
- 填写 允许提交模板的发件人,保存后点击 检查连接。此操作验证 SMTP、IMAP 及 INBOX 访问,不发送邮件。确认正常后在管理邮箱中开启 模板收信,服务每分钟检查;也可点击 立即收信。
- 从名单内的邮箱新建邮件发送到托管邮箱,主题为
[模板][海外运营]订单通知 {{日期}};正文和附件作为对应产品线模板。[模板]订单通知表示默认模板。回复/转发主题、范围标记不完整、未授权发件人和超出 10 MB 的邮件不导入。首次及邮箱 UID 变化只处理近 7 天邮件,保留该日期边界和 UID 游标;只读访问,不标记已读、不移动或删除邮件。 - 打开 模板与收件群组 → 预览并确认,核对来源、发信标题、产品线、表格、图片和附件后点击 确认生效。可调整标题和产品线,或切换为纯文本编辑正文。旧版本留作历史;多人确认发生冲突时不覆盖新版本。名单控制导入,管理员确认后才生效。
- 支持明确变量
{{产品线}}、{{订单号}}、{{日期}}、{{订单列表}},不执行模板表达式。HTML 预览隔离,阻断脚本及外链图片;保留原 EML,管理员可下载原邮件与附件。邮件中的 To/Cc 不会修改业务收件群组。 - 已生效模板可点击 发送测试到本邮箱 并确认目标。使用真实 SMTP 发送到托管邮箱自身,先记录发送任务,不自动重试不确定结果。此操作不会发给产品线群组。批量订单发信在后续业务规则接入。
旧模板草稿首次启动迁为待确认版本,确认时选择实际托管邮箱。邮箱维护须从部署机回环地址或已配置的 HTTPS 反向代理访问;与 BPM 登录使用同一传输要求。密码留空保留原值,更换邮箱、登录账号或服务器时须重新录入。后台持续检查不要求一直打开网页。
复用 Nodemailer 10.1.1、ImapFlow 2.4.3、MailParser 3.9.39 和 sanitize-html 2.18.1,版本已锁定。公司邮箱真实连接需管理员录入参数后检查。
BPM 登录
自动扫描与流程到达记录
在 订单与导出记录 → 流程到达记录 查看,每个到达日期单独一个分区,按北京时间倒序展示,可按连接及关键字查询、折叠日期、加载更早日期。PDF 导出记录保留在同页另一标签。
默认每 5 分钟通过新版门户列表 API 扫描已连接账号,遵循业务日历的“采集”开关。管理员可在“扫描设置”调整间隔、暂停或开启;管理员和连接负责人可“立即扫描”,手动扫描不受日历限制。当前待阅列表作为临时采集来源,保留真实流程名,后续按业务表格配置流程范围,不标记已阅或审批。
按接口的“收到时间”划分日期,不使用扫描时间、发起日期或流水号日期。正常扫描直接复用服务端 Cookie,认证失效时调用现有续登。全部分页读取成功才提交;按连接、来源、任务标识去重,历史记录保留。记录、扫描设置及最近运行结果保存在本机 bpm-scan\scan.sqlite,不随网页关闭或服务重启丢失。
- 在正式工作台打开 BPM 连接,创建连接并指定负责人。
- 点击 开启自动续登,录入 BPM 账号和托管密码,点击 保存账号。账号输入完成后检查是否已托管,保存时以数据库唯一约束再次检查;忽略首尾空格和大小写,同一账号只能在一条连接中开启。保存后自动检查现有会话,Cookie 有效时直接复用;确认失效后,使用已托管账号在已识别的新 SSO 表单自动续登。开启后可从 管理账号 更新密码或 关闭自动续登;关闭自动续登保留有效 Cookie。
- 只有需要验证码或额外验证时,点击 远程登录,在页面显示的 BPM 画面中完成验证。有托管账号会自动填入对应入口,也可点击 填入托管账号;不复制其他浏览器的 Cookie。
- 完成新版门户登录后点击 检查并保存。新版账号验证通过即显示“已连接”;只维护新版 BPM,不提供旧版入口或检查。
- 服务启动及每 5 分钟自动恢复检查并保存有效的刷新 Cookie,无须一直打开工作台。错误密码自动重试间隔至少 15 分钟,网络故障不触发密码提交,正在人工登录的连接暂不接管。需要人工处理时建立去重待办;重复失败合并为同一未关闭待办。BPM 服务端的强制到期或注销不能靠修改本地 Cookie 期限延长,届时由自动续登恢复,验证码仍需人工完成。
- 管理员可先 停用连接,再点击已停用卡片上的 删除。确认后清理该连接的托管账号和已保存 Cookie,并移除连接;历史审计保留。正在使用的连接需要先停用。
- 关闭登录画面会释放操作权,其他负责人可继续操作;停用连接会关闭对应浏览器并清除保存的会话与托管账号。每个连接同时只允许一个工作台会话操作。
部署机可直接通过 http://127.0.0.1:18766 操作登录。其他电脑操作 BPM 登录须使用 HTTPS 工作台:可使用公司已有反向代理,代理在部署机本地连接 127.0.0.1:18766 并设置 X-Forwarded-Proto: https,再在 config.json 设置 dashboard.trustedProxy: true。仅信任本机代理;远端直接传入此头不会启用登录。代理需保留公开 Host,工作台的同源检查会比对该 Host 与 Origin。示例见 deploy/bpm-login.Caddyfile。
托管账号登记在 %LOCALAPPDATA%\OrderNotificationAutomation\bpm-sessions\accounts.sqlite。账号和密码以 AES-GCM 加密后写入数据库,账号唯一键使用带密钥的摘要,主密钥由 Windows 当前服务账号 DPAPI 保护;账号接口只返回用户名和更新时间,已保存密码不回传。服务启动先将原加密账号文件事务迁移到数据库,迁移成功再移除原条目;发现旧账号重复则回滚并保留源文件,避免覆盖。远程画面输入不会另行记录,也不保存截图文件。状态检查只访问新版门户,不执行已阅、审批、知会或通知操作。
PDF 扩展首次使用
- 双击本目录的 启动工具.cmd,或运行
npm start。保持服务窗口打开。本机已有 Node.js、Chrome 和依赖,可直接启动。换电脑使用时,安装 Node.js 22.13+(建议 Node.js 24)和 Chrome,然后在项目目录运行npm install。框架使用 Node 内置 SQLite,部分 Node 版本会打印实验性 API 提示。 - 在 Chrome 地址栏打开
chrome://extensions,启用“开发者模式”,点击“加载已解压的扩展程序”。 - 选择服务窗口给出的本机目录:
%LOCALAPPDATA%\OrderNotificationAutomation\extension。不要选择项目内的 extension 源码目录:启动时会把源码和本机配对配置一起准备到上述目录。 - 在 Chrome 扩展菜单中固定“订单通知书 PDF”。在你已登录的 BPM 中打开订单详情,点击扩展,再点击 导出当前订单。
- 面板显示保存位置后,在本目录
output\pdf查看结果。导出在后台继续,关闭面板不会取消;可再次点击扩展查看结果。
Chrome 加载扩展只需做一次。修改扩展源码、重新配对或变更端口后,先重启本地工具,再到扩展管理页点击刷新。
内置浏览器无法安装这份 Chrome 扩展。使用独立工具时,在原有 Chrome 的已登录页面操作;若该 Chrome 尚未登录,需要在该 Chrome 中登录一次。工具不复制其他浏览器的登录状态。
命名和重复导出
规则:订单号_项目编号_产品型号_通知书编号.pdf。
虚构示例:900001_DEMO-PROJECT-001_DEMO-MODEL_DEMO-CHANGE-001.pdf。
四项来自表单 xdatabind:OrderNum、ProductNum、ProductModelNEW、SN,不依赖示例订单值。缺少任一项时停止并提示;非法文件名字符替换为下划线。同名文件追加 (2)、 (3),不覆盖旧文件。
设置
复制 config.example.json 为 config.json,可更改 outputDir、本地服务 port、PDF 缩放 scale。默认 A4 纵向,缩放 0.59,与本次验证样稿采用相同参数。outputDir 可以是相对项目路径,也可以是 Windows 绝对路径。
扩展桥接服务仅监听 127.0.0.1:18765;Web 看板默认监听 0.0.0.0:18766,可用 dashboard.host 改为 127.0.0.1。配对密钥只用于本机扩展和本机程序通信,不是 BPM 登录凭据。不要分享 %LOCALAPPDATA%\OrderNotificationAutomation 中的配对配置。
能力范围
- 扩展直接读取当前浏览器页的显示值、CSS 和图片,复用该 Chrome 的登录状态;不启动远程调试端口。
- 本地程序使用隔离的无界面 Chrome 排版,禁用页面脚本和网络;保存后关闭该排版进程,不影响你正在使用的 Chrome。
- 不导出密码、隐藏控件、ViewState、讨论输入和操作按钮,不提交或修改 BPM 订单。
- 输出是页面导出样稿,不是服务器原版 PDF,也不保证与 XForm 原生打印完全一致。 不支持的图片、资源读取失败会在扩展中提示。网页内的附件只显示名称,不会自动合并附件。
- 本版包含 PDF 导出、团队协作、BPM 托管、SMTP / IMAP 邮箱与模板审核及明确操作的测试发信。上传 210、业务规则匹配、按批次自动发信及 ZCode 监管尚未接入;不会自动处理知会或修改 BPM 审批。
故障处理
- 无法连接本地工具:确认启动窗口仍在运行;端口或配对变更后刷新扩展。
- 端口占用:先关闭重复启动的工具窗口;也可在
config.json修改端口,重启并刷新扩展。 - 缺少字段:进入“海外运营订单更改评审 V7”实际订单详情;其他表单的绑定不同,需要增加映射。
- 缺少排版依赖:在项目目录运行
npm install。 - 启动入口直接运行 Node,不需要 PowerShell 脚本,也不修改系统执行策略。
开发和验证
npm test 运行命名、重名保留、真实 PDF、可见字段采集和回环 API 访问控制测试。运行时优先使用本项目安装的 playwright-core,本机也兼容 Codex 提供的依赖目录;Chrome 路径可用 ORDER_CHROME_PATH 指定。
运行本地快照回归:node scripts/export-snapshot.cjs --snapshot <snapshot.json> --assets <assets.json>。该入口仅用于已有离线快照;日常使用扩展按钮。
验证记录见 docs/verification.md。浏览器扩展需要在 Chrome 中加载后才能完成真实会话的整体验证。