3.0 KiB
SMB 存储服务器与通知边界
依据:2026-10-17 用户确认使用 SMB,工作台管理独立账号和密码并加密保存;PDF 只归档至服务器;业务邮件只复制 BPM 简要说明,通知不同产业的接口人。
本次存储交付
新增独立“存储服务器”页面,支持服务器名称、主机、共享名、归档子目录、登录账号、密码、启停、连接读写检查、目录浏览、创建目录、下载 PDF,以及将已导出的 PDF 归档到选定目录。支持指定一个自动归档目标,对启用之后新导出的 PDF 自动归档。历史 PDF 由用户选择归档,避免首次启用回灌全部历史。
使用 Windows 原生 SMB(WNetAddConnection2),不映射盘符、不保存明文凭据至 Windows 命令行、不强制断开已有共享连接。相比维护第三方 SMB 协议客户端,这条路线复用部署机的 SMB 协议与认证支持;相比依赖人工映射盘符,重启后可根据已加密配置重新连接。1219 凭据冲突明确提示用户处理,不清理其他软件的会话。
服务器配置与归档记录存储在本机 storage/storage.sqlite;账号密码使用现有 AES-GCM/DPAPI 密钥体系加密。接口只返回密码是否存在。编辑留空保留密码,改变主机、共享或账号必须重新填写。配置有版本号,防止覆盖并发修改。管理员维护服务器和自动归档设置;操作员可浏览目录和归档;只读用户查看状态和归档记录。凭据维护沿用回环地址或可信 HTTPS 代理要求。
文件操作限定在配置的共享及归档根目录,拒绝父目录跳转、绝对路径、设备名和符号链接。目录浏览最多返回 500 项,PDF 下载和归档上限 64 MiB。归档仅接受工作台已有成功导出任务,源文件真实路径必须属于 outputDir。
归档流程:验证源 PDF → 写入目标目录临时文件 → 校验 SHA-256 → 原生不覆盖重命名发布 → 再验证最终文件 → 记录成功。相同文件幂等成功,不同内容同名使用内容摘要后缀保留两个版本。服务重启时未完成记录显示“已中断”,用户可重试并核对已有同内容文件。归档结果与 PDF 导出结果分别记录。
连接检查与验收
保存配置不访问服务器。用户点击“检查读写”后,创建本工具随机命名的探测文件,读取核对后仅删除该文件;失败返回可操作的脱敏错误。没有真实服务器地址前,以真实本地文件系统验证目录限制、发布、哈希、幂等、重启记录和 HTTP 权限,不能表述为已完成 210 实机联调。
邮件边界
归档操作不创建邮件任务,也不向邮件附加 PDF 或自动插入 SMB 地址。邮件正文来源为 BPM 简要说明,不由模型改写。产业到接口人的收件配置继续沿用群组管理。当前列表适配器只存 processInstanceSubject 等列表字段,尚需核实其是否就是页面“简要说明”,再接通通知来源;通知来源与正式收件映射未核实前,不发送业务邮件。