用途：为 Ramp 集成设计生产级参考架构，把凭证代理、类型化适配器、事件入口、持久化工作账本、财务连接器、对账与证据等信任和故障域分离，并让写权限窄于读与可观测路径。
主要能力：定义业务能力、参与者、租户/实体、延迟、数据类别、财务影响与恢复目标；按信任差异拆分只读摄取、事件接收、会计写入、卡/支出权限等独立 OAuth 应用与服务；在密钥托管下放置白名单类型化适配器，集中限流预算、分页、错误解析、trace ID 与 schema 版本证据；将已验证 Webhook 写入持久化去重队列异步处理，并按计划对账当前 API 状态与下游效果；设计部署、可观测性、事件隔离、数据保留、负向访问测试与回滚，并对可支出、同步或暴露卡数据的路径做威胁建模。
使用方式：先确认 Ramp 应用、环境、业务实体、受影响数据与工作流、负责人与回滚边界；阅读 references/official-docs.md 并复核端点 schema、scope、限制与支持状态；在生产访问与业务影响获批前使用合成夹具或 Ramp 沙箱；准备已批准的密钥存储与脱敏证据位置。工具纪律上，用 Glob 定位候选代码与证据，用 Grep 查找端点、字段、权限、标识符与错误，用 Read 检查最小必要文件，Write 仅用于新的已批准本地草稿、测试或证据，Edit 仅用于有已知回滚的有界变更。
适用场景：只读仓库导出器加 Webhook 触发与周期对账；ERP 连接器使源账本、下游回执与 Ramp 同步回执构成可审计状态机。
限制：本地文件工具不授权任何 Ramp 操作，也不替代负责人批准；架构、安全、隐私、业务与财务负责人批准边界，生产 Vault 等供应商受限面需 Ramp 批准；Webhook 事件可能重复或乱序，行动前应获取当前资源状态；未解决的供应商行为、权限或财务状态应视为停止条件。具体端点、scope、限额与支持状态以官方文档和当前 OpenAPI schema 为准，资料未提供具体数值。