AWS Diagram Tool

This tool enables architects and engineers to model AWS deployments by describing resources and relationships and generating diagrams that communicate architecture decisions. Target users include solutions architects, cloud engineers, DevOps, and IT managers for planning, reviews, and documentation. It supports region-aware layouts, grouping of related resources, tagging, and export-ready visuals suitable for runbooks and slide decks. Core problems solved include fast, reproducible cloud diagrams that reflect current architectures and facilitate stakeholder alignment.
Core Logic & Features include a resource model parser (fields: id, type, name, region, environment, owner) and connections; AWS-style icon mapping and consistent styling; a layout engine to position blocks and route edges; region-aware grouping and clustering; export to SVG/PNG; input validation (unique IDs, valid service types, known regions). Optional features include YAML/JSON import, templates, version history, multi-project management, API integration for IaC pipelines, and programmatic access for automation.
Inputs & Outputs cover project_name, region, resources[], connections[]. Outputs include diagram_svg (SVG string) and metadata describing resources and connections; optional export settings and asset references.
Algorithms & Calculations describe a layered graph approach with topological ordering and heuristics to minimize crossings; edge routing minimizes overlaps; resource blocks sized by type; region grouping respected; exports preserve vector fidelity and reference integrity.
Error & Edge Cases address missing fields, duplicates, unknown service types; cycles allowed but layout must resolve; unsupported regions default gracefully; export failures return error metadata; if a resource references a missing node, a warning is produced and the diagram renders what is available.
Industry/Region & Localization notes include AWS region awareness for global architectures, canonical AWS service types, neutral color schemes, and no currency calculations.
Assumptions & Exclusions state that the tool assumes a cohesive AWS environment, excludes non-AWS resources, and does not generate deployment scripts or costs; it focuses on visual diagram generation.