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

8.6 KiB
Raw Blame History

开发交接(2026-10-20)

工作区与版本

当前本地开发分支为 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 只恢复已发布快照并校验草稿/发布/启停版本,不发布新草稿。旧发布版本首次恢复若没有保留真实采集凭据,需要重新检查发布。详见分类业务配置验收。

字段映射已独立为 web/modules/field-mappings,后端 field-mappings.cjs / field-sources.cjs 负责来源、草稿、检查、生效及分类失效;order-execution/field-samples.cjs 单独负责只读采集。旧 adapters 写入仅存草稿。参考映射不能用于真实订单识别/发布;主订单和标题必须一致,新映射摘要仅支持标题。完整说明见字段映射指南,本轮验证见字段映射验收。

真实采样已扩为窗口待办、全部待办配置采样、已办/历史配置采样。当前31版本、11,523字段,配置流程28/29覆盖;缺零售国内返工订单更改评审,另三种零售流程名称不猜分类。31份草稿检查通过但未生效;历史不进入执行或通知。详情见采样记录。ZCode 项目内技能及固定卡片见接入说明,不安装个人技能、不开放原生工具。

前轮字段映射交付完整435项:434通过、0失败、1可选CLI跳过;211文件语法通过。正式状态已于10:36停服备份,更新后双端口、原登录、样本/草稿/密钥摘要及BPM会话内容核验通过。ZCode技能已加载,模型仍未配置,自动通知仍false。正式页面保留31个检查通过版本供人工核对。

当前要求

设计要求是当前权威入口,操作清单记录页面动作、权限、前置条件、结果、失败路径与验收。

2026-10-20新增待开发设计:用户指出配置仍需手工选择,要求改为“选择真实订单后自动带出流程、节点、版本和业务参数”,人工只核对歧义。本轮只整理计划,未修改业务代码、配置或正式服务;在新对话开发。先读交互设计和实施计划与新对话启动文本。此条是计划,不代表已上线;既有采样可复用,历史缺节点仍不能猜测,保存/检查/生效/分类发布继续分开。实际界面、接口、测试和部署结果由后续开发验收更新。

2026-10-20实施交付:已在本工作树完成真实订单选择器、只读识别提案、字段高级修正、精确配对显式加入及分类内就地字段配置。字段生效后同步规则版本并保留未保存输入,同字段并发修改需逐项核对;目录只取摘要,高级区按需读取字段。ZCode项目技能为1.1.0,与页面共用推荐/提案服务。代码验收版本5f389d7:完整470项中469通过、0失败、1可选CLI跳过,227文件语法通过。实际测试与交付版本见本轮代码验收。正式服务更新另行安排;未改正式数据、未发真实邮件或办理BPM。收尾发现正式进程也从本工作树运行,已确认首页引用新脚本而旧资源路由返回401,前端与运行后台混用,未重启不代表运行隔离;用户已明确选择保持正式进程不动,先交付提交与验收,记录共享目录问题,隔离另行安排,详见验收文档。只读核实正式自动通知enabled:false、version:1,未修改开关。上段为规划记录,本段与验收文档说明实施状态。

  • 七项侧栏,新增一级“订单通知管理”(总览、执行、通知订单、批次、发送记录、通知配置);业务设置仅规则/字段映射。所有模块接入 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。旧阶段调研保留历史用途,不作为当前产品行为说明。