用途:在 epistemix_platform 项目中创建网关类,作为清晰架构的外部集成层,隔离应用逻辑与外部服务(AWS、第三方 API 等)细节。
主要能力:接口优先设计,先在 gateways/interfaces.py 用 Protocol 定义契约并加 @runtime_checkable;网关方法只接受和返回业务/领域模型,不暴露外部 API 模型;隐藏 boto3、SDK 类型等实现细节;通过构造函数注入外部客户端以便 mock 测试;统一错误处理、日志、超时重试与幂等考虑。
使用方式:接口命名 I<ServicePurpose>,实现命名 <Technology><ServicePurpose>;动作方法用动词(submit_run、send_notification),查询方法用名词或状态(describe_run、get_status);配置(ARN、队列名、端点)经构造函数或常量传入;方法文档需含 Args、Returns、Raises、Side Effects、Note,并注明内部调用的外部 API。
适用场景:需要对接 AWS Batch、HTTP API、消息队列、存储服务、认证与限流等外部系统的集成层开发。
限制:资料未提供安装命令、收费、平台支持或具体版本信息;示例中的 ARN、队列名等为占位配置,生产环境应改用环境变量或配置对象。