History

welsberr a6b04a995a Initial commit		2026-03-26 00:54:55 -04:00
..
api	Initial commit	2026-03-26 00:54:55 -04:00
web	Initial commit	2026-03-26 00:54:55 -04:00
README.md	Initial commit	2026-03-26 00:54:55 -04:00

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.