Metamorph backend

Flask 3 API. See repo root README.md for the big picture.

Layout

app/
├── api/        # HTTP layer (blueprints), versioned under /api/v1
├── core/       # config (env-driven), structured logging
├── db/         # SQLAlchemy session + Alembic (M1+)
├── models/     # ORM models (M1+)
├── services/   # domain logic (M2+)
└── i18n/       # message catalogs (M13)
tests/          # pytest

Local dev

Requires uv and a reachable Postgres (M1+; not needed yet for /health).

uv sync                                            # install deps from pyproject.toml
uv run flask --app app.main run --debug --port 8000
curl http://localhost:8000/api/v1/health

Tests

uv run pytest

Lint

uv run ruff check .
uv run ruff format .