# ambujkumar999-cloud/qloapps architecture

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

- Interactive diagram: https://gitdiagram.com/ambujkumar999-cloud/qloapps
- Repository: https://github.com/ambujkumar999-cloud/qloapps

## Overview

QloApps is a hotel reservation system and booking engine. The main guest workflow is to browse hotel and room information, build a cart and place a booking; hotel staff also configure properties and manage bookings through the back office. The graph includes the documented hotel-booking capabilities and core commerce entities. Some connections are based on README descriptions or SOURCE INDEX references; unsampled implementation details are not treated as verified call paths.

Main entry points: [`controllers/front/ProductController.php`](https://github.com/ambujkumar999-cloud/qloapps/blob/develop/controllers/front/ProductController.php) (Hotel storefront), [`classes/Cart.php`](https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/Cart.php) (Cart), [`classes/Product.php`](https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/Product.php) (Products), [`classes/controller/AdminController.php`](https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/controller/AdminController.php) (Admin controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guest["Guest booking"]
  node_storefront["Hotel storefront"]
  node_cart["Cart<br/>[Cart.php]"]
end

subgraph group_domain["Hotel and commerce"]
  node_property["Hotel properties"]
  node_roomtype["Room types<br/>[HotelRoomType.php]"]
  node_product["Products<br/>[Product.php]"]
  node_category["Categories<br/>[Category.php]"]
  node_cart_rules["Cart rules<br/>[CartRule.php]"]
  node_customer["Customers<br/>[Customer.php]"]
  node_order["Orders<br/>[Order.php]"]
  node_payments["Payment options"]
  node_stock["Stock management<br/>[StockManager.php]"]
end

subgraph group_backoffice["Hotel operations"]
  node_hotel_admin["Hotel administration"]
  node_admin["Admin controller"]
  node_module_admin["Module admin"]
  node_modules["Modules<br/>[Module.php]"]
end

subgraph group_platform["Core platform"]
  node_configuration[("Configuration<br/>[Configuration.php]")]
  node_shop["Shop context<br/>[Shop.php]"]
  node_hook["Hook dispatch<br/>[Hook.php]"]
  node_tab["Admin tabs<br/>[Tab.php]"]
  node_validation["Input validation<br/>[Validate.php]"]
  node_collection["Collections"]
end

node_guest(("Guest"))
node_hotel_staff(("Hotel staff"))

node_guest -->|"browses"| node_storefront
node_storefront -->|"loads hotel data"| node_property
node_storefront -->|"loads room data"| node_roomtype
node_storefront -->|"loads products"| node_product
node_storefront -->|"loads categories"| node_category
node_guest -->|"books a stay"| node_cart
node_cart -->|"calculates prices"| node_product
node_cart -->|"applies rules"| node_cart_rules
node_cart -.->|"uses customer"| node_customer
node_cart -.->|"creates booking"| node_order
node_order -.->|"uses payment"| node_payments
node_hotel_staff -->|"configures hotels"| node_hotel_admin
node_hotel_admin -->|"edits properties"| node_property
node_hotel_staff -->|"manages bookings"| node_admin
node_module_admin -->|"extends"| node_admin
node_module_admin -->|"loads tab"| node_tab
node_module_admin -->|"loads module"| node_modules
node_admin -->|"reads settings"| node_configuration
node_admin -->|"checks rights"| node_tab
node_product -->|"reads settings"| node_configuration
node_product -->|"checks stock"| node_stock
node_product -->|"dispatches event"| node_hook
node_property -->|"uses categories"| node_category
node_customer -->|"reads settings"| node_configuration
node_customer -->|"validates dates"| node_validation
node_configuration -->|"resolves shop"| node_shop
node_hook -->|"dispatches modules"| node_modules

click node_storefront "https://github.com/ambujkumar999-cloud/qloapps/blob/develop/controllers/front/ProductController.php"
click node_property "https://github.com/ambujkumar999-cloud/qloapps/blob/develop/modules/hotelreservationsystem/classes/HotelBranchInformation.php"
click node_roomtype "https://github.com/ambujkumar999-cloud/qloapps/blob/develop/modules/hotelreservationsystem/classes/HotelRoomType.php"
click node_product "https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/Product.php"
click node_category "https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/Category.php"
click node_cart "https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/Cart.php"
click node_cart_rules "https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/CartRule.php"
click node_customer "https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/Customer.php"
click node_order "https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/order/Order.php"
click node_payments "https://github.com/ambujkumar999-cloud/qloapps/blob/develop/Core/Business/Payment/Core_Business_Payment_PaymentOption.php"
click node_hotel_admin "https://github.com/ambujkumar999-cloud/qloapps/blob/develop/modules/hotelreservationsystem/controllers/admin/AdminAddHotelController.php"
click node_admin "https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/controller/AdminController.php"
click node_module_admin "https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/controller/ModuleAdminController.php"
click node_modules "https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/module/Module.php"
click node_stock "https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/stock/StockManager.php"
click node_configuration "https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/Configuration.php"
click node_shop "https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/shop/Shop.php"
click node_hook "https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/Hook.php"
click node_tab "https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/Tab.php"
click node_validation "https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/Validate.php"
click node_collection "https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/PrestaShopCollection.php"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_storefront,node_cart toneBlue
class node_property,node_roomtype,node_product,node_category,node_cart_rules,node_customer,node_order,node_payments,node_stock toneAmber
class node_hotel_admin,node_admin,node_module_admin,node_modules toneMint
class node_configuration,node_shop,node_hook,node_tab,node_validation,node_collection toneRose
class node_guest,node_hotel_staff toneIndigo
```

## Components

### Guest booking

- [Hotel storefront](https://github.com/ambujkumar999-cloud/qloapps/blob/develop/controllers/front/ProductController.php): `controllers/front/ProductController.php`
- [Cart](https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/Cart.php): `classes/Cart.php`

### Hotel and commerce

- [Hotel properties](https://github.com/ambujkumar999-cloud/qloapps/blob/develop/modules/hotelreservationsystem/classes/HotelBranchInformation.php): `modules/hotelreservationsystem/classes/HotelBranchInformation.php`
- [Room types](https://github.com/ambujkumar999-cloud/qloapps/blob/develop/modules/hotelreservationsystem/classes/HotelRoomType.php): `modules/hotelreservationsystem/classes/HotelRoomType.php`
- [Products](https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/Product.php): `classes/Product.php`
- [Categories](https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/Category.php): `classes/Category.php`
- [Cart rules](https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/CartRule.php): `classes/CartRule.php`
- [Customers](https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/Customer.php): `classes/Customer.php`
- [Orders](https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/order/Order.php): `classes/order/Order.php`
- [Payment options](https://github.com/ambujkumar999-cloud/qloapps/blob/develop/Core/Business/Payment/Core_Business_Payment_PaymentOption.php): `Core/Business/Payment/Core_Business_Payment_PaymentOption.php`
- [Stock management](https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/stock/StockManager.php): `classes/stock/StockManager.php`

### Hotel operations

- [Hotel administration](https://github.com/ambujkumar999-cloud/qloapps/blob/develop/modules/hotelreservationsystem/controllers/admin/AdminAddHotelController.php): `modules/hotelreservationsystem/controllers/admin/AdminAddHotelController.php`
- [Admin controller](https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/controller/AdminController.php): `classes/controller/AdminController.php`
- [Module admin](https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/controller/ModuleAdminController.php): `classes/controller/ModuleAdminController.php`
- [Modules](https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/module/Module.php): `classes/module/Module.php`

### Core platform

- [Configuration](https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/Configuration.php): `classes/Configuration.php`
- [Shop context](https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/shop/Shop.php): `classes/shop/Shop.php`
- [Hook dispatch](https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/Hook.php): `classes/Hook.php`
- [Admin tabs](https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/Tab.php): `classes/Tab.php`
- [Input validation](https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/Validate.php): `classes/Validate.php`
- [Collections](https://github.com/ambujkumar999-cloud/qloapps/blob/develop/classes/PrestaShopCollection.php): `classes/PrestaShopCollection.php`

### Other components

- **Guest**
- **Hotel staff**

## Connections

- Guest → Hotel storefront: browses (evidence: `README.md`)
- Hotel storefront → Hotel properties: loads hotel data (evidence: `controllers/front/ProductController.php`)
- Hotel storefront → Room types: loads room data (evidence: `controllers/front/ProductController.php`)
- Hotel storefront → Products: loads products (evidence: `controllers/front/ProductController.php`)
- Hotel storefront → Categories: loads categories (evidence: `controllers/front/ProductController.php`)
- Guest → Cart: books a stay (evidence: `README.md`)
- Cart → Products: calculates prices (evidence: `classes/Cart.php`)
- Cart → Cart rules: applies rules (evidence: `classes/Cart.php`)
- Cart → Customers: uses customer (evidence: `classes/Cart.php`)
- Cart → Orders: creates booking (evidence: `classes/Cart.php`)
- Orders → Payment options: uses payment
- Hotel staff → Hotel administration: configures hotels (evidence: `README.md`)
- Hotel administration → Hotel properties: edits properties (evidence: `modules/hotelreservationsystem/controllers/admin/AdminAddHotelController.php`)
- Hotel staff → Admin controller: manages bookings (evidence: `README.md`)
- Module admin → Admin controller: extends (evidence: `classes/controller/ModuleAdminController.php`)
- Module admin → Admin tabs: loads tab (evidence: `classes/controller/ModuleAdminController.php`)
- Module admin → Modules: loads module (evidence: `classes/controller/ModuleAdminController.php`)
- Admin controller → Configuration: reads settings (evidence: `classes/controller/AdminController.php`)
- Admin controller → Admin tabs: checks rights (evidence: `classes/controller/AdminController.php`)
- Products → Configuration: reads settings (evidence: `classes/Product.php`)
- Products → Stock management: checks stock (evidence: `classes/Product.php`)
- Products → Hook dispatch: dispatches event (evidence: `classes/Product.php`)
- Hotel properties → Categories: uses categories (evidence: `modules/hotelreservationsystem/classes/HotelBranchInformation.php`)
- Customers → Configuration: reads settings (evidence: `classes/Customer.php`)
- Customers → Input validation: validates dates (evidence: `classes/Customer.php`)
- Configuration → Shop context: resolves shop (evidence: `classes/Configuration.php`)
- Hook dispatch → Modules: dispatches modules (evidence: `classes/Hook.php`)
