Skip to content

docs: add architecture diagrams and organize runbooks - #2

Merged
patrick-hudson merged 1 commit into
mainfrom
codex/architecture-and-docs
Oct 14, 2026
Merged

patrick-hudson merged 1 commit into
mainfrom
codex/architecture-and-docs

Conversation

@patrick-hudson

Copy link
Copy Markdown
Owner

Summary

Make the repository easier to inspect and operate from its GitHub landing page. The README now shows the AWS topology and a directory tree, with full setup, pipeline, and cost details in focused runbooks.

The editable draw.io document has two pages: AWS topology and deployment/state flow. SVG previews cover public Grafana ingress, private workers and monitoring, NAT egress, IRSA, OIDC roles, and separate workspace states. The drawings distinguish logical subnet tiers from replicated monitoring.

Terraform roots, module paths, inputs, state addresses, and workflow behavior are unchanged. The cleanup guide remains the complete teardown and AWS audit procedure.

Validation

  • Both pages rendered with draw.io Desktop 31.4.5 and inspected visually; legend contrast checked in light and dark themes.
  • XML structure, AWS shape names, edge references, embedded SVG diagram data, and all 36 local documentation links checked.
  • Markdown code fences and git whitespace checks passed.

No AWS actions or Terraform applies were run for this change.

@github-actions

Copy link
Copy Markdown

Terraform plan: dev

Job result: success. Commit: 8214293b08c78ba312d10e4456f753111c3115c6. Workflow run.

Root Result Add Change Destroy Replace
Platform Planned 50 0 0 0
Monitoring Deferred: cluster does not exist — — — —

Replacements also count toward Add and Destroy. Counts describe managed resources; output-only changes are not included.

A deferred monitoring plan requires an existing cluster. Check the workflow logs for any failure or incomplete results.

@github-actions

Copy link
Copy Markdown

Terraform plan: prod

Job result: success. Commit: 8214293b08c78ba312d10e4456f753111c3115c6. Workflow run.

Root Result Add Change Destroy Replace
Platform Planned 58 0 0 0
Monitoring Deferred: cluster does not exist — — — —

Replacements also count toward Add and Destroy. Counts describe managed resources; output-only changes are not included.

A deferred monitoring plan requires an existing cluster. Check the workflow logs for any failure or incomplete results.

@patrick-hudson
patrick-hudson merged commit 15a96a9 into main Oct 14, 2026
3 checks passed

This branch was successfully deployed

2 active deployments
dev-plan — 8214293b Deployed Oct 14, 2026 by patrick-hudson via Terraform (dev) #6
prod-plan — 8214293b Deployed Oct 14, 2026 by patrick-hudson via Terraform (prod) #6
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant