# hardeepsingh980/letsconnect architecture

> Architecture diagram of the GitHub repository hardeepsingh980/letsconnect, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hardeepsingh980/letsconnect
- Repository: https://github.com/hardeepsingh980/letsconnect

## Overview

##### Main Components Structure

a) Frontend Layer (React Application):
- User Interface Modules (Auth, Authenticated, Public views)
- Context Management (User context)
- Component Library
- Calendar Integration

b) Backend Layer (Django):
- Users Service
- Schedule Service
- Public Service
- Authentication System

c) External Services:
- Google Meet Integration
- Google Calendar Integration

##### Component Relationships

- REST API communication between frontend and backend
- External API interactions with Google services
- Database interactions
- Authentication flows

##### Specific Implementation Details

Technical aspects:
- Django's MVT (Model-View-Template) architecture in the backend
- React's component hierarchy in the frontend
- Docker containerization boundary
- Database (SQLite) connection

##### Component Details

Frontend Section:
**[Frontend Container]**
- Public Views
- User Schedule
- Auth Views
- Calendar
- Booking
- Notifications
- Authenticated Views
- Dashboard
- Profile
- Schedule Management
- Shared Components

Backend Section:
**[Backend Container]**
- Users Service
- Profile Management
- Authentication
- Schedule Service
- Slot Management
- Calendar Operations
- Public Service
- Meeting Management
- Notifications

##### Key Flows to Highlight

- User Authentication Flow
- Schedule Creation/Management Flow
- Booking Flow
- Calendar Integration Flow
- Notification System Flow

##### Technical Details to Note

- Django REST framework for API
- React for frontend
- SQLite database
- Docker containerization
- Google Calendar/Meet integration
- Shepherd for guided tours

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph "Legend"
        L1[Frontend Component]:::frontend
        L2[Backend Service]:::backend
        L3[External Service]:::external
        L4[(Database)]:::database
        L5[Authentication]:::auth
    end

    subgraph "Frontend Layer"
        UI[React Application]
        
        subgraph "Views"
            PV["Public Views"]:::frontend
            click PV "https://github.com/Hardeepsingh980/letsconnect/blob/main/frontend/src/ui/public/userSchedule.js"
            AV["Auth Views"]:::frontend
            click AV "https://github.com/Hardeepsingh980/letsconnect/tree/main/frontend/src/ui/auth/"
            AuthV["Authenticated Views"]:::frontend
            click AuthV "https://github.com/Hardeepsingh980/letsconnect/tree/main/frontend/src/ui/authenticated/"
        end

        subgraph "Core Components"
            CL["Component Library"]:::frontend
            click CL "https://github.com/Hardeepsingh980/letsconnect/tree/main/frontend/src/ui/components/"
            UC["User Context"]:::frontend
            click UC "https://github.com/Hardeepsingh980/letsconnect/tree/main/frontend/src/ui/context/User/"
            CI["Calendar Integration"]:::frontend
            click CI "https://github.com/Hardeepsingh980/letsconnect/blob/main/frontend/src/ui/auth/CalendarForPublic.js"
        end

        subgraph "Features"
            DB["Dashboard"]:::frontend
            click DB "https://github.com/Hardeepsingh980/letsconnect/blob/main/frontend/src/ui/authenticated/Dashboard.js"
            PR["Profile"]:::frontend
            click PR "https://github.com/Hardeepsingh980/letsconnect/blob/main/frontend/src/ui/authenticated/Profile.js"
            BS["Booking System"]:::frontend
            click BS "https://github.com/Hardeepsingh980/letsconnect/blob/main/frontend/src/ui/auth/BookSlotModal.js"
            NS["Notification System"]:::frontend
            click NS "https://github.com/Hardeepsingh980/letsconnect/blob/main/frontend/src/ui/auth/NotifyMeModal.js"
        end
    end

    subgraph "Backend Layer"
        API["Django REST API"]

        subgraph "Services"
            US["Users Service"]:::backend
            click US "https://github.com/Hardeepsingh980/letsconnect/tree/main/backend/users/"
            SS["Schedule Service"]:::backend
            click SS "https://github.com/Hardeepsingh980/letsconnect/tree/main/backend/schedule/"
            PS["Public Service"]:::backend
            click PS "https://github.com/Hardeepsingh980/letsconnect/tree/main/backend/public/"
        end

        subgraph "Models"
            PM["Profile Management"]:::backend
            click PM "https://github.com/Hardeepsingh980/letsconnect/blob/main/backend/users/models.py"
            SM["Schedule Management"]:::backend
            click SM "https://github.com/Hardeepsingh980/letsconnect/blob/main/backend/schedule/models.py"
            MM["Meeting Management"]:::backend
            click MM "https://github.com/Hardeepsingh980/letsconnect/blob/main/backend/public/models.py"
        end

        DB1[(SQLite Database)]:::database
    end

    subgraph "External Services"
        GM["Google Meet"]:::external
        GC["Google Calendar"]:::external
    end

    %% Connections
    UI --> API
    API --> DB1
    US --> DB1
    SS --> DB1
    PS --> DB1
    
    CI --> GC
    BS --> GM
    
    %% Service Connections
    US --> PM
    SS --> SM
    PS --> MM

    %% Frontend Feature Connections
    DB --> SS
    PR --> US
    BS --> PS
    NS --> PS

    classDef frontend fill:#3498db,stroke:#2980b9,color:#fff
    classDef backend fill:#2ecc71,stroke:#27ae60,color:#fff
    classDef external fill:#9b59b6,stroke:#8e44ad,color:#fff
    classDef database fill:#f1c40f,stroke:#f39c12,color:#fff
    classDef auth fill:#e74c3c,stroke:#c0392b,color:#fff
```
