Backend

HTTP routes: OpenAPI UI at /docs when the API is running.

Module docs and architecture: docs site (served locally with just docs::dev-up).

Running

just backend              # http://127.0.0.1:8780
just backend port=9000    # choose a different port

COMPASS_ENVIRONMENT defaults to development locally, enabling CORS for the Vite dev server. Set it to production to disable development-only middleware; docker-compose.yml defaults to production.

Tests

uv run pytest tests/ -v

Configuration

Use-case checklist: backend configuration. Ontology setup: ontology configuration.