# v-rohith-03/digital-online-queue-management architecture

> Architecture diagram of the GitHub repository v-rohith-03/digital-online-queue-management, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-02-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/v-rohith-03/digital-online-queue-management
- Repository: https://github.com/v-rohith-03/digital-online-queue-management

## Overview

##### Project Type and Purpose
- This is a monolithic LAMP-style web application (PHP + Apache + MySQL) for online queue management.
- Users book or cancel tokens from a browser; admins manage the queue.

##### File Structure Analysis
Top-level:
- README.md – project summary
- database.php – SQL queries for initial DB load
- queue-management/ – all PHP source, CSS and SQL schema
– config.php – DB connection settings
– admin_*.php – admin login/signup/dashboard
– user_*.php – user login/signup/dashboard
– book_*.php, cancel_*.php – business logic for token booking/cancellation
– dashboard.php – shared landing page
– css/style.css – presentation layer
– sql/database.sql – MySQL schema

##### Key Architectural Components
a. Clients (Web browsers)
b. Web Server: Apache on XAMPP running PHP scripts
c. Application Modules (all under queue-management/):
- Authentication module (admin & user signup/login/logout)
- Booking module (book_free_token, book_token, book_token_action)
- Cancellation module (cancel_booking, cancel_token)
- Dashboards (admin_dashboard, dashboard_user, dashboard_admin)
d. Database: MySQL (schema defined in sql/database.sql)

##### Interactions & Data Flows
1. Browser → HTTP request → Apache
2. Apache routes to appropriate PHP script
3. PHP script reads/writes via config.php → MySQL
4. MySQL returns result → PHP renders HTML/CSS → HTTP response → Browser

##### Architectural Patterns & Technologies
- Monolithic PHP: code and views intermixed in .php files
- LAMP stack: Linux/Windows (XAMPP) + Apache + MySQL + PHP
- Separation of concerns by module (auth, booking, cancellation, dashboards)
- Static assets served from css/

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Clients"
        Browser["Web Browser"]:::client
    end

    Browser -->|"HTTP Request"| ApachePHP

    subgraph "Web Server / PHP Application"
        ApachePHP["Apache + PHP (XAMPP)"]:::server

        subgraph "Authentication Module"
            AdminSignup["admin_signup.php"]:::logic
            click AdminSignup "https://github.com/v-rohith-03/digital-online-queue-management/blob/main/queue-management/admin_signup.php"
            AdminLogin["admin_login.php"]:::logic
            click AdminLogin "https://github.com/v-rohith-03/digital-online-queue-management/blob/main/queue-management/admin_login.php"
            AdminLogout["logout.php"]:::logic
            click AdminLogout "https://github.com/v-rohith-03/digital-online-queue-management/blob/main/queue-management/logout.php"
            UserSignup["user_signup.php"]:::logic
            click UserSignup "https://github.com/v-rohith-03/digital-online-queue-management/blob/main/queue-management/user_signup.php"
            UserLogin["user_login.php"]:::logic
            click UserLogin "https://github.com/v-rohith-03/digital-online-queue-management/blob/main/queue-management/user_login.php"
            UserLogout["user_logout.php"]:::logic
            click UserLogout "https://github.com/v-rohith-03/digital-online-queue-management/blob/main/queue-management/user_logout.php"
        end

        subgraph "Booking Module"
            BookFree["book_free_token.php"]:::logic
            click BookFree "https://github.com/v-rohith-03/digital-online-queue-management/blob/main/queue-management/book_free_token.php"
            BookToken["book_token.php"]:::logic
            click BookToken "https://github.com/v-rohith-03/digital-online-queue-management/blob/main/queue-management/book_token.php"
            BookAction["book_token_action.php"]:::logic
            click BookAction "https://github.com/v-rohith-03/digital-online-queue-management/blob/main/queue-management/book_token_action.php"
        end

        subgraph "Cancellation Module"
            CancelBooking["cancel_booking.php"]:::logic
            click CancelBooking "https://github.com/v-rohith-03/digital-online-queue-management/blob/main/queue-management/cancel_booking.php"
            CancelToken["cancel_token.php"]:::logic
            click CancelToken "https://github.com/v-rohith-03/digital-online-queue-management/blob/main/queue-management/cancel_token.php"
        end

        subgraph "Dashboard Module"
            SharedDash["dashboard.php / index.php"]:::presentation
            click SharedDash "https://github.com/v-rohith-03/digital-online-queue-management/blob/main/queue-management/dashboard.php"
            click SharedDash "https://github.com/v-rohith-03/digital-online-queue-management/blob/main/queue-management/index.php"

            subgraph "Admin Dashboards"
                DashboardAdmin["dashboard_admin.php"]:::presentation
                click DashboardAdmin "https://github.com/v-rohith-03/digital-online-queue-management/blob/main/queue-management/dashboard_admin.php"
                AdminDash["admin_dashboard.php"]:::presentation
                click AdminDash "https://github.com/v-rohith-03/digital-online-queue-management/blob/main/queue-management/admin_dashboard.php"
                AdminTypo["admin_dashbard.php"]:::presentation
                click AdminTypo "https://github.com/v-rohith-03/digital-online-queue-management/blob/main/queue-management/admin_dashbard.php"
            end

            subgraph "User Dashboards"
                DashboardUser["dashboard_user.php"]:::presentation
                click DashboardUser "https://github.com/v-rohith-03/digital-online-queue-management/blob/main/queue-management/dashboard_user.php"
                UserDash["user_dashboard.php"]:::presentation
                click UserDash "https://github.com/v-rohith-03/digital-online-queue-management/blob/main/queue-management/user_dashboard.php"
            end
        end

        Config["config.php"]:::server
        click Config "https://github.com/v-rohith-03/digital-online-queue-management/blob/main/queue-management/config.php"
    end

    ApachePHP -->|"routes to modules"| AdminSignup
    ApachePHP --> UserSignup
    ApachePHP --> BookFree
    ApachePHP --> CancelBooking
    ApachePHP --> SharedDash
    ApachePHP --> Config

    AdminSignup -->|"queries via config"| MySQL
    UserSignup -->|"queries via config"| MySQL
    BookFree -->|"queries via config"| MySQL
    BookToken -->|"queries via config"| MySQL
    BookAction -->|"queries via config"| MySQL
    CancelBooking -->|"queries via config"| MySQL
    CancelToken -->|"queries via config"| MySQL

    MySQL -->|"results via config"| AdminSignup
    MySQL --> UserSignup
    MySQL --> BookFree
    MySQL --> BookToken
    MySQL --> CancelBooking
    MySQL --> CancelToken

    ApachePHP -->|"HTTP Response (HTML/CSS)"| Browser

    subgraph "Database Server"
        MySQL[(MySQL DB)]:::persistence
    end

    subgraph "Static Assets"
        CSS["style.css"]:::presentation
        click CSS "https://github.com/v-rohith-03/digital-online-queue-management/blob/main/queue-management/css/style.css"
    end

    ApachePHP -->|"serves CSS"| CSS

    subgraph "Database Setup"
        Loader["database.php"]:::server
        click Loader "https://github.com/v-rohith-03/digital-online-queue-management/blob/main/database.php"
        Schema["database.sql"]:::persistence
        click Schema "https://github.com/v-rohith-03/digital-online-queue-management/blob/main/queue-management/sql/database.sql"
        Loader -->|"imports schema"| Schema
        Loader -->|"populates"| MySQL
    end

    classDef client fill:#a2d2ff,stroke:#333,stroke-width:1px;
    classDef server fill:#dee2e6,stroke:#333,stroke-width:1px;
    classDef logic fill:#d8f3dc,stroke:#333,stroke-width:1px;
    classDef presentation fill:#bde0fe,stroke:#333,stroke-width:1px;
    classDef persistence fill:#ffd6a5,stroke:#333,stroke-width:1px;
```
