# Application Notes

## API

The API lives in `apps/api/src/ecospecies_api` and supports two storage modes:

- PostgreSQL through Docker Compose
- SQLite fallback for host-local verification

The importer writes persisted `species`, `document_section`, and `ingest_diagnostic` records before the API serves traffic.

## Web

The web app is static and served by nginx. nginx proxies `/api/*` and `/healthz` to the API service inside the Compose network.

## Dependency handling

Compose bootstraps a bind-mounted Python virtual environment in `.docker/venv` and installs `apps/api/requirements.txt` into that environment. This keeps runtime dependencies isolated from the host Python installation while leaving the environment visible on the host filesystem.