# najibulmiddya/hotelsbooking architecture

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

- Interactive diagram: https://gitdiagram.com/najibulmiddya/hotelsbooking
- Repository: https://github.com/najibulmiddya/hotelsbooking

## Overview

##### Project Type and Purpose
- This is a full-stack web application (“Hotel Booking Portal”) built on PHP using the CodeIgniter 3 MVC framework.
- It serves two user roles:
- Guests (browse rooms, book, pay via Razorpay, view/download receipts)
- Admins (manage rooms, bookings, users, reports, refunds, notifications)

##### File Structure
- Top-level “index.php” is the CI front controller.
- “system/” folder: CodeIgniter core.
- “application/” folder: your app code, organized as MVC.
- application/controllers/Users & Admin
- application/models/…_model.php
- application/views/… (User views, admin views, error pages)
- application/config/ (routes, database, email, memcached, hooks)
- application/third_party/dompdf (PDF lib)
- “assets/”: static CSS/JS/images for frontend & admin UI
- “hotels (1).sql”: MySQL schema dump

##### README Insights
- Tech stack: HTML/CSS/Bootstrap/jQuery; PHP/CI3; MySQL; Razorpay API (cURL); DOMPDF; optional memcached caching.
- Features call out PDF generation, email/SMS notifications, admin dashboard metrics.

a) Main Components
- Client Browser (User & Admin UIs)
- Web Server (Apache/nginx + PHP‐FPM)
- CodeIgniter Application
– Front Controller (index.php)
– Router → Controllers (Users, Admin, Razorpay callback)
– Models (UserModel, BookingModel, RoomModel, etc.)
– Views & Templates
- MySQL Database
- Caching Layer (Memcached, optional)
- External Services
– Razorpay Payment Gateway
– SMTP/Email Service
- Third-Party Library
– DOMPDF for PDF generation
b) Relationships & Data Flows
1. Browser sends HTTP(S) requests → Web Server
2. Web Server invokes CI front controller
3. CI Router dispatches to appropriate controller
4. Controller uses Models to read/write MySQL (via DB driver)
5. Controller calls DOMPDF library to render receipts/reports
6. For payments: Controller issues cURL to Razorpay API → receives callback/webhook → updates DB
7. Controller sends email via CI Email library (SMTP)
8. Cacheable data (e.g., room lists) stored/retrieved from Memcached
9. App writes logs to application/logs
c) Architectural Patterns & Principles
- MVC separation: Controllers orchestrate, Models encapsulate data access, Views handle presentation
- Single Entry Point via front controller
- Dependency injection via CI “libraries” and “helpers”
- Layered design: Presentation → Business Logic → Data Access
- Externalizing configuration (application/config/*.php)
d) Key Technologies & Frameworks
- CodeIgniter 3 core (system/)
- MySQL via CI DB Query Builder
- Memcached session/cache drivers
- Razorpay API (cURL in application/controllers/Razorpay.php)
- DOMPDF (application/third_party/dompdf)
- CI Email library for notifications
- Bootstrap/jQuery for UI

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client Browsers
    UserUI["Client Browser (User UI)"]:::external
    AdminUI["Client Browser (Admin UI)"]:::external

    %% Web Server and CI App
    subgraph "Web Server / CI Application"
        direction TB
        FrontController["index.php (Front Controller)"]:::internal
        HTAccess[".htaccess"]:::internal

        RouterSub["Router"]:::internal
        RouterCore["system/core/Router.php"]:::internal
        RouterConfig["application/config/routes.php"]:::internal

        subgraph "Controllers"
            direction TB
            UsersAbout["About.php"]:::internal
            UsersRooms["Rooms.php"]:::internal
            UsersBookings["Bookings.php"]:::internal
            UsersContact["Contact.php"]:::internal
            UsersFacilities["Facilities.php"]:::internal
            AdminDashboard["Dashboard.php"]:::internal
            AdminBookings["Bookings.php"]:::internal
            AdminRooms["Rooms.php"]:::internal
            AdminFacilities["Facilities.php"]:::internal
            AdminCarousel["Carousel.php"]:::internal
            AdminSettings["Settings.php"]:::internal
            AdminUsers["Users.php"]:::internal
            AdminUsersQueries["Users_queries.php"]:::internal
            AdminAdmin["Admin.php"]:::internal
            RazorpayCtrl["Razorpay.php"]:::internal
            HomeCtrl["Home.php"]:::internal
        end

        subgraph "Models"
            direction TB
            CommonModel["Common_model.php"]:::internal
            AboutModel["About_model.php"]:::internal
            ContactModel["Contact_model.php"]:::internal
            RoomsModel["Rooms_model.php"]:::internal
            CarouselModel["Carousel_model.php"]:::internal
            FacilitiesModel["Facilities_model.php"]:::internal
            SettingsModel["Settings_model.php"]:::internal
            UsersQueriesModel["UsersQueries_model.php"]:::internal
            AdminModel["Admin_model.php"]:::internal
        end

        subgraph "Views & Templates"
            direction TB
            UserViews["application/views/Users/"]:::internal
            AdminViews["application/views/admin/"]:::internal
            RazorpayView["application/views/razorpay/"]:::internal
            ErrorViews["application/views/errors/"]:::internal
        end

        subgraph "Configuration"
            direction TB
            ConfigCore["config.php"]:::internal
            ConfigDB["database.php"]:::internal
            ConfigEmail["email.php"]:::internal
            ConfigCache["memcached.php"]:::internal
            ConfigHooks["hooks.php"]:::internal
            ConfigAutoload["autoload.php"]:::internal
        end

        subgraph "Libraries & Helpers"
            direction TB
            PDFWrapper["application/libraries/pdf.php"]:::internal
            GeneralHelper["General_helper.php"]:::internal
            EmailLib["system/libraries/Email.php"]:::internal
            SessionDriver["Session_memcached_driver.php"]:::internal
            CacheDriver["Cache_memcached.php"]:::internal
        end

        subgraph "Third-Party"
            direction TB
            DOMPDF["application/third_party/dompdf/"]:::internal
        end
    end

    %% Data Stores and Caching
    MySQL["MySQL Database"]:::datastore
    Memcached["Memcached Cache"]:::datastore
    Logs["Application Logs"]:::datastore

    %% External Services
    RazorpayAPI["Razorpay Payment Gateway"]:::external
    SMTP["SMTP / Email Service"]:::external

    %% Flows
    UserUI -->|"HTTP(S) requests"| FrontController
    AdminUI -->|"HTTP(S) requests"| FrontController
    FrontController -->|routes to| RouterSub
    RouterSub -->|dispatches| UsersAbout & UsersRooms & UsersBookings & UsersContact & UsersFacilities & AdminDashboard & AdminBookings & AdminRooms & AdminFacilities & AdminCarousel & AdminSettings & AdminUsers & AdminUsersQueries & AdminAdmin & RazorpayCtrl & HomeCtrl
    Controllers --> Models
    Models -->|CRUD| MySQL
    Controllers -->|generate PDF| DOMPDF
    Controllers -->|send email| SMTP
    Controllers -->|cURL| RazorpayAPI
    Controllers -->|cache data| Memcached
    Controllers -->|read/write| Logs

    %% Click Events
    click FrontController "https://github.com/najibulmiddya/hotelsbooking/blob/master/index.php"
    click HTAccess "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/.htaccess"
    click RouterCore "https://github.com/najibulmiddya/hotelsbooking/blob/master/system/core/Router.php"
    click RouterConfig "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/config/routes.php"
    click UsersAbout "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/controllers/Users/About.php"
    click UsersRooms "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/controllers/Users/Rooms.php"
    click UsersBookings "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/controllers/Users/Bookings.php"
    click UsersContact "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/controllers/Users/Contact.php"
    click UsersFacilities "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/controllers/Users/Facilities.php"
    click AdminDashboard "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/controllers/Admin/Dashboard.php"
    click AdminBookings "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/controllers/Admin/Bookings.php"
    click AdminRooms "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/controllers/Admin/Rooms.php"
    click AdminFacilities "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/controllers/Admin/Facilities.php"
    click AdminCarousel "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/controllers/Admin/Carousel.php"
    click AdminSettings "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/controllers/Admin/Settings.php"
    click AdminUsers "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/controllers/Admin/Users.php"
    click AdminUsersQueries "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/controllers/Admin/Users_queries.php"
    click AdminAdmin "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/controllers/Admin/Admin.php"
    click RazorpayCtrl "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/controllers/Razorpay.php"
    click HomeCtrl "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/controllers/Home.php"
    click CommonModel "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/models/Common_model.php"
    click AboutModel "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/models/Users/About_model.php"
    click ContactModel "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/models/Users/Contact_model.php"
    click RoomsModel "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/models/Admin/Rooms_model.php"
    click CarouselModel "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/models/Admin/Carousel_model.php"
    click FacilitiesModel "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/models/Admin/Facilities_model.php"
    click SettingsModel "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/models/Admin/Settings_model.php"
    click UsersQueriesModel "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/models/Admin/UsersQueries_model.php"
    click AdminModel "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/models/Admin/Admin_model.php"
    click UserViews "https://github.com/najibulmiddya/hotelsbooking/tree/master/application/views/Users/"
    click AdminViews "https://github.com/najibulmiddya/hotelsbooking/tree/master/application/views/admin/"
    click RazorpayView "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/views/razorpay/razorpay_redirect.php"
    click ErrorViews "https://github.com/najibulmiddya/hotelsbooking/tree/master/application/views/errors/html"
    click ConfigCore "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/config/config.php"
    click ConfigDB "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/config/database.php"
    click ConfigEmail "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/config/email.php"
    click ConfigCache "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/config/memcached.php"
    click ConfigHooks "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/config/hooks.php"
    click ConfigAutoload "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/config/autoload.php"
    click DOMPDF "https://github.com/najibulmiddya/hotelsbooking/tree/master/application/third_party/dompdf/"
    click PDFWrapper "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/libraries/pdf.php"
    click GeneralHelper "https://github.com/najibulmiddya/hotelsbooking/blob/master/application/helpers/General_helper.php"
    click EmailLib "https://github.com/najibulmiddya/hotelsbooking/blob/master/system/libraries/Email.php"
    click SessionDriver "https://github.com/najibulmiddya/hotelsbooking/blob/master/system/libraries/Session/drivers/Session_memcached_driver.php"
    click CacheDriver "https://github.com/najibulmiddya/hotelsbooking/blob/master/system/libraries/Cache/drivers/Cache_memcached.php"

    %% Styles
    classDef internal fill:#D0E6FF,stroke:#333,stroke-width:1px
    classDef datastore fill:#D0FFD6,stroke:#333,stroke-width:1px
    classDef external fill:#FFE0B2,stroke:#333,stroke-width:1px
```
