# satishvudata98/admin-panel architecture

> Architecture diagram of the GitHub repository satishvudata98/admin-panel, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-23). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/satishvudata98/admin-panel
- Repository: https://github.com/satishvudata98/admin-panel

## Overview

##### Project type and purpose
- This is a full-stack web application (“Admin Panel”) composed of:
- A React/JavaScript single-page application (frontend)
- A Node.js/Express REST API (backend)
- A database layer (via Supabase client or another RDBMS)
- Purpose: user registration, login, and access to protected routes. Frontend holds user state in context, backend issues and validates JWTs, and persists user data.

##### File structure
- Top-level directories:
- backend/
- frontend/
- backend/config contains database (db.js), JWT (jwtConfig.js), and Supabase client setup.
- backend/controllers routes business logic for authentication.
- backend/routes maps REST endpoints (/auth/register, /auth/login).
- frontend/src/api contains Axios wrapper (axios.js).
- frontend/src/context holds UserContext for global user state.
- frontend/src/components holds login, registration, protected-route, navigation, home view.

##### README
- Confirms React frontend on port 3000, Express backend on port 5000.
- Authentication, JWT, REST API, protected routes.
- Development & deployment instructions.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Frontend Layer
    subgraph "Frontend (React SPA)"
        direction TB
        Browser("User Browser/Client"):::external
        ReactApp["React App"]:::frontend
        UserContext["UserContext"]:::frontend
        Login["Login Component"]:::frontend
        Registration["Registration Component"]:::frontend
        Home["Home Component"]:::frontend
        ProtectedRoute["ProtectedRoute Component"]:::frontend
        AxiosNavigator["AxiosNavigator (wraps API calls)"]:::frontend
        AxiosClient["axios.js"]:::frontend
    end

    %% Backend Layer
    subgraph "Backend (Express API)"
        direction TB
        ExpressServer["Express Server\n(index.js)"]:::backend
        AuthRoutes["Auth Routes (/auth)"]:::backend
        AuthController["Auth Controller\n(register, login, verify)"]:::backend
        JWTMiddleware["JWT Middleware\n(jwtConfig.js)"]:::backend
        SupabaseClient["Supabase Client\n(supabaseClient.js)"]:::backend
        DBConfig["DB Config (db.js)"]:::backend
    end

    %% Data Layer
    Database["PostgreSQL Database\n(Supabase)"]:::database
    ExternalAuth["Supabase Auth Service"]:::external

    %% Interactions
    Browser -->|"loads SPA"| ReactApp
    ReactApp -->|"provides context"| UserContext
    ReactApp --> Login
    ReactApp --> Registration
    ReactApp --> Home
    ReactApp --> ProtectedRoute
    Login -->|"dispatch login action"| AxiosNavigator
    Registration -->|"dispatch register action"| AxiosNavigator
    ProtectedRoute -->|"checks JWT in context"| UserContext
    AxiosNavigator -->|"calls axios client"| AxiosClient
    AxiosClient -->|"POST /auth/login or /auth/register"| AuthRoutes
    AuthRoutes -->|"forwards request"| AuthController
    AuthController -->|"read/write users"| DBConfig
    AuthController -->|"use client"| SupabaseClient
    AuthController -->|"generate/verify JWT"| JWTMiddleware
    AuthController -->|"returns {token, user}"| AxiosNavigator
    AxiosNavigator -->|"stores token"| UserContext
    ProtectedRoute -->|"on API call including token"| AxiosNavigator
    AxiosNavigator -->|"Authorization: Bearer <JWT>"| AuthRoutes
    AuthRoutes -->|"verifies token"| JWTMiddleware
    JWTMiddleware --> AuthController
    AuthController -->|"access data"| Database
    %% External auth
    AuthController -->|"optionally use"| ExternalAuth

    %% Click Events
    click ReactApp "https://github.com/satishvudata98/admin-panel/tree/main/frontend/"
    click Login "https://github.com/satishvudata98/admin-panel/blob/main/frontend/src/components/Login.jsx"
    click Registration "https://github.com/satishvudata98/admin-panel/blob/main/frontend/src/components/Registration.jsx"
    click Home "https://github.com/satishvudata98/admin-panel/blob/main/frontend/src/components/Home.jsx"
    click ProtectedRoute "https://github.com/satishvudata98/admin-panel/blob/main/frontend/src/components/ProtectedRoute.jsx"
    click AxiosNavigator "https://github.com/satishvudata98/admin-panel/blob/main/frontend/src/components/AxiosNavigator.jsx"
    click AxiosClient "https://github.com/satishvudata98/admin-panel/blob/main/frontend/src/api/axios.js"
    click UserContext "https://github.com/satishvudata98/admin-panel/blob/main/frontend/src/context/UserContext.jsx"
    click ExpressServer "https://github.com/satishvudata98/admin-panel/blob/main/backend/index.js"
    click AuthRoutes "https://github.com/satishvudata98/admin-panel/blob/main/backend/routes/authRoutes.js"
    click AuthController "https://github.com/satishvudata98/admin-panel/blob/main/backend/controllers/authController.js"
    click JWTMiddleware "https://github.com/satishvudata98/admin-panel/blob/main/backend/config/jwtConfig.js"
    click SupabaseClient "https://github.com/satishvudata98/admin-panel/blob/main/backend/config/supabaseClient.js"
    click DBConfig "https://github.com/satishvudata98/admin-panel/blob/main/backend/config/db.js"

    %% Styles
    classDef frontend fill:#D0E7FF,stroke:#0366D6,color:#000
    classDef backend fill:#DFFFE0,stroke:#28A745,color:#000
    classDef database fill:#FFE8A1,stroke:#E36C09,color:#000
    classDef external fill:#E8E8E8,stroke:#666,color:#000
```
