# puneethreddyhc/online-shopping-system-advanced architecture

> Architecture diagram of the GitHub repository puneethreddyhc/online-shopping-system-advanced, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/puneethreddyhc/online-shopping-system-advanced
- Repository: https://github.com/puneethreddyhc/online-shopping-system-advanced

## Overview

##### Project type and purpose
- This is a monolithic, full-stack LAMP-style e-commerce web application.
- Purpose: public storefront (browsing products, cart, checkout, orders, reviews) plus an advanced admin console (user management, product CRUD, orders, sales reports).

##### File structure
- Top-level PHP files (index.php, product.php, cart.php, checkout.php, etc.) form the public site.
- “admin/” folder contains a parallel PHP application for administrators, including layout (assets/css, js, scss), page logic (add_products.php, orders.php), and shared includes (admin/includes/db.php).
- Shared configuration: config.php, db.php, database/onlineshop.sql.
- Static assets: css/, js/, img/, product_images/.
- No microservices—single Apache/PHP runtime with MySQL.

##### Main components
A. Clients (Web browsers, mobile)
B. Web Server (Apache + PHP runtime)
– Public module (index.php, cart.php, checkout.php, product.php, review_action.php, etc.)
– Admin module (admin/index.php, admin/add_products.php, admin/orders.php, etc.)
– Shared code (config.php, db.php, common includes, product_images storage)
C. Database Server (MySQL)
– Tables: users, products, orders, order_items, reviews, wishlist, suppliers, etc.
D. External services
– Email SMTP for newsletter/offers (newslettter.php, offersmail.php)
– (Optional) Payment gateway endpoint if integrated in checkout_process.php

##### Relationships and data flows
- Client ←→ Web Server via HTTP/S
– Public HTTP routes → Public module → DB queries → HTML/CSS/JS responses
– Admin HTTP routes (under /admin) → Admin module → DB queries → Admin UI
- Web Server → MySQL over TCP
- Web Server → SMTP server for transactional emails
- File storage: product_images served directly by web server

##### Architectural patterns and design principles
- Monolithic MVC-style with “controller” PHP pages, “view” includes (header.php, footer.php), and simple “model” via db.php abstraction.
- Clear separation of public vs. admin contexts (separate directories, sessions, authentication).
- Reusable shared components: CSS/JS assets, PHP includes for database connection and header/footer.
- Session-based user authentication for both users and admin.

## Diagram (Mermaid)

```mermaid
graph TB
    %% Clients
    subgraph "Clients"
        direction TB
        Browser["Web Browser"]:::client
        Mobile["Mobile App"]:::client
    end

    %% Web Server
    subgraph "Apache + PHP Runtime" 
        direction TB
        %% Public Module
        subgraph "Public Module" 
            direction TB
            Index["index.php"]:::server
            Product["product.php"]:::server
            Products["products.php"]:::server
            Store["store.php"]:::server
            Cart["cart.php"]:::server
            Checkout["checkout.php"]:::server
            CheckoutProcess["checkout_process.php"]:::server
            Review["review.php"]:::server
            ReviewAction["review_action.php"]:::server
            HomeAction["homeaction.php"]:::server
            MyOrders["myorders.php"]:::server
            OrderSuccess["order_successful.php"]:::server
            PaymentSuccess["payment_success.php"]:::server
            Wishlist["wishlist.php"]:::server
        end

        %% Admin Module
        subgraph "Admin Module"
            direction TB
            AdminIndex["admin/admin/index.php"]:::server
            AddProducts["admin/admin/add_products.php"]:::server
            ElectronicList["admin/admin/electroniclist.php"]:::server
            ProductsList["admin/admin/products_list.php"]:::server
            EditProduct["admin/admin/edit_product.php"]:::server
            AdminOrders["admin/admin/orders.php"]:::server
            ManageUser["admin/admin/manageuser.php"]:::server
            AddSuppliers["admin/admin/addsuppliers.php"]:::server
            Activity["admin/admin/activity.php"]:::server
            AdminLogin["admin/login.php"]:::server
            AdminReg["admin/reg.php"]:::server
        end

        %% Shared Includes
        subgraph "Shared Configuration & Includes"
            direction TB
            Config["config.php"]:::server
            DBConfig["db.php"]:::server
            ServerErrors["admin/server/errors.php"]:::server
            ServerIndex["admin/server/server.php"]:::server
            AdminDBInclude["admin/admin/includes/db.php"]:::server
            FooterInclude["admin/admin/footer.php"]:::server
            TopHeader["admin/admin/topheader.php"]:::server
            SideNav["admin/admin/sidenav.php"]:::server
            AdminErrors["admin/admin/errors.php"]:::server
            Header["header.php"]:::server
            Footer["footer.php"]:::server
            Body["body.php"]:::server
            TopHeaderPub["topheader"]:::server
        end

        %% Static Assets
        subgraph "Static Assets & Product Images"
            direction TB
            CSS["css/"]:::folder
            JS["js/"]:::folder
            IMG["img/"]:::folder
            ProductImages["product_images/"]:::folder
            Fonts["fonts/"]:::folder
            AdminAssetsCSS["admin/admin/assets/css/"]:::folder
            AdminAssetsJS["admin/admin/assets/js/"]:::folder
            AdminAssetsImg["admin/admin/assets/img/"]:::folder
            AdminAssetsCSS2["admin/assets/css/"]:::folder
            AdminAssetsJS2["admin/assets/js/"]:::folder
            AdminAssetsImg2["admin/assets/images/"]:::folder
        end
    end

    %% Database
    MySQL["MySQL Database"]:::datastore
    SQLSchema["database/onlineshop.sql"]:::datastore

    %% External Services
    EmailService["SMTP / Email Service"]:::external
    PaymentGateway["Payment Gateway"]:::external

    %% Connections
    Browser -->|"HTTP/S"| Apache
    Mobile -->|"HTTP/S"| Apache
    Apache -->|"TCP 3306"| MySQL
    Apache -->|"Reads schema"| SQLSchema
    Apache -->|"SMTP"| EmailService
    Apache -->|"API call"| PaymentGateway
    Apache -->|"Serves assets"| CSS
    Apache -->|"Serves assets"| JS
    Apache -->|"Serves assets"| IMG
    Apache -->|"Serves images"| ProductImages
    Apache -->|"Serves assets"| Fonts

    %% Click Events
    click Index "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/index.php"
    click Product "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/product.php"
    click Products "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/products.php"
    click Store "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/store.php"
    click Cart "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/cart.php"
    click Checkout "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/checkout.php"
    click CheckoutProcess "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/checkout_process.php"
    click Review "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/review.php"
    click ReviewAction "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/review_action.php"
    click HomeAction "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/homeaction.php"
    click MyOrders "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/myorders.php"
    click OrderSuccess "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/order_successful.php"
    click PaymentSuccess "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/payment_success.php"
    click Wishlist "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/wishlist.php"

    click AdminIndex "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/admin/admin/index.php"
    click AddProducts "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/admin/admin/add_products.php"
    click ElectronicList "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/admin/admin/electroniclist.php"
    click ProductsList "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/admin/admin/products_list.php"
    click EditProduct "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/admin/admin/edit_product.php"
    click AdminOrders "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/admin/admin/orders.php"
    click ManageUser "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/admin/admin/manageuser.php"
    click AddSuppliers "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/admin/admin/addsuppliers.php"
    click Activity "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/admin/admin/activity.php"
    click AdminLogin "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/admin/login.php"
    click AdminReg "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/admin/reg.php"

    click AdminDBInclude "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/admin/admin/includes/db.php"
    click FooterInclude "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/admin/admin/footer.php"
    click TopHeader "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/admin/admin/topheader.php"
    click SideNav "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/admin/admin/sidenav.php"
    click AdminErrors "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/admin/admin/errors.php"

    click Config "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/config.php"
    click DBConfig "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/db.php"
    click ServerIndex "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/admin/server/server.php"
    click ServerErrors "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/admin/server/errors.php"

    click CSS "https://github.com/puneethreddyhc/online-shopping-system-advanced/tree/master/css/"
    click JS "https://github.com/puneethreddyhc/online-shopping-system-advanced/tree/master/js/"
    click IMG "https://github.com/puneethreddyhc/online-shopping-system-advanced/tree/master/img/"
    click ProductImages "https://github.com/puneethreddyhc/online-shopping-system-advanced/tree/master/product_images/"
    click Fonts "https://github.com/puneethreddyhc/online-shopping-system-advanced/tree/master/fonts/"

    click AdminAssetsCSS "https://github.com/puneethreddyhc/online-shopping-system-advanced/tree/master/admin/admin/assets/css/"
    click AdminAssetsJS "https://github.com/puneethreddyhc/online-shopping-system-advanced/tree/master/admin/admin/assets/js/"
    click AdminAssetsImg "https://github.com/puneethreddyhc/online-shopping-system-advanced/tree/master/admin/admin/assets/img/"
    click AdminAssetsCSS2 "https://github.com/puneethreddyhc/online-shopping-system-advanced/tree/master/admin/assets/css/"
    click AdminAssetsJS2 "https://github.com/puneethreddyhc/online-shopping-system-advanced/tree/master/admin/assets/js/"
    click AdminAssetsImg2 "https://github.com/puneethreddyhc/online-shopping-system-advanced/tree/master/admin/assets/images/"

    click SQLSchema "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/database/onlineshop.sql"
    click EmailService "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/newslettter.php"
    click EmailService "https://github.com/puneethreddyhc/online-shopping-system-advanced/blob/master/offersmail.php"

    %% Styles
    classDef client fill:#D0E6FF,stroke:#0366d6,color:#0366d6
    classDef server fill:#D0FFD0,stroke:#228B22
    classDef datastore fill:#FFE0A0,stroke:#FF8C00
    classDef external fill:#F0F0F0,stroke:#808080
    classDef folder fill:#E8E8E8,stroke:#A9A9A9
```
