How norsaje/cosmo_track works
cosmo_track is a field-level vegetation-monitoring service: a user authenticates, selects or draws a polygon, binds it to an available observation series, submits an analysis, then polls its job and views reconstructed NDVI, uncertainty and anomaly explanations. The API validates and queues work; a Celery worker fetches fixture-backed series, reconstructs them and stores analysis results for retrieval. The graph also preserves the documented polygon, session, job-status, export and anomaly capabilities. Source excerpts establish key worker and reconstruction calls; some route and DL details are documented or represented only by their exact enclosing directory paths.
Main entry points: tasks.py Celery worker · analyses.py Analysis routes · main.py FastAPI entry · models.py PostGIS records
Components 24
Identity
- Auth routes
apps/api/routes/auth.py - Identity client
apps/auth/braining_id.py - Session handling
apps/auth/sessions.py
API and records
- FastAPI entry
apps/api/main.py - Polygon routes
apps/api/routes/polygons.py - Analysis routes
apps/api/routes/analyses.py - Job status
apps/api/routes/jobs.py - API schemas
apps/api/schemas/analyses.py - Job state contract
apps/api/schemas/jobs.py - PostGIS records
apps/db/models.py
Analysis processing
- Celery worker
apps/worker/tasks.py - Series provider
src/veg_recovery/providers/fixture.py - Analysis orchestration
src/veg_recovery/service/orchestrator.py - Reconstructor
src/veg_recovery/service/reconstructor.py - NDVI inference
src/veg_recovery/inference.py - Feature builder
src/veg_recovery/features/builder.py - Model bundle
src/veg_recovery/models/bundle.py - Mounted ML package
model/ndvi
Anomaly insights
- Baseline anomalies
src/veg_recovery/anomalies/baseline.py - Advanced anomaly analysis
src/veg_recovery/anomalies/advanced.py - Events and explanations
src/veg_recovery/anomalies/events.py
Other components
- Field user
- Braining ID
- Redis broker
Connections 28
- Field user → FastAPI entry: uses API
- FastAPI entry → Auth routes: registers
apps/api/main.py - FastAPI entry → Polygon routes: registers
apps/api/main.py - FastAPI entry → Analysis routes: registers
apps/api/main.py - FastAPI entry → Job status: registers
apps/api/main.py - Auth routes → Identity client: verifies identity
apps/api/routes/auth.py - Identity client → Braining ID: requests codes
- Auth routes → Session handling: issues sessions
apps/api/routes/auth.py - Auth routes → PostGIS records: persists users
apps/api/routes/auth.py - Polygon routes → PostGIS records: stores polygons
- Analysis routes → API schemas: validates requests
apps/api/routes/analyses.py - Analysis routes → PostGIS records: creates analyses
apps/api/routes/analyses.py - Analysis routes → Redis broker: queues job
- Analysis routes → Celery worker: dispatches task
apps/api/routes/analyses.py - Celery worker → Job state contract: updates stages
apps/worker/tasks.py - Celery worker → PostGIS records: stores outcomes
apps/worker/tasks.py - Job status → PostGIS records: reads progress
- Celery worker → Series provider: fetches series
apps/worker/tasks.py - Celery worker → Analysis orchestration: runs analysis
apps/worker/tasks.py - Analysis orchestration → Reconstructor: reconstructs series
src/veg_recovery/service/orchestrator.py - Reconstructor → NDVI inference: delegates inference
- NDVI inference → Feature builder: builds features
src/veg_recovery/inference.py - NDVI inference → Model bundle: uses bundle
src/veg_recovery/inference.py - Celery worker → Mounted ML package: loads mounted model
- Celery worker → Baseline anomalies: computes events
apps/worker/tasks.py - Baseline anomalies → Advanced anomaly analysis: optional analysis
- Advanced anomaly analysis → Events and explanations: uses event helpers
src/veg_recovery/anomalies/advanced.py - Analysis routes → Baseline anomalies: serves anomalies