initial commit

Change-Id: I15e0d095273278f8531caa7399565fe92857a7ad
2026-03-18 18:18:32 +00:00
commit a4edf15862
15 changed files with 765 additions and 0 deletions
--- a/docs/architecture.md
+++ b/docs/architecture.md
@@ -0,0 +1,32 @@
+# Architecture
+
+`test-alex-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
+```