167 lines
14 KiB
Markdown
167 lines
14 KiB
Markdown
# 订单通知中心使用指南
|
|
|
|
本指南对应当前工作台。前半部分是简短上手流程,后半部分按页面介绍功能、角色和操作边界。截图来自独立空白示例环境;`demo_admin` 是虚构账号,页面中的空列表不代表实际部署数据。
|
|
|
|
## 快速上手
|
|
|
|
1. 在部署机启动 `npm start` 或双击 `启动工具.cmd`,在部署机打开 `http://127.0.0.1:18766`。首次创建管理员账号;没有默认账号或密码,新密码至少 12 位。
|
|
2. 管理员在“系统设置 → 团队账号”创建同事账号并分配角色。登录地址可使用部署机局域网 IP;跨网段访问还要求网络路由、网间策略和 Windows 防火墙允许 TCP `18766`。
|
|
3. 先配置“BPM 连接”和“字段映射”目录,再导入或维护“分类通知规则”。根据实际业务核对流程、触发节点、收件人、模板和归档要求。
|
|
4. 在“工具 → 存储服务器”添加 SMB 目录并分别检查读取和写入权限;在“系统设置 → 邮箱管理”配置托管邮箱并检查连接。
|
|
5. 在“业务设置 → 通知配置”核对发送计划、业务日历、模板和发送设置。先用真实样本和受限环境完成核验;当前自动处理和自动邮件默认暂停,未通过现场检查前不要开启正式自动处理或发送。
|
|
6. 日常查看“业务首页”“订单中心”“邮件批次”和“异常待办”。结果不明的发信先核对邮箱服务器记录,不要直接重试。
|
|
|
|
更完整的部署、规则、字段目录和备份说明见[部署与维护](deployment.md)、[分类通知规则](order-rules-guide.md)、[业务配置](business-configuration.md)、[字段映射说明](field-mappings-guide.md)及[备份恢复](backup-restore-guide.md)。
|
|
|
|
## 导航与角色
|
|
|
|
侧栏分为业务首页、订单中心、邮件批次、工具、异常待办、业务设置和系统设置。工具内可切换流程到达记录、PDF 导出记录、DSH 助手和存储服务器;业务设置内可切换分类通知规则、字段映射及通知配置;系统设置内可切换 BPM 连接、邮箱管理、助手设置、系统健康、团队账号和操作记录。右上角可修改个人密码或退出登录。
|
|
|
|
- **管理员**:管理连接、账号和业务配置,可执行受权限门控的恢复、归档和邮件操作。
|
|
- **操作员**:查看其有权访问的业务数据并处理分配给自己的异常;不能管理系统配置或账号。
|
|
- **只读成员**:查看有权访问的页面和记录,不能提交配置或业务状态变更。
|
|
|
|
页面会根据角色隐藏或禁用操作。连接、订单和异常信息仍受负责人及数据授权范围限制。
|
|
|
|
## 页面功能
|
|
|
|
### 业务首页
|
|
|
|

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

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

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

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

|
|
|
|
汇总查询手工导出任务和订单自动归档回执,可按订单号、项目、状态筛选并分页。下载前会复核当前文件可用性、访问权限和内容哈希;“已归档”表示存在持久回执,不保证文件此刻仍可访问。PDF 归档与邮件发送相互独立,PDF 不会自动作为邮件附件。
|
|
|
|
订单页在已登录的 BPM 订单页面上配合 Chrome 扩展,可以手工导出当前订单 PDF。扩展使用本机桥接服务;安装和版本要求见 [README](../README.md)。
|
|
|
|
### DSH 助手
|
|
|
|

|
|
|
|
可建立和继续对话、查看会话历史,并在助手已配置且运行时查询系统状态、分析运行异常或提出受控操作。允许的操作由管理员在助手设置中限定;执行前会显示操作内容并要求确认,操作和结果写入审计记录。助手不是 BPM 自动办理入口,也不能替代业务核验。不要向对话输入密码、Cookie、完整业务表单或不必要的客户信息。
|
|
|
|
### 存储服务器
|
|
|
|

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

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

|
|
|
|
以 Excel 类别维护精确的流程与触发节点配对,以及类别通知内容、To/Cc、模板、归档位置和验证状态。可搜索类别、导入规则文件、下载当前规则。导入先预览错误和变更,再一次性确认;错误行或并发版本变化会阻止整次提交。保存产生草稿,不会覆盖当前发布版本;真实待办样本检查通过且依赖完整后,管理员才可发布。字段目录须先在字段映射页采集。更新字段映射后,相关类别可能暂停并要求重新检查发布。
|
|
|
|
本页检查一个真实样本不等于全部类别和表单版本都已验收。当前整体自动通知仍按首页及发送设置显示为暂停/待核验;不要把规则存在或发布描述成完整业务闭环。
|
|
|
|
### 字段映射
|
|
|
|

|
|
|
|
维护 BPM 实际采集到的流程和触发节点目录,供分类通知规则选择。管理员选择授权 BPM 连接后,可只读更新目录、搜索已采集流程/节点,并控制自动采集。此页当前重点是流程/节点目录和已有证据,并不是旧版任意编辑业务字段路径的页面;Excel 导入不会改目录,未知流程/节点需要先核对真实 BPM 采集结果。采集只读,不打开订单详情、不办理 BPM、不创建邮件。
|
|
|
|
目录有名称不表示对应流程字段、PDF、归档或通知都已核验。字段映射的历史设计和状态细节见[字段映射说明](field-mappings-guide.md)。
|
|
|
|
### 发送计划
|
|
|
|

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

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

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

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

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

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

|
|
|
|
管理员管理 DSH 运行包、模型连接和允许的受控操作,可检查运行状态、启停助手并查看用量/操作记录。连接或密钥配置须在部署机本地或可信 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 归档与邮件发送独立。结果未知先查明外部系统状态,再由有权限的管理员作出处理;系统不会对结果未知的发信自动重试。
|
|
- 正式自动处理和自动通知只有在真实流程、字段、存储、邮箱和发送结果完成现场核验后才可评估启用。当前状态以工作台显示和管理员配置为准。
|