# srinath1987-ops/campuspro architecture

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

- Interactive diagram: https://gitdiagram.com/srinath1987-ops/campuspro
- Repository: https://github.com/srinath1987-ops/campuspro

## Overview

##### Project Type and Purpose
- This is a full-stack, serverless web application (“CampusPro Bus Management System”) that provides real-time bus tracking, student counting, role-based dashboards (Admin, Driver, Student), and reporting.
- Key purpose: streamline campus bus operations by tying together IoT hardware (ESP32 RFID gates), serverless endpoints (Supabase Edge/Functions), a PostgreSQL database, and a React/TypeScript front end.

##### File Structure
Top-level folders:
- “hardware/ESP32_RFID_Gate_Controller” – IoT firmware controlling RFID gate readers.
- “Edge Function/http_bus_entry_exit” & “Edge Function/http_bus_status” – serverless TypeScript functions for handling IoT HTTP callbacks.
- “supabase/functions” mirrors the Edge Functions for deployment under Supabase’s Functions.
- “src/” – React app with subfolders: components, contexts, hooks, integrations (Supabase client + schemas), pages (admin, driver, public), redux (state slices), utils, main.tsx.
- “scripts/create_missing_tables.sql” – DDL for relational schema.
- Configuration: vite.config.ts, tailwind.config.ts, supabase/config.toml.

##### Extract Architectural Insights from README
- Frontend: React + TypeScript + Tailwind, state management via Redux Toolkit.
- Backend: Supabase (PostgreSQL + Auth + Edge Functions).
- Roles and use cases: Admin, Driver, Student.
- Real-time updates (Supabase real-time or polling via Edge Functions).

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Physical Layer
    subgraph "Physical Layer"
        IoT["ESP32 RFID Gate Controller"]:::hardware
    end

    %% Serverless API Layer
    subgraph "Serverless API Layer"
        entry["http_bus_entry_exit"]:::api
        status["http_bus_status"]:::api
    end

    %% Managed Services
    subgraph "Managed Services"
        supa["Supabase Cloud"]:::cloud
        subgraph "Database (PostgreSQL)"
            db["bus_student_count, bus_details, bus_routes, profiles, feedback"]:::db
        end
        auth["Supabase Auth"]:::service
    end

    %% Frontend Layer
    subgraph "Frontend Layer"
        web["React/TypeScript Web App"]:::frontend
        subgraph "Web App Codebase"
            main["src/main.tsx"]:::code
            app["src/App.tsx"]:::code
            subgraph "State Management (Redux)"
                store["src/redux/store.ts"]:::code
                authSlice["src/redux/slices/authSlice.ts"]:::code
                busSlice["src/redux/slices/busSlice.ts"]:::code
                userSlice["src/redux/slices/userSlice.ts"]:::code
                hooks["src/redux/hooks.ts"]:::code
            end
            subgraph "Context Providers"
                authCtx["src/contexts/AuthContext.tsx"]:::code
                cacheCtx["src/contexts/CacheContext.tsx"]:::code
            end
            subgraph "Supabase Integrations"
                client["src/integrations/supabase/client.ts"]:::code
                schemaInt["src/integrations/supabase/schema.sql"]:::code
                types["src/integrations/supabase/types.ts"]:::code
            end
            subgraph "Pages"
                admin["src/pages/admin/Dashboard.tsx"]:::code
                driver["src/pages/driver/Dashboard.tsx"]:::code
                public["src/pages/Index.tsx"]:::code
            end
            subgraph "Components & Utils"
                layout["src/components/MainLayout.tsx"]:::code
                utils["src/utils/apiCache.ts"]:::code
            end
        end
    end

    %% Infrastructure Scripts & Config
    scripts["scripts/create_missing_tables.sql"]:::script
    conf["supabase/config.toml"]:::script

    %% Connections
    IoT -->|POST /entry-exit| entry
    IoT -->|POST /bus-status| status
    entry -->|INSERT/UPDATE bus_student_count| db
    status -->|UPDATE bus_details| db

    web -->|Auth Request| auth
    auth -->|JWT Token| web
    web -->|REST/Realtime Calls| supa
    web -->|SELECT/UPDATE| db
    db -->|Realtime Updates| web

    scripts -->|DDL Bootstrap| db
    conf -->|Configures| auth
    conf -->|Configures| db
    conf -->|Configures| entry
    conf -->|Configures| status

    %% Click Events
    click IoT "https://github.com/srinath1987-ops/campuspro/blob/main/hardware/ESP32_RFID_Gate_Controller/ESP32_RFID_Gate_Controller.ino"
    click entry "https://github.com/srinath1987-ops/campuspro/blob/main/Edge Function/http_bus_entry_exit/index.ts"
    click status "https://github.com/srinath1987-ops/campuspro/blob/main/Edge Function/http_bus_status/index.ts"
    click scripts "https://github.com/srinath1987-ops/campuspro/blob/main/scripts/create_missing_tables.sql"
    click conf "https://github.com/srinath1987-ops/campuspro/blob/main/supabase/config.toml"
    click client "https://github.com/srinath1987-ops/campuspro/blob/main/src/integrations/supabase/client.ts"
    click schemaInt "https://github.com/srinath1987-ops/campuspro/blob/main/src/integrations/supabase/schema.sql"
    click types "https://github.com/srinath1987-ops/campuspro/blob/main/src/integrations/supabase/types.ts"
    click main "https://github.com/srinath1987-ops/campuspro/blob/main/src/main.tsx"
    click app "https://github.com/srinath1987-ops/campuspro/blob/main/src/App.tsx"
    click store "https://github.com/srinath1987-ops/campuspro/blob/main/src/redux/store.ts"
    click authSlice "https://github.com/srinath1987-ops/campuspro/blob/main/src/redux/slices/authSlice.ts"
    click busSlice "https://github.com/srinath1987-ops/campuspro/blob/main/src/redux/slices/busSlice.ts"
    click userSlice "https://github.com/srinath1987-ops/campuspro/blob/main/src/redux/slices/userSlice.ts"
    click hooks "https://github.com/srinath1987-ops/campuspro/blob/main/src/redux/hooks.ts"
    click authCtx "https://github.com/srinath1987-ops/campuspro/blob/main/src/contexts/AuthContext.tsx"
    click cacheCtx "https://github.com/srinath1987-ops/campuspro/blob/main/src/contexts/CacheContext.tsx"

    %% Styles
    classDef hardware fill:#ffe6e6,stroke:#ff6666,stroke-width:1px
    classDef api fill:#e6f0ff,stroke:#3399ff,stroke-width:1px
    classDef service fill:#e6ffe6,stroke:#33cc33,stroke-width:1px
    classDef db fill:#e6ffe6,stroke:#009900,stroke-width:1px
    classDef cloud fill:#f0f8ff,stroke:#3366cc,stroke-width:1px,stroke-dasharray: 5 5
    classDef frontend fill:#fff0f5,stroke:#ff66cc,stroke-width:1px
    classDef script fill:#fff8dc,stroke:#cc9933,stroke-width:1px,stroke-dasharray: 2 2
    classDef code fill:#f5f5f5,stroke:#666666,stroke-width:1px,stroke-dasharray: 1 2
```
