Design Notes for dxaws-accounts

Architecture

Explain how this module fits into the overall dxaws system.

Declarative Convergence

This module follows a declarative convergence model.

Instead of issuing imperative AWS calls directly, callers describe the desired state. The module then:

  1. Plans what needs to change to reach that state

  2. Applies the plan using provider-backed AWS operations

This separation makes behavior predictable, testable, and idempotent, while keeping AWS-specific logic isolated in providers.

Key Concepts

  • Providers

  • Module (public facade)

  • Planner / Executor

  • Tokens / naming

  • AWS service boundaries

Tradeoffs

Call out intentional decisions or limitations.