diff --git a/docs/superpowers/plans/2026-10-19-web-closure.md b/docs/superpowers/plans/2026-10-19-web-closure.md new file mode 100644 index 0000000..e33124e --- /dev/null +++ b/docs/superpowers/plans/2026-10-19-web-closure.md @@ -0,0 +1,54 @@ +# 设置横栏与全站功能闭环实施计划 + +用户于当前会话明确批准并要求实施。基线提交20ea009,工作区为现有codex/modular-refactor隔离工作树。 + +## Global Constraints + +- 以用户完整批准方案为准:六项侧栏;业务设置横栏为分类规则、发送计划、业务日历、邮件模板;系统设置横栏为BPM连接、邮箱管理、存储服务器、助手设置、系统健康、团队账号、操作记录。 +- Excel的15类为唯一分类;同一时段同类一封;通知与更改分离;北京时间和既有周一/工作日规则;不自动追补历史。 +- 标题按订单号分段提取;惠州额外通知待业务确认;BPM节点人工办理。 +- 正式自动发信保持暂停;开发只用隔离BPM/SMTP/临时文件;不接触真实密码、不发送真实邮件、不提交BPM。 +- 保留持久数据和加密身份,旧功能删除指操作入口与调度,不是删除历史记录;旧写入明确410。 +- 文件按模块维护;先失败回归再实现;运行受影响测试、最终全量测试。每个任务提交并给出报告。不派生子代理。 + +### Task 1: 顶部横栏、页面生命周期与全站前端闭环 + +负责web/全部前端及相关前端测试、assets注册;不要修改后端业务模块或application.cjs。取消设置卡片中转;原hash继续有效,设置入口默认第一项;系统新增assistant-settings路由,并从助手主页面迁移接入表单;手机横向滚动、高亮与浏览器历史可用。 + +移除supervisor/connections/notifications可编辑入口,旧hash分别跳转health/health/order-rules。发送计划只维护两时点、周末;模板页只保留模板管理与类别关联,群组名单统一规则。后端模板关联接口由父代理接入:GET /api/mail/templates/categories -> {categories:[{id,name}],bindings:[{categoryId,templateId,version}]},POST同路径{categoryId,templateId,version}(管理员,templateId为空则解除)。模板类别显示来源已有映射,不自动猜测。旧通知历史稍后由records页面只读入口呈现。 + +创建独立页面生命周期/操作模块,统一dirty保护、页面离开dispose、保存中防重复、提交反馈、错误保留输入、旧响应抑制。导航离开有未保存配置时提供保存并继续/放弃/留在;密码和账号创建仅放弃/留在。支持浏览器前后退、页面刷新beforeunload;敏感表单不持久化草稿。不要用自动等待确认阻塞用户。提供共享接口供页面注册脏状态和保存回调;整合各表单(规则内部tab也适用)、按钮和取消。HTTP写入超时显示结果待核实并查询状态,不自动重试。保留已有真实取消机制。 + +订单执行扩展API由Task2提供:GET /api/order-execution -> {tasks,capabilities,fields}; POST /api/order-execution/scan {connectionId,idempotencyKey}; POST /api/order-execution/tasks/:id/retry {version,idempotencyKey,note}; POST /api/order-rules/batches/:id/resend {version,idempotencyKey,note}; GET /api/order-rules/fields -> {samples,adapters}; POST /api/order-rules/adapters {sampleId,processName,processVersion,fields,version?}。字段目录通过真实采集样本的路径/标签列表下拉绑定,不能任意输入标记已核验。相关UI按契约实现,错误/阻塞清楚。管理员设置才可写,操作员仅授权扫描与已有受控动作。 + +覆盖角色、横栏/旧地址、dirty三选项、重复提交、快速切换、失败输入保留、390px、助手设置迁移。新增前端专项回归,调整被菜单变更影响的测试。报告须说明实测与待父代理集成项,不能伪造完成功能。 + +### Task 2: 订单协调、字段目录、任务持久化和人工补发 + +负责src/modules/order-rules及tests/order-rules,另建src/modules/order-execution(不改application/dashboard/frontend/BPM/storage/mail/workspace文件,列出所需接线)。复用既有RuleStore加密records及dispatcher,新增持久任务、真实样本/字段适配、版本/幂等与重试/补发。对外契约与Task1一致。 + +协调模块接受{store,workspace,provider,archive,mail,dashboard,clock,settings,calendar}。provider接口:scan(connection,principal)->rows,capture(connection,principal,row)->{sample,snapshot};rows为{source:'todo',taskId,instanceId,revision,processName,nodeName,receivedAt,serialNum,title,detailUrl?,processVersion?}。sample保持既有匹配格式;snapshot为{html,styles,images,sourceUrl,fields:[{path,label,value}],processVersion}。archive接口archive({order,rule,snapshot,taskId})->{archivedAt,files:[{name,path,sha256,size,kind:'pdf'|'notice'}]},由父代理实现。归档证据必须由实际归档模块产生,不接受HTTP客户端的路径或sha断言。 + +任务状态与规则订单状态一致并持久进度;启动恢复中断任务,按稳定事件身份去重,重试只从明确失败步骤继续;归档成功后避免重复导出。对未知版本/字段缺失/冲突保存受阻原因。字段适配绑定必须来自捕获样本实际字段,固定流程版本,保留证据;保留静态两项适配兼容,所有15类可通过已捕获样本配置,无需硬编码15个未知表单。实际能力来自provider/archive探测,不准单纯注入true绕过运行条件。 + +发布规则继续要求真实样本;匹配/发布使用动态适配注册表;邮箱模板关联由父代理接线,dispatcher可通过可选templateResolver(categoryId)取冻结正文模板(无映射继续规则正文),收件人与附件依规则,任何模板To/Cc不改变规则收件人。坚持全类别完整冻结,某类受阻则该类不漏单发送。 + +dispatcher新增人工resend(batchId,input,actor):仅管理员、版本与幂等校验、至少5字依据;明确failed可操作,unknown必须先核验;复制原冻结内容/订单关联为新尝试,关联原批次,原收件人/正文/附件不被新配置篡改;允许原窗口过期但禁止自动追补,成功不能再发。重启sending变unknown。现有错误resolve/retry流程必须真正可继续,不得解锁后无可达执行。 + +异常通过workspace现有接口/新的可选callback关联同一任务去重,负责人连接owner,否则未分配;重试成功记录待核验/解决过程不擅自伪造人工核验。 + +用真实本地SMTP/文件临时目录和provider夹具测完整识别-归档-冻结-发送;覆盖15类、时间、幂等、重启、部分拒收、结果不明核验和人工补发。报告接线步骤与所有测试。 + +### Task 3: 实际BPM与归档提供器、旧功能退役和模板关联 + +父代理负责:基于已保存BPM会话、已确认只读请求与真实可见DOM构建todo/capture provider;不猜测生产端点,不因inform代替todo。允许采集经门户返回的详情URL,限公司域名/测试loopback白名单,阻断审批/提交副作用。采集实际xdatabind字段与表单版本、静态快照;不执行任意网页操作。 + +归档提供器按已配置服务器匹配规则UNC目录,实际生成PDF/通知文档,校验文件摘要并返回证据;专用业务命名订单号+选择日期+流水号,不改变扩展既有四字段命名契约。复用SMB有界worker、安全路径及不覆盖写入。archive仅在任务执行时运行,不能把UI参数当证据。 + +application接线provider/协调器/dispatcher生命周期与shutdown drain;scanner/协调器共用认证互斥。旧notifications不再start,GET保留旧历史,POST410;supervisor POST410,旧settings.groups写入410并保留旧数据读取。mail新增分类模板关联API与持久绑定,版本冲突、已生效模板/存在类别约束,不猜旧群组映射。 + +建立docs/web-action-inventory.md逐项列出所有页面动作与测试/结果;最终文档更新设计要求与HANDOFF,修复旧宣传、通知模式和默认时点硬编码。正式状态备份后部署,默认paused不变,双端口和实际页面验证。 + +### Task 4: 全站复核、全量验收与正式更新 + +逐项核对用户批准方案与操作清单;未完成项不能写已验证。独立审查修复重要问题,覆盖保存、导航、权限、会话、外部动作幂等、任务恢复、发送unknown与副作用边界。全量npm test,相关JS语法和diff检查;本地SMTP真实收信、隔离可读PDF/归档证据,桌面及390px截图。备份真实状态且保持密码/业务配置,正式发信暂停;服务重启后登录、设置横栏、健康检查和数据指纹验收。提交本地,不推送或合并。