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

36 KiB
Raw Blame History

开发交接(2026-10-23)

2026-10-26 剩余阻塞与读取速度优化

  • 发现屏障独立到discovery-barrier.cjs。停用来源的旧待交付/待处理线索只保留证据,不阻断无关的新批次;活动来源及未移除相关不确定任务仍严格检查。
  • 后台每30秒触发时整轮共享执行,慢采集期间不再重复排队;stop等待后台完成最终线索回执持久化。三处只读窗口的调用改为直接计算,不再构造完整规则/订单/审计快照。
  • 适配器、受限运行配置在同一次同步snapshot内复用,独立检查仍每次读取;不缓存跨请求权限、期限或可编辑批次结果。summary只计算一次收集中批次。相同只读数据、固定时钟比较,snapshot适配器读取58→1次、解密1798→31次;摘要中位耗时120.53→8.18ms,完整输出一致。数值是本机副本基准,不承诺所有页面相同比例。
  • 界面“当前生效类别”不再等同全部流程实单已验证;未覆盖流程说明局部待采样/适配。实时待办正常、零匹配订单且无失败扫描时,顶栏显示待验证;其他失败仍显示受阻,providersReady执行门槛不改。能力提示不再误称PDF为邮件附件。
  • 旧responsiveness测试补齐当前store接口,强化暂停/关闭/整批发现及零全量快照断言;真实BPM、SMTP、SMB和五天测试设置不用于测试。实际验收及本机更新以忽略目录回执为准。
  • 最终业务回归118项、未知结果/发现屏障/测试期限保护专项15项通过。独立复核发现的精简snapshot接口兼容回归已恢复可选get防护并单独复验6项;一条旧文案断言按新“当前生效”含义更新后完整重跑通过。未运行旧千项全量。

2026-10-26 审查前两项与依赖修复

  • 原通知任务在及时启动的扫描中被接收后,持久保存intakeWindow和intakeStartedAt;慢列表读取、详情采集、归档及重启均复用原窗口,不因跨过发送后60秒而直接ignored。已接收任务最多沿用既有30分钟发送宽限,超期明确受阻留证。到达截止仍提前5分钟,不接纳任意迟到历史,不扩大已冻结批次,unknown/sent不自动重发。
  • 新批次扫描屏障排除removedAt历史任务,保留未移除不确定任务及活动来源的完整对账检查;原记录、归档与回执不删除。
  • nodemailer升级10.2.1,mailparser升级3.12.4,smtp-server隔离测试依赖升级3.21.1;ExcelJS保持4.4.0,仅覆盖其uuid至CommonJS兼容的11.1.1。工作区及本机预装依赖均干净安装,npm audit(含dev)报告0条已知告警。验证Unicode邮件、无附件信封、Excel读写/扩展条件格式及UUID边界检查。
  • 本轮仅修前两项与依赖;扫描报告中的通用“发测试到本邮箱”受限策略旁路仍未修改。真实BPM/SMTP/SMB不参与代码测试;本机测试期、收件箱、签名、标题、规则与业务数据在更新时保留,正式服务机不操作。验收和依赖切换回执保存在忽略的output/business-flow-test。
  • 验证:业务回归95项通过;最终慢采集/旧屏障/惠州独立投递/五天期限专项66项通过。新增兼容测试最初使用了不触发扩展格式的Excel夹具,已按ExcelJS声明条件改为真实扩展格式路径复验;一次Windows加密初始化超时单独重跑通过。独立审查发现的普通通知sent/unknown后惠州补充通知宽限丢失已修复,保留普通冻结回执与惠州自身unknown保护。未运行旧千项全量。

2026-10-26 五天受限稳定性测试

  • 用户授权清空旧订单中心显示后开始连续五天受限测试。旧订单、任务软移除,任务保留防重,原PDF/归档/邮件回执不删;原异常留档。仅新基线后的真实匹配通知参与,固定测试QQ、空Cc、无附件、桌面归档及BPM只读保持。
  • stability-test/main持久保存实际开始及结束时间(120小时);到期有效settings和restricted-state暂停,采集/归档/发送前及SMTP验证后均复核期限。重启或启停开关不能绕过到期,不退出受限模式。测试设置显示结束时间。
  • 实际起止、软移除数量、备份及核对回执在忽略的output/business-flow-test/five-day-run-20261026.json;不能拿代码实现时间替代实际启用时间。定期巡检不重发邮件,不替代应用到期保护。

2026-10-26 发送前五分钟到达截止

  • 用户确认:11:00批次接收10:55前到达的订单,10:55起归17:00;16:55起归下一工作日首批。相邻到达区间连续,含起点、不含终点。保留原始接收时间和模板日期。
  • 新窗口另存collectionStart/collectionEnd(计划时点提前5分钟),start/end仍表示原计划发送区间,policyVersion=2。旧冻结快照没有这些字段时按原窗口核验,不重写、不重发。
  • 当前截止后到达的任务先显示等待下一批处理,下一窗口核验当前来源后采集,不阻塞前批。已到期等待任务如果离开BPM则转历史核验。仅旧规则误报且没有任何完成/冻结/未知证据的相邻最后五分钟任务允许受控恢复;原任务仍须在当前待办且身份一致。
  • 订单315475原接收10:59:59属于新规则17:00批次;现场核对时原通知任务已离开待办,不能据历史实例直接补采、归档或发信。

2026-10-26 邮件批次待发送/已发送分离

  • 邮件批次以 Tabler 页签提供待发送、已发送、全部;替代原范围下拉。待发送含收集中、已冻结、发送中、失败及结果待核实;已发送仅显示 sent,取消记录在全部中保留。
  • 修复默认 active 与 status=sent 相交导致历史不可见;服务端和地址状态均将该旧查询规范到 sent 范围。范围在权限筛选后分页,不改冻结正文、收件人、发送回执或发送行为。切换清除状态并回第一页,刷新/前后退恢复地址;点击当前页签不重复加载。
  • 批次列表和详情显示发送时间(缺失不造时间);已发送正文和订单详情继续可查,只读且不提供编辑/补发。实机核对当前业务批次表为空,邮箱存在两条独立 sends 回执,不伪造为业务批次历史。
  • 验证使用隔离批次与账号,未发送邮件、未办理 BPM、未调整自动处理或发信设置;相关查询/分页/导航/弹窗30项通过。用户三份本地业务设计草稿保持不动。

2026-10-26 订单采集失败修复与剩余边界

  • 修复动态明细 datamap 包含合法隐藏列时被误判的问题:额外列必须有同表隐藏控件,且每条后端记录都确有对应列;仍拒绝跨表映射、不明确行关系及缺少可见字段。
  • 后端字段读取成功而静态 PDF 失败时保存独立字段证据 captureEvidenceId,不写入成功 sampleId,不作为 PDF/归档凭据。保存结构原因、表名、行数与字段路径;授权详情弹窗可查看字段值及接口/表/列/行来源,列表不返回字段值。
  • 确定性结构、身份及权限错误暂停自动重试;暂时连接错误指数退避(1分钟起,上限30分钟)。只有新鲜完整待办扫描成功才把已离开待办的失败采集任务转为待历史核验;失败扫描与旧发现线索不能推导任务离开。已归档、发送中、已发送、unknown、冲突及替代任务保持保护。
  • 原任务重新出现且人工核验后重试,必须重新采集完整 PDF;独立字段证据不得代替成功快照。成功后清理当前“已离开”标记,保留历史证据,重复扫描不重复归档。
  • 待历史核验任务提供显式“核验当前任务并重试”入口,要求确认原任务及填写依据;执行前仍重新读取当前待办验证身份与节点,任务仍不在时只保留阻断,不能拿历史实例替代。
  • 监听器交付的完整列表也可用于离开判定,但必须与持久完整对账回执逐项一致、为最新且五分钟内的非未来回执,并且早于该次扫描的失败任务才参与;旧线索不能覆盖更新的任务状态。避免后台持续收到列表而不走直接查询时,失败任务永远留在旧状态。
  • 两个真实海外更改单的历史表单只读证据证明:V7 / 列表1.9 的隐藏列误判已解决,但 HTML 仍包含后端 Columns 与行数据都不存在的 SubsidiaryDelivery1、SubsidiaryDelivery2、SoftRequireImage_Remark。当前继续阻断,不猜测字段别名;是否在 PDF 明确标注未提供后继续,已向业务负责人询问,尚待答复。
  • 业务负责人已确认忽略上述三个已核验 V7 遗留展示控件:不读取或填造其值,快照记录 warnings;只有该完整表单路径与列表版本1.9生效,必要业务字段仍严格阻断校验。两条真实历史HTML/表数据离线复验均生成3页A4 PDF(364487/360046字节),Poppler pdfinfo及首屏视觉检查通过;PDF仅写入忽略的 output 诊断目录,未作 SMB 回执、邮件或 BPM 操作。
  • 当前历史列表只提供实例与开始/完成时间,不能恢复原通知节点到达身份;禁止把历史开始时间当通知到达时间、构造任务或自动补发。零售国内返工订单更改评审在两个已核验历史来源均无样本,继续标明未覆盖,不能声称15类实单闭环完成。
  • 分类与测试设置现在列出未覆盖流程的具体名称。隔离回归仍使用临时文件/本机 SMTP;真实资料只保存在忽略的 output,未办理 BPM 或手动发送业务邮件。本机更新与最终测试结果以本轮回执为准。
  • 验证:当前业务集72项通过,表单/执行/弹窗专项79项通过,另补成功恢复与完整对账证明相关回归。未重跑旧千项全量。首次集成运行发现“未匹配记录仍可见”的过时断言,按现行业务边界修正;下拉候选断言补上实际渲染等待,避免读取尚未显示的候选。已备份并更新原本机测试副本,原账号、模板、规则、订单、批次和邮件配置/记录在更新时核对一致。自动处理、定时发送及隔离模式保持原开启设置;运行期间正常发现的错过时段任务仍人工核验,不自动补发。

2026-10-26 订单中心与发送前收集批次

  • 用户确认保留11:00/17:00自动发送,发送前可以编辑,未编辑继续使用分类模板。邮件批次新增“收集中”,按当前发送窗口、分类、规则版本、模板及普通/惠州模式分组;订单中心有对应批次入口。读取分组不写业务订单或冻结批次,不把未匹配记录放入订单中心。
  • 收集窗口资格复用restricted-test.orderInWindow,与实际prepare一致,包括先前明确纳入待办的处理规则;普通历史订单不移动到新窗口。截止时点后内容只读;既有prepared/sending/sent/unknown不提供编辑接口。
  • 管理员可编辑本批标题及纯文本/HTML正文,保留自动订单明细变量和普通通知目录变量,新订单到达仍加入邮件;编辑存入batch-content-drafts,只作用于本批,不改模板、规则或BPM原文。支持版本冲突、来源配置变化阻断、保存失败保留输入及离页保护。归档未完成时也可提前保存文案,冻结时仍检查全部归档与来源就绪。
  • prepare通过原composeBatch读取本批编辑并保存contentEdit证据,账户签名自动追加。冻结后后续改模板/签名不重写正文,仍由既有调度器与隔离SMTP策略发送;不新增人工发送入口。新批次HTML预览独立鉴权并受CSP和sandbox限制。
  • 订单/批次详情使用居中弹窗;点批次内订单打开其来源、摘要、归档与状态详情,可返回原批次,地址和筛选不跳转。弹窗关闭/换页中止请求并清理控件、遮罩与滚动锁;后台更新只提示刷新,不重画正在阅读的详情。
  • 真实只读核对:现有1条pending海外订单符合当前11:00窗口,可直接显示收集批次,无需补造订单/归档/邮件记录。已办通知补漏、缺少适配流程及完整业务验收仍未完成,本次不宣称全业务闭环。
  • 本轮44项相关回归通过;独立复核发现的两项P2及弹窗打开过渡期间离页滚动锁均已补回归并修复。备份后更新原本机测试服务,实机验证315198收集批次、可编辑控件和关联订单弹窗/返回;没有保存真实批次文案,没有人工发信或办理BPM。账号、模板、规则、订单、批次及发信记录核对一致,状态和发送计划保持原值。

2026-10-26 BPM竞态修复

  • 基于远端42d19c7,修复SignalR握手尚未完成时onClose先于reject的问题:首次关闭在推进轮询状态后立即安排待办/知会只读对账;旧票据使重复关闭和catch不重复推进或入队。既有退避、业务日历、停用及身份隔离继续生效。
  • Cookie持久化的四条调用路径均显式传入principal;异步采集与storageState返回后重新核对授权和票据,在Vault同步提交边界前拦截撤销。权限撤销和普通退出登录统一同步作废对应票据,再等待原连接锁清理;保留已有有效会话,不删除历史凭据。
  • 清理执行前核对仍是原lease,避免误关排队期间其他合法调用者创建的新窗口;不提升整条连接generation,不作废其他调用者/后台托管的票据。
  • 新增14个回归场景均先观察失败,包括握手重复回调、权限撤销/退出登录在save/check/ensure的capture和storage两个阶段,以及新旧窗口清理竞争。测试使用隔离连接/本机浏览器,不访问真实BPM,不发真实邮件。旧测试退出登录后改用新工作台session,避免复用已撤销身份。
  • 部署沿用原本机测试副本,更新前备份,保留账号、模板、业务数据与发送设置,不操作服务机。当前版本与验收回执以code-revision.json及忽略的output/business-flow-test目录为准。
  • 最终关键回归71项全部通过:29项实际manager/本机隔离浏览器、32项接口/账号生命周期/状态及10项监听。独立复核无剩余P1/P2;未跑旧千项全量。已备份更新并重启原测试服务,规则、订单、批次、适配器、原模板、邮箱配置和发信记录哈希一致。实机账号/同步健康,PDF与自动归档仍按原现场验收状态受阻,不因本次修复改为就绪。

邮件模板编辑与账户签名

  • 邮件模板页可新建、编辑待确认/已生效模板,支持纯文本、HTML源码及安全预览。active编辑保留模板ID和分类关联,版本递增并保留修改前历史;历史/忽略模板可复制为新草稿。新建/待确认模板仍需确认生效;已生效模板不能直接改变普通/惠州通知模式。
  • 邮箱管理→管理邮箱中维护固定尾部签名,可选纯文本或HTML。默认未启用,不自动迁移或删除旧正文中的署名。启用后由实际发件账户在新批次冻结时追加;旧规则署名仅兼容保留,页面不再编辑。模板内已有署名须由用户在正文中调整,避免重复。
  • 正文效果预览与实际冻结共用composeBatch,包括模板、签名及容量检查。冻结保存模板/账户签名版本及最终正文,后续编辑不改写已冻结批次;测试发信也使用该账户签名。To/Cc隔离、无附件及unknown不重发约束不变。
  • HTML复用现有白名单清理,并生成纯文本备选。编辑预览使用独立受限页面,保留安全内联样式,禁止脚本/远程图片;预览仅在内存中保存最多20条、5分钟并绑定管理员,不写业务数据库。HTML转文本库原已安装,现声明html-to-text 10.0.1为直接依赖。
  • 本轮34项相关验收全部通过,另有SMTP服务专项通过;未重跑旧千项全量。独立复核发现的预览签名差异已补失败测试并闭合。已备份并更新原本机测试副本,实机打开HTML编辑/预览及账户签名入口验收。原模板与邮箱配置、规则、订单、批次和发信记录哈希保持一致。本轮未发送真实邮件、未办理BPM,也未操作正式服务机。

匹配编辑交互更新

移除分类规则中的独立“搜索流程或节点”框和可见Excel类别编号,内部类别标识保留以兼容导入。流程、节点选择复用Tabler配套Tom Select,输入即时筛选、支持键盘选择,禁止创建未采集项;节点按流程联动。搜索输入不标记草稿变更,切换/离页时销毁控件。此次为界面调整,不修改业务快照、发送设置或BPM行为。

相关15项交互验收完成;其中4项旧选择器在适配新组合框后单独重跑通过。本轮未重跑旧全量。备份后更新本机测试副本并实机验证输入筛选,原业务规则、订单、批次、适配器、设置与发信记录哈希保持一致;未发邮件、未办理BPM。截图及部署回执保存在忽略的output/business-flow-test目录。

当前:字段映射仅维护BPM流程和节点(2026-10-23)

  • 字段映射页面简化为自动采集开关、只读更新、搜索与流程/节点列表。目录使用原加密数据库中的独立记录持久化,仅由可信BPM列表及真实待办采集更新;初次升级从已保存的服务端证据初始化,不从规则、Excel或历史节点占位名反向生成。
  • 分类规则新增行仅使用目录中的流程及对应节点;已有未知值保留并标注,不污染其他行候选。内部详情适配器及证据保留,页面不再编辑客户、数量、型号等业务字段路径。自动采集暂停不改变已有活动规则。
  • Excel仅修改分类草稿;新增“下载规则导入模板”,每行一配对,同分类多行合并并要求业务配置一致,附填写说明和BPM可选项。兼容原xls及旧配置导出,支持模板ID、产品线。未知流程/节点逐行警告,可保存草稿,但应用、首次开启测试、恢复测试和正式发布均复核目录。模板无效及同分类配置冲突在预览时报错。
  • 实采名称保留原标点,包括全角括号及斜线/加号;导入优先完整匹配实采名称,再兼容旧表多值写法。原已发布规则、受限快照、邮件计划、账号和数据不因迁移改写。未观测名称不等于BPM一定不存在;已办通知补漏及真实PDF/归档能力验收仍未完成。
  • 本轮核心54项、采集专项10项、分类交互专项4项和新增流程专项1项通过;未运行旧千项全量。备份后更新原本机测试副本,初始化20个流程/32个配对,规则、订单、批次、内部适配器、真实采集样本、测试快照、设置及发信记录哈希不变。实机新页面已刷新验收。本轮未发送邮件或办理BPM;具体代码版本以code-revision.json为准,正式服务机未操作。

本轮:旧记录移除与隔离样例邮件验收(2026-10-23 16:18)

  • 按用户要求将唯一旧受阻订单软移出订单中心,原归档与规则快照哈希保持一致,防重数据保留;当前订单中心0条。未新增业务订单或业务批次。
  • 四个实时来源(v8/v4待办与知会)均成功完整分页,共16条,精确命中0条;多数停在生效节点,继续严格排除。已办通知任务补漏尚未实现,不能将实时分页完整表述为覆盖全部应通知订单。
  • 自动处理、计划发送及受限测试开关保持开启;PDF/归档现场能力检查尚未完成,自动链仍受阻。修复应用单类别时丢失其他类别未覆盖流程警告的问题,仍显示1个缺适配流程。
  • 两笔已核验历史订单按Excel同属试产类别,使用既有分类绑定模板合为1封样例邮件,隔离QQ收件、空Cc、无附件;16:17 SMTP已接受,实收待用户确认。另一笔历史订单因节点名称不符继续排除。本次没有生成PDF、归档回执或真实业务批次,不代表自动闭环验收。
  • 样例发送复用原邮件通道及发送记录,固定隔离信封,持久幂等;sending/unknown不自动重发,无新增HTTP发信入口。维护前备份两个相关数据库,更新后本机守护健康;正式服务机及BPM流程未操作。
  • 本轮仅运行邮件样例、Excel执行桥接和订单查询相关19项测试:19通过、0失败。未重跑旧全量。代码已覆盖本机原测试副本,具体版本以该目录code-revision.json为准;业务数据、预览、回执与备份位于忽略的output目录,不入Git。

当前:Excel规则已接入测试执行链

订单中心仅展示有分类匹配证据的订单和执行任务;未匹配候选、不带分类的识别失败记录不进入列表、统计或订单详情。已匹配但缺字段、归档失败或待核验的订单继续显示。原到达与候选数据保留,不删除或重做业务。本机14e48339目录保留为基础版本路径,后续视图补丁按当前分支提交覆盖,不再把目录名当成完整代码版本。默认核心测试另纳入10项订单查询回归;本次查询专项10项通过,不声称重跑旧全量。

本机运行 %LOCALAPPDATA%/OrderNotificationAutomationReleases/test-excel-import-20261023-14e48339,代码树 14e483398ff3d44f4f0948009e6cbac2c5033092。原76版本保留作回退,正式服务机未操作。

  • Excel预览后可“确认导入并应用到测试”;编辑则“保存草稿 → 应用到测试”。直接复用既有匹配、详情采集、PDF归档、批次与调度器,不增加第二套业务链。规则仍严格按Excel流程和节点,不添加节点别名。
  • 测试固定邮箱、空Cc、无附件、桌面目录、运行ID/基线及计划不变。应用不回填历史,不重做旧订单和冻结批次;有未完成的旧版本任务时拒绝切换,先完成或人工处理。正式发布路径保留。
  • 默认 npm test 改跑29项核心业务验收,全部通过,约74秒;旧完整测试保留为 npm run test:full,不再每次运行。首次全量曾因下载等待超时失败、第二轮由用户主动中止,均不计通过。导出已改用官方单文件包,保留Excel格式。
  • 更新前官方完整备份并自动验证:%LOCALAPPDATA%/OrderNotificationAutomationBackups/before-excel-execution-20261023-151155。更新后账号、连接、全部规则/适配器/样本、旧订单/批次/原始回执、SMTP配置/游标/发信记录逐项哈希一致。532个候选文件与对应Git树一致。
  • 实机页面已刷新,原始Excel识别15类,“确认导入并应用到测试”可用;仅预览,没有在实机确认导入或应用。本轮没有真实发信或办理BPM。自动通知仍等待真实合格订单的PDF/归档检查;缺少的流程适配与已办通知补漏仍未完成,不声称15类真实业务闭环已验收。

操作说明见业务配置与Excel导入,证据见整合验收记录。下文为此前原生代码切换的历史记录,进程入口以前述新版本为准。

早前原生整合切换记录(76bbac02版本)

本节为当前交接基准,下文旧日期内容仅保留历史。源码位于 Z 盘项目目录(同一 UNC 共享目录),分支为 codex/smb-storage。当前业务代码提交1848a6c,已经推送;本机运行已切到经过逐文件核对的本地副本,原工作树代码保持不动。

  • 业务范围严格取原 Excel 的15类精确流程与节点;海外四流程仅允许“订单专员(订单通知书)”。“生效”和BOM固化不作为通知节点。产品线、模板由分类明确配置,测试产品线标签取规则名称。
  • 处理身份为 source + portalSource + taskId;上游未提供业务修订时保持缺失,真实0保留。到达库沿用唯一旧键及首见来源;多个旧键冲突须人工核验,整批回滚,不挑选或删除历史记录。
  • 当前新鲜待办只有经服务器读取、精确范围及版本检查后才可纳入不可变允许清单;原 receivedAt 不改,admittedAt 单独保存。冻结与发送前重新确认已纳入任务仍存在、内容一致。
  • 只启动一套原生 OrderExecutionCoordinator / OrderRuleDispatcher;根目录旧工作流不启动。只读详情限制已核验路径、字段及表单版本,listVersion 与 formVersion 分开。BPM 不已阅、不审批、不保存、不办理。
  • PDF归档及读回校验成功后才能通知;To固定隔离QQ邮箱,Cc与附件为空,归档限定原桌面测试目录。普通与惠州模式均保留模板问候、说明、签名,订单区一单一行且从订单号开始;日期变量使用原始 event.receivedAt 的北京时间日期,跨日按出现顺序去重,不采用发送、纳入或创建日期。
  • 按分类、模板及窗口冻结,既有冻结正文不重渲染;sent/unknown不自动重发。每天北京时间11:00/17:00遵循原业务日历,空批次不发送,不自动补发历史窗口。明确纳入的待办可进入下一合法窗口;冻结prepared队列宽限30分钟。

实际运行与恢复

本机测试地址:http://127.0.0.1:18766/#notification-orders 。运行副本为 %LOCALAPPDATA%/OrderNotificationAutomationReleases/test-native-20261023-76bbac02 。请从该副本的 scripts/service.cjs start 启动当前测试版本;源码目录用于开发,旧modular-refactor目录仅保留原代码与原PDF输出,不作为新测试版本启动入口。登录自启原为关闭,保持关闭;正式服务机未操作。

状态目录仍为原 %LOCALAPPDATA%/OrderNotificationAutomation。原账号、连接、邮箱、31个字段适配器、32份样本、旧归档及规则快照保留;原PDF输出路径继续使用旧工作树的output/pdf。完整备份位于 %LOCALAPPDATA%/OrderNotificationAutomationBackups/strict-excel-before-20261023-2026-10-23T04-05-17-523Z,已通过官方创建、验证和应用前恢复性检查。

15类受限快照已应用,自动处理及11:00/17:00计划意图已启用。此前已收件测试任务的原身份、批次和证据导入防重;旧运行的一条已归档待发记录保持待核验,不自动重排或发送。惠州附加通知原来未启用,本次保持未启用。

第一次实际切换发现历史对账微任务连续执行阻塞心跳,以及监听层仍拒绝缺失revision。已修复为扫描窗口一次取值、历史线索间让出事件循环及重检暂停/停止,并修正真实待办身份。最终全量990项:989通过、0失败、1项可选ZCode测试跳过。409个运行及测试文件与本地副本逐字节核对一致。

更新后观察同一业务进程持续运行超过十分钟,未新增重启;295份对账线索已完成,17条真实待办读取成功,原82条到达记录的键、首见时间及来源保留。新建业务批次0,本轮没有新增真实邮件。数字是交接时快照,后台后续对账会继续更新。

13:03/13:09 的17条实时待办均未命中Excel通知节点,这是当时待办快照,不能据此判断今天没有应通知订单。随后根据用户提供的当天邮件,在已办列表及只读流程步骤中找到三笔:两笔试产类订单已于11:24/11:25提交Excel的确切通知节点;一笔海外返工订单于11:26结束名为“订单通知书”的节点,与Excel的“订单专员(订单通知书)”不一致,用户已选择继续按Excel,不建立节点别名。严格测试运行基线为12:12,三笔都已离开通知待办。

当前执行器只读当前待办,历史采样只用于字段配置,缺少已办通知任务的补偿发现。已验证的 ProcessStep 只返回节点名称和办理完成时间,没有通知任务ID或节点到达时间;不能用流程实例ID、行号、完成时间构造通知任务。下一步需核实可获取原通知任务ID/到达时间的只读来源,再设计受控历史对账与持久通知快照;历史纳入和补发范围须明确,原已发送/结果不明任务仍禁止自动重演。人工邮件跨类别合并不覆盖Excel分类:这两类仍分别使用分类模板。详见本轮整合验证。

运行能力中的PDF导出及自动归档仍待首笔合格真实任务验证,页面显示“自动通知受阻”;不伪造就绪状态,也不处理“生效”订单来补证据。15类真实闭环未完成;零售国内返工订单更改评审仍缺字段适配器,继续阻断。逐类真实节点、PDF视觉核对、计划邮件实收和正式210/SMB另行验收。本次三笔调查未更改代码、规则、测试基线或发送范围,未补发邮件,也未办理BPM。

你提供的两笔历史邮件样本已与BPM历史摘要逐字段核对一致,两流程均属海外类别;未取得当时通知节点证据,不以邮件正文证明触发时点合规。详细证据、已知边界见本轮整合验证。业务PDF、数据库、Cookie、密钥、原始采样、截图和本地设计草稿不提交Git。

2026-10-18 历史接续分支与运行记录

本节及以下早期能力、命令、路径和测试计数是当时快照,不是本次合并切换回执;继续工作以前述 2026-10-23 权威边界为准。

仓库:https://git.simgreek.com/simgreek/order-notification-automation.git。

当前开发分支是 codex/smb-storage,包含 SMB、预览、ZCode 和守护的全部工作;旧 main 不代表最新能力。最近实现提交:9a23197 服务守护和健康面板、e2bd8c3 BPM 请求异常导致进程退出的修复、3363a88 ZCode 接入、fff2a29 按真实订单号归档、607b240 BPM 会话 SQLite 持久化。

git fetch origin
git switch codex/smb-storage
git pull --ff-only origin codex/smb-storage
npm ci
npm start

新克隆尚无本地分支时用 git switch --track origin/codex/smb-storage。本机源码在 F:\Sync Tool Skyworth\Work Maps\order,依赖已安装,无须为继续开发重复安装。

本机交接时守护正常,Windows 当前用户登录自启已启用。工作台 http://127.0.0.1:18766,健康页 /#health,助手 /#assistant。

命令 用途
npm start 后台守护启动;重复打开复用实例
npm run service:status 查看守护实际响应与持久状态
npm run service:restart 正常重启并检查两个端口
npm run service:stop 显式停止,不自动拉起;保留自启设置
npm run service:install / service:uninstall 安装/移除当前用户登录自启
npm run start:foreground 前台排错,需先停守护以免端口冲突

自启在当前 Windows 用户登录后执行,沿用其 DPAPI 和 SMB 权限,不是未登录运行的系统服务。移动源码或更换 Node 路径后重新安装自启。

已实现

  • 工作台账号/角色/持久登录、日历、异常、BPM 远程登录与加密托管续登、只读分页扫描、按到达日查询。
  • SMB 主机共享浏览、免填或独立凭据、可取消的有界检查、读取成功后添加、PDF 手动/新文件自动归档。按可见 BPM OrderNum 的完整 6/7 位订单号建目录,保留前导零、复用已有目录,不默认截取或从文件名猜号。
  • 本机内嵌 PDF、图片、文本、DOCX/XLSX 预览;旧 DOC/XLS 下载,Office 排版不保证与桌面软件一致。
  • 邮箱与模板审核,以及独立业务通知队列:来源字段映射、样本预览、产业群组、两个北京时间时段、去重及结果不明核验。
  • ZCode 个人对话、加密历史、权限、固定操作卡片、取消及额度。官方桌面包 3.14.3 附带 CLI 实际为 0.16.9,已用官方 CLI + 本机测试模型验证;真实模型 API 参数尚未配置/认证,后台自主监管未实现。换机器用 7-Zip 和 node scripts/setup-zcode.cjs 校验解包,管理员在页面配置模型,运行包不在 Git。
  • 独立守护、双端口实例心跳、退出/持续无响应恢复、退避/冷却、日志轮转、Windows 登录自启、只读历史健康面板与断线恢复。

必须延续的业务边界

  • PDF 仅归档,不附加到通知邮件,不因归档而触发邮件。 邮件正文只取 BPM 简要说明原文,按产业通知接口人。
  • 流程范围、简要说明字段、产业与接口人映射由同事整理后配置;不把全部待阅/知会当订单,不猜收件人,不自动已阅或审批。
  • “210”是可配置 SMB 能力,不硬编码服务器或目录。免填模式使用部署账号/现有 SMB 会话,不是网页访问者身份。
  • ZCode 仅使用授权快照;固定动作须用户点选并重新检查权限,不执行模型任意命令、文件、审批或邮件操作。
  • 健康卡片是上次保存/观测结果,不等同实时外网连通性;刷新不触发外部检查。邮件结果不明保持待核实,不自动重发。

2026-10-18 历史下一步建议

当时确认并完成的是“服务守护+健康面板”。以下建议仅保留历史,不作为当前业务身份或实施状态:

  1. 批量导出/归档与持久任务记录:从扫描列表人工勾选,自动打开详情、采集可见字段、生成 PDF、按真实订单号归档;显示进度、支持取消及失败步骤重试。
  2. 统一订单任务中心:按订单号和业务版本关联扫描、导出、归档及独立通知状态,保持 PDF 和通知两条链路独立。
  3. 健康异常跳转具体失败记录,复用已完成结果,只重试允许重试的步骤。
  4. 可配置业务规则和试运行预览;同事资料核实后再接自动来源。
  5. 自动备份与恢复演练;跨机或跨 Windows 用户需验证 DPAPI 恢复条件或重新授权。

验证与容易重复踩的问题

  • 服务守护及受影响回归 20/20、额外加密存储 7/7,共 27 项不同测试通过;19 个 JS 语法检查通过。覆盖实际子进程退出/无响应、冷却、手动重启/停止、鉴权及畸形消息、未知端口保护、中文启动器、安装失败/外来快捷方式、健康历史/权限、浏览器断线恢复。
  • 实机独立 CLI 重启后守护保持、两个端口恢复、登录会话保留,健康页无脚本错误。没有重启 Windows,也未验收公司真实邮件及正式全业务自动处理。
  • ZCode 官方 CLI 的真实请求已核对地址/模型/鉴权及空工具列表;返回未经请求的 Write 调用时没有写文件。供应商真实认证仍待配置。
  • 本环境曾拒绝文件 rename(EXDEV),会话已改 SQLite,不倒退为临时文件 rename。
  • BPM fulfill/abort 必须在 try 内 await,否则异步拒绝绕过 catch 导致服务退出。
  • Windows PowerShell 明确 UTF-8 输入/输出;VBS 用 UTF-16LE BOM,已执行验证中文及空格路径。
  • 管理令牌仅用于本机管道,HTTP 心跳每次启动独立随机。超时不能当停止成功,须通道关闭且同一实例的 stopped 状态落盘。
  • CLI 工具禁止名单按精确名称,* 不代表全部;旧 provider 导入忽略 tool_call:false 和输出 token 上限,不能把它们当安全控制。
node --test --test-concurrency=1 tests/service-supervisor.test.cjs tests/service-control.test.cjs tests/windows-startup.test.cjs tests/runtime-health.test.cjs tests/health-http-ui.test.cjs tests/server.test.cjs tests/workspace-http.test.cjs tests/bpm-runtime.test.cjs tests/dashboard-http.test.cjs
node --test tests/bpm-vault.test.cjs

详细证据见 验证记录。日志/截图位于本机忽略目录 output/verification,新克隆需要重新生成。

运行数据与阅读入口

状态位于 %LOCALAPPDATA%\OrderNotificationAutomation,含工作台、BPM、邮件、扫描、存储、通知、助手、健康与守护的 SQLite,以及加密主密钥和本机运行包。账号密码、Cookie、API Key、数据库、业务 PDF/原邮件、日志、截图不提交 Git。

Git 推送不等于运行数据备份。 备份先 npm run service:stop,保护整个本地状态及业务输出目录和 DPAPI 恢复条件,再 npm start。本机开发/测试连接不视为正式 210 等服务器端到端验收。

阅读顺序:README、当前设计要求、业务资料整理表,按任务查 守护设计、ZCode 接入记录、验证历史。早期阶段文档的“尚未实现”以最新基准及代码为准。