# kalpanabhaskar/drishti-gdg-app architecture

> Architecture diagram of the GitHub repository kalpanabhaskar/drishti-gdg-app, 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/kalpanabhaskar/drishti-gdg-app
- Repository: https://github.com/kalpanabhaskar/drishti-gdg-app

## Overview

Drishti is an event safety command dashboard: organizers configure or select a video feed, monitor crowd zones and incidents, assess risk, and coordinate announcements and response. The graph follows the evidenced UI-to-service paths and preserves documented monitoring, incident, announcement, mapping, and AI capabilities. Several feature implementations were not excerpted; their nodes use exact component paths from the tree, and uncertain connections are omitted.

Main entry points: [`App.tsx`](https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/App.tsx) (Dashboard App), [`services/hybridVideoAnalysisOrchestrator.ts`](https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/services/hybridVideoAnalysisOrchestrator.ts) (Hybrid Analysis), [`services/firebaseConfig.ts`](https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/services/firebaseConfig.ts) (Firebase Setup), [`services/firestoreService.ts`](https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/services/firestoreService.ts) (Event Data Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Command Dashboard"]
  node_app["Dashboard App<br/>[App.tsx]"]
  node_layout["Navigation Layout<br/>[Layout.tsx]"]
  node_eventmap["Event Map<br/>[EventMap.tsx]"]
  node_riskui["Risk Overlay"]
end

subgraph group_response["Event Response"]
  node_complaints["Complaint Launch"]
  node_emergency["Emergency Overlay"]
end

subgraph group_analysis["Video Intelligence"]
  node_videoinput["Video Source Setup"]
  node_livefeed["Live Feed Player<br/>[LiveFeedPlayer.tsx]"]
  node_hybridpanel["Analysis Panel"]
  node_hybridorch["Hybrid Analysis"]
  node_mediapipe["Frame Detection"]
  node_geminilimited["Rate-Limited Analysis"]
  node_specialist["Specialist Analysis"]
  node_summary["Situational Summary"]
  node_gemini["Gemini Intelligence<br/>[geminiService.ts]"]
  node_grokauto["Automated Insights"]
end

subgraph group_platform["Identity &amp; Data"]
  node_authmodal["Admin Sign-in<br/>[AuthModal.tsx]"]
  node_authservice["Authentication Service<br/>[authService.ts]"]
  node_firebase["Firebase Setup<br/>[firebaseConfig.ts]"]
  node_firestore["Event Data Service"]
  node_firestoredb[("Cloud Firestore")]
  node_firebaseauth["Firebase Auth"]
end

node_organizer(("Organizer"))
node_attendees(("Attendees"))
node_geminiapi["Google Gemini"]
node_grokapi["Grok API"]

node_organizer -->|"uses"| node_app
node_app -->|"renders"| node_layout
node_app -->|"renders"| node_eventmap
node_app -->|"renders"| node_riskui
node_app -->|"renders"| node_videoinput
node_app -->|"renders"| node_livefeed
node_app -->|"renders"| node_summary
node_app -->|"renders"| node_emergency
node_app -->|"renders"| node_authmodal
node_app -->|"renders"| node_complaints
node_app -->|"updates incidents"| node_firestore
node_livefeed -->|"starts analysis"| node_hybridorch
node_hybridpanel -->|"uses"| node_hybridorch
node_hybridorch -->|"detects frames"| node_mediapipe
node_hybridorch -->|"requests analysis"| node_geminilimited
node_hybridorch -->|"requests specialist review"| node_specialist
node_summary -->|"requests summary"| node_gemini
node_emergency -->|"requests assistance"| node_gemini
node_gemini -->|"calls"| node_geminiapi
node_specialist -.->|"optional analysis"| node_grokapi
node_grokauto -->|"automates insights"| node_grokapi
node_attendees -->|"views public dashboard"| node_app
node_attendees -->|"submits concerns"| node_complaints
node_authmodal -.->|"authenticates"| node_authservice
node_authservice -->|"uses auth client"| node_firebase
node_firestore -->|"uses database client"| node_firebase
node_firebase -->|"initializes"| node_firebaseauth
node_firebase -->|"initializes"| node_firestoredb
node_firestore -->|"reads and writes"| node_firestoredb
node_app -.->|"loads event data"| node_firestore

click node_app "https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/App.tsx"
click node_layout "https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/components/Layout.tsx"
click node_eventmap "https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/components/EventMap.tsx"
click node_riskui "https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/components/RiskScoreOverlay.tsx"
click node_videoinput "https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/components/VideoInputManager.tsx"
click node_livefeed "https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/components/LiveFeedPlayer.tsx"
click node_hybridpanel "https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/components/HybridVideoAnalysisPanel.tsx"
click node_hybridorch "https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/services/hybridVideoAnalysisOrchestrator.ts"
click node_mediapipe "https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/services/mediaPipeDetectionService.ts"
click node_geminilimited "https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/services/rateLimitedGeminiService.ts"
click node_specialist "https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/services/specialistAnalysisService.ts"
click node_summary "https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/components/SituationalSummaryPanel.tsx"
click node_gemini "https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/services/geminiService.ts"
click node_grokauto "https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/services/grokAutomationService.ts"
click node_complaints "https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/components/ComplaintLaunch.tsx"
click node_emergency "https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/components/EmergencyOverlay.tsx"
click node_authmodal "https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/components/AuthModal.tsx"
click node_authservice "https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/services/authService.ts"
click node_firebase "https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/services/firebaseConfig.ts"
click node_firestore "https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/services/firestoreService.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_app,node_layout,node_eventmap,node_riskui toneBlue
class node_complaints,node_emergency toneAmber
class node_videoinput,node_livefeed,node_hybridpanel,node_hybridorch,node_mediapipe,node_geminilimited,node_specialist,node_summary,node_gemini,node_grokauto,node_grokapi toneMint
class node_authmodal,node_authservice,node_firebase,node_firestore,node_firestoredb,node_firebaseauth toneRose
class node_organizer,node_attendees,node_geminiapi toneIndigo
```

## Components

### Command Dashboard

- [Dashboard App](https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/App.tsx): `App.tsx`
- [Navigation Layout](https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/components/Layout.tsx): `components/Layout.tsx`
- [Event Map](https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/components/EventMap.tsx): `components/EventMap.tsx`
- [Risk Overlay](https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/components/RiskScoreOverlay.tsx): `components/RiskScoreOverlay.tsx`

### Event Response

- [Complaint Launch](https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/components/ComplaintLaunch.tsx): `components/ComplaintLaunch.tsx`
- [Emergency Overlay](https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/components/EmergencyOverlay.tsx): `components/EmergencyOverlay.tsx`

### Video Intelligence

- [Video Source Setup](https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/components/VideoInputManager.tsx): `components/VideoInputManager.tsx`
- [Live Feed Player](https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/components/LiveFeedPlayer.tsx): `components/LiveFeedPlayer.tsx`
- [Analysis Panel](https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/components/HybridVideoAnalysisPanel.tsx): `components/HybridVideoAnalysisPanel.tsx`
- [Hybrid Analysis](https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/services/hybridVideoAnalysisOrchestrator.ts): `services/hybridVideoAnalysisOrchestrator.ts`
- [Frame Detection](https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/services/mediaPipeDetectionService.ts): `services/mediaPipeDetectionService.ts`
- [Rate-Limited Analysis](https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/services/rateLimitedGeminiService.ts): `services/rateLimitedGeminiService.ts`
- [Specialist Analysis](https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/services/specialistAnalysisService.ts): `services/specialistAnalysisService.ts`
- [Situational Summary](https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/components/SituationalSummaryPanel.tsx): `components/SituationalSummaryPanel.tsx`
- [Gemini Intelligence](https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/services/geminiService.ts): `services/geminiService.ts`
- [Automated Insights](https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/services/grokAutomationService.ts): `services/grokAutomationService.ts`

### Identity & Data

- [Admin Sign-in](https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/components/AuthModal.tsx): `components/AuthModal.tsx`
- [Authentication Service](https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/services/authService.ts): `services/authService.ts`
- [Firebase Setup](https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/services/firebaseConfig.ts): `services/firebaseConfig.ts`
- [Event Data Service](https://github.com/kalpanabhaskar/drishti-gdg-app/blob/main/services/firestoreService.ts): `services/firestoreService.ts`
- **Cloud Firestore**
- **Firebase Auth**

### Other components

- **Organizer**
- **Attendees**
- **Google Gemini**
- **Grok API**

## Connections

- Organizer → Dashboard App: uses (evidence: `README.md`)
- Dashboard App → Navigation Layout: renders (evidence: `App.tsx`)
- Dashboard App → Event Map: renders (evidence: `App.tsx`)
- Dashboard App → Risk Overlay: renders (evidence: `App.tsx`)
- Dashboard App → Video Source Setup: renders (evidence: `App.tsx`)
- Dashboard App → Live Feed Player: renders (evidence: `App.tsx`)
- Dashboard App → Situational Summary: renders (evidence: `App.tsx`)
- Dashboard App → Emergency Overlay: renders (evidence: `App.tsx`)
- Dashboard App → Admin Sign-in: renders (evidence: `App.tsx`)
- Dashboard App → Complaint Launch: renders (evidence: `App.tsx`)
- Dashboard App → Event Data Service: updates incidents (evidence: `App.tsx`)
- Live Feed Player → Hybrid Analysis: starts analysis (evidence: `components/LiveFeedPlayer.tsx`)
- Analysis Panel → Hybrid Analysis: uses (evidence: `components/HybridVideoAnalysisPanel.tsx`)
- Hybrid Analysis → Frame Detection: detects frames (evidence: `services/hybridVideoAnalysisOrchestrator.ts`)
- Hybrid Analysis → Rate-Limited Analysis: requests analysis (evidence: `services/hybridVideoAnalysisOrchestrator.ts`)
- Hybrid Analysis → Specialist Analysis: requests specialist review (evidence: `services/hybridVideoAnalysisOrchestrator.ts`)
- Situational Summary → Gemini Intelligence: requests summary (evidence: `components/SituationalSummaryPanel.tsx`)
- Emergency Overlay → Gemini Intelligence: requests assistance (evidence: `components/EmergencyOverlay.tsx`)
- Gemini Intelligence → Google Gemini: calls (evidence: `services/geminiService.ts`)
- Specialist Analysis → Grok API: optional analysis (evidence: `services/specialistAnalysisService.ts`)
- Automated Insights → Grok API: automates insights (evidence: `services/grokAutomationService.ts`)
- Attendees → Dashboard App: views public dashboard (evidence: `README.md`)
- Attendees → Complaint Launch: submits concerns (evidence: `README.md`)
- Admin Sign-in → Authentication Service: authenticates
- Authentication Service → Firebase Setup: uses auth client (evidence: `services/authService.ts`)
- Event Data Service → Firebase Setup: uses database client (evidence: `services/firestoreService.ts`)
- Firebase Setup → Firebase Auth: initializes (evidence: `services/firebaseConfig.ts`)
- Firebase Setup → Cloud Firestore: initializes (evidence: `services/firebaseConfig.ts`)
- Event Data Service → Cloud Firestore: reads and writes (evidence: `services/firestoreService.ts`)
- Dashboard App → Event Data Service: loads event data (evidence: `App.tsx`)
