# osvaldo-ojeda/ecommerce architecture

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

- Interactive diagram: https://gitdiagram.com/osvaldo-ojeda/ecommerce
- Repository: https://github.com/osvaldo-ojeda/ecommerce

## Overview

##### Project type and purpose
- This is a monolithic, full-stack PHP/MySQL ecommerce application.
- Users browse products, add to a cart, log in/out, and administrators manage categories, products, and users via CRUD pages.

##### File structure
- Top-level PHP scripts (index.php, carrito.php, producto.php, admin*.php, login.php, logout.php) act as controllers/entry points.
- class/ holds model classes: Categoria.php, Producto.php, Usuario.php, and the database connector Conexion.php.
- config/ contains global configuration (config.php) and webserver rules (.htaccess).
- db/ holds the SQL schema/data dump (deBuenaMadera.sql).
- includes/ has reusable view fragments: header.html, nav.php, footer.php, paginador.php.
- css/ and js/ hold static assets (style.css, sweetalert2.js).
- images/ stores product images.
- CRUD form scripts (formAgregar*.php, formModificar*.php, formEliminar*.php) separate views from action scripts (agregar*, modificar*, eliminar*).

##### README for additional insights
- README confirms PHP, SQL, HTML5, and CSS3 stack.

a. Main components
- Users (Browsers/Mobile)
- Web Server (Apache/Nginx + PHP interpreter)
- Presentation Layer (HTML/CSS/JS + includes/)
- Application Layer (Controller scripts + business logic in class/)
- Data Access Layer (Conexion.php + SQL queries in model classes)
- Database (MySQL)
- Static Asset Storage (css/, js/, images/)
b. Relationships & interactions
- User → HTTP request → Web Server
- Web Server routes to PHP controllers (index.php, producto.php, carrito.php, admin*.php, login.php)
- Controllers invoke model classes via Conexion.php to read/write MySQL
- Controllers render views by including header, nav, content templates, and footer
- Static assets served directly (CSS, JS, images)
- Admin controllers perform CRUD via form scripts and redirect or render success/failure via SweetAlert2
c. Architectural patterns & principles
- Separation of concerns:
– Presentation (includes/, css/, js/)
– Controllers (standalone entry-point scripts)
– Models/Data (class/)
- Centralized configuration (config/config.php)
- Single-entry forms for each CRUD operation
- Use of PSR-style autoload or manual includes (if implemented)
d. Key technologies
- PHP 7.x/8.x
- MySQL
- Apache/Nginx with .htaccess
- HTML5, CSS3, SweetAlert2 (client feedback)
- Vanilla JS for dynamic alerts

##### Detail and capturing essentials
- CRUD boundary is shown (forms → action scripts → model calls).
- Config/config.php as a shared dependency for all controllers.
- Includes/ as reusable view fragments loaded by controllers.
- MySQL schema (deBuenaMadera.sql) and the major tables (categorias, productos, usuarios, carrito).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Infrastructure
    Browser["User Browser/Mobile"]:::infra
    WebServer["Web Server\n(Apache/Nginx + PHP)"]:::infra
    ConfigDir["Configuration"]:::infra
    ConfigHtaccess[".htaccess"]:::infra
    ConfigFile["config.php"]:::infra

    %% Presentation Layer
    subgraph "Presentation Layer" 
        direction TB
        Includes["View Templates"]:::frontend
        header["header.html"]:::frontend
        nav["nav.php"]:::frontend
        footer["footer.php"]:::frontend
        paginador["paginador.php"]:::frontend
        StaticAssets["Static Assets"]:::frontend
        css["style.css"]:::frontend
        js["sweetalert2.js"]:::frontend
        images["images/"]:::frontend
    end

    %% Application Layer
    subgraph "Application Layer" 
        direction TB
        Controllers["Controllers"]:::backend
        subgraph "Public Controllers"
            direction TB
            index["index.php"]:::backend
            productos["productos.php"]:::backend
            producto["producto.php"]:::backend
            carrito["carrito.php"]:::backend
            vistaCarrito["vistaCarrito.php"]:::backend
            unoMas["unoMasAlCarrito.php"]:::backend
            quitarCarrito["quitarCarrito.php"]:::backend
            login["login.php"]:::backend
            logout["logout.php"]:::backend
            perfil["perfilUsuario.php"]:::backend
        end
        subgraph "Admin Controllers"
            direction TB
            adminMain["admin.php"]:::backend
            adminCat["adminCategorias.php"]:::backend
            adminProd["adminProductos.php"]:::backend
            adminUsr["adminUsuarios.php"]:::backend
        end
        subgraph "Category CRUD"
            direction TB
            formCatAdd["formAgregarCategoria.php"]:::backend
            formCatMod["formModificarCategoria.php"]:::backend
            formCatDel["formEliminarCategoria.php"]:::backend
            actionCatAdd["agregarCategoria.php"]:::backend
            actionCatMod["modificarCategoria.php"]:::backend
            actionCatDel["eliminarCategoria.php"]:::backend
        end
        subgraph "Product CRUD"
            direction TB
            formProdAdd["formAgregarProducto.php"]:::backend
            formProdMod["formModificarProducto.php"]:::backend
            formProdDel["formEliminarProducto.php"]:::backend
            actionProdAdd["agregarProducto.php"]:::backend
            actionProdMod["modificarProducto.php"]:::backend
            actionProdDel["eliminarProducto.php"]:::backend
        end
        subgraph "User CRUD & Profile"
            direction TB
            formUsrAdd["formAgregarUsuario.php"]:::backend
            formUsrMod["formModificarUsuario.php"]:::backend
            formUsrDel["formEliminarUsuario.php"]:::backend
            formProfileMod["formModificarPerfil.php"]:::backend
            formProfileDel["formEliminarPerfil.php"]:::backend
            actionUsrAdd["agregarUsuario.php"]:::backend
            actionUsrMod["modificarUsuario.php"]:::backend
            actionUsrDel["eliminarUsuario.php"]:::backend
            actionProfileDel["eliminarPerfil.php"]:::backend
        end
    end

    %% Data Access Layer
    subgraph "Data Access Layer" 
        direction TB
        Conexion["Conexion.php"]:::data
        CategoriaClass["Categoria.php"]:::data
        ProductoClass["Producto.php"]:::data
        UsuarioClass["Usuario.php"]:::data
    end

    %% Database
    Database["MySQL Database"]:::infra
    dbDump["deBuenaMadera.sql"]:::infra
    ProjectDoc["README.md"]:::infra

    %% Relationships
    Browser -->|"HTTP Request"| WebServer
    Browser -->|"Requests Static Assets"| StaticAssets
    WebServer --> ConfigDir
    ConfigDir --> ConfigHtaccess
    ConfigDir --> ConfigFile
    WebServer --> Controllers
    Controllers --> Includes
    Controllers --> Conexion
    Controllers --> CategoriaClass
    Controllers --> ProductoClass
    Controllers --> UsuarioClass
    Conexion --> Database
    CategoriaClass --> Conexion
    ProductoClass --> Conexion
    UsuarioClass --> Conexion
    Database --> dbDump
    WebServer --> ProjectDoc

    %% Click Events
    click ConfigHtaccess "https://github.com/osvaldo-ojeda/ecommerce/blob/master/config/.htaccess"
    click ConfigFile "https://github.com/osvaldo-ojeda/ecommerce/blob/master/config/config.php"
    click header "https://github.com/osvaldo-ojeda/ecommerce/blob/master/includes/header.html"
    click nav "https://github.com/osvaldo-ojeda/ecommerce/blob/master/includes/nav.php"
    click footer "https://github.com/osvaldo-ojeda/ecommerce/blob/master/includes/footer.php"
    click paginador "https://github.com/osvaldo-ojeda/ecommerce/blob/master/includes/paginador.php"
    click css "https://github.com/osvaldo-ojeda/ecommerce/blob/master/css/style.css"
    click js "https://github.com/osvaldo-ojeda/ecommerce/blob/master/js/sweetalert2.js"
    click images "https://github.com/osvaldo-ojeda/ecommerce/tree/master/images/"
    click index "https://github.com/osvaldo-ojeda/ecommerce/blob/master/index.php"
    click productos "https://github.com/osvaldo-ojeda/ecommerce/blob/master/productos.php"
    click producto "https://github.com/osvaldo-ojeda/ecommerce/blob/master/producto.php"
    click carrito "https://github.com/osvaldo-ojeda/ecommerce/blob/master/carrito.php"
    click vistaCarrito "https://github.com/osvaldo-ojeda/ecommerce/blob/master/vistaCarrito.php"
    click unoMas "https://github.com/osvaldo-ojeda/ecommerce/blob/master/unoMasAlCarrito.php"
    click quitarCarrito "https://github.com/osvaldo-ojeda/ecommerce/blob/master/quitarCarrito.php"
    click login "https://github.com/osvaldo-ojeda/ecommerce/blob/master/login.php"
    click logout "https://github.com/osvaldo-ojeda/ecommerce/blob/master/logout.php"
    click perfil "https://github.com/osvaldo-ojeda/ecommerce/blob/master/perfilUsuario.php"
    click adminMain "https://github.com/osvaldo-ojeda/ecommerce/blob/master/admin.php"
    click adminCat "https://github.com/osvaldo-ojeda/ecommerce/blob/master/adminCategorias.php"
    click adminProd "https://github.com/osvaldo-ojeda/ecommerce/blob/master/adminProductos.php"
    click adminUsr "https://github.com/osvaldo-ojeda/ecommerce/blob/master/adminUsuarios.php"
    click formCatAdd "https://github.com/osvaldo-ojeda/ecommerce/blob/master/formAgregarCategoria.php"
    click formCatMod "https://github.com/osvaldo-ojeda/ecommerce/blob/master/formModificarCategoria.php"
    click formCatDel "https://github.com/osvaldo-ojeda/ecommerce/blob/master/formEliminarCategoria.php"
    click actionCatAdd "https://github.com/osvaldo-ojeda/ecommerce/blob/master/agregarCategoria.php"
    click actionCatMod "https://github.com/osvaldo-ojeda/ecommerce/blob/master/modificarCategoria.php"
    click actionCatDel "https://github.com/osvaldo-ojeda/ecommerce/blob/master/eliminarCategoria.php"
    click formProdAdd "https://github.com/osvaldo-ojeda/ecommerce/blob/master/formAgregarProducto.php"
    click formProdMod "https://github.com/osvaldo-ojeda/ecommerce/blob/master/formModificarProducto.php"
    click formProdDel "https://github.com/osvaldo-ojeda/ecommerce/blob/master/formEliminarProducto.php"
    click actionProdAdd "https://github.com/osvaldo-ojeda/ecommerce/blob/master/agregarProducto.php"
    click actionProdMod "https://github.com/osvaldo-ojeda/ecommerce/blob/master/modificarProducto.php"
    click actionProdDel "https://github.com/osvaldo-ojeda/ecommerce/blob/master/eliminarProducto.php"
    click formUsrAdd "https://github.com/osvaldo-ojeda/ecommerce/blob/master/formAgregarUsuario.php"
    click formUsrMod "https://github.com/osvaldo-ojeda/ecommerce/blob/master/formModificarUsuario.php"
    click formUsrDel "https://github.com/osvaldo-ojeda/ecommerce/blob/master/formEliminarUsuario.php"
    click formProfileMod "https://github.com/osvaldo-ojeda/ecommerce/blob/master/formModificarPerfil.php"
    click formProfileDel "https://github.com/osvaldo-ojeda/ecommerce/blob/master/formEliminarPerfil.php"
    click actionUsrAdd "https://github.com/osvaldo-ojeda/ecommerce/blob/master/agregarUsuario.php"
    click actionUsrMod "https://github.com/osvaldo-ojeda/ecommerce/blob/master/modificarUsuario.php"
    click actionUsrDel "https://github.com/osvaldo-ojeda/ecommerce/blob/master/eliminarUsuario.php"
    click actionProfileDel "https://github.com/osvaldo-ojeda/ecommerce/blob/master/eliminarPerfil.php"
    click Conexion "https://github.com/osvaldo-ojeda/ecommerce/blob/master/class/Conexion.php"
    click CategoriaClass "https://github.com/osvaldo-ojeda/ecommerce/blob/master/class/Categoria.php"
    click ProductoClass "https://github.com/osvaldo-ojeda/ecommerce/blob/master/class/Producto.php"
    click UsuarioClass "https://github.com/osvaldo-ojeda/ecommerce/blob/master/class/Usuario.php"
    click dbDump "https://github.com/osvaldo-ojeda/ecommerce/blob/master/db/deBuenaMadera.sql"
    click ProjectDoc "https://github.com/osvaldo-ojeda/ecommerce/blob/master/README.md"

    %% Styles
    classDef frontend fill:#D0E8FF,stroke:#409EFF,color:#000
    classDef backend fill:#D0FFD8,stroke:#40C463,color:#000
    classDef data fill:#FFE8A0,stroke:#F49E00,color:#000
    classDef infra fill:#E0E0E0,stroke:#A0A0A0,color:#000
```
