开发文档
测试与验证
协议、权限、资金及崩溃恢复的测试层次与证据要求
资金、支付和授权是必要自动化测试范围。具体产品场景见验收标准，阶段 1 原版与验证性扩展按集成验证分别记录。
测试层次
| 层 | 方法 | 重点 |
|---|---|---|
| 单元/表驱动 | 固定输入与确定规则 | 定价选择、舍入、状态转换、指纹、权限矩阵 |
| 数据库集成 | 隔离真实 PostgreSQL，真实迁移/约束/事务 | 并发资金、唯一约束、重复事件、Key 额度恢复 |
| 协议集成 | 本地 TCP/HTTP 上游夹具 | 三协议普通/SSE、缓存推理、断流、缺用量、视频未知 |
| 服务集成 | 平台 + 测试产品 + 本地支付夹具 | 会话/CSRF/产品授权、同钱包、可信通知 |
| 页面端到端 | Console/Admin + 实际服务 | 充值/Key/调用/记录/调整、错误状态和回读 |
| 恢复演练 | 受控结束进程并重启、租约接管 | 提交前后、账务成功后日志失败、结算/退款持久恢复 |
SQLite 或内存 store 不能替代 PostgreSQL 并发资金证据。前端 mock 可以验证界面，但不证明身份、账务和供应兼容。
必测失败矩阵
- 同用户并发预留恰好竞争余额；结算/释放竞争；确认开始/到期释放竞争。
- 同键重复、不同输入、跨用户与跨产品；后台凭据试图对任意用户扣费。
- 支付重复回调、错误签名/商户/金额/币种、浏览器提前返回、通知乱序、补单重复。
- 三协议的缓存/推理字段及各启用计量项、流中断、用量缺失、实际消费超过预扣。
- 外部提交已成功但响应丢失、原任务查询失败、迟到成功、重复回执、产品结果保存失败。
- DB 提交前/后进程中止；Key 额度、使用记录或通知失败后重启；租约到期双执行者接管。
- Cookie 域/路径、撤销、切换账号、允许与拒绝 Origin、返回地址白名单、Admin 权限直调。
每个故障都核对原操作、余额、冻结、资金流水、Key 额度、任务关联和恢复状态。不能仅断言 HTTP 成功/失败。
测试数据与费用
默认本地夹具、隔离账户/库/Redis、固定测试价格。真实供应及支付调用需获授权，并限定 Key、模型、次数/预算和环境；没有授权时留作明确未验证项。测试脚本默认不能连接生产，不在输出中暴露 Key、会话或签名 URL。
CI 与本地检查
源码导入后建立可从干净检出执行的入口：Go 格式/静态检查与测试、数据库集成测试、两前端类型/测试/构建、契约生成一致性、服务构建与启动冒烟。具体命令写入平台 README，不用不存在的脚本假装检查通过。恢复与发布演练作为阶段验收，避免每个文档提交启动重型业务测试。
文档变更执行 pnpm docs:redirects → pnpm docs:check → pnpm types:check → pnpm build，在文档仓库运行。它们只证明文档可用，不证明平台业务实现。
证据格式
每份索引包含需求/验收/任务编号、基线及提交、环境与配置摘要、命令、输入、实际/预期、资金断言、恢复步骤及未验证范围。建议按 docs/verification/<任务编号>/ 保存脱敏测试摘要/报告；大日志与敏感附件存受控环境，只留下引用。失败不覆盖成成功，复验关联前次证据。