# pujo-atlas-kolkata/pujoatlaskol-web architecture

> Architecture diagram of the GitHub repository pujo-atlas-kolkata/pujoatlaskol-web, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pujo-atlas-kolkata/pujoatlaskol-web
- Repository: https://github.com/pujo-atlas-kolkata/pujoatlaskol-web

## Overview

##### Main Components

A. Frontend Layer
- Astro-based frontend architecture with two main layouts:
- Landing Page Layout
- Web App Layout
- Features:
- Pandal Map View
- Search Functionality
- Carousel Components
- Multilingual Support (English/Bengali)

B. State Management Layer
- Stores structure:
- Active Store
- Pujo Store
- Query Store
- Search Store

C. API Integration Layer
- Request handling system
- Hooks structure:
- Location hooks
- Pandal hooks
- Search hooks
- Query hooks (mutations and queries)

D. External Services
- Netlify (Hosting)
- Cloudflare (CDN/DNS)
- Sentry (Error Tracking)
- Google Maps Integration

**┌─────────────────────────────────────────────────────────┐**
- Client Layer                        │
- ┬────────────────┬───────────┬──────────────┤
- Landing    │ Web App        │ Shared    │ Multilingual │
- Components │ Components     │ Components│ Routes       │
- ┴────────────────┴───────────┴──────────────┘
- ↕                    ↕
**┌─────────────────────────────────────────────────────────┐**
- State Management                       │
- ┬────────────────┬───────────┬──────────────┤
- Active     │ Pujo           │ Query     │ Search       │
- Store      │ Store          │ Store     │ Store        │
- ┴────────────────┴───────────┴──────────────┘
- ↕                    ↕
**┌─────────────────────────────────────────────────────────┐**
- Custom Hooks                         │
- ┬────────────────┬───────────┬──────────────┤
- Location   │ Pandal         │ Search    │ Query        │
- Hooks      │ Hooks          │ Hooks     │ Hooks        │
- ┴────────────────┴───────────┴──────────────┘
- ↕                    ↕
**┌─────────────────────────────────────────────────────────┐**
- External Services                      │
- ┬────────────────┬───────────┬──────────────┤
- Netlify    │ Cloudflare     │ Sentry    │ Google Maps  │
- ┴────────────────┴───────────┴──────────────┘

##### Special Features to Highlight

- Search and debounce mechanism
- Map clustering system
- Multilingual routing structure

##### Important Details

- Data flow direction indicators
- Separation between server and client-side code
- Build and deployment pipeline

##### Notes for Implementation

- Keep the abstraction level high enough to be understandable but detailed enough to show the application's complexity
- Use standardized symbols for different types of components
- Notes about the key architectural decisions

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client
        FL[Frontend Layer]
        
        subgraph Layouts
            LPL["Landing Page Layout"]:::frontend
            WAL["Web App Layout"]:::frontend
        end
        
        subgraph Components
            PMV["Pandal Map View"]:::frontend
            SF["Search Functionality"]:::frontend
            CC["Carousel Components"]:::frontend
            PC["Pandal Cards"]:::frontend
        end
        
        subgraph Navigation
            AH["App Header"]:::frontend
            BN["Bottom Navigation"]:::frontend
            MN["Main Navbar"]:::frontend
        end
        
        subgraph "Map Features"
            CM["Cluster Marker"]:::frontend
            LM["Location Marker"]:::frontend
            UL["User Location"]:::frontend
        end
        
        subgraph "Multilingual Routes"
            BR["Bengali Routes"]:::frontend
            ER["English Routes"]:::frontend
        end
    end
    
    subgraph "State Management"
        AS["Active Store"]:::state
        PS["Pujo Store"]:::state
        QS["Query Store"]:::state
        SS["Search Store"]:::state
    end
    
    subgraph "Custom Hooks"
        LH["Location Hooks"]:::hooks
        PH["Pandal Hooks"]:::hooks
        SH["Search Hooks"]:::hooks
        QH["Query Hooks"]:::hooks
    end
    
    subgraph "API and Utils"
        AC["API Constants"]:::api
        RH["Request Handler"]:::api
        TD["Type Definitions"]:::api
    end
    
    subgraph "External Services"
        NF["Netlify"]:::external
        CF["Cloudflare"]:::external
        ST["Sentry"]:::external
        GM["Google Maps"]:::external
    end
    
    %% Relationships
    FL --> Layouts
    FL --> Components
    FL --> Navigation
    Components --> AS
    Components --> PS
    Components --> QS
    Components --> SS
    AS --> LH
    PS --> PH
    QS --> QH
    SS --> SH
    LH --> RH
    PH --> RH
    SH --> RH
    QH --> RH
    RH --> NF
    NF --> CF
    Components --> GM
    FL --> ST
    
    %% Click Events
    click LPL "https://github.com/Pujo-Atlas-Kolkata/PujoAtlasKol-Web/blob/dev/src/layouts/LandingPageLayout.astro"
    click WAL "https://github.com/Pujo-Atlas-Kolkata/PujoAtlasKol-Web/blob/dev/src/layouts/WebAppLayout.astro"
    click PMV "https://github.com/Pujo-Atlas-Kolkata/PujoAtlasKol-Web/blob/dev/src/components/app/map/GoogleMap.tsx"
    click SF "https://github.com/Pujo-Atlas-Kolkata/PujoAtlasKol-Web/tree/dev/src/components/app/shared/Search/"
    click CC "https://github.com/Pujo-Atlas-Kolkata/PujoAtlasKol-Web/tree/dev/src/components/Carousel/"
    click PC "https://github.com/Pujo-Atlas-Kolkata/PujoAtlasKol-Web/tree/dev/src/components/app/home/Cards/"
    click AS "https://github.com/Pujo-Atlas-Kolkata/PujoAtlasKol-Web/blob/dev/src/stores/active/index.ts"
    click PS "https://github.com/Pujo-Atlas-Kolkata/PujoAtlasKol-Web/blob/dev/src/stores/pujo/index.ts"
    click QS "https://github.com/Pujo-Atlas-Kolkata/PujoAtlasKol-Web/blob/dev/src/stores/query/index.ts"
    click SS "https://github.com/Pujo-Atlas-Kolkata/PujoAtlasKol-Web/blob/dev/src/stores/search/index.ts"
    click LH "https://github.com/Pujo-Atlas-Kolkata/PujoAtlasKol-Web/blob/dev/src/hooks/location/useLocation.ts"
    click PH "https://github.com/Pujo-Atlas-Kolkata/PujoAtlasKol-Web/tree/dev/src/hooks/pandals/"
    click SH "https://github.com/Pujo-Atlas-Kolkata/PujoAtlasKol-Web/tree/dev/src/hooks/search/"
    click QH "https://github.com/Pujo-Atlas-Kolkata/PujoAtlasKol-Web/tree/dev/src/hooks/query/"
    click BR "https://github.com/Pujo-Atlas-Kolkata/PujoAtlasKol-Web/tree/dev/src/pages/bn/"
    click ER "https://github.com/Pujo-Atlas-Kolkata/PujoAtlasKol-Web/tree/dev/src/pages/"
    click AC "https://github.com/Pujo-Atlas-Kolkata/PujoAtlasKol-Web/blob/dev/src/constants/api.ts"
    click RH "https://github.com/Pujo-Atlas-Kolkata/PujoAtlasKol-Web/blob/dev/src/libs/request.ts"
    click TD "https://github.com/Pujo-Atlas-Kolkata/PujoAtlasKol-Web/tree/dev/src/types/"
    click CM "https://github.com/Pujo-Atlas-Kolkata/PujoAtlasKol-Web/blob/dev/src/components/app/map/ClusterMarker.tsx"
    click LM "https://github.com/Pujo-Atlas-Kolkata/PujoAtlasKol-Web/blob/dev/src/components/app/map/LocationMarker.tsx"
    click UL "https://github.com/Pujo-Atlas-Kolkata/PujoAtlasKol-Web/blob/dev/src/components/app/map/UserLocation.tsx"
    click AH "https://github.com/Pujo-Atlas-Kolkata/PujoAtlasKol-Web/blob/dev/src/components/app/shared/AppHeader.astro"
    click BN "https://github.com/Pujo-Atlas-Kolkata/PujoAtlasKol-Web/blob/dev/src/components/app/shared/BottomNav.astro"
    click MN "https://github.com/Pujo-Atlas-Kolkata/PujoAtlasKol-Web/blob/dev/src/components/shared/Navbar.tsx"
    
    %% Styles
    classDef frontend fill:#3498db,stroke:#2980b9,color:white
    classDef state fill:#2ecc71,stroke:#27ae60,color:white
    classDef hooks fill:#e67e22,stroke:#d35400,color:white
    classDef api fill:#95a5a6,stroke:#7f8c8d,color:white
    classDef external fill:#9b59b6,stroke:#8e44ad,color:white
```
