How raghav-305/freight-sih works
Freight Chartering Intelligence is a human-reviewed maritime procurement decision-support platform. Users provide cargo, route, vessel class, timing and contract requirements through the frontend; the FastAPI backend exposes analysis and recommendation capabilities, with results including forecasts, feasibility, vessel and contract recommendations, costs, savings and risk. The README documents the services-to-ML/optimization/database architecture and offline operating modes. The graph preserves major documented capabilities, but unsampled implementation details are represented at subsystem level rather than connected speculatively.
Main entry points: main.py FastAPI boundary · main.tsx Decision workspace · charter.py Charter recommendation · market.py Market intelligence
Components 21
User experience
- Decision workspace
frontend/src/main.tsx
API capabilities
- FastAPI boundary
backend/app/main.py - Charter recommendation
backend/app/api/charter.py - Freight forecasts
backend/app/api/forecast.py - Market intelligence
backend/app/api/market.py - Vessel intelligence
backend/app/api/vessels.py - Constraint eligibility
backend/app/api/eligibility.py - Risk intelligence
backend/app/api/risk.py - Scenario analysis
backend/app/api/scenarios.py - Counterfactuals
backend/app/api/counterfactual.py - Maritime map
backend/app/api/map.py - Bid anomaly review
backend/app/api/collusion.py - Charterparty studio
backend/app/api/charterparty.py - Data quality
backend/app/api/data_quality.py
Decision engines
- Charter optimization
data/charter_strategy/optimize_charter.py - Market inference
ml/inference/market_intelligence.py
Data and operations
- Live AIS tracking
backend/app/services/ais_tracker.py - Operational database
backend/app/database/models.py - Freight data store
backend/app/database/freight_store.py
Other components
- Chartering user
- AIS feed
Connections 21
- Chartering user → Decision workspace: submits requirements
- Decision workspace → FastAPI boundary: requests analysis
- FastAPI boundary → Charter recommendation: routes requests
backend/app/main.py - FastAPI boundary → Freight forecasts: routes requests
backend/app/main.py - FastAPI boundary → Market intelligence: routes requests
backend/app/main.py - FastAPI boundary → Vessel intelligence: routes requests
backend/app/main.py - FastAPI boundary → Constraint eligibility: routes requests
backend/app/main.py - FastAPI boundary → Risk intelligence: routes requests
backend/app/main.py - FastAPI boundary → Scenario analysis: routes requests
backend/app/main.py - FastAPI boundary → Counterfactuals: routes requests
backend/app/main.py - FastAPI boundary → Maritime map: routes requests
backend/app/main.py - FastAPI boundary → Bid anomaly review: routes requests
backend/app/main.py - FastAPI boundary → Charterparty studio: routes requests
backend/app/main.py - FastAPI boundary → Data quality: routes requests
backend/app/main.py - Charter recommendation → Charter optimization: optimizes charter
- Market intelligence → Market inference: uses inference
- FastAPI boundary → Live AIS tracking: starts ingestion
backend/app/main.py - AIS feed → Live AIS tracking: supplies positions
- FastAPI boundary → Operational database: uses persistence
- FastAPI boundary → Freight data store: reads freight status
- Operational database → Freight data store: stores freight data