Files
order-notification-automation/docs/HANDOFF.md
T

43 lines
4.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 开发交接(2026-10-19)
## 工作区与版本
当前本地开发分支为 codex/modular-refactor,工作区 C:/Users/ABS/.codex/worktrees/modular-refactor/Order Notification Automation。原Z盘源码不改。未推送或合并;本轮导航及部署检查见[订单通知管理验收](notification-navigation-verification-2026-10-19.md),前次执行闭环见[执行闭环验收](web-closure-verification-2026-10-19.md)。
源码模块:BPM会话与只读接口在src/modules/bpm;15类规则、窗口、冻结批次及受控发送在order-rules;执行协调与字段证据在order-execution;归档提供器在storage/order-archive.cjs。扩展原PDF四字段文件名保持兼容。web/modules/navigation/lifecycle.js负责页面生命周期。
分类工作台新增 order-rules/scopes.cjs 统一流程节点配对、trial.cjs 验证候选草稿与真实采集凭据;storage/order-filename.cjs 共用正式命名。前端 scope-editor.js、editor.js、preview.js、view.js 分别负责范围、配置、验证呈现和生命周期。现有15类及发送/冻结策略保留;通用字段条件留待后续。验收见[分类工作台验收](rule-workbench-verification-2026-10-19.md)。
## 当前要求
[设计要求](design-requirements.md)是当前权威入口,[操作清单](web-action-inventory.md)记录页面动作、权限、前置条件、结果、失败路径与验收。
- 七项侧栏,新增一级“订单通知管理”(总览、执行、通知订单、批次、发送记录、通知配置);业务设置仅规则/字段映射。所有模块接入 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。旧阶段调研保留历史用途,不作为当前产品行为说明。