# vardhanreddy024/freightiq architecture

> Architecture diagram of the GitHub repository vardhanreddy024/freightiq, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vardhanreddy024/freightiq
- Repository: https://github.com/vardhanreddy024/freightiq

## Overview

FreightIQ is a client-side maritime decision cockpit for bulk-material procurement into East Coast India. Users enter through the landing page or command center, then review freight forecasts, vessel fit, port conditions, and risk before testing scenarios or viewing an executive charter recommendation. The deterministic decision engine and demo datasets support those analyses; the README documents the broader capability flow. Connections reflect shown imports, calls, or documented workflow; source for some page implementations and integrations was not sampled.

Main entry points: [`src/App.tsx`](https://github.com/vardhanreddy024/freightiq/blob/main/src/App.tsx) (Page Router), [`src/engine/decisionEngine.ts`](https://github.com/vardhanreddy024/freightiq/blob/main/src/engine/decisionEngine.ts) (Decision Engine), [`src/pages/Home.tsx`](https://github.com/vardhanreddy024/freightiq/blob/main/src/pages/Home.tsx) (Landing Experience), [`src/components/maritime.tsx`](https://github.com/vardhanreddy024/freightiq/blob/main/src/components/maritime.tsx) (Maritime Visuals)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Product Entry"]
  node_home["Landing Experience<br/>[Home.tsx]"]
  node_hero_visual["Hero Visuals<br/>[HeroShipVisual.tsx]"]
  node_hero_canvas["Ship Canvas<br/>[HeroShipCanvas.tsx]"]
  node_hud_map["Corridor Map<br/>[IndiaHudMap.tsx]"]
  node_workflow_modal["Workflow Guide<br/>[WorkflowModal.tsx]"]
end

subgraph group_workspace["Decision Workspace"]
  node_app["Page Router<br/>[App.tsx]"]
  node_layout["Command Shell<br/>[Layout.tsx]"]
  node_overview["Command Center<br/>[Overview.tsx]"]
  node_forecast["Freight Forecast<br/>[Forecast.tsx]"]
  node_vessel["Vessel Optimizer<br/>[Vessel.tsx]"]
  node_ports["Port Intelligence<br/>[Ports.tsx]"]
  node_simulator["Scenario Simulator<br/>[Simulator.tsx]"]
  node_risk["Risk Command<br/>[Risk.tsx]"]
  node_decision["Decision Center<br/>[Decision.tsx]"]
  node_copilot["FreightIQ Copilot<br/>[Copilot.tsx]"]
  node_freight_chart["Freight Chart<br/>[FreightChart.tsx]"]
  node_maritime["Maritime Visuals<br/>[maritime.tsx]"]
end

subgraph group_analysis["Analysis Engine"]
  node_engine["Decision Engine<br/>[decisionEngine.ts]"]
end

subgraph group_data["Domain Data"]
  node_freight_data["Freight Dataset<br/>[freightData.ts]"]
  node_port_data["Port Dataset<br/>[portData.ts]"]
  node_vessel_data["Vessel Dataset<br/>[vesselData.ts]"]
  node_risk_data["Risk Dataset<br/>[riskData.ts]"]
end

node_user(("Procurement User"))

node_user -->|"opens"| node_home
node_user -->|"navigates"| node_app
node_home -->|"renders"| node_hero_visual
node_home -->|"renders"| node_hero_canvas
node_home -->|"renders"| node_hud_map
node_home -->|"opens"| node_workflow_modal
node_home -->|"enters workspace"| node_app
node_app -->|"wraps pages"| node_layout
node_app -->|"routes to"| node_overview
node_app -->|"routes to"| node_forecast
node_app -->|"routes to"| node_vessel
node_app -->|"routes to"| node_ports
node_app -->|"routes to"| node_simulator
node_app -->|"routes to"| node_risk
node_app -->|"routes to"| node_decision
node_app -->|"renders"| node_copilot
node_overview -->|"requests analysis"| node_engine
node_forecast -->|"requests forecasts"| node_engine
node_vessel -->|"requests scoring"| node_engine
node_ports -->|"requests analysis"| node_engine
node_simulator -->|"requests scenarios"| node_engine
node_risk -->|"requests analysis"| node_engine
node_decision -->|"requests recommendation"| node_engine
node_forecast -->|"renders"| node_freight_chart
node_overview -->|"renders"| node_freight_chart
node_ports -->|"renders"| node_maritime
node_vessel -->|"renders"| node_maritime
node_decision -->|"renders"| node_maritime
node_engine -->|"builds series"| node_freight_data
node_engine -->|"reads"| node_vessel_data
node_engine -->|"reads"| node_port_data
node_engine -->|"reads"| node_risk_data
node_freight_chart -->|"plots"| node_freight_data
node_maritime -->|"maps ports"| node_port_data

click node_home "https://github.com/vardhanreddy024/freightiq/blob/main/src/pages/Home.tsx"
click node_hero_visual "https://github.com/vardhanreddy024/freightiq/blob/main/src/components/home/HeroShipVisual.tsx"
click node_hero_canvas "https://github.com/vardhanreddy024/freightiq/blob/main/src/components/home/HeroShipCanvas.tsx"
click node_hud_map "https://github.com/vardhanreddy024/freightiq/blob/main/src/components/home/IndiaHudMap.tsx"
click node_workflow_modal "https://github.com/vardhanreddy024/freightiq/blob/main/src/components/home/WorkflowModal.tsx"
click node_app "https://github.com/vardhanreddy024/freightiq/blob/main/src/App.tsx"
click node_layout "https://github.com/vardhanreddy024/freightiq/blob/main/src/components/Layout.tsx"
click node_overview "https://github.com/vardhanreddy024/freightiq/blob/main/src/pages/Overview.tsx"
click node_forecast "https://github.com/vardhanreddy024/freightiq/blob/main/src/pages/Forecast.tsx"
click node_vessel "https://github.com/vardhanreddy024/freightiq/blob/main/src/pages/Vessel.tsx"
click node_ports "https://github.com/vardhanreddy024/freightiq/blob/main/src/pages/Ports.tsx"
click node_simulator "https://github.com/vardhanreddy024/freightiq/blob/main/src/pages/Simulator.tsx"
click node_risk "https://github.com/vardhanreddy024/freightiq/blob/main/src/pages/Risk.tsx"
click node_decision "https://github.com/vardhanreddy024/freightiq/blob/main/src/pages/Decision.tsx"
click node_copilot "https://github.com/vardhanreddy024/freightiq/blob/main/src/components/Copilot.tsx"
click node_freight_chart "https://github.com/vardhanreddy024/freightiq/blob/main/src/components/FreightChart.tsx"
click node_maritime "https://github.com/vardhanreddy024/freightiq/blob/main/src/components/maritime.tsx"
click node_engine "https://github.com/vardhanreddy024/freightiq/blob/main/src/engine/decisionEngine.ts"
click node_freight_data "https://github.com/vardhanreddy024/freightiq/blob/main/src/data/freightData.ts"
click node_port_data "https://github.com/vardhanreddy024/freightiq/blob/main/src/data/portData.ts"
click node_vessel_data "https://github.com/vardhanreddy024/freightiq/blob/main/src/data/vesselData.ts"
click node_risk_data "https://github.com/vardhanreddy024/freightiq/blob/main/src/data/riskData.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_home,node_hero_visual,node_hero_canvas,node_hud_map,node_workflow_modal,node_user toneBlue
class node_app,node_layout,node_overview,node_forecast,node_vessel,node_ports,node_simulator,node_risk,node_decision,node_copilot,node_freight_chart,node_maritime toneAmber
class node_engine toneMint
class node_freight_data,node_port_data,node_vessel_data,node_risk_data toneRose
```

## Components

### Product Entry

- [Landing Experience](https://github.com/vardhanreddy024/freightiq/blob/main/src/pages/Home.tsx): `src/pages/Home.tsx`
- [Hero Visuals](https://github.com/vardhanreddy024/freightiq/blob/main/src/components/home/HeroShipVisual.tsx): `src/components/home/HeroShipVisual.tsx`
- [Ship Canvas](https://github.com/vardhanreddy024/freightiq/blob/main/src/components/home/HeroShipCanvas.tsx): `src/components/home/HeroShipCanvas.tsx`
- [Corridor Map](https://github.com/vardhanreddy024/freightiq/blob/main/src/components/home/IndiaHudMap.tsx): `src/components/home/IndiaHudMap.tsx`
- [Workflow Guide](https://github.com/vardhanreddy024/freightiq/blob/main/src/components/home/WorkflowModal.tsx): `src/components/home/WorkflowModal.tsx`

### Decision Workspace

- [Page Router](https://github.com/vardhanreddy024/freightiq/blob/main/src/App.tsx): `src/App.tsx`
- [Command Shell](https://github.com/vardhanreddy024/freightiq/blob/main/src/components/Layout.tsx): `src/components/Layout.tsx`
- [Command Center](https://github.com/vardhanreddy024/freightiq/blob/main/src/pages/Overview.tsx): `src/pages/Overview.tsx`
- [Freight Forecast](https://github.com/vardhanreddy024/freightiq/blob/main/src/pages/Forecast.tsx): `src/pages/Forecast.tsx`
- [Vessel Optimizer](https://github.com/vardhanreddy024/freightiq/blob/main/src/pages/Vessel.tsx): `src/pages/Vessel.tsx`
- [Port Intelligence](https://github.com/vardhanreddy024/freightiq/blob/main/src/pages/Ports.tsx): `src/pages/Ports.tsx`
- [Scenario Simulator](https://github.com/vardhanreddy024/freightiq/blob/main/src/pages/Simulator.tsx): `src/pages/Simulator.tsx`
- [Risk Command](https://github.com/vardhanreddy024/freightiq/blob/main/src/pages/Risk.tsx): `src/pages/Risk.tsx`
- [Decision Center](https://github.com/vardhanreddy024/freightiq/blob/main/src/pages/Decision.tsx): `src/pages/Decision.tsx`
- [FreightIQ Copilot](https://github.com/vardhanreddy024/freightiq/blob/main/src/components/Copilot.tsx): `src/components/Copilot.tsx`
- [Freight Chart](https://github.com/vardhanreddy024/freightiq/blob/main/src/components/FreightChart.tsx): `src/components/FreightChart.tsx`
- [Maritime Visuals](https://github.com/vardhanreddy024/freightiq/blob/main/src/components/maritime.tsx): `src/components/maritime.tsx`

### Analysis Engine

- [Decision Engine](https://github.com/vardhanreddy024/freightiq/blob/main/src/engine/decisionEngine.ts): `src/engine/decisionEngine.ts`

### Domain Data

- [Freight Dataset](https://github.com/vardhanreddy024/freightiq/blob/main/src/data/freightData.ts): `src/data/freightData.ts`
- [Port Dataset](https://github.com/vardhanreddy024/freightiq/blob/main/src/data/portData.ts): `src/data/portData.ts`
- [Vessel Dataset](https://github.com/vardhanreddy024/freightiq/blob/main/src/data/vesselData.ts): `src/data/vesselData.ts`
- [Risk Dataset](https://github.com/vardhanreddy024/freightiq/blob/main/src/data/riskData.ts): `src/data/riskData.ts`

### Other components

- **Procurement User**

## Connections

- Procurement User → Landing Experience: opens (evidence: `README.md`)
- Procurement User → Page Router: navigates (evidence: `README.md`)
- Landing Experience → Hero Visuals: renders (evidence: `src/pages/Home.tsx`)
- Landing Experience → Ship Canvas: renders (evidence: `src/pages/Home.tsx`)
- Landing Experience → Corridor Map: renders (evidence: `src/pages/Home.tsx`)
- Landing Experience → Workflow Guide: opens (evidence: `src/pages/Home.tsx`)
- Landing Experience → Page Router: enters workspace (evidence: `src/pages/Home.tsx`)
- Page Router → Command Shell: wraps pages (evidence: `src/App.tsx`)
- Page Router → Command Center: routes to (evidence: `src/App.tsx`)
- Page Router → Freight Forecast: routes to (evidence: `src/App.tsx`)
- Page Router → Vessel Optimizer: routes to (evidence: `src/App.tsx`)
- Page Router → Port Intelligence: routes to (evidence: `src/App.tsx`)
- Page Router → Scenario Simulator: routes to (evidence: `src/App.tsx`)
- Page Router → Risk Command: routes to (evidence: `src/App.tsx`)
- Page Router → Decision Center: routes to (evidence: `src/App.tsx`)
- Page Router → FreightIQ Copilot: renders (evidence: `src/App.tsx`)
- Command Center → Decision Engine: requests analysis (evidence: `src/pages/Overview.tsx`)
- Freight Forecast → Decision Engine: requests forecasts (evidence: `src/pages/Forecast.tsx`)
- Vessel Optimizer → Decision Engine: requests scoring (evidence: `src/pages/Vessel.tsx`)
- Port Intelligence → Decision Engine: requests analysis (evidence: `src/pages/Ports.tsx`)
- Scenario Simulator → Decision Engine: requests scenarios (evidence: `src/pages/Simulator.tsx`)
- Risk Command → Decision Engine: requests analysis (evidence: `src/pages/Risk.tsx`)
- Decision Center → Decision Engine: requests recommendation (evidence: `src/pages/Decision.tsx`)
- Freight Forecast → Freight Chart: renders (evidence: `src/pages/Forecast.tsx`)
- Command Center → Freight Chart: renders (evidence: `src/pages/Overview.tsx`)
- Port Intelligence → Maritime Visuals: renders (evidence: `src/pages/Ports.tsx`)
- Vessel Optimizer → Maritime Visuals: renders (evidence: `src/pages/Vessel.tsx`)
- Decision Center → Maritime Visuals: renders (evidence: `src/pages/Decision.tsx`)
- Decision Engine → Freight Dataset: builds series (evidence: `src/engine/decisionEngine.ts`)
- Decision Engine → Vessel Dataset: reads (evidence: `src/engine/decisionEngine.ts`)
- Decision Engine → Port Dataset: reads (evidence: `src/engine/decisionEngine.ts`)
- Decision Engine → Risk Dataset: reads (evidence: `src/engine/decisionEngine.ts`)
- Freight Chart → Freight Dataset: plots (evidence: `src/components/FreightChart.tsx`)
- Maritime Visuals → Port Dataset: maps ports (evidence: `src/components/maritime.tsx`)
