EcoSpecies-Atlas/apps/README.md

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.