diff --git a/docs/HANDOFF.md b/docs/HANDOFF.md index ca13392..c3bcd49 100644 --- a/docs/HANDOFF.md +++ b/docs/HANDOFF.md @@ -1,4 +1,16 @@ -# 开发交接(2026-10-20) +# 开发交接(2026-10-21) + +## 全局优化已交付(最新状态) + +用户在全局审查后要求“全部优化”,已按[本轮设计](superpowers/specs/2026-10-21-global-optimization-design.md)及[计划](superpowers/plans/2026-10-21-global-optimization.md)完成。业务执行/监听、统一首页/订单中心/邮件批次、分页与权限、归档纠正/恢复、账号交接、PDF历史保留、助手会话归档和受控备份均已验收;旧生产发送器与重复入口已退役。代码提交69583e8,前序84e2f0d/1148aa6及核心/监听提交均在本地codex/modular-refactor,未推送合并。 + +新鲜npm ci后最终完整640项:639通过、0失败、1可选ZCode CLI跳过;295个JS/CJS语法、8份文档50条本地链接及1个锚点、差异与暂存敏感文件检查通过。模块和最终复审门禁通过,中间失败及修复证据完整保留,见[全局优化验收](global-optimization-verification-2026-10-21.md)与[复审记录](reviews/2026-10-21-global-optimization-final-review.md)。 + +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项验证,未覆盖原状态,见[备份恢复指南](backup-restore-guide.md)。 + +现场项:当前BPM连接验证未通过/查询跳转,自动续登未开启;邮箱与SMB未配置,字段草稿尚待实际发布。服务可访问不代表真实业务链已联调。历史47次存储失败根因尚未证实,本轮确证的一次key_protect子进程15秒超时已加入受限重试及安全诊断,不能据此宣称历史故障根治。自动处理与发信继续暂停;未发真实邮件、未办理BPM、未操作服务机。 ## 本轮同步设置与记录导航 diff --git a/docs/design-requirements.md b/docs/design-requirements.md index 4b5aca9..e7ae07c 100644 --- a/docs/design-requirements.md +++ b/docs/design-requirements.md @@ -1,14 +1,14 @@ # 订单通知自动化:当前设计要求 -更新:2026-10-20。与早期调研冲突时,以本文、已批准的设置与执行方案和 Excel 分类为准。 +更新:2026-10-21。与早期调研冲突时,以本文、已批准的设置与执行方案和 Excel 分类为准。 ## 界面与权限 -沿用 Tabler 1.6.1,侧栏七项:工作总览、订单通知管理、订单与导出记录、异常待办、助手、业务设置、系统设置。顶部接入原生 nav-segmented 圆角分段横栏:灰底、白色选中项、SVG图标、清晰焦点。390px 单行滚动且选中项自动进入横栏视口。所有页签为真实 hash 链接,默认首项,刷新及浏览器前后退继续有效。 +沿用 Tabler 1.6.1,侧栏七项:首页、订单中心、邮件批次、工具、异常待办、业务设置、系统设置。顶部接入原生 nav-segmented 圆角分段横栏:灰底、白色选中项、SVG图标、清晰焦点。390px 单行滚动且选中项自动进入横栏视口。所有页签为真实 hash 链接,默认首项,刷新及浏览器前后退继续有效。 -订单通知管理:通知总览、订单执行、通知订单、待发批次、发送记录、通知配置。通知配置卡片内为发送计划、业务日历、邮件模板、发送设置;规则收件人在业务设置维护。通知总览显示真实时段、下一计划时点、待发数及阻塞原因;通知订单关联冻结批次及归档证据,导出记录仍独立查询采集/PDF。顶部通知状态以服务端为准,查询失败为待确认,不猜测暂停或启用。 +日常业务使用唯一首页、订单中心和邮件批次。首页显示双开关、连续窗口、下一时点、未配置与实际阻塞;订单中心合并执行任务和通知订单,详情按进度、来源、PDF/归档、批次和核验展开。邮件批次统一未终结与历史,prepared跨窗口保留,具体历史追溯带scope=all;旧hash兼容跳转。业务列表服务端分页25/50/100,显式查询,按账号保留已应用状态,后台只提示更新;关闭详情取消迟到响应,按钮、Escape和遮罩统一未保存保护。工具收纳到达/PDF台账、共享文件和可选助手。 -业务横栏:分类通知规则、字段映射。系统横栏:BPM连接、邮箱管理、存储服务器、助手设置、系统健康、团队账号、操作记录。团队账号仅管理员可见;个人改密在右上角。助手主页面只保留对话和授权操作卡片。 +业务横栏:分类通知规则、字段映射。系统横栏:BPM连接、邮箱管理、助手设置、系统健康、团队账号、操作记录。团队账号仅管理员可见;个人改密在右上角。助手主页面只保留对话和授权操作卡片。 订单与导出记录采用用户确认的A台账方案:顶部流程到达记录/PDF导出记录复用同一Tabler分段导航,对应`#records`/`#records-pdf`。到达记录默认现有连接、订单相关流程及全部到达类型,统一表格每页25条;来源与日期放更多筛选,长标题和完整来源信息在详情侧栏。历史是累计到达台账,不宣称当前待办。删除BPM连接在同一事务保留安全来源档案,关联记录进入历史归档;停用仍属现有来源,旧孤立来源保留ID且不猜账号。PDF导出状态、本地文件可下载与实际存储归档回执分别显示,无连接关联时不按订单号猜测归属。详见[台账设计](superpowers/specs/2026-10-20-records-ledger-design.md)及[验收](records-ledger-verification-2026-10-20.md)。 @@ -36,11 +36,11 @@ Excel 的15类规则是唯一业务分类。流程名称、版本、配置节点 执行步骤持久化:识别、导出、归档读回校验、入队、批次冻结、发送、人工核验。归档记录文件路径、字节数、SHA256,名称按订单号/所选日期/流水号;浏览器扩展的原有四字段命名契约不变。SMB 操作限已配置共享内,禁止越界、链接、覆盖不同内容;有界worker超时退出后才释放操作。 -规则保存产生草稿。发布须完整字段适配、真实样本试跑、收件人和目录齐备且无冲突。规则、收件人、正文模板、附件在批次生成时冻结,后续配置不篡改已有批次。模板保留收取、预览、确认、历史;类别须显式关联,旧产品线和群组不猜分类。 +规则保存产生草稿。发布须完整字段适配、真实样本试跑、收件人和目录齐备且无冲突。规则、收件人、正文模板、附件在批次生成时冻结,后续配置不篡改已有批次。模板保留收取、预览、确认、历史;模板仅由分类规则选择;模板库显示有效使用情况,旧关联只读兼容,旧POST410。旧产品线和群组不猜分类。 -明确发送前失败可修复后重试。SMTP发出后断线、部分收件人拒绝或重启前sending均为结果待核验,禁止自动重复发信。已生成失败批次可由管理员填写依据、携带版本和幂等标识逐批补发,新尝试关联原批次和审计;已发送不可补发,unknown先核验。后台调度从不补历史。 +明确发送前失败可修复后重试。SMTP发出后断线、部分收件人拒绝或重启前sending均为结果待核验,禁止自动重复发信。已生成失败批次可由管理员填写依据、携带版本和幂等标识逐批补发,新尝试关联原批次和审计;已发送不可补发,unknown先核验。后台调度从不补历史。自动处理和发信独立开关,启用处理保存基线,基线前未处理历史不自动入队;窗口从前一个有效时点连续积累,包括普通晚间。时点60秒内整理和冻结,合法冻结队列最多30分钟,过期显式待处理,不能重建历史冻结。 -执行失败关联异常并去重,保留负责人、失败原因和可用恢复动作;恢复成功留待人工核验,不伪造核验完成。任务查询和受控重试/补发复用现有API模块。 +执行失败关联异常并去重,保留负责人、失败原因和可用恢复动作;恢复成功留待人工核验,不伪造核验完成。任务查询和受控重试/补发复用现有API模块。业务问题源账本先持久化,幂等关联可认领/转交/核验的异常,复发重开;unknown须先核验原批次,关闭异常本身不改变发送状态。 ## 保留与退役 @@ -48,7 +48,7 @@ Excel 的15类规则是唯一业务分类。流程名称、版本、配置节点 保留账号、BPM与只读到达历史、分类通知、导出归档、日历、模板与邮箱历史、异常协作、助手、服务健康、审计。旧监管草稿、重复连接汇总页、与Excel并行的通用通知写入/调度和逐单/产品线选项已退役。旧数据、邮件记录与模板保留查询,旧写入返回410并指出新入口,旧hash重定向。收件人仅在Excel分类规则维护。 -旧到达记录扫描读取inform接口,仅供到达历史查询;订单执行独立读取实际todo接口,绝不将inform改名当todo。 +到达台账明确区分实际todo与inform接口及累计收录含义,不能将待阅改名当待办,也不将累计记录当当前待办。成功todo对账作为可信本地线索驱动执行;生产者加密投递队列与消费者待处理都参与冻结屏障,失败同run重试不重新读取BPM。 海外订单通知书默认正文采用类别引导语、多条订单摘要、统一实际归档目录和签名;机芯号、型号、客户简称、出货方式、数量从标题段落独立提取。一个事件多个摘要不自动拆成多个PDF任务。其他类别格式保持兼容,附件仍按类别规则;旧模板变量保持原义,新增订单明细、存放地址、类别名称变量。已冻结批次不重新生成正文。 @@ -66,6 +66,8 @@ Excel 的15类规则是唯一业务分类。流程名称、版本、配置节点 远程登录保留精确域白名单、认证互斥、禁止任意外部导航和下载。只读订单采集另建禁脚本上下文,禁止审批/保存/提交请求及未经核验的重定向。新版门户登录成功不等于旧版表单会话就绪。 -上线前备份正式SQLite、WAL及加密密钥,保持同一Windows身份,更新后检查18765/18766双端口、登录、横栏和配置状态。正式自动发信保持暂停,直到相应类别真实字段、旧版会话、共享目录、邮箱与预览完成现场核验。未核验能力显示具体阻塞,不能手动勾选ready。 +账号停用/降权需交接未结工作;旧登录和BPM租约排空,清理失败持久保留目标并可重试,保护最后启用管理员。PDF任务原子迁入独立SQL表,默认永久保留;系统健康提供容量与安全摘要历史导出。个人助手会话可归档/恢复并在100轮后延续,历史动作证据不删除。 + +上线前使用[受控备份恢复](backup-restore-guide.md)保存SQLite、WAL、PDF与目录绑定的加密键;恢复只允许新空目录并验证当前Windows身份,不覆盖原状态。更新后检查18765/18766双端口、登录、横栏和配置状态。正式自动发信保持暂停,直到相应类别真实字段、旧版会话、共享目录、邮箱与预览完成现场核验。未核验能力显示具体阻塞,不能手动勾选ready。 逐项验收见[操作清单](web-action-inventory.md),配置见[分类规则说明](order-rules-guide.md),当前交接与局限见[HANDOFF](HANDOFF.md)。 diff --git a/docs/global-optimization-verification-2026-10-21.md b/docs/global-optimization-verification-2026-10-21.md new file mode 100644 index 0000000..8010a0b --- /dev/null +++ b/docs/global-optimization-verification-2026-10-21.md @@ -0,0 +1,61 @@ +# 全局优化验收(2026-10-21) + +用户在[全局审查](reviews/2026-10-21-global-functional-review.md)后授权全部优化。实现依据为[设计](superpowers/specs/2026-10-21-global-optimization-design.md)与[计划](superpowers/plans/2026-10-21-global-optimization.md)。工作树为`C:/Users/ABS/.codex/worktrees/modular-refactor/Order Notification Automation`,分支`codex/modular-refactor`;原共享源码不改,不推送或合并。 + +本机原测试实例开发前已停止,并完成8074文件、5,973,158字节的离线备份,位置为`C:/Users/ABS/AppData/Local/OrderNotificationAutomationBackups/global-optimization-2026-10-21T01-07-32-042Z`。原账号、受保护键、31份样本与31份字段草稿必须保留;只允许明确的schema与双开关迁移。不发送真实邮件,不办理BPM,不操作服务机。 + +## 最终结果 + +代码提交69583e8,前序84e2f0d/1148aa6与核心/监听修复保留在本地codex/modular-refactor。最终完整npm test退出0:640项中639通过、0失败、1可选ZCode CLI跳过,耗时671.6秒。295个JS/CJS语法通过;8份文档50条本地链接及1个锚点通过;差异检查通过;最后46个暂存代码/测试文件未发现私有数据文件或疑似真实密钥字面量。各模块与最终规格/正确性复审通过,见[复审记录](reviews/2026-10-21-global-optimization-final-review.md)。npm ci使用原锁定依赖,未加入新依赖;安装日志报告2项既有中危依赖审计项,本轮未进行强制破坏升级。 + +12:30按原方式npm start恢复原本机实例,双端口心跳正常、37项资源返回200且首页HTML与交付文件一致。原浏览器会话已刷新为新版,保留原管理员登录;实际首页、订单中心、邮件批次、BPM全局同步、团队账号、容量与PDF台账均可读。原账号/全部原有受保护键/31份样本/31份字段草稿/字段适配/规则/订单/批次/BPM托管账号摘要核对保持;主设置及发送计划、配对键和原PDF台账/文件核对保持。原有PDF任务和本地输出均为0,长期台账保留使用5001+合成记录验证。 + +通知设置version1,enabled=false、processingEnabled=false、processingSince=null。同步设置维持原启用及5分钟间隔。未发送真实邮件、未办理BPM、未操作服务机、未推送合并。当前BPM连接检查失败,邮箱和SMB未配置,不能把服务恢复当作现场业务联调完成。 + +证据保存在忽略目录output/verification以及output/global-optimization-{before,prestart,after}.json、extra-{before,after}.json;仅包含安全摘要与验证结果。原始及受控备份均保留,完整失败轮次与专项红绿结果没有删除。 + +## 审查项与实现 + +| 原项 | 实现与隔离验证 | +|---|---| +| F01 归属过滤 | 统一连接、订单、批次、文件权限,业务接口移除原始表单;混合来源批次要求全部可读。global-core/query | +| F02 归档纠正 | 输出指纹与archiveGeneration,纠正建新代、同次故障恢复复用原代;保留旧证据。global-core/archive | +| F03 时点提前推进 | 60秒整理可重试;冻结批次最多30分钟发送队列;错过时点显式阻塞。window/dispatcher | +| F04 旧批次消失 | 邮件批次统一列表,旧prepared始终可查,历史范围含已发送和取消;追溯链接包含scope=all。business-records | +| F05 模板双入口 | 分类规则为唯一模板选择入口;旧类别绑定GET保留、POST410。section-ui/mail | +| F06 间隔缩短不生效 | 按上次完整对账重算期限;todo/inform独立失败和退避;来源与下一对账时间可见。arrival-monitor | +| F07 恢复/退役 | 恢复转待核验、删除关联异常退役、旧手工/孤立异常管理员显式归档;新失败使旧核验失效。workspace/account | +| F08 探测累积 | 临时目录探测后清理,能力缓存5分钟,真实成功归档更新证据。archive | +| F09 台账截断 | PDF任务原子迁入独立SQL表,5001+记录仍可查、下载定位保留;管理员容量与摘要历史导出。job-retention/maintenance | +| F10 后台重画 | 业务列表复用记录页分页/状态工具,仅提示更新;详情关闭取消旧响应,Escape/遮罩共用未保存保护。business-records | +| F11 文案链接 | “扫描并处理订单”说明PDF与归档;修正PDF/执行/批次链接和扩展自动归档范围;累计待办/待阅分开。navigation/bpm | +| F12 存储诊断 | 保留cause与安全阶段/代码,ACL复用仅限同一真实目录身份,新增启动及事件循环观测。vault-diagnostics/runtime-health | +| D01 处理/发信分离 | 独立processingEnabled与enabled;启用基线processingSince排除旧历史;当前迁移保持暂停。global-core | +| D02 归档后节点消失 | 已归档依据回执和文件读回验证,不再依赖原todo仍存在;修订有受控采用/忽略。execution | +| D03 冻结与发送期限 | 时点冻结集合与最长30分钟发送队列分开,原冻结证据不改,未冻结历史不补成新批次。window/dispatcher | +| D04 规则迁移 | 当前已发布规则预览/版本/幂等/依据,冻结或不确定结果不改写。migrations | +| D05 可信监听线索 | todo成功与加密投递队列同事务保存,本地同run重试不重复读取;生产者与消费者待处理均参与冻结屏障。delivery-barrier | +| D06 健康与就绪 | 来源读取、监听和本地投递分别显示,失败保留,新鲜度与服务健康分开。runtime-health | +| D07 普通晚间到达 | 从前一有效截止时点连续积累,涵盖普通工作日晚间;启用基线前历史不自动入队。window/global-core | + +## 能力补齐与精简 + +账号支持停用、角色、负责人交接和撤销登录,保护最后启用管理员。旧会话按授权版本失效,连接交接暂停并排空旧租约;失败清理保留目标后重试。助手是工具区可选功能,支持个人会话归档/恢复、分页、100轮后延续新会话,动作审计保留;核心业务无需模型。 + +首页、订单中心、邮件批次成为日常主线;旧订单执行/待发/发送记录hash保留明确跳转。字段映射复用真实订单选择器;重复采样状态和监管草稿表单退出,监管历史保留。旧通用通知生产装配只有历史读取,无恢复或发送调度;所有旧写入口继续410。 + +备份create/verify/restore只恢复至新空目录,实际验证DPAPI与换目录后的加密内容/PDF引用。备份专项16/16;本机实际离线受控备份create/verify均退出0,新备份位于C:/Users/ABS/AppData/Local/OrderNotificationAutomationBackups/global-optimization-verified-20261021-112248,8518文件、5,704,104字节、3个目录绑定vault。换目录解密与PDF引用恢复使用隔离合成数据验证,未覆盖原状态;说明见[备份恢复指南](backup-restore-guide.md)。 + +## 验证记录 + +初始全局审查完整527项为524通过、2失败、1跳过,两项单独复跑通过;该结果不作为本轮全量通过依据。Task1核心83/83及独立global-core8/8,Task2监听/队列30/30和持久化/损坏2/2通过。管理专项61项中60通过、0失败、1可选CLI跳过;工作台审查五项发现修复后14/14及详情关闭1/1通过。原红测及中间失败均保存在忽略目录`output/verification`,没有用放宽断言替代修复。 + +新鲜`npm ci`已完成。账号最终13/13通过;跨模块归档/迁移/恢复及UI契约修正后的完整相关切片55/55通过。最终审查发现异步归档写回、交接快照及保存失败后重新登录三类并发边界,均有红绿回归;未提交归档的新版规则迁移建立新代,已有一致归档证据保留。 + +首轮新鲜完整测试在旧通知页链接的UI测试失败,复现确认原字段契约已通过、失败为退役路由查找;迁移到当前分页详情后继续验证版本、幂等、核验依据与结果。该轮在相关恢复残余明确后停止,原日志保留,不作为完成全量结果。修正55/55后的完整轮次为637项:631通过、5失败、1可选CLI跳过。该失败整轮已保留。五项涉及工具导航标签、邮件模板入口和可用性降级、字段目录专用API、独立开关/统一批次,以及摘要刷新模拟。已修复工具导航语义与模板局部失败隔离,并保留/扩展原权限、真实样本、发布、版本、幂等、保存后刷新失败断言。对应专项19/19、18/18、模板隔离1/1通过;其后的完整轮次637项中635通过、1失败、1可选CLI跳过;唯一失败在页面初始化前,安全诊断明确为key_protect阶段的powershell.exe 15秒ETIMEDOUT(SIGTERM、stderr为空)。这不能证明历史47次故障的具体根因。 + +针对当前证实的超时,固定ACL/DPAPI调用仅对ETIMEDOUT重试一次、输入相同,每次15秒;权限错误或再次失败直接保留stage/cause,密钥发布仍用wx,原始随机键finally清零。注入超时/权限的6项及原交互单项通过,独立安全复审通过。原失败日志保留。最终canonical完整测试已退出0,结果及恢复核对见本文“最终结果”。 + +## 外部验收条件 + +自动处理与自动邮件继续暂停。实际邮箱/SMTP、共享目录、分类预览与缺失流程字段发布仍须按真实业务验证;未观察自然BPM事件的流程不能宣称现场监听验收。历史47次存储包装启动失败根因尚未确证,本轮增加诊断与缓存不能证明已根治。BPM节点始终人工办理。 diff --git a/docs/reviews/2026-10-21-global-optimization-final-review.md b/docs/reviews/2026-10-21-global-optimization-final-review.md new file mode 100644 index 0000000..4e4c09c --- /dev/null +++ b/docs/reviews/2026-10-21-global-optimization-final-review.md @@ -0,0 +1,20 @@ +# 全局优化复审记录 + +本轮从`51d9e65118d6d02c2b25b8cd857dd373e1a0bb35`审查至本轮交付代码,包含模块复审和跨模块最终复审。以下为已修复并定点关闭的关键发现;详细验收与完整测试结果见[本轮验收](../global-optimization-verification-2026-10-21.md)。 + +| 范围 | 发现与最终处理 | +|---|---| +| 核心调度 | 空时段/完成时段继续推进;晚到及错过时点保留明确任务;每次完整对账的待处理线索独立持久化,不被新列表覆盖 | +| 监听与投递 | 暂停/删除阻止迟到提交;成功读取和本地执行投递分阶段,投递失败保留同run加密队列;暂停保留故障证据;生产者待投递也阻止冻结 | +| 业务详情 | 列表和详情选同一个有效修订任务,原修订证据另行授权;关闭详情取消请求,Escape/遮罩统一保护输入;已发送批次链接明确包含历史范围 | +| 账号交接 | 使用真实suspend契约和同一连接生命周期队列,清理目标先持久化;失败后新登录的hash/租约重新合并,最终同步边界重读归属,新连接未锁定时拒绝并要求重试 | +| 管理交互 | BPM复发使旧待核验版本失效;助手分页失败可重试,迟到失败不覆盖新范围;旧异常归档保留全局审计标签 | +| 归档并发 | 异步调用前冻结代次/来源/输出/任务版本,回写时事务内比较;过期回执只留原代历史,不能排入新代订单;过期错误不覆盖新任务 | +| 归档恢复 | 真实持久意图回归发现仅改收件人的未提交归档迁移会卡住。最终为未提交收据的新发布版本建立新代;已提交且实际输出一致的归档仍保留。原持久指纹无需兼容性改写 | +| 验收回归 | 工具页导航无障碍标签正确命名;模板使用情况读取失败局部提示,保留已读模板预览与维护;过时测试迁移到专用字段API、摘要分页与独立开关,原权限/来源/发布/保存失败断言保留 | +| 当前DPAPI超时 | 完整测试诊断到key_protect子进程ETIMEDOUT;固定保护操作仅对该码做一次有界同输入重试,其余错误保留,清零和原子密钥发布保留;不据此推断历史47次根因 | +| 备份与退役 | 恢复输出限定新状态内固定目录并拒绝junction/跨卷;旧unknown通知批次优先可见;旧生产发送器只保留历史读取 | + +模块及最终定点审查的规格、正确性门禁均已通过。最终归档恢复修正的相关切片55/55通过;审核者只核对保存日志与代码,没有把引用的实施结果标成独立重跑。完整`npm test`、原数据保留和本机服务恢复仍以本轮验收记录为准。 + +历史47次存储包装启动失败的具体根因尚未确认;本轮诊断和初始化缓存不构成根治证明。真实邮箱、共享目录、字段发布与自然到达仍须现场核验,自动处理和发信继续暂停。 diff --git a/docs/superpowers/plans/2026-10-21-global-optimization.md b/docs/superpowers/plans/2026-10-21-global-optimization.md index efed299..c16c7d5 100644 --- a/docs/superpowers/plans/2026-10-21-global-optimization.md +++ b/docs/superpowers/plans/2026-10-21-global-optimization.md @@ -31,7 +31,7 @@ - 管理员规则迁移`POST /api/order-rules/rules/:id/migration/{preview|apply}`使用`{version,idempotencyKey,note}`;修订处理`POST /api/order-execution/tasks/:id/resolve`使用`{version,idempotencyKey,resolution,note}`。 - `OrderArchiveProvider.archive`以来源+标准输出指纹+archiveGeneration区分故障恢复与业务纠正,旧意图迁移保留证据。 -- [ ] **Step 1:** 新增有实际断言的回归,验证非负责人快照不泄露、A→B归档纠正、自动处理与发信分离、归档后待办消失、当前时段重试与15类慢SMTP、周二晚间进入周三首封。 +- [x] **Step 1:** 新增有实际断言的回归,验证非负责人快照不泄露、A→B归档纠正、自动处理与发信分离、归档后待办消失、当前时段重试与15类慢SMTP、周二晚间进入周三首封。 ```js assert.equal(canReadOrder(workspace,{username:'other',role:'operator'},order),false); @@ -39,10 +39,10 @@ assert.equal(inWindow('2026-10-20T17:30:00+08:00',windowForCutoff('2026-10-21T11 assert.notDeepEqual(correctedArchive.files,originalArchive.files); ``` -- [ ] **Step 2:** 运行`node --test --test-concurrency=1 tests/order-rules/global-core.test.cjs`,记录缺陷对应失败;禁止通过放宽断言绕过。 -- [ ] **Step 3:** 实现统一授权投影、代次归档/临时探测、两个门控和启用基线、连续窗口、当前整理60秒/冻结发送30分钟、已归档证据复核;未知结果仍阻止自动重发。增加受控批量规则迁移与修订状态机,冻结或unknown不能被改写。 -- [ ] **Step 4:** 为发送失败/构建受阻/时点超期创建去重异常或持久待处理项,明确负责人、证据与核验路径;后台错误不能静默失踪。 -- [ ] **Step 5:** 运行新回归和`store,batches,window,execution,business-mail-content`现有测试,更新明确改变的策略断言;写出Task 1接口摘要、迁移决定和测试结果,由主代理审查后提交限定文件。 +- [x] **Step 2:** 运行`node --test --test-concurrency=1 tests/order-rules/global-core.test.cjs`,记录缺陷对应失败;禁止通过放宽断言绕过。 +- [x] **Step 3:** 实现统一授权投影、代次归档/临时探测、两个门控和启用基线、连续窗口、当前整理60秒/冻结发送30分钟、已归档证据复核;未知结果仍阻止自动重发。增加受控批量规则迁移与修订状态机,冻结或unknown不能被改写。 +- [x] **Step 4:** 为发送失败/构建受阻/时点超期创建去重异常或持久待处理项,明确负责人、证据与核验路径;后台错误不能静默失踪。 +- [x] **Step 5:** 运行新回归和`store,batches,window,execution,business-mail-content`现有测试,更新明确改变的策略断言;写出Task 1接口摘要、迁移决定和测试结果,由主代理审查后提交限定文件。 ## Task 2: 监听、健康与存储诊断(主代理) @@ -50,7 +50,7 @@ assert.notDeepEqual(correctedArchive.files,originalArchive.files); **Interfaces:** monitor构造器新增可选`onTodoReconciled(payload)`,payload与Task 1的notifyDiscovery签名相同;快照增加`nextReconcileAt`和按todo/inform的success/failure/retryAt。`diagnostics.safeDiagnostic(error)`仅返回阶段/类型/代码/程序位置。 -- [ ] **Step 1:** 补假时钟测试,24小时改1分钟在新期限内对账;todo失败不被inform成功覆盖,失败有退避且事件可合并;暂停/删除后旧回调不能提交。 +- [x] **Step 1:** 补假时钟测试,24小时改1分钟在新期限内对账;todo失败不被inform成功覆盖,失败有退避且事件可合并;暂停/删除后旧回调不能提交。 ```js config.intervalMinutes=1; advance(60001); await monitor.tick(); @@ -59,9 +59,9 @@ assert.equal(snapshot.sources.todo.status,'error'); assert.equal(JSON.stringify(safeDiagnostic(secretError)).includes('synthetic-secret'),false); ``` -- [ ] **Step 2:** 确认测试先失败,再实现按最后对账重排、来源失败队列、完整线索通知和健康新鲜度。 -- [ ] **Step 3:** 在vault边界保留cause并加入不含敏感值的阶段;同进程复用已核验且仍同一目录身份的ACL/密钥初始化,变更/失败不复用。保留首次ACL与DPAPI CurrentUser保护;不把503当登录过期。 -- [ ] **Step 4:** 启动错误记录安全诊断及启动阶段耗时,健康保留独立待办/待阅/监听证据;运行专项与隐私回归,审查后限定提交。 +- [x] **Step 2:** 确认测试先失败,再实现按最后对账重排、来源失败队列、完整线索通知和健康新鲜度。 +- [x] **Step 3:** 在vault边界保留cause并加入不含敏感值的阶段;同进程复用已核验且仍同一目录身份的ACL/密钥初始化,变更/失败不复用。保留首次ACL与DPAPI CurrentUser保护;不把503当登录过期。 +- [x] **Step 4:** 启动错误记录安全诊断及启动阶段耗时,健康保留独立待办/待阅/监听证据;运行专项与隐私回归,审查后限定提交。 ## Task 3: 唯一首页、订单中心、邮件批次与查询(实现子代理) @@ -69,17 +69,17 @@ assert.equal(JSON.stringify(safeDiagnostic(secretError)).includes('synthetic-sec **Interfaces:** 消费Task 1 access、两个设置开关、迁移/修订接口;产生`orderRuleQueryApi({orderRules,execution,workspace,user,url,route,method,reply,response})`。查询GET路径、参数和返回字段严格沿设计;默认25,最大100;非法枚举拒绝,超末页夹取,零记录第1页。 -- [ ] **Step 1:** 用超过3页的合成订单/批次验证授权、过滤、真实末页、零记录、详情/文件越权;有旧prepared跨窗口仍在active列表。 +- [x] **Step 1:** 用超过3页的合成订单/批次验证授权、过滤、真实末页、零记录、详情/文件越权;有旧prepared跨窗口仍在active列表。 ```js assert.deepEqual(queryOrders(context,{page:999,pageSize:25},principal).page,4); assert.equal(queryBatches(context,{scope:'active'},principal).items.some(b=>b.id===oldPrepared.id),true); ``` -- [ ] **Step 2:** 实现有限输出的服务端查询、可见范围一致的详情、授权文件读取与证据校验;内部原始字段不出现在列表或详情。 -- [ ] **Step 3:** Tabler复用记录页状态/分页工具实现订单中心与邮件批次,旧hash跳转保留;唯一首页显示真实业务阻塞。后台只提示更新,慢/旧响应、翻页失败与详情稳定有专项UI测试。 -- [ ] **Step 4:** 分类是唯一模板选择入口,模板库取消易误导的关联写表单;字段映射合并重复采样入口;修复错误链接和“扫描并处理订单”说明;助手/手工导出/文件查看移到工具区。连接页显示新monitor来源状态,异常retired视为历史且不可再办理。 -- [ ] **Step 5:** 检查查询/回车、25/50/100、刷新/前后退/离页清理、账号隔离、390px、文件追溯及unknown核验/补发;不以真实BPM或SMTP验证。提供新增资源路径清单,主代理统一装配、审查及限定提交。 +- [x] **Step 2:** 实现有限输出的服务端查询、可见范围一致的详情、授权文件读取与证据校验;内部原始字段不出现在列表或详情。 +- [x] **Step 3:** Tabler复用记录页状态/分页工具实现订单中心与邮件批次,旧hash跳转保留;唯一首页显示真实业务阻塞。后台只提示更新,慢/旧响应、翻页失败与详情稳定有专项UI测试。 +- [x] **Step 4:** 分类是唯一模板选择入口,模板库取消易误导的关联写表单;字段映射合并重复采样入口;修复错误链接和“扫描并处理订单”说明;助手/手工导出/文件查看移到工具区。连接页显示新monitor来源状态,异常retired视为历史且不可再办理。 +- [x] **Step 5:** 检查查询/回车、25/50/100、刷新/前后退/离页清理、账号隔离、390px、文件追溯及unknown核验/补发;不以真实BPM或SMTP验证。提供新增资源路径清单,主代理统一装配、审查及限定提交。 ## Task 4: 账号交接、PDF历史与助手会话(主代理) @@ -87,17 +87,17 @@ assert.equal(queryBatches(context,{scope:'active'},principal).items.some(b=>b.id **Interfaces:** `POST /api/users/:id/lifecycle`接受`{version,enabled,role,transferTo}`;`POST /api/users/:id/revoke-sessions`管理员撤销;`POST /api/connections/:id/owner`接受当前版本与新负责人。`Store.jobs()`兼容现有调用但从独立SQL表读取;`recordJob`不裁剪。会话`POST /api/assistant/conversations/:id/archive|restore`使用当前版本,归档不删除动作审计。 -- [ ] **Step 1:** 红测验证最后管理员保护、停用/降权后旧会话和BPM租约失效、负责人统一交接、并发版本拒绝、连接删除关联异常retired、恢复只转待核验。 -- [ ] **Step 2:** 实现生命周期及显式交接,失败明确返回已完成阶段,支持安全重试;保留原用户ID与历史负责人。viewer不能成为自动处理连接负责人。 -- [ ] **Step 3:** 用5001+浏览器任务红测验证最旧任务仍可下载/查询,原子迁移jobs至独立表;加入只读容量/记录统计和不含凭据的历史导出,默认不删除数据。 +- [x] **Step 1:** 红测验证最后管理员保护、停用/降权后旧会话和BPM租约失效、负责人统一交接、并发版本拒绝、连接删除关联异常retired、恢复只转待核验。 +- [x] **Step 2:** 实现生命周期及显式交接,失败明确返回已完成阶段,支持安全重试;保留原用户ID与历史负责人。viewer不能成为自动处理连接负责人。 +- [x] **Step 3:** 用5001+浏览器任务红测验证最旧任务仍可下载/查询,原子迁移jobs至独立表;加入只读容量/记录统计和不含凭据的历史导出,默认不删除数据。 ```js for(let i=0;i<5001;i++)store.recordJob({jobId:String(i),status:'success'}); assert.equal(store.jobs().some(j=>j.jobId==='0'),true); ``` -- [ ] **Step 4:** 会话归档/恢复释放活跃额度、100轮延续新会话,运行中卡片先取消/排空;所有操作按本人授权,审计独立保留;UI显式说明作用与结果。 -- [ ] **Step 5:** 运行账号HTTP/租约、workspace、jobs台账和助手专项;核对兼容既有账号密码、角色和历史;审查后限定提交。 +- [x] **Step 4:** 会话归档/恢复释放活跃额度、100轮延续新会话,运行中卡片先取消/排空;所有操作按本人授权,审计独立保留;UI显式说明作用与结果。 +- [x] **Step 5:** 运行账号HTTP/租约、workspace、jobs台账和助手专项;核对兼容既有账号密码、角色和历史;审查后限定提交。 ## Task 5: 备份恢复、生产装配与退役清理(主代理) @@ -105,7 +105,7 @@ assert.equal(store.jobs().some(j=>j.jobId==='0'),true); **Interfaces:** `npm run backup -- create --destination `、`verify --source `、`restore --source --destination `。创建一致备份前服务必须停止;manifest记录相对路径、大小、sha256、应用版本、原state/output定位及Windows身份兼容摘要,不含明文秘密。拒绝链接、越界、覆盖和篡改。restore重绑定目录相关的加密key标识,仅在当前身份可解密时完成。 -- [ ] **Step 1:** 红测备份完整性、缺文件/篡改/路径穿越拒绝、非空目标拒绝;临时目录恢复后能读取原合成加密记录,原状态字节保持。不能将“复制完成”冒充可恢复。 +- [x] **Step 1:** 红测备份完整性、缺文件/篡改/路径穿越拒绝、非空目标拒绝;临时目录恢复后能读取原合成加密记录,原状态字节保持。不能将“复制完成”冒充可恢复。 ```js assert.throws(()=>verifyBackup(tampered),/校验/); @@ -113,17 +113,17 @@ assert.throws(()=>restoreBackup(source,nonempty),/空目录/); assert.deepEqual(readRestoredSyntheticRecord(),originalSyntheticRecord); ``` -- [ ] **Step 2:** 实现停服快照与新目录恢复验证命令;备份输出与密钥不入Git,默认完整保留,不执行真实状态覆盖。 -- [ ] **Step 3:** 应用将monitor完整线索接入execution;按source健康装配monitor;加入query-api与新JS资源;所有旧hash仍有明确目的页。 -- [ ] **Step 4:** 旧通知生产装配只保留历史读取,写入继续410;移除无用发送调度依赖、监管草稿死界面/写方法、模板类别双重写入口。删除只验证已退役发送能力的过时测试,补历史兼容和410回归,历史数据不删除。 -- [ ] **Step 5:** 专项验证备份/恢复、完整应用启动/关闭、资源、旧历史;更新设计要求与动作清单,审查后限定提交。 +- [x] **Step 2:** 实现停服快照与新目录恢复验证命令;备份输出与密钥不入Git,默认完整保留,不执行真实状态覆盖。 +- [x] **Step 3:** 应用将monitor完整线索接入execution;按source健康装配monitor;加入query-api与新JS资源;所有旧hash仍有明确目的页。 +- [x] **Step 4:** 旧通知生产装配只保留历史读取,写入继续410;移除无用发送调度依赖、监管草稿死界面/写方法、模板类别双重写入口。删除只验证已退役发送能力的过时测试,补历史兼容和410回归,历史数据不删除。 +- [x] **Step 5:** 专项验证备份/恢复、完整应用启动/关闭、资源、旧历史;更新设计要求与动作清单,审查后限定提交。 ## Task 6: 全量验收、提交与原本机测试服务恢复 **Files:** 新增`docs/global-optimization-verification-2026-10-21.md`,更新`docs/HANDOFF.md`及本计划复选框;忽略目录保存每项红绿证据、SQL/键摘要、备份与资源核对结果。 -- [ ] **Step 1:** 逐条核对F01–F12、D01–D07、能力补齐和精简项,记录实现文件、测试与实际外部前置;不把缺少真实配置当成已验收。 -- [ ] **Step 2:** 在停服状态运行`npm ci`,随后运行专项与新鲜完整`npm test`,不得有失败;如有失败按systematic-debugging定位根因并保留原结果。一次通过后不无理由重复全量。 -- [ ] **Step 3:** 运行JS/CJS语法、本地文档链接/锚点、`git diff --check`及文件范围/秘密检查;完整分支审查,修复关键反馈,提交本地分支。 -- [ ] **Step 4:** 验证停服备份,核对当前账号/原有密钥/样本/草稿/规则/历史保留,只允许明确的schema/设置迁移。确保`enabled=false,processingEnabled=false`,不新增真实规则、邮箱、目录或业务动作。 -- [ ] **Step 5:** `npm start`恢复原本机实例,核对18765/18766、全部资源、原账号会话、首页/订单/批次/设置/台账、暂停状态;更新交接与验收,保留备份和未完成现场条件,不推送合并。 +- [x] **Step 1:** 逐条核对F01–F12、D01–D07、能力补齐和精简项,记录实现文件、测试与实际外部前置;不把缺少真实配置当成已验收。 +- [x] **Step 2:** 在停服状态运行`npm ci`,随后运行专项与新鲜完整`npm test`,不得有失败;如有失败按systematic-debugging定位根因并保留原结果。一次通过后不无理由重复全量。 +- [x] **Step 3:** 运行JS/CJS语法、本地文档链接/锚点、`git diff --check`及文件范围/秘密检查;完整分支审查,修复关键反馈,提交本地分支。 +- [x] **Step 4:** 验证停服备份,核对当前账号/原有密钥/样本/草稿/规则/历史保留,只允许明确的schema/设置迁移。确保`enabled=false,processingEnabled=false`,不新增真实规则、邮箱、目录或业务动作。 +- [x] **Step 5:** `npm start`恢复原本机实例,核对18765/18766、全部资源、原账号会话、首页/订单/批次/设置/台账、暂停状态;更新交接与验收,保留备份和未完成现场条件,不推送合并。 diff --git a/docs/web-action-inventory.md b/docs/web-action-inventory.md index 3b8e776..10438c7 100644 --- a/docs/web-action-inventory.md +++ b/docs/web-action-inventory.md @@ -1,9 +1,22 @@ # 全站操作清单与验收 -适用:2026-10-20 订单通知管理、分段横栏、执行协调与独立字段映射版本。状态“已验证可用”指隔离环境对应行为通过测试,外部系统现场核验另列。所有写操作先校验登录、同源、角色、版本及前置条件;失败保留输入,结果不明查询实际状态,不自动重复写入或发信。所有查询支持重新进入刷新;无真实取消能力的动作不提供取消。 +适用:2026-10-21 全局优化版本;[本轮验收](global-optimization-verification-2026-10-21.md)记录完整验证结果。状态“已验证可用”指隔离环境对应行为通过测试,外部系统现场核验另列。所有写操作先校验登录、同源、角色、版本及前置条件;失败保留输入,结果不明查询实际状态,不自动重复写入或发信。所有查询支持重新进入刷新;无真实取消能力的动作不提供取消。 操作归属:业务设置维护规则/字段映射;订单通知管理维护运行任务、通知订单、批次、发送记录和计划/日历/模板/发送设置;系统设置维护服务与账号。导出记录保留只读到达历史和PDF任务,与通知订单互相链接。 +## 本轮新增与统一入口 + +| 操作 | 权限与结果 | 验证 | +|---|---|---| +| 订单中心/邮件批次 | 归属授权、25/50/100、详情/文件、稳定阅读;旧hash兼容 | query/business-records | +| 规则迁移、修订采用/忽略 | 管理员、当前版本/幂等/依据;冻结与unknown不改 | global-core/migrations | +| 账号停用/降权/交接/撤销登录 | 管理员;最后管理员保护,交接暂停连接、旧登录与租约清理可重试 | account-lifecycle/account-cleanup | +| 旧异常归档与业务核验 | 管理员显式归档手工/孤立历史;实际业务认领/转交/验证/关闭,unknown先核验原批次 | workspace/business-issues | +| 助手会话归档/恢复/延续 | 本人;运行中先停止/等待;释放活跃额度,保留审计 | conversation-lifecycle/assistant-http-ui | +| 容量与PDF历史导出 | 管理员只读;永久保留,安全摘要NDJSON | maintenance/job-retention | +| 备份/验证/新空目录恢复 | 停服命令、DPAPI实际验证、SHA256与路径/链接防护 | backup16项;[指南](backup-restore-guide.md) | +| 旧模板绑定与通用通知 | 旧写410、旧发送器不装配,历史只读 | retired-binding/history-adapter/application | + ## 共用交互 | 编号 / 操作 | 权限、前置条件 | 实际执行及结果位置 | 失败 / 验收 | 状态 |