# 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
```