用途:在围绕外部依赖设计代码之前,先测量该依赖的真实行为,避免把假设当成事实。它适用于需要弄清供应商在重复请求、响应丢失、重复数据、限流、过期等情形下如何响应的场景。
主要能力:通过 Veris 沙箱(服务的有状态孪生)回答代码库无法回答的问题,并可按需制造真实供应商不会主动制造的故障。核心原则是依赖的契约可测量,因此应测量。
使用方式:先准备沙箱,依次调用 get_environment、create_sandbox、get_sandbox 直到就绪;get_sandbox 返回各服务的 url 和 control_url,/veris/* 路径始终走 control_url。探测不是被测代码,可直接用 curl 或短脚本发往 url,使用沙箱公布的凭据(/veris/manual 会列出)。
测量阶梯:先 GET {control_url}/veris/manual 获取供应商契约;再 GET {control_url}/veris/schema 查看存储结构;然后发探测,例如重复发送、超限、翻页;接着制造故障,通过 POST {control_url}/veris/data 配置故障行并驱动真实调用;最后用 GET {control_url}/veris/requests 和 GET {control_url}/veris/data?entity_type=<name> 回读实际发送与存储内容。
记录:在 .veris/MEASUREMENTS.md 中维护台账,每行一条探测,包含 claim、request、response、rules in / rules out。设计应引用台账行。
限制:需要先有沙箱环境;若仓库尚未接入环境,需用 setting-up-veris 接入。文档描述意图,沙箱才是行为,探测优先于文档。常见错误包括先设计后验证、发现答案却不行动、只读公开文档而不运行、把简报前提当作问题陈述。后续可用 integration-testing 在沙箱中验证变更。