5.4 KiB
开发交接(2026-10-19)
工作区与版本
当前本地开发分支为 codex/modular-refactor,工作区 C:/Users/ABS/.codex/worktrees/modular-refactor/Order Notification Automation。原Z盘源码不改。未推送或合并;本轮导航及部署检查见订单通知管理验收,前次执行闭环见执行闭环验收。
源码模块:BPM会话与只读接口在src/modules/bpm;15类规则、窗口、冻结批次及受控发送在order-rules;执行协调与字段证据在order-execution;归档提供器在storage/order-archive.cjs。扩展原PDF四字段文件名保持兼容。web/modules/navigation/lifecycle.js负责页面生命周期。
分类规则目前为两栏:左侧分类卡片及已发布版本启停,右侧流程节点、BPM自动识别、模板/服务器文件夹、真实订单检查。scopes.cjs 统一精确配对;trial.cjs 保持真实采集发布凭据;import.cjs 管理 Excel 预览/原子导入,import-template.cjs 导出当前规则;mail/rule-template.cjs 按规则快照选择模板,缺少新增字段时继续兼容原类别绑定。
前端 scope-editor.js、editor.js、preview.js、resources.js、import-view.js、import-parser.js/import-worker.js 与 view.js 分开负责范围、配置、中文结果、资源选择、Excel交互/解析及页面生命周期。首次启用仍需真实订单检查并发布;resume 只恢复已发布快照并校验草稿/发布/启停版本,不发布新草稿。旧发布版本首次恢复若没有保留真实采集凭据,需要重新检查发布。详见分类业务配置验收。
当前要求
设计要求是当前权威入口,操作清单记录页面动作、权限、前置条件、结果、失败路径与验收。
- 七项侧栏,新增一级“订单通知管理”(总览、执行、通知订单、批次、发送记录、通知配置);业务设置仅规则/字段映射。所有模块接入 Tabler nav-segmented 圆角横栏,通知配置内为计划/日历/模板/发送设置。团队账号管理员可见;个人改密右上角。助手接入配置移到系统设置。
- Excel15类精确匹配流程/版本/节点,同窗口同类别一封。收件人由分类规则维护,模板显式关联类别;归档与附件要求以Excel类别为准。
- 标题按订单号拆段提取。惠州额外通知待确认;BPM节点人工办理。
- 北京时间、公司日历,周一首封从上个发送工作日最后截止起,历史不自动处理/追补。
- 执行任务、归档证据、冻结批次、受控恢复和核验持久化;unknown禁止自动重发;管理员持依据逐批人工补发。
- 监管草稿、重复连接汇总、旧通用通知写入/调度已退役;旧数据保留查询、旧写入410。
真实系统已核验与阻塞
2026-10-19只读核验,门户实际待办接口为 /bpm/worklist 与 /skyworth/todo/v2/workflow/get_process_of_work_v4,读取33条;当前列表没有通知书目标节点。V4详情地址取 executionPointerId,收到时间取 startTime,流程版本取 processVersion。该证据不代表全部类别现场验收完成。
V4详情包含短期SSO入口。提供器只在内存保留入口凭据,持久任务仅保留不带凭据的Process地址;严格验证SSO → 相同tid/pid的Process → XForm跳转链。表单业务值由已观察的DataProvider只读GetFormProcessData加载;采集不执行页面脚本,不调用保存/审批。最近结构采集取得92个字段、48个非空值,但当前非目标节点样本不能替代15类真实通知字段核验。未知路径、版本和缺失业务字段仍受阻,不扩大远程登录白名单。
正式自动发信保持暂停,直到对应类别真实字段、目录、邮箱与批次预览完成现场核验。当前的隔离样本、真实Chromium PDF、临时FileArea与本地SMTP验证不能替代公司系统现场验收。
启动、数据与备份
Node.js22.13+、Chrome及锁定依赖,npm start后台启动;service:status/restart/stop管理守护。默认桥接127.0.0.1:18765,工作台0.0.0.0:18766。Windows登录自启沿用当前用户DPAPI及SMB身份,不是未登录运行的系统服务。
正式状态为%LOCALAPPDATA%/OrderNotificationAutomation,包含账号、会话、规则、执行、邮箱、存储、助手等SQLite及加密身份。更新前停止服务后完整备份;保留原数据/密钥/密码,不读取account-recovery。输出PDF需另备份。异机/异Windows用户恢复必须验证DPAPI条件。
运行npm test、JS语法及git diff --check后再更新正式服务,验证双端口、登录、横栏与paused状态。默认不发送真实邮件、不提交BPM。对外发布、推送与合并未获本轮授权。
故障处理约束
先查询实际持久状态再决定恢复;网络超时不表示未执行。会话失效与网络失败分开,网络故障不重复提交托管密码。SMTP部分接受/断线/崩溃均人工核验。SMB写入后读回校验路径/大小/SHA256,worker退出后才释放锁。页面离开后禁止旧响应覆盖新页面/新登录。
测试输出与截图位于忽略目录output/verification。原邮件、密码、Cookie、模型Key、数据库、业务PDF及加密密钥不得提交Git。旧阶段调研保留历史用途,不作为当前产品行为说明。