18 KiB
开发交接(2026-10-21)
全局优化已交付(最新状态)
用户在全局审查后要求“全部优化”,已按本轮设计及计划完成。业务执行/监听、统一首页/订单中心/邮件批次、分页与权限、归档纠正/恢复、账号交接、PDF历史保留、助手会话归档和受控备份均已验收;旧生产发送器与重复入口已退役。代码提交69583e8,前序84e2f0d/1148aa6及核心/监听提交均在本地codex/modular-refactor,未推送合并。
新鲜npm ci后最终完整640项:639通过、0失败、1可选ZCode CLI跳过;295个JS/CJS语法、8份文档50条本地链接及1个锚点、差异与暂存敏感文件检查通过。模块和最终复审门禁通过,中间失败及修复证据完整保留,见全局优化验收与复审记录。
12:30已按原方式npm start恢复原本机测试实例;18765/18766双端口心跳和37项页面资源正常,原浏览器登录仍有效。原账号/原有受保护键/31份样本/31份字段草稿/规则/订单/批次/BPM托管账号摘要均保持;原发送计划等配置、扩展配对键和PDF台账核对保持。通知设置version1,enabled=false、processingEnabled=false、processingSince=null。实际界面已核对首页、订单、批次、BPM全局同步(原启用、5分钟)、系统健康/容量、团队账号及PDF台账。入口http://127.0.0.1:18766/#overview。
停服原始备份和新增受控备份均保留;新增备份C:/Users/ABS/AppData/Local/OrderNotificationAutomationBackups/global-optimization-verified-20261021-112248,8518文件5,704,104字节3个目录绑定vault,create/verify均退出0。换目录解密和PDF引用恢复以合成数据16项验证,未覆盖原状态,见备份恢复指南。
现场项:当前BPM连接验证未通过/查询跳转,自动续登未开启;邮箱与SMB未配置,字段草稿尚待实际发布。服务可访问不代表真实业务链已联调。历史47次存储失败根因尚未证实,本轮确证的一次key_protect子进程15秒超时已加入受限重试及安全诊断,不能据此宣称历史故障根治。自动处理与发信继续暂停;未发真实邮件、未办理BPM、未操作服务机。
本轮同步设置与记录导航
用户明确要求实施同步设置迁移与页签/分页优化。全局同步设置已迁入BPM连接页独立卡片,管理员保存、其他角色只读;记录页只保留摘要与手工同步。两页白名单状态写入hash和按账号隔离的sessionStorage,退出及认证失效清理;支持25/50/100条、数字页码、实际末页修正、加载禁重和失败重试。后台更新只提示,详情和列表不自动重画;显式查询不会把未应用输入混入翻页。
代码提交c215e6e。专项已验证页签/刷新/前后退/滚动位置、账号隔离、配置失败与保存离页、慢响应及详情清理;新鲜完整527项中526通过、0失败、1可选ZCode CLI跳过,254文件语法/6份文档36条本地链接/差异检查通过。18:35恢复原本机实例,双端口healthy、35项资源正常;原账号/密钥/31份采样和草稿/规则/订单/批次核对保持,自动发信false、version:1。备份与当前同步配置逐项相同:开启、每5分钟。实际已核对BPM设置卡片、16条到达记录及每页条数的刷新/往返恢复,核对后恢复25条默认;入口 http://127.0.0.1:18766/#records ,设置 http://127.0.0.1:18766/#bpm 。最终验收与服务恢复见本轮记录。不发送真实邮件、不办理BPM、不操作服务机、不推送合并。
本轮订单与导出记录台账
用户选择A台账方案,确认删除连接后记录自动进入历史归档、默认聚焦订单相关流程。已实现统一Tabler分段导航(#records/#records-pdf)、分页台账、来源与日期筛选、详情侧栏和窄屏布局。Workspace删除事务保留安全来源档案;旧孤立来源不猜账号。PDF导出状态、文件可用性和存储归档回执独立,缺失或越界文件不显示下载;不按订单号猜BPM连接归属。
代码提交20bb686。专项回归50项通过,最终页面回归7项通过,新鲜完整514项中513通过、0失败、1可选ZCode CLI跳过;249个JS/CJS文件语法、6份文档33条本地链接及差异检查通过。17:34已恢复原本机实例,双端口healthy、32项资源可用,原登录/账号/密钥/规则/31份采样和草稿/订单/批次核对保持;自动通知false、version:1。实际默认13条订单相关到达,历史归档4条,PDF0条;已只读检查详情与导航,入口 http://127.0.0.1:18766/#records 。最终结果和恢复记录见台账验收,设计与步骤见已确认设计及实施计划。不发真实邮件、不办理BPM、不操作服务机,保留原业务数据和当前分支,不推送合并。
本轮BPM系统设置改造
用户已确认BPM可恢复启停、轻量连接检测和原生被动监听方案,本轮在既有本机测试工作树顺序实施。连接停用改为保留账号/会话的暂停,启用恢复检查;真正删除才清除身份。卡片分别显示登录会话、订单接口与到达监听状态,后台复用近期成功业务请求,明确区分认证过期、权限不足和网络失败。
原生SignalR仅接收已核实的待办/待阅变化线索;首次连接、重连与定期完整对账读取真实列表,事件合并、分页原子提交与来源隔离保留。新监听不触发PDF、归档、发信或BPM节点动作。真实系统已验证鉴权协商、JSON握手和心跳,尚未观察自然业务事件,不能宣称全部流程版本的自然到达已验收。细节见研究证据与方案、实施计划与本轮验收。
代码提交 8ca493d。专项回归133项通过;新鲜完整504项中503通过、0失败、1可选ZCode CLI跳过,240个JS/CJS文件语法通过,8份相关文档31条本地链接和差异检查通过。16:19已通过 npm start 恢复原本机测试实例,18765/18766双端口与30项页面资源正常;原登录可用,BPM卡片显示登录会话/订单接口可用、推送已连接,初次只读对账完成;16:20手工轻量检查成功。原账号、密钥、规则、31份采样及草稿、订单、批次和设置核对保持,自动通知仍false、version:1。入口 http://127.0.0.1:18766/#bpm 。备份、证据和自然事件限制见本轮验收。不操作服务机,不发送真实邮件,不办理BPM,不推送或合并。
工作区与版本
当前本地开发分支为 codex/modular-refactor,工作区 C:/Users/ABS/.codex/worktrees/modular-refactor/Order Notification Automation。原Z盘源码不改。未推送或合并;本轮导航及部署检查见订单通知管理验收,前次执行闭环见执行闭环验收。
2026-10-20 13:36(北京时间)用户明确说明:此前称为“正式进程”的现有实例实际是本机测试进程,本机测试后才到服务机测试;要求沿用现有方式启动,不另建测试副本。已停服备份并通过 npm start 启动交付代码,保留原账号与数据,18765/18766双端口就绪;30项页面资源正常,原登录会话可用,分类与字段映射页面已打开核对。31份采样、31份字段草稿、规则、批次、订单、账号和密钥核对一致,自动通知仍为false、version:1。入口为 http://127.0.0.1:18766/#rule-fields 。本次仅更新本机测试实例,未操作服务机、未发真实邮件或办理BPM;下文早先的进程称呼和不重启决定是此次澄清前的记录。备份和检查细节见本轮验收补充。
源码模块:BPM会话与只读接口在src/modules/bpm;15类规则、窗口、冻结批次及受控发送在order-rules;执行协调与字段证据在order-execution;归档提供器在storage/order-archive.cjs。扩展原PDF四字段文件名保持兼容。web/modules/navigation/lifecycle.js负责页面生命周期。
分类规则目前为两栏:左侧分类卡片及已发布版本启停;右侧为适用通知、通知内容、归档要求、验证与发布。字段来源和生效只在字段映射维护,分类通过已生效接口验证业务分发。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,标准摘要输出包含机芯号、型号、客户简称、出货方式、数量等,各订单段落仍关联原BPM事件。后端 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业务职责调整:用户明确“识别BPM订单 → 页面PDF → 分类目录归档 → 每天两次同类汇总一封”,并提供海外实收邮件样例。本轮已完成分类与字段编辑分离、标题出货方式独立提取、海外默认正文按摘要与统一实际目录组织,以及兼容旧格式的新模板变量。全站24页职责、官方参考和后续整合建议见逐页评审稿;当前验证及运行状态见本轮验收。业务代码版本c53da6f;新鲜完整475项中474通过、0失败、1可选CLI跳过,229文件语法通过。14:45已恢复本机测试服务,双端口与30项资源正常,原账号/密钥/31份采样及草稿/规则/批次保持,自动通知false、version:1;未操作服务机、真实邮件或BPM办理。本段为最新设计方向与运行记录,后文先前内嵌映射相关描述属于历史交付记录。
当前要求
设计要求是当前权威入口,操作清单记录页面动作、权限、前置条件、结果、失败路径与验收。
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。旧阶段调研保留历史用途,不作为当前产品行为说明。