feat(records): add source history and Tabler record ledgers
This commit is contained in:
1 parent
1421edd6d4
commit
20bb68615f
27 files changed
+291
-91
No files matched your search
@@ -1,5 +1,11 @@
|
||||
# 开发交接(2026-10-20)
|
||||
|
||||
## 本轮订单与导出记录台账
|
||||
|
||||
用户选择A台账方案,确认删除连接后记录自动进入历史归档、默认聚焦订单相关流程。已实现统一Tabler分段导航(`#records`/`#records-pdf`)、分页台账、来源与日期筛选、详情侧栏和窄屏布局。Workspace删除事务保留安全来源档案;旧孤立来源不猜账号。PDF导出状态、文件可用性和存储归档回执独立,缺失或越界文件不显示下载;不按订单号猜BPM连接归属。
|
||||
|
||||
专项回归50项通过,最终页面回归7项通过,新鲜完整514项中513通过、0失败、1可选ZCode CLI跳过;249个JS/CJS文件语法、6份文档33条本地链接及差异检查通过。本机实例已停服并保护备份,恢复核验随后补记。最终结果和恢复记录见[台账验收](records-ledger-verification-2026-10-20.md),设计与步骤见[已确认设计](superpowers/specs/2026-10-20-records-ledger-design.md)及[实施计划](superpowers/plans/2026-10-20-records-ledger.md)。保持自动通知false、version:1,不发真实邮件、不办理BPM、不操作服务机,保留账号/密钥/原业务数据和当前分支,不推送合并。
|
||||
|
||||
## 本轮BPM系统设置改造
|
||||
|
||||
用户已确认BPM可恢复启停、轻量连接检测和原生被动监听方案,本轮在既有本机测试工作树顺序实施。连接停用改为保留账号/会话的暂停,启用恢复检查;真正删除才清除身份。卡片分别显示登录会话、订单接口与到达监听状态,后台复用近期成功业务请求,明确区分认证过期、权限不足和网络失败。
|
||||
|
||||
@@ -10,6 +10,8 @@
|
||||
|
||||
业务横栏:分类通知规则、字段映射。系统横栏: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)。
|
||||
|
||||
表单离开保护提供保存并继续/放弃/留下;密码、新建账号等敏感或不可自动提交表单只允许放弃或留下。刷新受浏览器原生 beforeunload 保护,不可能自定义其三个按钮。提交禁重、错误保留输入;持久保存与刷新失败分别提示;旧页/旧登录响应不得覆盖当前页面。
|
||||
|
||||
## 唯一业务分类与窗口
|
||||
|
||||
@@ -0,0 +1,28 @@
|
||||
# 订单与导出记录台账验收
|
||||
|
||||
日期:2026-10-20(北京时间)。基线`1421edd`;指定工作树`C:/Users/ABS/.codex/worktrees/modular-refactor/Order Notification Automation`,分支`codex/modular-refactor`。用户选择[设计A](superpowers/specs/2026-10-20-records-ledger-design.md),并确认删除连接转历史、默认订单相关。只更新本机测试实例,自动发信保持暂停,不发真实邮件、不办理BPM、不操作服务机、不推送合并。
|
||||
|
||||
## 实际行为
|
||||
|
||||
- `#records`/`#records-pdf`共用Tabler分段导航,可刷新、前后退及直达;查询输入不触发业务表单的未保存保护。
|
||||
- 到达台账默认现有来源、订单相关、全部类型。订单相关精确取分类目录与已配置规则,包含暂停规则;其他流程保留在全部流程筛选。每页25条,长标题截断,完整标题、来源及观察时间在详情。
|
||||
- 删除连接时,同一Workspace事务保留安全来源档案;停用仍在现有来源。新到达保存首次来源快照,重扫保留。旧孤立记录仍可查,未记录的账号/删除时间不推断。归档列表不提供同步动作。
|
||||
- 到达时间、首次采集、最近观察各自显示;累计记录不冒充当前待办。旧日期分组API保持兼容,新ledger模式提供明确的分页和范围。
|
||||
- PDF导出完成、本地文件可下载、持久存储归档分别显示。缺失/越界/不是PDF的文件不能下载;归档结果按任务查询完整回执,不用最近100条窗口猜测。没有可靠BPM来源关联的导出任务保持独立。
|
||||
- 后台状态刷新保留筛选输入与页码;PDF加载迟到不能吞掉用户搜索。详情使用Tabler Offcanvas,离页清理;窄屏保留详情操作,辅助字段合并到主信息或详情。
|
||||
|
||||
## 证据
|
||||
|
||||
- 修改前观察失败:台账查询缺失、归档来源丢失、PDF缺失仍可下载,以及旧页面没有统一导航和详情。
|
||||
- 后端、HTTP、存储和导航专项50项通过;日志`output-records-focused-final.log`。额外慢响应回归先失败后通过,确认加载过程中输入的搜索仍会发送;日志`output-records-race-red.log`/`output-records-race-green.log`。
|
||||
- 真实本地SQLite验证跨重启归档、停用不归档、旧来源、首次身份快照、精确业务筛选及日期/分页。真实临时文件验证PDF下载边界,真实持久回执验证超过100条历史仍可查询。
|
||||
- 最终真实浏览器回归7项通过,覆盖统一导航、详情、后台新记录、搜索、原权限、历史范围、扫描服务失败时PDF入口、直接刷新PDF页、关闭详情后跳页及390px布局;661px到达表格检查详情按钮位于视口内。隔离样例用于视觉复查,发现并修正窄屏操作列被挤出视口;最终业务页面截图随本机恢复补记。
|
||||
- `npm ci`成功,锁定依赖未变。最终249个JS/CJS文件语法检查通过,`git diff --check`通过;6份相关文档33条本地链接均存在。
|
||||
- 新鲜完整`npm test`:514项,513通过、0失败、0取消、1项可选ZCode CLI跳过,退出码0,耗时875,750.9513毫秒(约14分36秒);日志`output-records-full-test.log`。完整套件启动后没有修改业务源码。
|
||||
- 本地复核确认:来源档案只保留安全身份字段,真正删除仍清除凭据;历史源ID不会重新挂靠新连接。新旧API并存,来源归档不改变PDF或业务执行状态;实际下载复用文件边界检查,页面查询不读取SMB或发起归档/发送。后台查询与业务保存分离,离页清理详情和定时器。
|
||||
|
||||
## 本机数据与服务
|
||||
|
||||
修改前自动通知`enabled:false`、`version:1`,用户1个、采样31份、字段草稿31份、批次0个。已停止原本机测试实例,完整保护备份在`%LOCALAPPDATA%/OrderNotificationAutomationBackups/records-ledger-20261020-165333`;7257个文件摘要匹配、12份SQLite quick_check通过,未读取或复制account-recovery。证据:`output/records-ledger-backup-verification.json`。
|
||||
|
||||
全量测试通过后恢复原实例,并核对原账号、密钥、规则、采样、草稿、订单、批次、双端口和暂停状态。Workspace新增来源档案表为预期迁移,不删除到达记录、不搬动PDF、不更改既有业务设置。
|
||||
@@ -0,0 +1,39 @@
|
||||
# 订单与导出记录台账 Implementation Plan
|
||||
|
||||
> **For agentic workers:** 使用 executing-plans 在当前会话顺序实施,不自动分派子代理。用户已选择A并确认归档与默认业务范围,不重复请求批准。
|
||||
|
||||
**Goal:** 交付可追溯历史来源、清楚文件状态的Tabler台账页面。
|
||||
|
||||
**Architecture:** Workspace在删除事务中保留安全来源档案;到达查询模块将档案与旧记录结合,在SQLite分页和筛选。PDF记录查询单独核验本地文件与持久回执。两页接入现有路由导航和统一详情侧栏,执行/发送引擎不改。
|
||||
|
||||
**Tech Stack:** 既有Node、SQLite、原生JS、Tabler 1.6.1及Playwright;不增加依赖。
|
||||
|
||||
**Spec:** [已确认设计](../../superpowers/specs/2026-10-20-records-ledger-design.md)。仅指定modular-refactor工作树开发,原共享检出不改。
|
||||
|
||||
## Task 1:历史来源和台账查询
|
||||
|
||||
- [x] 先写并观察失败测试:删除后名称/账号可追溯、停用保留正常范围、旧孤立来源不猜身份、跨重启、精确业务筛选和稳定分页。
|
||||
- [x] Workspace删除事务保留安全来源档案;采集保存首次来源快照。新增records-query,扩展scan-store分页读取,旧日期分组接口兼容。
|
||||
- [x] scan-api装配分类目录与安全来源,新增ledger模式;历史查询不产生远端动作,权限保持。
|
||||
- [x] 运行专项回归并复核删除/在途工作协调。
|
||||
|
||||
## Task 2:PDF可用性和归档回执
|
||||
|
||||
- [x] 先写并观察失败测试:成功任务文件缺失、真实文件可下载、越界/链接拒绝、空记录、分页和真实归档回执。
|
||||
- [x] 独立job-records模块复用受限文件定位,按分页核验本地文件;storage按jobId查询完整持久回执,避免最近100条窗口误判。
|
||||
- [x] dashboard保留原API结构并提供ledger分页;概览下载状态使用同一核验,不更改导出/归档动作。
|
||||
- [x] 运行HTTP、文件与存储专项回归。
|
||||
|
||||
## Task 3:两页Tabler台账
|
||||
|
||||
- [x] 先更新/新增真实浏览器回归,观察缺失统一导航、默认业务筛选、历史范围和详情的失败。
|
||||
- [x] 统一nav-segmented路由,保留#records并新增#records-pdf;流程台账与PDF页面分别管理筛选、分页、加载和错误状态。
|
||||
- [x] 详情侧栏使用Tabler;列表长标题截断,完整内容按需展开;离页销毁定时器/详情,后台刷新不覆盖用户输入或跳回第一页。
|
||||
- [x] 测试权限、空态、后台更新、延迟响应、后退/刷新直达和窄屏。
|
||||
|
||||
## Task 4:验收和本机交付
|
||||
|
||||
- [ ] 同步设计要求、操作清单、HANDOFF及验收记录;本地评审来源追溯、文件边界与页面生命周期。
|
||||
- [ ] npm ci、全量npm test、所有JS/CJS语法、文档链接及git diff --check;提交代码。
|
||||
- [ ] 停服保护备份并恢复原本机服务,核对双端口、原身份/数据、真实页面及自动通知false/version1;不操作服务机、不发真实邮件、不办理BPM。
|
||||
- [ ] 保留分支工作树,提交验收,无推送合并。
|
||||
@@ -0,0 +1,25 @@
|
||||
# 订单与导出记录:台账式设计
|
||||
|
||||
用户已选择A:借鉴[Baserow表格](https://baserow.io/user-docs/guide-to-grid-view),配一行[Windmill运行摘要](https://www.windmill.dev/docs/core_concepts/monitor_past_and_future_runs),导航复用[Tabler分段导航](https://docs.tabler.io/ui/components/segmented-control)。另已确认删除BPM连接后记录自动转历史、默认只看订单相关流程。此确认授权本轮实施及原本机测试服务更新,不另行请求同项批准。
|
||||
|
||||
## 页面
|
||||
|
||||
- 一级入口仍为订单与导出记录;`#records`为流程到达记录,`#records-pdf`为PDF导出记录。共享现有业务设置的Tabler导航,刷新、后退、直达均保持页签。
|
||||
- 到达记录默认现有连接、订单相关、全部到达类型,每页25条,按到达时间倒序。来源范围可选现有连接/历史归档/全部;停用仍属现有连接。类型区分待办到达、待阅到达,累计历史不声称当前待办。
|
||||
- 筛选包含搜索、日期起止、来源、业务范围和到达类型。订单相关严格取分类规则涉及的流程与已有分类目录,包含暂停规则;不按标题猜分类。
|
||||
- 统一表格展示流水号/流程、节点/类型、标题摘要、来源、到达时间与详情入口。长标题截断;详情侧栏展示原完整标题、流程版本、任务身份、首次采集/最近观察、来源及历史原因。只读,不提供BPM办理或自动重试。
|
||||
- 一行摘要展示实际推送连接数、最近同步与现有对账周期;手工同步沿用原权限,历史范围不显示同步动作。扫描设置折叠,不占主要列表。
|
||||
- PDF表格展示订单/通知书编号、项目/型号、导出状态、文件可用性、存储归档结果和时间。成功但文件丢失时保留导出历史并停止显示下载。详情显示实际归档回执;来源无关联就明确未记录,不按订单号猜连接。
|
||||
|
||||
## 数据和接口
|
||||
|
||||
- Workspace SQLite新增已删除连接的安全来源档案,与连接删除处于同一事务,仅保存ID、名称、负责人、账号显示身份及删除时间;不含凭据。删除仍先停用和排空,真正删除继续清除账号/Cookie。
|
||||
- 新采集行保存首次来源快照,重扫不改写首次来源。已删除且无快照的旧记录仍进入历史,显示历史连接短ID和信息缺失,不能从相似名称推断原账号或删除日期。
|
||||
- `GET /api/arrivals?view=ledger`返回分页items、total、page、pageSize和安全来源目录;筛选scope=current|archived|all、business=orders|all、kind=all|todo|inform、q、connectionId、from、to。缺省为current/orders/all,页大小25、上限100;日期按北京时间的到达日,起止均包含。稳定次序为到达时间、来源、任务身份。
|
||||
- 无view参数的原到达接口保持日期分组和待阅默认值,既有扫描、去重和历史数据不重建。
|
||||
- `GET /api/jobs?view=ledger`提供搜索、状态与25条分页,补充实际文件可用状态和本地持久归档回执。原jobs返回结构兼容;下载入口继续验证输出目录边界,页面不读取SMB目录、不产生归档或发信。
|
||||
- 来源归档与PDF存储归档是独立事实;现有PDF导出任务缺少连接关联时不跟随删除动作。未开放重新挂靠、批量删除和批量重试。
|
||||
|
||||
## 验收和交付
|
||||
|
||||
临时SQLite/文件/假BPM验证删除档案跨重启、停用不归档、旧孤立来源、精确业务筛选、分页/日期/权限、文件缺失/目录越界和归档回执。真实浏览器验证导航、详情关闭、筛选保留、空态、后台刷新不覆盖输入及离页迟到响应。npm ci、新鲜全量测试、语法/链接/差异检查完成后提交,备份并恢复原本机实例,核对账号、密钥、31份采样/草稿及发信暂停。不发真实邮件、不办理BPM、不操作服务机、不推送合并。
|
||||
@@ -78,6 +78,8 @@
|
||||
| B03 托管账号、更新/移除、填入、检查保存 | 管理员/负责人;本机或HTTPS | DPAPI加密会话/身份,真实状态 | 不绕验证码,不写回明文;bpm-account-* | 已验证可用 |
|
||||
| B04 连接检查与状态观察 | 管理员/负责人检查,其他角色按原只读范围 | 登录/待办/监听三项;复用业务证据,轻量检查与续登分离 | 403/401/网络分开、检查合并、输入保留;connection-health/bpm-ui | 专项验收 |
|
||||
| B05 原生监听、重连、完整对账、到达类型切换 | 启用连接、日历与原执行门控 | 事件名仅提示变化,待办/待阅分开,失败原子保留 | 真实本地Hub、事件合并、同数量替换、停止清理;signalr-client/arrival-monitor/bpm-scan-http-ui | 专项验收 |
|
||||
| B06 到达台账、历史来源、分页和详情 | 已登录;只读查询 | 默认现有来源/订单流程,删除后保留来源档案,历史可按来源查询;旧孤立来源不猜身份 | 删除/停用/重启、精确流程、日期与分页、只读角色、后台刷新和离页;records-ledger/bpm-scan-http-ui | 本轮验收 |
|
||||
| F04 PDF台账、文件可用性、归档回执 | 已登录;仅允许本地输出目录内PDF下载 | 导出成功不等于文件仍存在;实际文件检查及持久归档回执分别显示,不移动文件 | 文件缺失、越界、格式、旧回执超100条、详情及窄屏;job-records/dashboard-http/bpm-scan-http-ui | 本轮验收 |
|
||||
| M01 添加/编辑邮箱、保留空密码、保存/取消 | 管理员;本机/HTTPS、有效参数 | 加密SMTP/IMAP配置与版本 | 错误保留输入;mail-ui/mail-http | 已验证可用 |
|
||||
| M02 检查邮箱、收取模板、自发测试 | 管理员;已托管非只读邮箱 | 验证状态、收件记录、自身测试记录 | SMTP/IMAP异常明确;未知结果先核验;mail-service | 已验证可用 |
|
||||
| M03 只读邮箱、文件夹、日期/主题查询、正文/返回 | 管理员;IMAP;最多31天 | 只读Sent历史、To/Cc/附件名 | UID变化重查;不标读删移;history-* | 已验证可用 |
|
||||
|
||||
Reference in new issue
Block a user