initial commit

Change-Id: I3184ea3bc23ecc769c9de5fad0a0a0229e353629
2026-03-23 23:19:03 +00:00
commit d10e2ce029
19 changed files with 1089 additions and 0 deletions
--- a/docs/architecture.md
+++ b/docs/architecture.md
@@ -0,0 +1,32 @@
+# Architecture
+
+`test-alex-gitops-1` is a Python 3.12 **FastAPI** application served by **Uvicorn**.
+
+## Components
+
+| Component | Technology |
+|-----------|-----------|
+| Web framework | FastAPI 0.111 |
+| ASGI server | Uvicorn |
+| Metrics | prometheus-fastapi-instrumentator → `/metrics` |
+| Validation | Pydantic v2 models |
+| Health | Custom `/health` endpoint |
+| API docs | Built-in Swagger UI at `/docs` |
+
+## Deployment flow
+
+```
+Push to main
+    │
+    ▼
+build-push.yml
+  docker build (python:3.12-slim)
+  docker push → ACR (OIDC)
+    │
+    ▼
+deploy-humanitec.yml
+  humctl score deploy → Humanitec
+    │
+    ▼
+AKS pod :8000
+```