# 2026-10-12 v0.5：业务闭环架构开发与验证

本轮按用户授权落实生产架构阶段 A：模块化单体、完整链历史、已确认事件索引、跨系统只读对账与基础告警。模拟 v0.3 的注册/登录/管理员和资产逻辑保留，链模式不共享赠币。设计见 [v0.5](../07-history/v0.5-design.md)，部署见 [链部署](../05-deployment/web3-deployment.md)。

## 实际改动

- history.go / Web3History.tsx：订单、最终成交、任务、事件 keyset 分页，钱包筛选，公开详情；原 state 最近100项与原 tasks 数组兼容保留。OpenAPI升级0.5.0并生成TS，游标绑定数据集、筛选与插入上界，各页状态可更新。
- tasks.go：旧任务表事务升级 schema 2、version CAS、不可回退终态、已签raw/hash/nonce保护、创建/更新时间和原因。旧时间为0，不捏造历史；日志 schema 1及Domain编码不变。
- index.go：固定blockHash读取确认块日志，父块连续性、事件唯一键、事件/游标同事务，从创世补拉且每轮64块，重启不丢/不重复；深重组停止，不自动回滚filled。
- reconcile.go：固定完整投影水位后独立重放日志，检查全部订单/意图/守恒/outbox/任务/索引事件，核对SQL状态与payload；PG只读快照为REPEATABLE READ。差异与异步lag分开，无自动修钱或补发。
- observability.go / main：结算、索引、采样独立调度；30秒观测、请求耗时histogram、索引落后、最老任务/outbox、对账差异/lag、采样失败与worker错误。只在回环开放/check与metrics；8条Prometheus规则，未配置消息通知。
- 全部当前文档/目标同步，历史设计注明适用版本，历史 reports/evidence不改写。新增源码、测试、前端、脚本与部署配置均有中文注释。

## 实际执行证据

| 验证 | 证据与结果 |
| --- | --- |
| 常规全套 | [verify](evidence-v0.5/verify.txt)、[最终verify](evidence-v0.5/verify-complete-final.txt)：格式、mod verify、vet、Go、race、前端44单元、契约生成、构建与SIGKILL恢复 |
| 新模块单元 | [首轮完整链包](evidence-v0.5/chain-unit.txt)、[最终race](evidence-v0.5/chain-final-race.txt)：分页、迁移/CAS、事务失败、重启/重组、损坏/终态对账、公开契约与诊断 |
| 真实EVM合约 | [contracts](evidence-v0.5/contracts.txt)：真实Anvil原子交换、maker价、部分成交、重复/签名/cancel/授权撤回回滚 |
| 本地链＋浏览器 | [JSON](evidence-v0.5/simulation-local-complete.json)、[日志](evidence-v0.5/complete-local/simulation-local-log.txt)、[截图](evidence-v0.5/complete-local/wallet-page.png)：12组检查，包括完整历史、详情与原签单刷新恢复 |
| Redis/PG/Kafka | [race组件](evidence-v0.5/middleware-unit.txt)、[完整链](evidence-v0.5/simulation-middleware.json)、[最终完整链](evidence-v0.5/simulation-middleware-complete.json)：去重、缓存水位、限流、owner、历史/索引/对账和故障恢复 |
| 当前只读容器 | [构建](evidence-v0.5/container-build-metrics-final.txt)、[闭环](evidence-v0.5/simulation-container-complete.json)：scratch UID10001、命名卷、host网络、原交易恢复及索引/对账 |
| 原模拟浏览器 | [8场景](evidence-v0.5/simulation-browser.txt)：注册/双账户交易/管理员/分页/待确认恢复全部通过 |
| 覆盖率 | [语句汇总](evidence-v0.5/final-coverage/coverage.txt)、[HTML](evidence-v0.5/final-coverage/coverage.html)、[逐项JSON](evidence-v0.5/final-coverage/go-tests.jsonl)：全仓库语句64.1%，backend82.6%，chaintrade见下方统计；链E2E进程不计Go语句覆盖 |
| 告警规则 | [Prometheus配置](evidence-v0.5/prometheus-config-check.txt)、[promtool用例](evidence-v0.5/prometheus-rule-tests.txt)：8条规则语法，差异/停滞触发与健康不误报，另有[指标格式](evidence-v0.5/prometheus-metrics-check-final.txt)校验；未运行Alertmanager通知 |
| 依赖审计 | [Go](evidence-v0.5/govulncheck.txt)、[frontend](evidence-v0.5/frontend-audit.json)、[contracts](evidence-v0.5/contracts-audit.json)：Go可达0，另2导入包/1模块未调用漏洞；npm各0。仅代表本次扫描 |

## 保留的失败与修正

[首次取消索引等待失败](evidence-v0.5/initial-event-wait-failure.txt)断言最新事件应为CANCELLED，但索引还停在MATCHED。receipt、取消扫描、完整索引各有独立调度；成交对账追平不意味着取消索引已到链头。修正测试为明确等待取消事件可查询，未改资产数据、未跳过事件。后续本地/中间件/容器通过。

前端新历史状态提示使用独立 aria-live，保留原交易页唯一status语义，避免旧浏览器用例选中两个status。新读取在切换类型/钱包后中断旧请求，游标重置，后台业务不受中断影响。

## 环境、清理与边界

WSL/Linux、Go1.26.9、Node22.22.3、npm12.0.2；真实Anvil、Redis7.4.2、Postgres17.4、Kafka3.9.0。测试使用随机端口、临时目录和新增PG数据库，不覆盖旧dataset；中间件停止但保留卷，链容器命名卷也保留。源码无Git仓库，不编造commit或远程CI成绩。

没有重新给出容量数字：Apply、FULL受理、HTTP与链最终成交不同；30秒全量对账、每轮64块、单sender和每单一个pending有资源边界。公共链/云/原生Windows/真实钱包扩展兼容性、长时链拥塞、硬件断电、安全审计、交易替换/nonce窗口/DLQ、HA/fencing/复制/分区未完成。Prometheus规则验证不等于生产告警送达，钱包交易对账不等于储备证明。

独立读池：日志/投影的 WAL 读取与唯一写连接分开，每读池1连接；SQLite读池query_only，PG任务Reader独立1连接，owner与任务写池仍分别占用专用/业务连接。TestReadSnapshotDoesNotBlockWriter 保持旧水位快照时仍能完成新命令，避免对账占住唯一写池。查询仍有CPU/磁盘与WAL保留成本，需要超时和后续增量策略。

对账还离线验签任务原交易：raw编码、sender、chain/to/value、hash/nonce与calldata都按当前域核对；不需relayer私钥、不调用发送RPC。终态对账测试额外损坏raw，必须报TASK_RAW_INVALID，检查不会尝试修复或广播。

最后指标 lint 提示缺少 HELP 说明，保留 [初始结果](evidence-v0.5/prometheus-metrics-missing-help.txt)，已补每个 counter/gauge/histogram 的 HELP/TYPE 并通过 promtool。Docker Hub镜像代理DNS失败后改用固定 quay.io Prometheus 镜像，未修改宿主daemon配置。只做规则/指标校验，没有宣称实际通知送达。

最终注释/文档核对见 [函数注释](evidence-v0.5/comments-check-final.txt)、[文档链接及围栏](evidence-v0.5/document-check.json)、[环境](evidence-v0.5/environment.json)、[源码摘要](evidence-v0.5/source-sha256.txt)。摘要基于当前源码文件，不包含依赖/生成构建产物，不编造commit。

最终链包 Go 语句覆盖率为 55.6%，模块汇总见 [coverage-summary](evidence-v0.5/coverage-summary.json)。覆盖率不是分支覆盖或正确率；web3server 入口仍为0，真实链/E2E在独立进程验证。
