alex-1/docs/architecture.md

Architecture

alex-1 is a python-fastapi service.

Component	Detail
Runtime	python-fastapi
Container port	8000
Health check	/health
Metrics	/metrics (Prometheus format)
Image	Azure Container Registry (bstagecjotdevacr)

Deployment flow

Push to dev/staging/prod
  → build-push.yml  (build + test → push image to ACR)
  → deploy-humanitec.yml (hctl score deploy)

Branch model

Branch	Purpose
main	System of record — catalog, docs, score.yaml, platform config
dev	Active development
staging	Pre-production (lazy-created on first promote)
prod	Production (lazy-created on first promote)

Promotions between environments are triggered from the Backstage CI/CD tab.