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

17 KiB

订单通知中心使用指南

本指南对应当前工作台。前半部分是简短上手流程,后半部分按页面介绍功能、角色和操作边界。截图来自独立空白示例环境;demo_admin 是虚构账号,页面中的空列表不代表实际部署数据。

快速上手

  1. 在部署机启动 npm start 或双击 启动工具.cmd,在部署机打开 http://127.0.0.1:18766。首次创建管理员账号;没有默认账号或密码,新密码至少 12 位。
  2. 管理员在“系统设置 → 团队账号”创建同事账号并分配角色。登录地址可使用部署机局域网 IP;跨网段访问还要求网络路由、网间策略和 Windows 防火墙允许 TCP 18766。
  3. 先配置“BPM 连接”和“字段映射”目录,再导入或维护“分类通知规则”。根据实际业务核对流程、触发节点、收件人、模板和归档要求。
  4. 在“工具 → 存储服务器”添加 SMB 目录并分别检查读取和写入权限;在“系统设置 → 邮箱管理”配置托管邮箱并检查连接。
  5. 在“业务设置 → 通知配置”核对发送计划、业务日历、模板和发送设置。先用真实样本和受限环境完成核验;当前自动处理和自动邮件默认暂停,未通过现场检查前不要开启正式自动处理或发送。
  6. 日常查看“业务首页”“订单中心”“邮件批次”和“异常待办”。结果不明的发信先核对邮箱服务器记录,不要直接重试。

更完整的部署、规则、字段目录和备份说明见部署与维护、分类通知规则、业务配置、字段映射说明及备份恢复。

导航与角色

侧栏分为业务首页、订单中心、邮件批次、工具、异常待办、业务设置和系统设置。工具内可切换流程到达记录、PDF 导出记录、DSH 助手和存储服务器;业务设置内可切换分类通知规则、字段映射及通知配置;系统设置内可切换 BPM 连接、邮箱管理、助手设置、系统健康、团队账号和操作记录。右上角可修改个人密码或退出登录。

  • 管理员:管理连接、账号和业务配置,可执行受权限门控的恢复、归档和邮件操作。
  • 操作员:查看其有权访问的业务数据并处理分配给自己的异常;不能管理系统配置或账号。
  • 只读成员:查看有权访问的页面和记录,不能提交配置或业务状态变更。

页面会根据角色隐藏或禁用操作。连接、订单和异常信息仍受负责人及数据授权范围限制。

页面功能

业务首页

业务首页

显示订单数量、受阻订单、结果待核实和未终结批次等概况;展示当前北京时间处理窗口、下一发送时点、自动处理/自动邮件开关,以及待验证的 BPM、PDF 和归档能力。业务阻塞区可跳转异常或原批次。首页是状态汇总,不会主动执行扫描、导出、归档或发信;“待验证”不代表接入失败,也不代表功能已通过现场验收。

订单中心

订单中心

按订单号、标题、类别、来源连接、状态及北京时间接收日期筛选订单。详情可核对分类结果、受阻原因、采集证据、订单摘要、PDF/归档回执、所属邮件批次和关联异常。管理员及有权限的操作员可以发起“扫描并处理订单”;它读取授权待办并尝试采集和后续处理,但服务端会按 BPM、字段、PDF、存储和发送条件逐项阻断未就绪能力。BPM 节点的提交或结束始终由人工办理。

邮件批次

邮件批次

切换待发送、已发送或全部,按订单/标识/主题、类别、来源连接、状态和时间窗口筛选。打开批次可查看收件人、冻结正文、HTML 预览、附件和关联订单。尚在收集且可编辑的批次,管理员可在截止前修改本批邮件内容;这不会改写模板。失败批次的人工补发和结果未知批次的人工核验仅向管理员开放。SMTP 接受不等于最终送达,结果未知时必须先查证,系统不会自动重发。

流程到达记录

流程到达记录

查看 BPM 流程到达/扫描记录,可按当前或归档范围、订单或知会类型、连接、标题和日期筛选,并分页查看详情。这里是来源记录查询,不等同于订单资格认定;看到流程记录不表示已生成 PDF、归档或邮件批次。旧数据保留供追溯,不会因查看而自动补处理。

PDF 导出记录

PDF 导出记录

汇总查询手工导出任务和订单自动归档回执,可按订单号、项目、状态筛选并分页。下载前会复核当前文件可用性、访问权限和内容哈希;“已归档”表示存在持久回执,不保证文件此刻仍可访问。PDF 归档与邮件发送相互独立,PDF 不会自动作为邮件附件。

订单页在已登录的 BPM 订单页面上配合 Chrome 扩展,可以手工导出当前订单 PDF。扩展使用本机桥接服务;安装和版本要求见 README。

DSH 助手

DSH 助手

助手采用 DSH 原生交互适配的三栏工作区:左侧搜索/切换个人会话,中间阅读回答和本轮过程,右侧查看概况、证据、操作及记录。输入区固定在中栏底部;手机通过“会话列表”和“上下文”按钮打开侧栏。顶部“← 返回工具”为醒目的 110×44px 按钮,在手机上也保留。

每条会话右侧的 ⋯ 可归档、恢复或移至回收站;会话范围可切换活跃、已归档、回收站。回收站历史只读,支持恢复或经确认永久删除,没有自动清空。删除不会退回当日调用额度,独立操作审计及已延续到其他会话的上下文保留。回复/操作进行中需先停止回复或等待操作结束。继续新对话带入最近三轮上下文;父会话删除后子会话仍可继续。归档/回收站标题搜索覆盖最近 2000 个,超出时明确标注范围。

可直接描述连接、扫描或归档异常,也可输入 / 打开固定命令菜单。/help 展示帮助,/status 只刷新本机授权概况;/bpm、/storage、/archive 选择可见目标后填入诊断草稿,发送才调用模型。输入区模型控件与 /model 可按供应商选择管理员已启用的模型,下一轮生效;每轮回答旁显示实际使用的供应商/模型。移除或停用所选模型后须重新选择。概况刷新不会自动检查外部连接,未知命令不会作为提示词发送。未配置模型时仍可查看授权概况。

过程按真实阶段推送,断线后补读,必要时回退轮询;首版回答在完整校验后显示,不逐字输出,也不展示模型内部思考。概况是最近观测,证据页是该轮实际使用的快照,两者时间和范围可能不同。停止只针对模型回复,确认进程退出前显示“正在停止”;操作中断或结果不明显示“待核验”。

点击回答下方“查看操作”可审查目标、影响和操作编号,再点执行。允许的动作仍由管理员及工作台权限限定;断线、刷新、重新诊断都不会自动执行或重放旧操作。管理员代码修复入口在右栏“记录 → 提出代码修复”,先展示修改前后,测试通过后仍待审查。操作与结果保留审计。

助手不是 BPM 自动办理入口,也不能替代业务核验。不要向对话输入密码、Cookie、完整业务表单或不必要的客户信息。

存储服务器

存储服务器

管理员维护 SMB 服务器、共享目录和访问方式,可浏览共享目录、检查读取连接、检查写入权限,并查看归档配置与归档记录。可使用部署机 Windows 权限或明确指定凭据;凭据由工作台加密保存。检查连接不会保存草稿配置,写入检查会创建并清理探测文件。保存配置不等于自动归档已可用;启用前要确认目录、权限、文件命名和真实归档结果。

异常待办

异常待办

集中记录需要团队跟进的问题,可搜索标题/说明/负责人并按状态过滤。操作员可认领未分配异常、处理自己负责的事项、转交、提交核验、填写核验结果后关闭或重新打开;管理员可管理全部异常。每次状态变化都保留操作人、时间和说明。关闭异常只改变跟踪状态,不会改写邮件发送结果或重新执行订单。

分类通知规则

分类通知规则

以 Excel 类别维护精确的流程与触发节点配对,以及类别通知内容、To/Cc、模板、归档位置和验证状态。可搜索类别、导入规则文件、下载当前规则。导入先预览错误和变更,再一次性确认;错误行或并发版本变化会阻止整次提交。保存产生草稿,不会覆盖当前发布版本;真实待办样本检查通过且依赖完整后,管理员才可发布。字段目录须先在字段映射页采集。更新字段映射后,相关类别可能暂停并要求重新检查发布。

本页检查一个真实样本不等于全部类别和表单版本都已验收。当前整体自动通知仍按首页及发送设置显示为暂停/待核验;不要把规则存在或发布描述成完整业务闭环。

字段映射

字段映射

维护 BPM 实际采集到的流程和触发节点目录,供分类通知规则选择。管理员选择授权 BPM 连接后,可只读更新目录、搜索已采集流程/节点,并控制自动采集。此页当前重点是流程/节点目录和已有证据,并不是旧版任意编辑业务字段路径的页面;Excel 导入不会改目录,未知流程/节点需要先核对真实 BPM 采集结果。采集只读,不打开订单详情、不办理 BPM、不创建邮件。

目录有名称不表示对应流程字段、PDF、归档或通知都已核验。字段映射的历史设计和状态细节见字段映射说明。

发送计划

发送计划

管理员设置每天两个北京时间发送时点及周末是否按工作日处理。此配置决定计划窗口,不会立即发送邮件,也不会覆盖业务日历中的某日停发或调休安排。保存后由首页和批次页展示下一发送时点。

业务日历

业务日历

按月查看公司工作日、休息日和暂停日;选择日期后可设置该日是否采集、是否发送及备注,并覆盖每周默认安排。采集和发送是分别控制的;暂停日不执行这两项计划。修改先作为页面草稿,保存后才对团队生效;每周默认时段仍在发送计划维护。

邮件模板

邮件模板

管理员可新建、编辑纯文本或 HTML 模板,预览内容并维护版本。托管邮箱也可按允许发件人名单接收模板邮件;导入后须在模板列表预览并确认生效。正文支持明确列出的订单、产品线、日期、明细和存放地址等变量;不执行模板表达式,HTML 预览会隔离脚本和远程资源。模板只定义内容,类别关联和收件人在分类通知规则维护;新模板不会自动替换正在使用的规则版本。

发送设置

发送设置

管理员可分别查看/维护订单自动处理和分类邮件自动发送开关、发件邮箱及单封容量上限。两个开关相互独立;邮件启用还要求邮箱、类别和归档条件通过服务端校验。若当前存在受限稳定性测试,页面会显示其固定收件箱、归档位置、测试基线和到期信息;测试状态不是正式生产配置。保存开关不会代替真实收件、归档和 SMTP 验证。

BPM 连接

BPM 连接

管理员创建连接并指定负责人,打开受控登录窗口完成 BPM 登录,检查并保存会话;可查看连接状态、重新验证、重启会话或停用连接。BPM 会话和托管账号由部署机本地加密保存,连接负责人或管理员按权限操作。连接可用只证明相应登录/检查状态,不证明所有流程、字段、待办和通知接入均已核验。

邮箱管理

邮箱管理

维护托管 SMTP/IMAP 邮箱、连接检查、模板收信开关、允许提交模板的发件人和收信历史。连接检查只验证服务端连通性,不发送邮件;模板收信是只读读取,不会标记已读、移动或删除邮件。也可添加 IMAP 配置只读查询已发送邮件夹,查看正文、收件信息和附件名称。模板测试邮件明确发送到托管邮箱自身,业务群组邮件由独立批次控制。授权码只在工作台输入,不写入说明、命令或助手对话。

助手设置

助手设置

助手设置包含“模型供应商”“默认模型”“运行与权限”。管理员可添加 DeepSeek、OpenAI、Anthropic 或自定义兼容 API,独立维护地址、协议、密钥和模型列表,设置默认模型,编辑/停用/删除供应商。支持 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages。模型列表每行可填 模型 ID | 显示名 | 上下文窗口 | 最大输出,后面三项可省略;获取目录只填入草稿,检查并保存后生效。旧单模型配置会迁成 DeepSeek 供应商,保留原地址、模型、密钥与助手开关。

已保存的密钥不读回输入框,留空保留;更换协议或地址需重填。供应商编辑有未保存确认,保存/获取目录期间锁定字段,避免迟到结果覆盖新输入。运行包、超时、调用上限和受控操作权限单独保存;其他成员可在自己的会话选择可用模型,不能维护供应商。

连接或密钥配置须在部署机本地或可信 HTTPS 环境维护;密钥由本地安全存储管理。添加供应商或打开设置页不会自动启用助手。调用使用当轮启动时的配置,不因后续切换改变正在回复的模型;目录获取也不等同真实模型调用验证。

系统健康

系统健康

查看工作台进程、独立守护/自启动、BPM 连接与同步、到达扫描、存储、邮件和其他模块的最近检查结果;“刷新健康状态”刷新工作台提供的状态快照。页面以最近已知状态为主,不会替代对 BPM、SMB 或 SMTP 的实时连通性测试。需要实际验证时,进入对应连接页面执行相应检查。

团队账号

团队账号

管理员创建同事账号、分配管理员/操作员/只读成员角色、启用或停用账号,并维护负责连接和异常的交接关系。管理员可重置其他成员密码、撤销其登录;重置会使该账号旧会话失效。管理员不能在此重置自己的密码,请使用右上角“修改密码”。初始密码应通过受控渠道告知本人,并由本人修改。

操作记录

操作记录

按北京时间查看最近操作的时间、操作人、动作和详情,汇总工作台配置与业务操作记录,最多展示最近 200 条。记录用于追溯,不显示密码或密码哈希;它不是外部系统的完整日志,也不能单独证明邮件最终送达或文件仍存在。

个人账号

个人账号

所有角色都可从右上角修改本人密码。需要输入当前密码和两次一致的新密码;新密码为 12–128 位,且不能与原密码相同。修改成功后此账号的其他登录会话失效,需用新密码重新登录。个人页面不会修改角色或其他成员账号。

安全与处理边界

  • Web 工作台默认监听 0.0.0.0:18766;扩展桥接只监听本机 127.0.0.1:18765。局域网和跨网段访问还取决于主机防火墙、路由与网络 ACL。
  • 数据和密钥保存在部署机本地运行状态目录,不随 Git 仓库或源码克隆复制。仓库不应提交 config.json、数据库、邮箱凭据、BPM 会话、业务 PDF 或运行输出。
  • 本工具可读 BPM 待办,但 BPM 节点提交/结束仍由人工办理。查看历史、保存草稿、连接成功或单样本检查通过都不代表真实订单闭环已经完成。
  • PDF 归档与邮件发送独立。结果未知先查明外部系统状态,再由有权限的管理员作出处理;系统不会对结果未知的发信自动重试。
  • 正式自动处理和自动通知只有在真实流程、字段、存储、邮箱和发送结果完成现场核验后才可评估启用。当前状态以工作台显示和管理员配置为准。