From a4f183e9e3e2fe4cf32273ac1d21019a6ba22282 Mon Sep 17 00:00:00 2001
From: Philipp Keller <p.keller@nexus.local>
Date: Tue, 17 Feb 2026 14:00:00 +0000
Subject: [PATCH] Add architecture overview page

---
 Architecture.md | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)
 create mode 100644 Architecture.md

diff --git a/Architecture.md b/Architecture.md
new file mode 100644
index 0000000..2bcb3ba
--- /dev/null
+++ b/Architecture.md
@@ -0,0 +1,30 @@
+# Architecture Overview
+
+## Network topology
+
+```
+Internet → Route 53 → ALB (public) → EKS nodes (private) → RDS (isolated)
+                                   ↘ ElastiCache (private)
+```
+
+## Services map
+
+| Service | Technology | Owner | Namespace |
+|---------|-----------|-------|-----------|
+| API | Rust/Axum | backend team | `nexus` |
+| Frontend | React/Vite (static CDN) | frontend team | — |
+| Data pipeline | Python/Airflow | data team | `airflow` |
+| Auth | OIDC (Keycloak) | platform team | `auth` |
+| Monitoring | Prometheus + Grafana | platform team | `monitoring` |
+
+## Deployment flow
+
+```
+PR merged to main
+  → GitHub Actions CI
+  → Docker build + push to registry.nexus.local
+  → Helm upgrade (nexus-staging) — auto
+  → Smoke tests
+  → Manual approval gate
+  → Helm upgrade (nexus-prod)
+```