Base directory for migration control plane and data orchestration.
- app/ → Application code (Python services, workers)
- log/ → Runtime logs (Loki forwarder target)
- config/ → YAML/ENV configuration
- spool/ → SQLite job spools and queue staging
- db/ → PostgreSQL DDL, backups, migrations
- index/ → Optional indexing/search systems
- http/ → UI + API layer
- scripts/ → Operational scripts and cron jobs
- docs/ → Architecture, runbooks, reports
- man/ → Man pages for tools/scripts
- spool/ is transient but critical for restart/recovery
- db/postgres/ should NOT be used for production PGDATA unless explicitly intended
- log/ should be forwarded to centralized logging (Loki) EOF