ColdTrace 🧊

Pharmaceutical cold chain integrity auditor — full hackathon prototype.

coldtrace/
├── backend/   ← FastAPI + SQLModel + SQLite + Open-Meteo + scoring engine
└── frontend/  ← React (Vite) + Tailwind + Recharts + Leaflet

Quick start

1. Backend

cd backend
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python seed.py            # loads 3 demo shipments
uvicorn main:app --reload

API docs → http://localhost:8000/docs

2. Frontend

cd frontend
npm install
npm run dev

Open http://localhost:5173.

If the backend is not running, the UI falls back to built-in demo data so the design stays previewable.

Example curl commands

Upload a new shipment (sensor.csv + gps.csv must be in cwd):

curl -X POST http://localhost:8000/api/v1/shipments/upload \
  -F "product_name=Hepatitis B Vaccine" \
  -F "origin_city=Delhi" \
  -F "destination_city=Jaipur" \
  -F "sensor_file=@sensor.csv" \
  -F "gps_file=@gps.csv"

Get full analysis for SHP-DEMO-002:

curl http://localhost:8000/api/v1/shipments/SHP-DEMO-002 | jq

Standards

• WHO PQS E006: 2–8°C safe band
• ICH Q5C: cumulative damage to biologics
• USP <1079>: storage & shipping
• Q10 = 2.0 (pharma default)