当前基线:模拟 v0.3 保留,独立链模式升级为 v0.5。新增完整历史查询、任务版本保护、已确认事件索引、只读对账和基础告警,见 设计、执行报告。历史报告与证据保留原版本。
v0.4新增独立链测试:完整链测试设计与用例映射,真实执行报告。本页原用例继续验证模拟模式;新增真实EVM/三中间件/钱包adapter/硬杀/重组/容器,不把旧测试数或性能继承为链成绩。
更新:2026-10-11。此目录描述当前已实现能力的输入与预期,执行命令见测试手册,实际 pass/fail/skip 以本轮报告及 JSON 原始证据为准。下表是场景组,不用表格行数充当自动化测试数量。
1. 金额、核心与不变量#
| ID / 优先级 | 输入/动作 | 预期与证明点 | 自动化入口 |
|---|---|---|---|
| U01 / P0 | 零/负数、指数、前导零、空白、NaN、32/33 字节、小数边界、上限 | 只接受规定普通十进制;金额精确,不静默舍入 | unit_test.go ↗ TestParseAmountBoundaries |
| U02 / P0 | 相同业务内容改 seq/time/schema/hash;另改金额 | 外围字段不改变摘要,金额改变摘要 | TestPayloadHashIgnoresTransportFields |
| U03 / P0 | 改 side/type/TIF、MARKET GTC、价格/数量精度、买卖余额不足 | 确定 Code;无订单、成交、分录,既有资金不变 | engine_boundary_test.go ↗ TestOrderValidationHasNoFinancialSideEffects |
| U04 / P0 | maker 乱序价格且时间相同;BUY/SELL 各吃 4 个 maker | BUY 升价、SELL 降价,同价 FIFO,按 maker 价格结算 | TestPricePriorityBothDirections |
| U05 / P0 | 同价 A/B/C,撤 B,买 3 @105 | 只成交 A/C;买余量 1 冻结 105,价差准确退回 | engine_test.go ↗ TestMatchingFIFOAndSettlement |
| U06 / P0 | 对手有其他账户,后遇自己 maker | 先成交其他账户;保留自身 maker,取消 taker 余量,不跳队列 | TestIOCAndSelfTrade |
| U07 / P0 | BUY/SELL MARKET IOC、空盘/价格保护之外 | 零成交 CANCELED,原因明确,冻结归零,资产不变 | TestIOCProtectionAndEmptyBook |
| U08 / P0 | 卖 1,成交 0.4,再撤 | filled=0.4、canceled=0.6、remaining=0;只退 0.6 ETH | TestPartialMakerCancellation |
| U09 / P0 | 重复键、冲突内容、他人撤单、拒绝后注资/再确认 | 首次结果稳定,冲突无效果;新键可接受,键按账户隔离 | TestIdempotencyAndRejections / TestRejectedFirstResultAndAccountIsolation |
| U10 / P0 | 终态撤单、未知订单撤单 | ORDER_TERMINAL/ORDER_NOT_FOUND,无重复资金释放 | TestRejectedFirstResultAndAccountIsolation |
| U11 / P0 | 篡改返回 Order/Orders/Balances 后原键重试 | 核心状态和首次幂等记忆不变;重试无新分录/成交 | TestCoreResultOwnership |
| U12 / P0 | 无效 CREDIT 资产/精度/零额、未知 Kind | INVALID_AMOUNT/INVALID_COMMAND,供给与余额不变 | TestCreditAndUnknownCommandRejections |
| U13 / P0 | 10 个小额 maker、decimal 0.1+0.2 | 总资产精确守恒、无 dust,数量恒等式每步成立 | TestDecimalAndAssetConservation |
| U14 / P0 | 相同序列重放于两空核心 | 订单/资金一致,不依赖时钟/随机 | TestDeterministicReplay |
| U15 / P0 | 1025 个可成交 maker | 撮合预算提前拒绝,无部分成交/冻结,maker 全保留 | TestMatchBudgetRejectsBeforeMutation |
| U16 / P0 | seq 在 2^53 后 | ID/result/progress 在 JSON 中为精确字符串 | TestIDsBeyondJSSafeInteger |
| U17 / P0 | 固定 3 seed,各 500 步限价/IOC/撤单/重试 | 每步数量/冻结/供给、极值、价树/FIFO/索引一致 | property_test.go ↗ TestRandomizedCoreProperties |
| U18 / P0 | 静态解析核心 import/调用 | 核心无 SQL/HTTP/文件/锁/时钟/随机依赖与 float 金额构造 | TestCoreArchitectureBoundary |
不变量 helper 逐档枚举红黑树及 FIFO,核对节点/反向索引/订单指针一一对应、同价 seq 递增、余量为正、无空价档、买卖方向正确、最优价缓存和树极值相同。冻结从活动订单重新计算,不沿用生产累计量作为答案。
2. 外围校验、认证与 HTTP#
| ID / 优先级 | 输入/动作 | 预期 | 自动化入口 |
|---|---|---|---|
| A01 / P0 | 邮箱大小写/空格/展示名称/非法地址;密码 11/12/72/73 字节 | 规范邮箱与边界准确;bcrypt 上限按字节 | auth_unit_test.go ↗ TestAuthValidationRules |
| A02 / P0 | 独立高熵 token;数据库会话存储 | 原 token 只用于 Cookie,存 tokenHash,CSRF 独立 | TestTokenHashAndRandomToken / TestSessionExpiryAndReenableDoesNotReviveTokens |
| A03 / P0 | 会话过期、停用再启用、错密码/不存在邮箱/重复规范邮箱 | 过期/撤销凭证不复活,登录拒绝合并;重复邮箱冲突 | security_boundary_test.go ↗ TestSessionExpiryAndReenableDoesNotReviveTokens |
| A04 / P0 | auth_audit 最后一步 trigger 失败 | 停用/删会话全部回滚,原会话仍有效 | TestDisableAuditFailureRollsBack |
| A05 / P0 | 未登录/USER 访问所有管理路由 | 401/403,不能依靠隐藏按钮提权 | http_boundary_test.go ↗ TestEveryAdminRouteEnforcesRBAC |
| A06 / P0 | 伪造注册 role/下单 account_id、CSRF 缺失、撤他人订单 | 接入拒绝,身份来自真实会话 | integration_test.go ↗ TestAuthAndRBAC |
| A07 / P0 | Origin 同 Host、跨站、路径/查询/userinfo、显式代理 Origin | 合法同源/配置 Origin 接受,非法来源拒绝 | TestOriginValidationMatrix / TestOriginAndPasswordStorage |
| A08 / P0 | 幂等键短/长/空格/system.;未知 JSON 字段、多值、类型错、>16KiB | 400,坏输入不进入日志 | TestStrictRequestHelpers / TestDecodeLimitsAndUnknownFields |
| A09 / P1 | 同 IP 10 次后换端口/XFF;过期记录;bcrypt/WS 额度满 | 限流不被头/端口绕过,过期恢复;满额在昂贵工作前拒绝 | TestAuthRateLimitAndRecovery / TestAuthAndWSAdmissionBudgets |
| A10 / P0 | CookieSecure=true 注册/注销、API 响应 | HttpOnly/Secure/Strict、禁缓存、安全头、数据集头;JSON 不泄露 Cookie token | TestCookiePolicyAndSecurityHeaders |
| A11 / P0 | auth.db 关闭后使用原凭证 | 503 AUTH_UNAVAILABLE,不能伪报 401 | TestAuthStoreFailureIsNotUnauthenticated |
| A12 / P1 | JS 文件、SPA 路由、HEAD、缺失资源、越根路径、POST | 正常文件/回退,HEAD 无 body,缺 JS 为 404,无越根泄露 | TestStaticFilesAndSPAFallback |
| A13 / P0 | 管理员注资同键重试、注销、USER bootstrap、停用 ADMIN | 只发钱一次,旧会话失效,不提权/不停用 ADMIN | TestAdminCreditsAndLogout |
3. 游标、契约、运行时与存储#
| ID / 优先级 | 输入/动作 | 预期 | 自动化入口 |
|---|---|---|---|
| Q01 / P0 | 订单游标跨账户/数据集/all,上下界、非法 base64/未知字段/尾随 JSON | ErrCursor;游标不是授权凭证 | TestCursorDecodingRejectsCrossScopeInput / cursor_unit_test.go ↗ TestAdminCursorValidationMatrix |
| Q02 / P0 | AUTH/CREDIT 游标相位、管理员、种类、两个上界 | 绑定身份/数据集/来源;users 不接受 credit 相位 | TestAdminCursorValidationMatrix |
| Q03 / P0 | 订单首屏后新增,继续翻页;他人单查询 | 首屏集合固定,无重复遗漏/新单混入,归属隔离 | query_test.go ↗ TestOrderPaginationBoundaryAndOwnership |
| Q04 / P0 | 同秒 23 用户、AUTH/CREDIT 跨来源、同 seq 多笔成交 | rowid seek 不漏;审计区分成功/拒绝/重试,不能假装全局时间快照 | admin_query_test.go ↗ TestAdminPaginationAndCreditResults / TestPublicTradesPagination |
| Q05 / P0 | 当下订单与首次按键结果、投影 lag、数据集升级/切换 | 首次结果稳定,未找到不等于未受理,旧数据集请求被挡 | TestCommandLookupFirstResultAndLag / TestDatasetIdentityUpgradeAndWriteFence |
| Q06 / P1 | limit/depth 越界、非法 min_seq、游标、未知市场;合法金额 1.00/1 原键确认 | 400/404,而非空成功页;不同合法金额文本规范化到同一订单,冻结只一次 | TestQueryInputErrorMatrix |
| Q07 / P0 | 公共/认证/管理真实响应与契约;TS 重新生成 | 金额/ID/枚举/页对象匹配,同源契约无差异 | contract_test.go ↗ TestOpenAPIContractAndRealResponses + api:check |
| T01 / P0 | 20 并发同键、重启与删除可派生 views | 一次业务、同资金与首次结果,auth/journal 保留 | TestRuntimeConcurrentIdempotencyAndRestart |
| T02 / P0 | 暂停投影,额度 1 时第二请求;第一请求取消等待 | 第二请求拒绝且不入日志,第一仍执行,提交投影后释放额度 | runtime_test.go ↗ TestBackpressureAndCanceledWait |
| T03 / P0 | 投影末端/批内第二条 SQL 错误 | 第一条与水位也回滚,停机后重放补齐 | TestProjectionRollbackAndRecovery / TestProjectionBatchIsAtomic |
| T04 / P0 | 占用唯一 Views 连接,响应后篡改所有返回对象 | 投影和首次结果保持真实内容,与调用者独立 | runtime_boundary_test.go ↗ TestRuntimeResponseCannotMutateProjection / TestCopyResultIncludesEveryMutableField |
| T05 / P0 | 队列/inflight/batch/wait 非法预算;启动环境非法 | 受控拒绝,启动失败释放 Store 锁 | TestRuntimeConfigBoundaries / server main_test.go ↗ TestInvalidStartupConfigReleasesStore |
| T06 / P1 | 诊断 lag 瞬间为负、Views 不可用,业务端访问诊断 | lag=0,指标无需 SQL/无敏感标签,业务诊断 404,独立 pprof 可用 | TestDiagnosticsIsolationAndLagClamp |
| T07 / P0 | WS 正常关闭、seq int64 耗尽、第二实例、journal 错误 | 连接/额度回收,拒绝不越过持久化屏障,受控失败 | TestShutdownClosesWebSockets / TestSequenceExhaustionIsControlled / TestDataDirectoryLockAndJournalBarrier |
4. 故障恢复与离线工具#
| ID / 优先级 | 前置/故障 | 重启后预期 | 自动化入口 |
|---|---|---|---|
| R01 / P0 | CREDIT 7,日志提交前暂停并 Kill | journal 0 条,账户无余额 | crash_recovery_test.go ↗ TestCrashRecoveryWindows/before-commit |
| R02 / P0 | 提交后、尚未送核心暂停并 Kill | journal 已提交,恢复资金为 7 | after-commit |
| R03 / P0 | Apply 后暂停并 Kill | 恢复资金为 7,原键确认只取首次结果 | after-apply |
| R04 / P0 | 投影前暂停并 Kill | 日志补齐投影、水位和余额,不重复注资 | before-project |
| R05 / P0 | 投影事务内提交前暂停并 Kill | 未提交投影回滚,再重放为完整结果 | inside-project |
| R06 / P0 | 预置已提交未投影日志,恢复事务中再次 Kill | 后续两次重放/原键确认保持 7 | during-recovery |
| R07 / P0 | journal schema/hash/seq 错、未知 engine、损坏权威 DB、超前投影 | 明确拒绝,不跳记录/删权威,启动失败释放锁 | maintenance_test.go ↗ TestReplayRejectsCorruptCommands / TestAuthorityCorruptionRejectsStartup / TestProjectionAheadRejectsStartup / TestUnsupportedVersionReleasesStore |
| R08 / P0 | 旧 schema=0 数据重试 | 与 schema=1 相同业务摘要,旧首次结果保持 | TestOldSchemaIdempotencyCompatibility |
| R09 / P0 | 坏 views、同水位余额篡改 | 检测损坏;重建只替换可派生投影,保留坏文件 | TestRebuildCorruptViews / TestOfflineCheckDetectsProjectionTampering |
| R10 / P0 | 离线 backup/restore,同卷会话/订单/资金/原键 | manifest/字节/逐表结果匹配,不覆盖已有目标 | TestOfflineBackupRestore |
| R11 / P0 | manifest 语法/尾随/未知字段/版本/报告不符、DB 为 symlink | 拒绝;预检不建目标,复制后失败清理新目标 | backup_boundary_test.go ↗ TestRestoreRejectsMalformedManifestAndCleansDestination |
| R12 / P0 | CLI 非法参数/错误目录;init/check/backup/restore/rebuild 全链 | 不误建空库;初始资金只一次、原密码保留、锁释放 | exchangectl main_test.go ↗ 两个测试 |
| R13 / P0 | 真实已构建服务下单后 SIGKILL,再启动 | 身份/会话/订单/余额/原键一致 | crash_check.py ↗ |
| R14 / P1 | 容器只读/非 root,同卷 restart,停机备份恢复新目录 | 静态页/契约/健康与持久性一致 | container_check.py ↗,执行记录与源码版本需对应 |
六个精确窗口用父进程等待标记确认位置后 Kill/Wait;未到达是失败,不是“可能覆盖”。命令已提交但没回包可以恢复存在,未提交不能产生资金。它们不等同于真实断电。文件名修复前 Linux 未收集这组;本轮证据及历史报告校正在执行报告中明确说明。
5. 前端单元与浏览器#
| ID / 优先级 | 场景 | 预期 | 自动化入口 |
|---|---|---|---|
| W01 / P0 | HTTP 写请求、ID 超 2^53、网络失败/坏 JSON/超时 | 原键/原内容与 CSRF/dataset 保留,金额/ID 文本,未知执行不自动重试 | api.test.mjs ↗ |
| W02 / P0 | 401/429/5xx/CSRF/Origin/数据集拒绝 vs 确定业务拒绝 | 不能因确认失败删除先前未知请求;业务码/状态准确 | api.test.mjs 未知执行分类用例 |
| W03 / P0 | 恢复格式、账户/数据集、路径、请求体、键、存储错误 | 只恢复当前原请求,损坏记录阻止新写;撤单 ID 仍为字符串 | pending.test.mjs ↗ |
| E01 / P0 | 注册两账户,卖 1/买 0.4、撤余量、管理员注资停用 | 双方余额/订单真实一致,停用旧会话失效,375px 可展示 | exchange.spec.ts ↗ |
| E02 / P0 | 用户/审计各自翻页、注资拒绝/重复确认 | UI 与真实 API 页对象/资金结果一致 | admin.spec.ts ↗ 第一个场景 |
| E03 / P1 | 捕获并关闭真实 WS,等待新连接 | 自动重连,连接状态与行情恢复 | admin.spec.ts 第二个场景 |
| E04 / P0 | 服务端成功后丢下单/撤单响应,刷新确认 | 保存原键/原内容,无重复订单/冻结/成交 | recovery.spec.ts ↗ 下单/撤单场景 |
| E05 / P0 | 注资成功后丢响应,刷新管理员页确认 | 只增一次,原目标/金额/原因保持 | recovery.spec.ts 注资场景 |
| E06 / P0 | 历史前后页、存储禁用 | 金额字符串,翻页正确;无法保存时没有写请求 | recovery.spec.ts 两个场景 |
| E07 / P0 | 同数据集旧行情、另一数据集低序号 | 同数据集不倒退,新数据集可接受低序号 | recovery.spec.ts 行情场景 |
当前前端单元 34 个 Node 用例,真实浏览器 8 个 Playwright 场景;E04 一个场景包含两类写操作。测试数量不等于业务输入组合穷尽。
6. 关键场景的可计算步骤#
C1:价格时间优先和卖方部分撤单#
两个账户分别通过 CREDIT 获得 10 ETH/100000 USDT。卖方挂 1 ETH @100,买方买 0.4 ETH @105。成交价格必须为 100,买方实际花 40 USDT,不能扣 42;买方余额 ETH=10.4、USDT=99960、冻结=0。卖方剩余挂单 ETH 冻结=0.6。撤销后卖方 ETH 可用=9.6、冻结=0,USDT=100040,订单 1=0.4+0+0.6。两方 ETH 总数=20,USDT=200000。
C2:首次结果/调用者/投影所有权#
核心测试下 1 ETH 买单 @100,保存真实返回副本,然后改返回 Order.status、Orders[0].remaining、Balances[0].frozen。核心原订单仍 OPEN、冻结100;原键确认仍返回首次 OPEN,重复分录为空。运行时测试先等待资金投影,占用唯一 Views 连接,Submit 回包后改结果,再释放连接。排空后 SQL 订单 OPEN、available=900、frozen=100、按键首次结果 OPEN。该窗口由连接所有权确定,不用睡眠猜测投影是否已开始。
C3:认证事务回滚#
真实注册 USER 与会话,创建只在临时 auth.db 中存在的 BEFORE INSERT auth_audit 失败 trigger。调用 SetDisabled(true) 应报错,随后原会话仍可查询到 disabled=false 用户。证明不能出现“用户已停用/会话已删,但审计失败”的部分状态。测试结束销毁自己的临时库,不往运行中的用户库注入 trigger。
C4:精确提交屏障#
子进程准备 CREDIT 7 的确定命令,父进程只在相应 hook 写出标记后 Kill。R01 事务未提交,恢复后 COUNT=0、余额为空;R02–R06 已有提交前缀,恢复后余额7。重新建运行时,再用同键/同内容确认,replayed=true 且余额仍7。SQL 查询错误也必须使测试失败,不能将默认 count=0 误认成未提交结论。
C5:备份元数据与文件边界#
从独立真实库生成正常 backup,分别改 manifest 尾随 JSON、未知字段、版本与 users 报告。前三者预检失败,目标不存在;报告错在复制/重放后失败,新目标也必须清理。最后把 journal.db 换成指向相同字节的符号链接,仍拒绝,证明不只校验 checksum。正常恢复和会话/资金/原键由 R10/R12 验证。
7. 性能、专项与待执行项#
| 用例 | 当前入口/状态 | 验收或后续环境 |
|---|---|---|
| P01 核心/日志/恢复基准 | benchmark_test.go ↗,历史 v0.3 有实测 | ns/op、分配、批与恢复条件分开;本轮副本修复后未复测容量 |
| P02 开放到达率与资金对账 | load_check.py + cmd/loadcheck,历史 v0.3 有实测 | 全部状态、客户端丢弃、计划至完成延迟、最终精确资金 |
| P03 发生器报告/目标限制 | loadcheck main_test.go ↗ | nearest-rank、空样本、loopback/协议限制、metrics 解析与非200错误 |
| X01 真实满盘/只读块设备/fsync 错误/断电 | 未执行硬件专项 | 独立可销毁磁盘/VM,成功确认集合与完整日志前缀均恢复 |
| X02 云实机 TLS/域名/安全组/systemd/监控 | 文档已提供,实机未执行 | 指定服务器/域名后按部署手册验收;不能用本机容器替代 |
| X03 长时生产混合负载/冷缓存恢复 | 未执行完整专项 | 固定成交/撤单/查询/WS 配比、持续历史增长、明确SLO与资源上限 |
| X04 多浏览器、键盘/reduced-motion/对比度完整审计 | 现有 Chromium 局部可操作性覆盖 | Firefox/WebKit、键盘全流程、自动/人工无障碍;局部截图不能算全通过 |
| X05 全断网/弱网/服务重启期间 WS 与多标签 | 当前只验证实际 socket 关闭重连和刷新恢复 | 网络代理/浏览器故障矩阵,sessionStorage 仍仅同标签 |
| X06 真实多市场/费用/VWAP/模拟Redis/分区/HA | 未实现,不是当前测试通过项 | 功能实现及对应协议审阅后另建测试,不从计划抄为成果 |
当前每条已实现规则有明确测试入口,但随机种子、短时 fuzz 和覆盖率不构成形式证明。P0 表示资金/权限/恢复等高影响验收性质,P1 表示展示/运维/资源行为;这是项目内测试优先级,不是第三方认证。
文档一致性复核#
用例证明的性质不因增加注释而扩大。本轮文档与注释复核见报告;对象隔离/六窗口的真实执行仍引用测试完善证据。没有用文档修改宣称云实机、物理断电、全弱网或新的容量验证通过。
Windows 启动增量用例#
local_admin_test.go ↗ 覆盖账号字符/大小写规范、8/7/73 字节密码、常规注册与管理员仍拒绝八字节、bcrypt、重跑不改身份/密码、USER 不提权;真实 HTTP 验证别名模式/普通模式/错误密码/注册拒绝与 ADMIN 权限,并对照 LoginCredentials 请求契约。
server main_test.go ↗ 覆盖 IPv4/IPv6 回环允许,空 host/0.0.0.0/localhost/非本机拒绝、两种管理员配置互斥。Windows PowerShell 实际构建/启动/登录/重启与失败路径独立记录,见本轮报告,不使用旧覆盖率总数当新增代码成绩。
v0.5 链闭环验证#
chaintrade/production_test.go 新增 TestHistoryBoundaries(111条/上界/筛选/游标隔离)、TestTaskMigrationAndCAS(旧表升级/raw不变/冲突/终态)、TestIndexerAtomicRestartReorganization(重启/浅尾部/深锚点)、TestIndexTransactionFailure(事件失败游标不推进)、TestReconciliationDetectsCorruption(全量投影守恒/只读/lag)、TestHistoryContractAndDiagnostics(新接口真实契约/raw不泄漏)。
真实 scripts/web3_check.mjs 额外覆盖历史翻页、钱包筛选、详情、重启索引、对账和直方图;浏览器进入成交历史并打开任务详情。先构建同版前后端,再运行真实 Anvil/中间件/容器。WEB3_CHECK_EVIDENCE_DIR 指定本次独立目录,默认为 docs/reports/evidence-v0.5;历史 evidence-web3 不改写。全套命令、失败重试与执行结果见 web3-testing.md 和 v0.5 报告;公共链/云/原生 Windows、硬件断电没有在本轮执行。
最终补充 TestFinalizedReconciliation(正确终态零差异,缺失事件/终态冲突检测)、TestIndexDiskRestart(真实关闭重开仍保留游标与事件)、TestReadSnapshotDoesNotBlockWriter(读事务持有旧水位,新命令可完成且只读池拒写)。