golang-ddd-infrastructure

Golang DDD 基础设施

当基础设施或交付工作需要强化服务架构，而不是渗入领域模型或削弱安全保障时，请使用此技能。

从这里开始

• 将基础设施视为对服务设计的支持，而不是弥补应用边界缺失的地方。
• 在服务边界大致明确后，或 CI、身份验证或仓库设计开始阻碍开发时，使用此技能。

工作流

1. 保持基础设施声明式。

• 优先使用基础设施即代码，而不是点击式操作。
• 将重复的基础设施模式归纳为 Terraform 模块或类似的清晰抽象。

2. 明确连接服务。

• 通过命名清晰的配置传递服务端点、凭据和环境差异。
• 避免将特定于基础设施的细节偷偷带入领域包。

3. 让测试金字塔落到实处。

• 保持领域测试快速且本地化。
• 使用集成测试验证适配器和事务行为。
• 使用组件测试，针对单个服务并模拟外部依赖。
• 有选择地进行端到端测试，不要将其作为默认的安全保障。

4. 设计稳定的 CI。

• 在流水线中自动运行测试。
• 确保非单元测试可安全并行且结果确定。
• 避免基于 sleep 的同步；等待明确的就绪状态或最终条件。

5. 明确安全机制。

• 不要使用伪造用户或隐藏的上下文值来执行特权内部更新。
• 优先使用明确的角色、命令或仓库方法，并通过名称表明其安全影响。
• 在配置和适配器代码中清晰呈现服务间身份验证和权限。

6. 保持架构边界。

• 基础设施可以组合端口和适配器，但不能迫使领域了解部署细节。
• 如果仓库或处理程序需要特殊的内部行为，应明确命名，而不是添加隐式标志。

使用以下参考资料

• 阅读 references/infra-and-delivery.md，了解符合此风格的 Terraform、Cloud Run 和 CI 模式。
• 阅读 references/testing-and-security.md，了解测试架构和安全设计优先的仓库指南。

交付成果

• 可通过代码审查的基础设施，
• 明确的服务连接和权限，
• 自动运行适当测试的 CI 流程，
• 结果确定的集成测试和组件测试，
• 具有明确安全边界的内部操作。