# keerathan-dilip/enhancing-security-and-efficiency-of-ad-hoc-network-during-disaster-via-ai architecture

> Architecture diagram of the GitHub repository keerathan-dilip/enhancing-security-and-efficiency-of-ad-hoc-network-during-disaster-via-ai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/keerathan-dilip/enhancing-security-and-efficiency-of-ad-hoc-network-during-disaster-via-ai
- Repository: https://github.com/keerathan-dilip/enhancing-security-and-efficiency-of-ad-hoc-network-during-disaster-via-ai

## Overview

##### Project type and purpose
- This is a single-page web application written in React + TypeScript and bundled with Vite.
- Purpose: an AI-driven “studio” for building, visualizing, and analyzing network topologies and code snippets, leveraging Google Gemini and custom algorithms (pathfinding, network analysis, code generation).

##### File structure
- Top level:
- App.tsx, index.tsx, index.html → entry points and root.
- package.json, tsconfig.json, vite.config.ts → build and configuration.
- .env.local (.gitignore’d) holds GEMINI_API_KEY for external AI calls.
- /components: All UI panels and views (CodeEditorWorkspace, VisualBuilderWorkspace, Panels, Canvas, Toolbar, etc.).
- /services: Business-logic layer: codeGenerationService, geminiService (wraps Gemini API), networkAnalysisService, pathfindingService.
- constants.ts, types.ts, metadata.json define shared types, constants, and metadata.

##### README
- Confirms it’s a client-side app to run locally, driven by environment variables and external AI API.
- No internal backend—services call out to Gemini and run in-browser algorithms.

##### Final advice
- Be exhaustive: break the UI into its major sub-panels and workspaces.
- Four services as distinct processing components.
- External Gemini API as a separate system requiring an API key.
- Build artifacts (Vite, .env.local) to show how the app is configured and launched.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Entry Points
    subgraph "Entry Points" 
        HTML["index.html"]:::entry
        IDX["index.tsx"]:::entry
        APP["App.tsx"]:::entry
    end

    %% Presentation Layer
    subgraph "Presentation Layer" 
        WS["WorkspaceSwitcher"]:::frontend
        TB["Toolbar"]:::frontend
        CE["CodeEditorWorkspace"]:::frontend
        VB["VisualBuilderWorkspace"]:::frontend
        NC["NetworkCanvas"]:::frontend
        AI["AIInsightsPanel"]:::frontend
        CA["CodeAnalysisPanel"]:::frontend
        CP["ConnectionPanel"]:::frontend
        IP["IPConfigurationPanel"]:::frontend
        PR["PropertiesPanel"]:::frontend
        PL["PacketDeliveryLogPanel"]:::frontend
        RD["ReportDashboardPanel"]:::frontend
        CD["CodeDisplayHelper"]:::frontend
        NI["NetworkNodeIcon"]:::frontend
    end

    %% Services Layer
    subgraph "Services Layer"
        GEM["geminiService"]:::service
        CG["codeGenerationService"]:::service
        NA["networkAnalysisService"]:::service
        PF["pathfindingService"]:::service
    end

    %% External Systems
    subgraph "External Systems"
        GG["Google Gemini API"]:::external
    end

    %% Build & Config
    subgraph "Build & Config"
        PKG["package.json"]:::config
        VITE["vite.config.ts"]:::config
        TS["tsconfig.json"]:::config
        ENV[".env.local"]:::config
        CONST["constants.ts"]:::config
        TYPES["types.ts"]:::config
        META["metadata.json"]:::config
    end

    %% User Flow
    User["User"] -->|"loads"| HTML
    HTML -->|"boots React"| IDX
    IDX -->|"renders root"| APP
    APP -->|"renders UI components"| WS
    APP --> TB
    APP --> CE
    APP --> VB
    APP --> NC
    APP --> AI
    APP --> CA
    APP --> CP
    APP --> IP
    APP --> PR
    APP --> PL
    APP --> RD
    APP --> CD
    APP --> NI

    %% UI to Services interactions
    CE -->|"invoke codeGenService.generate()"| CG
    CG -->|"calls geminiService.request()"| GEM
    GEM -->|"API key from .env.local"| GG
    GEM -->|"returns AI response"| CG
    CG -->|"returns code snippet"| CE

    VB -->|"invoke codeGenService.generate()"| CG
    VB -->|"invoke networkAnalysisService.analyze()"| NA
    NC -->|"invoke pathfindingService.findPath()"| PF

    NA -->|"returns analysis data"| VB
    PF -->|"returns path data"| NC

    AI -->|"invoke geminiService.request()"| GEM
    CA -->|"invoke geminiService.request()"| GEM

    %% Build & Config links
    HTML -->|"template"| VITE
    IDX -->|"tsconfig settings"| TS
    VITE -->|"build scripts"| PKG
    ENV -.->|"env vars"| GEM

    %% Click Events
    click HTML "https://github.com/keerathan-dilip/enhancing-security-and-efficiency-of-ad-hoc-network-during-disaster-via-ai/blob/main/index.html"
    click IDX "https://github.com/keerathan-dilip/enhancing-security-and-efficiency-of-ad-hoc-network-during-disaster-via-ai/blob/main/index.tsx"
    click APP "https://github.com/keerathan-dilip/enhancing-security-and-efficiency-of-ad-hoc-network-during-disaster-via-ai/blob/main/App.tsx"
    click WS "https://github.com/keerathan-dilip/enhancing-security-and-efficiency-of-ad-hoc-network-during-disaster-via-ai/blob/main/components/WorkspaceSwitcher.tsx"
    click TB "https://github.com/keerathan-dilip/enhancing-security-and-efficiency-of-ad-hoc-network-during-disaster-via-ai/blob/main/components/Toolbar.tsx"
    click CE "https://github.com/keerathan-dilip/enhancing-security-and-efficiency-of-ad-hoc-network-during-disaster-via-ai/blob/main/components/CodeEditorWorkspace.tsx"
    click VB "https://github.com/keerathan-dilip/enhancing-security-and-efficiency-of-ad-hoc-network-during-disaster-via-ai/blob/main/components/VisualBuilderWorkspace.tsx"
    click NC "https://github.com/keerathan-dilip/enhancing-security-and-efficiency-of-ad-hoc-network-during-disaster-via-ai/blob/main/components/NetworkCanvas.tsx"
    click AI "https://github.com/keerathan-dilip/enhancing-security-and-efficiency-of-ad-hoc-network-during-disaster-via-ai/blob/main/components/AIInsightsPanel.tsx"
    click CA "https://github.com/keerathan-dilip/enhancing-security-and-efficiency-of-ad-hoc-network-during-disaster-via-ai/blob/main/components/CodeAnalysisPanel.tsx"
    click CP "https://github.com/keerathan-dilip/enhancing-security-and-efficiency-of-ad-hoc-network-during-disaster-via-ai/blob/main/components/ConnectionPanel.tsx"
    click IP "https://github.com/keerathan-dilip/enhancing-security-and-efficiency-of-ad-hoc-network-during-disaster-via-ai/blob/main/components/IPConfigurationPanel.tsx"
    click PR "https://github.com/keerathan-dilip/enhancing-security-and-efficiency-of-ad-hoc-network-during-disaster-via-ai/blob/main/components/PropertiesPanel.tsx"
    click PL "https://github.com/keerathan-dilip/enhancing-security-and-efficiency-of-ad-hoc-network-during-disaster-via-ai/blob/main/components/PacketDeliveryLog.tsx"
    click RD "https://github.com/keerathan-dilip/enhancing-security-and-efficiency-of-ad-hoc-network-during-disaster-via-ai/blob/main/components/ReportDashboard.tsx"
    click CD "https://github.com/keerathan-dilip/enhancing-security-and-efficiency-of-ad-hoc-network-during-disaster-via-ai/blob/main/components/CodeDisplay.tsx"
    click NI "https://github.com/keerathan-dilip/enhancing-security-and-efficiency-of-ad-hoc-network-during-disaster-via-ai/blob/main/components/NodeIcon.tsx"
    click GEM "https://github.com/keerathan-dilip/enhancing-security-and-efficiency-of-ad-hoc-network-during-disaster-via-ai/blob/main/services/geminiService.ts"
    click CG "https://github.com/keerathan-dilip/enhancing-security-and-efficiency-of-ad-hoc-network-during-disaster-via-ai/blob/main/services/codeGenerationService.ts"
    click NA "https://github.com/keerathan-dilip/enhancing-security-and-efficiency-of-ad-hoc-network-during-disaster-via-ai/blob/main/services/networkAnalysisService.ts"
    click PF "https://github.com/keerathan-dilip/enhancing-security-and-efficiency-of-ad-hoc-network-during-disaster-via-ai/blob/main/services/pathfindingService.ts"
    click CONST "https://github.com/keerathan-dilip/enhancing-security-and-efficiency-of-ad-hoc-network-during-disaster-via-ai/blob/main/constants.ts"
    click TYPES "https://github.com/keerathan-dilip/enhancing-security-and-efficiency-of-ad-hoc-network-during-disaster-via-ai/blob/main/types.ts"
    click META "https://github.com/keerathan-dilip/enhancing-security-and-efficiency-of-ad-hoc-network-during-disaster-via-ai/blob/main/metadata.json"
    click PKG "https://github.com/keerathan-dilip/enhancing-security-and-efficiency-of-ad-hoc-network-during-disaster-via-ai/blob/main/package.json"
    click VITE "https://github.com/keerathan-dilip/enhancing-security-and-efficiency-of-ad-hoc-network-during-disaster-via-ai/blob/main/vite.config.ts"
    click TS "https://github.com/keerathan-dilip/enhancing-security-and-efficiency-of-ad-hoc-network-during-disaster-via-ai/blob/main/tsconfig.json"
    click ENV "https://github.com/keerathan-dilip/enhancing-security-and-efficiency-of-ad-hoc-network-during-disaster-via-ai/blob/main/.env.local"

    %% Styles
    classDef frontend fill:#D0E8FF,stroke:#0288D1;
    classDef service fill:#E0F2F1,stroke:#004D40;
    classDef external fill:#FFE0B2,stroke:#E65100;
    classDef config fill:#EEEEEE,stroke:#757575;
    classDef entry fill:#F3E5F5,stroke:#6A1B9A;
```
