# eswar163/sih26078 architecture

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

- Interactive diagram: https://gitdiagram.com/eswar163/sih26078
- Repository: https://github.com/eswar163/sih26078

## Overview

Trikaal is an offline, browser-based weather-event intelligence application for synthetic numerical weather prediction over India. A user selects a season and seed; application state requests a run through the worker client, which runs the model pipeline and returns results for map, timeline, and event views. The broader product includes ensemble probability cones, event memory and lineage, scenario attribution, intelligence and alerts, and verification. Connections for unsampled capabilities are included only where the README or SOURCE INDEX supports them; some detailed internal calls are therefore not shown.

Main entry points: [`src/worker/engine.worker.ts`](https://github.com/eswar163/sih26078/blob/main/src/worker/engine.worker.ts) (Engine worker), [`src/App.tsx`](https://github.com/eswar163/sih26078/blob/main/src/App.tsx) (Application shell), [`src/engine/run.ts`](https://github.com/eswar163/sih26078/blob/main/src/engine/run.ts) (Field-to-event run), [`src/engine/intel/briefing.ts`](https://github.com/eswar163/sih26078/blob/main/src/engine/intel/briefing.ts) (Briefing and alerts)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Application interface"]
  node_app["Application shell<br/>[App.tsx]"]
  node_state["Run state<br/>[store.ts]"]
  node_url["Shareable URL state<br/>[url.ts]"]
end

subgraph group_runtime["Worker runtime"]
  node_client["Worker client<br/>[client.ts]"]
  node_worker["Engine worker<br/>[engine.worker.ts]"]
  node_memberworker["Ensemble member worker<br/>[member.worker.ts]"]
end

subgraph group_model["Weather and events"]
  node_world["Synthetic atmosphere<br/>[world.ts]"]
  node_climate["Seasonal climate<br/>[climate.ts]"]
  node_run["Field-to-event run<br/>[run.ts]"]
  node_detect["Event detection<br/>[detect.ts]"]
  node_track["Event tracking<br/>[track.ts]"]
  node_events["Event enrichment<br/>[events.ts]"]
  node_dna["Event DNA<br/>[dna.ts]"]
end

subgraph group_intelligence["Forecast intelligence"]
  node_archive[("Event memory<br/>[archive.ts]")]
  node_analogs["Analog search<br/>[analogs.ts]"]
  node_ensemble["Ensemble forecast<br/>[ensemble.ts]"]
  node_cone["Probability cone<br/>[cone.ts]"]
  node_scenario["Scenario attribution<br/>[scenario.ts]"]
  node_briefing["Briefing and alerts<br/>[briefing.ts]"]
  node_decision["Decision clock<br/>[decision.ts]"]
end

subgraph group_presentation["Views and analysis"]
  node_map["Weather map<br/>[MapView.tsx]"]
  node_chartview["Chart view<br/>[ChartView.tsx]"]
  node_memoryview["Memory view<br/>[MemoryView.tsx]"]
  node_scenarioview["Scenario Lab view<br/>[ScenarioView.tsx]"]
  node_briefingview["Briefing view<br/>[BriefingView.tsx]"]
  node_verifyview["Verification view<br/>[VerifyView.tsx]"]
end

node_user(("Weather analyst"))

node_user -->|"uses"| node_app
node_app -->|"coordinates"| node_state
node_app -->|"routes to"| node_chartview
node_app -->|"routes to"| node_memoryview
node_app -->|"routes to"| node_scenarioview
node_app -->|"routes to"| node_briefingview
node_app -->|"routes to"| node_verifyview
node_app -->|"syncs state"| node_url
node_state -->|"requests run"| node_client
node_client -->|"dispatches work"| node_worker
node_worker -->|"runs"| node_run
node_worker -->|"requests ensemble"| node_ensemble
node_worker -->|"requests archive"| node_archive
node_worker -->|"requests analogs"| node_analogs
node_worker -->|"requests cone"| node_cone
node_worker -->|"requests scenario"| node_scenario
node_worker -->|"dispatches members"| node_memberworker
node_run -->|"uses model"| node_world
node_run -->|"uses climate"| node_climate
node_run -->|"detects events"| node_detect
node_run -->|"tracks detections"| node_track
node_run -->|"enriches tracks"| node_events
node_events -->|"fingerprints events"| node_dna
node_archive -->|"simulates seasons"| node_world
node_analogs -->|"searches memory"| node_archive
node_ensemble -->|"runs members"| node_run
node_memberworker -->|"computes members"| node_ensemble
node_cone -->|"summarizes members"| node_ensemble
node_scenario -->|"varies conditions"| node_world
node_briefing -->|"uses analogs"| node_analogs
node_briefing -->|"uses forecast"| node_cone
node_briefing -->|"uses decisions"| node_decision
node_briefingview -->|"shows warnings"| node_decision
node_chartview -->|"renders map"| node_map
node_map -->|"renders cone"| node_cone
node_memoryview -->|"browses memory"| node_archive
node_memoryview -->|"shows relatives"| node_analogs
node_scenarioview -->|"runs scenarios"| node_scenario
node_briefingview -->|"presents intelligence"| node_briefing
node_verifyview -.->|"requests scores"| node_worker

click node_app "https://github.com/eswar163/sih26078/blob/main/src/App.tsx"
click node_state "https://github.com/eswar163/sih26078/blob/main/src/state/store.ts"
click node_url "https://github.com/eswar163/sih26078/blob/main/src/state/url.ts"
click node_client "https://github.com/eswar163/sih26078/blob/main/src/worker/client.ts"
click node_worker "https://github.com/eswar163/sih26078/blob/main/src/worker/engine.worker.ts"
click node_memberworker "https://github.com/eswar163/sih26078/blob/main/src/worker/member.worker.ts"
click node_world "https://github.com/eswar163/sih26078/blob/main/src/engine/world.ts"
click node_climate "https://github.com/eswar163/sih26078/blob/main/src/engine/climate.ts"
click node_run "https://github.com/eswar163/sih26078/blob/main/src/engine/run.ts"
click node_detect "https://github.com/eswar163/sih26078/blob/main/src/engine/detect.ts"
click node_track "https://github.com/eswar163/sih26078/blob/main/src/engine/track.ts"
click node_events "https://github.com/eswar163/sih26078/blob/main/src/engine/events.ts"
click node_dna "https://github.com/eswar163/sih26078/blob/main/src/engine/dna.ts"
click node_archive "https://github.com/eswar163/sih26078/blob/main/src/engine/archive.ts"
click node_analogs "https://github.com/eswar163/sih26078/blob/main/src/engine/analogs.ts"
click node_ensemble "https://github.com/eswar163/sih26078/blob/main/src/engine/ensemble.ts"
click node_cone "https://github.com/eswar163/sih26078/blob/main/src/engine/cone.ts"
click node_scenario "https://github.com/eswar163/sih26078/blob/main/src/engine/scenario.ts"
click node_briefing "https://github.com/eswar163/sih26078/blob/main/src/engine/intel/briefing.ts"
click node_decision "https://github.com/eswar163/sih26078/blob/main/src/engine/decision.ts"
click node_map "https://github.com/eswar163/sih26078/blob/main/src/map/MapView.tsx"
click node_chartview "https://github.com/eswar163/sih26078/blob/main/src/views/ChartView.tsx"
click node_memoryview "https://github.com/eswar163/sih26078/blob/main/src/views/MemoryView.tsx"
click node_scenarioview "https://github.com/eswar163/sih26078/blob/main/src/views/ScenarioView.tsx"
click node_briefingview "https://github.com/eswar163/sih26078/blob/main/src/views/BriefingView.tsx"
click node_verifyview "https://github.com/eswar163/sih26078/blob/main/src/views/VerifyView.tsx"

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_app,node_state,node_url toneBlue
class node_client,node_worker,node_memberworker toneAmber
class node_world,node_climate,node_run,node_detect,node_track,node_events,node_dna toneMint
class node_archive,node_analogs,node_ensemble,node_cone,node_scenario,node_briefing,node_decision toneRose
class node_map,node_chartview,node_memoryview,node_scenarioview,node_briefingview,node_verifyview,node_user toneIndigo
```

## Components

### Application interface

- [Application shell](https://github.com/eswar163/sih26078/blob/main/src/App.tsx): `src/App.tsx`
- [Run state](https://github.com/eswar163/sih26078/blob/main/src/state/store.ts): `src/state/store.ts`
- [Shareable URL state](https://github.com/eswar163/sih26078/blob/main/src/state/url.ts): `src/state/url.ts`

### Worker runtime

- [Worker client](https://github.com/eswar163/sih26078/blob/main/src/worker/client.ts): `src/worker/client.ts`
- [Engine worker](https://github.com/eswar163/sih26078/blob/main/src/worker/engine.worker.ts): `src/worker/engine.worker.ts`
- [Ensemble member worker](https://github.com/eswar163/sih26078/blob/main/src/worker/member.worker.ts): `src/worker/member.worker.ts`

### Weather and events

- [Synthetic atmosphere](https://github.com/eswar163/sih26078/blob/main/src/engine/world.ts): `src/engine/world.ts`
- [Seasonal climate](https://github.com/eswar163/sih26078/blob/main/src/engine/climate.ts): `src/engine/climate.ts`
- [Field-to-event run](https://github.com/eswar163/sih26078/blob/main/src/engine/run.ts): `src/engine/run.ts`
- [Event detection](https://github.com/eswar163/sih26078/blob/main/src/engine/detect.ts): `src/engine/detect.ts`
- [Event tracking](https://github.com/eswar163/sih26078/blob/main/src/engine/track.ts): `src/engine/track.ts`
- [Event enrichment](https://github.com/eswar163/sih26078/blob/main/src/engine/events.ts): `src/engine/events.ts`
- [Event DNA](https://github.com/eswar163/sih26078/blob/main/src/engine/dna.ts): `src/engine/dna.ts`

### Forecast intelligence

- [Event memory](https://github.com/eswar163/sih26078/blob/main/src/engine/archive.ts): `src/engine/archive.ts`
- [Analog search](https://github.com/eswar163/sih26078/blob/main/src/engine/analogs.ts): `src/engine/analogs.ts`
- [Ensemble forecast](https://github.com/eswar163/sih26078/blob/main/src/engine/ensemble.ts): `src/engine/ensemble.ts`
- [Probability cone](https://github.com/eswar163/sih26078/blob/main/src/engine/cone.ts): `src/engine/cone.ts`
- [Scenario attribution](https://github.com/eswar163/sih26078/blob/main/src/engine/scenario.ts): `src/engine/scenario.ts`
- [Briefing and alerts](https://github.com/eswar163/sih26078/blob/main/src/engine/intel/briefing.ts): `src/engine/intel/briefing.ts`
- [Decision clock](https://github.com/eswar163/sih26078/blob/main/src/engine/decision.ts): `src/engine/decision.ts`

### Views and analysis

- [Weather map](https://github.com/eswar163/sih26078/blob/main/src/map/MapView.tsx): `src/map/MapView.tsx`
- [Chart view](https://github.com/eswar163/sih26078/blob/main/src/views/ChartView.tsx): `src/views/ChartView.tsx`
- [Memory view](https://github.com/eswar163/sih26078/blob/main/src/views/MemoryView.tsx): `src/views/MemoryView.tsx`
- [Scenario Lab view](https://github.com/eswar163/sih26078/blob/main/src/views/ScenarioView.tsx): `src/views/ScenarioView.tsx`
- [Briefing view](https://github.com/eswar163/sih26078/blob/main/src/views/BriefingView.tsx): `src/views/BriefingView.tsx`
- [Verification view](https://github.com/eswar163/sih26078/blob/main/src/views/VerifyView.tsx): `src/views/VerifyView.tsx`

### Other components

- **Weather analyst**

## Connections

- Weather analyst → Application shell: uses (evidence: `README.md`)
- Application shell → Run state: coordinates (evidence: `src/App.tsx`)
- Application shell → Chart view: routes to (evidence: `src/App.tsx`)
- Application shell → Memory view: routes to (evidence: `src/App.tsx`)
- Application shell → Scenario Lab view: routes to (evidence: `src/App.tsx`)
- Application shell → Briefing view: routes to (evidence: `src/App.tsx`)
- Application shell → Verification view: routes to (evidence: `src/App.tsx`)
- Application shell → Shareable URL state: syncs state (evidence: `src/App.tsx`)
- Run state → Worker client: requests run (evidence: `src/state/store.ts`)
- Worker client → Engine worker: dispatches work (evidence: `src/worker/client.ts`)
- Engine worker → Field-to-event run: runs (evidence: `src/worker/engine.worker.ts`)
- Engine worker → Ensemble forecast: requests ensemble (evidence: `src/worker/engine.worker.ts`)
- Engine worker → Event memory: requests archive (evidence: `src/worker/engine.worker.ts`)
- Engine worker → Analog search: requests analogs (evidence: `src/worker/engine.worker.ts`)
- Engine worker → Probability cone: requests cone (evidence: `src/worker/engine.worker.ts`)
- Engine worker → Scenario attribution: requests scenario (evidence: `src/worker/engine.worker.ts`)
- Engine worker → Ensemble member worker: dispatches members (evidence: `src/worker/engine.worker.ts`)
- Field-to-event run → Synthetic atmosphere: uses model (evidence: `README.md`)
- Field-to-event run → Seasonal climate: uses climate (evidence: `src/engine/run.ts`)
- Field-to-event run → Event detection: detects events (evidence: `src/engine/run.ts`)
- Field-to-event run → Event tracking: tracks detections (evidence: `src/engine/run.ts`)
- Field-to-event run → Event enrichment: enriches tracks (evidence: `src/engine/run.ts`)
- Event enrichment → Event DNA: fingerprints events (evidence: `src/engine/events.ts`)
- Event memory → Synthetic atmosphere: simulates seasons (evidence: `README.md`)
- Analog search → Event memory: searches memory (evidence: `src/engine/analogs.ts`)
- Ensemble forecast → Field-to-event run: runs members (evidence: `src/engine/ensemble.ts`)
- Ensemble member worker → Ensemble forecast: computes members (evidence: `src/worker/member.worker.ts`)
- Probability cone → Ensemble forecast: summarizes members (evidence: `src/engine/cone.ts`)
- Scenario attribution → Synthetic atmosphere: varies conditions (evidence: `README.md`)
- Briefing and alerts → Analog search: uses analogs (evidence: `src/engine/intel/briefing.ts`)
- Briefing and alerts → Probability cone: uses forecast (evidence: `src/engine/intel/briefing.ts`)
- Briefing and alerts → Decision clock: uses decisions (evidence: `src/engine/intel/briefing.ts`)
- Briefing view → Decision clock: shows warnings (evidence: `README.md`)
- Chart view → Weather map: renders map (evidence: `src/views/ChartView.tsx`)
- Weather map → Probability cone: renders cone (evidence: `src/map/MapView.tsx`)
- Memory view → Event memory: browses memory (evidence: `src/views/MemoryView.tsx`)
- Memory view → Analog search: shows relatives (evidence: `src/views/MemoryView.tsx`)
- Scenario Lab view → Scenario attribution: runs scenarios (evidence: `src/views/ScenarioView.tsx`)
- Briefing view → Briefing and alerts: presents intelligence (evidence: `README.md`)
- Verification view → Engine worker: requests scores
