# agustinalopez23/proyectoliceo architecture

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

- Interactive diagram: https://gitdiagram.com/agustinalopez23/proyectoliceo
- Repository: https://github.com/agustinalopez23/proyectoliceo

## Overview

##### Project Type and Purpose
- ProyectoLiceo is a LAMP-style, monolithic web application (PHP, Apache, MySQL).
- Features: user registration/login, session management, CRUD blog (artículos), likes, room/resource reservations, email confirmations.

##### File Structure
- Entry points and views: `ProyectoLiceo.php`, `blog.php`, `articulo.php`, `admin_blog.php`, `login.php`, `registro.php`, `panel_usuario.php`, etc.
- Controllers/processors: `procesar_login.php`, `procesar_registro.php`, `procesar_articulo.php`, `procesar_like.php`, `procesar_reserva.php`, etc.
- Shared modules: `conexion.php` (DB connection), `send_email.php` (wrapper around PHPMailer).
- Static assets: `styles.css`, `scripts.js`, `/imagenes`.
- Third-party library: `phpmailer/PHPMailer-master` for SMTP email.
- Configuration: `.htaccess` (URL rewriting, access rules).

##### Main Components and Their Relationships
A. Client Browser
– Sends HTTP/HTTPS requests for pages, assets, form submissions.
– Runs `scripts.js`, applies `styles.css`.
B. Web Server (Apache + PHP)
– Hosts all `.php` files.
– Routes incoming URLs via `.htaccess`.
– Static requests served directly from file system (`/imagenes`, `styles.css`, `scripts.js`).
– PHP scripts split into:
- **Views**: template pages (e.g., `blog.php`, `registro.php`).
- **Controllers**: `procesar_*.php` scripts that validate input, call the model, redirect back to views.
- **Model**: `conexion.php` + inline SQL queries in controllers.
C. Database (MySQL or MariaDB)
– Stores users, articles, likes, reservations.
– Accessed via `conexion.php`.
D. File System / Storage
– `/imagenes`: uploaded images for articles, user avatars, etc.
E. External Services
– SMTP Email Server (via PHPMailer) for sending confirmation emails (`send_email.php` → `phpmailer` classes → SMTP host).

##### Architectural Patterns and Design Principles
- MVC-inspired separation:
– **Model**: `conexion.php` + SQL calls.
– **View**: PHP pages combining HTML/CSS/JS.
– **Controller**: process scripts.
- Single monolithic codebase—no microservices or separate API layer.
- Use of a well-known mailing library (PHPMailer) for extensibility and security.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client-side
    subgraph "Client Browser"
        Browser["Client Browser"]:::client
        Scripts["scripts.js"]:::client
        Styles["styles.css"]:::client
    end

    %% Server-side Application
    subgraph "Web Server (Apache + PHP)"
        WebServerNode["Apache + PHP"]:::server

        subgraph "View Layer"
            ProyectoLiceo["ProyectoLiceo.php"]:::server
            Blog["blog.php"]:::server
            Articulo["articulo.php"]:::server
            AdminBlog["admin_blog.php"]:::server
            Login["login.php"]:::server
            Registro["registro.php"]:::server
            PanelUsuario["panel_usuario.php"]:::server
            PublicarArticulo["publicar_articulo.php"]:::server
            EditarArticulo["editar_articulo.php"]:::server
            EliminarArticulo["eliminar_articulo.php"]:::server
            ConfirmacionReserva["confirmacion_reserva.php"]:::server
            CerrarSesion["cerrar_sesion.php"]:::server
        end

        subgraph "Controller Layer"
            ProcesarLogin["procesar_login.php"]:::server
            ProcesarRegistro["procesar_registro.php"]:::server
            ProcesarArticulo["procesar_articulo.php"]:::server
            ProcesarPublicarArticulo["procesar_publicar_articulo.php"]:::server
            ProcesarEditarArticulo["procesar_editar_articulo.php"]:::server
            ProcesarLike["procesar_like.php"]:::server
            ProcesarReserva["procesar_reserva.php"]:::server
        end

        subgraph "Model Layer"
            Conexion["conexion.php"]:::server
        end

        subgraph "Email Notification Module"
            SendEmail["send_email.php"]:::server
            subgraph "PHPMailer Library"
                PHPMailerLib["PHPMailer-master/"]:::server
            end
        end
    end

    %% Storage and External
    Database["MySQL Database"]:::storage
    FileSystem["File System (/imagenes)"]:::storage
    SMTP["SMTP Server"]:::external

    %% Data Flows
    Browser -->|"HTTP GET/POST"| WebServerNode
    WebServerNode -->|"routes via .htaccess"| ProyectoLiceo
    WebServerNode -->|"renders views"| Blog
    WebServerNode -->|"renders views"| Articulo
    WebServerNode -->|"renders views"| Login
    WebServerNode -->|"renders views"| Registro
    WebServerNode -->|"renders views"| PanelUsuario
    WebServerNode -->|"renders views"| AdminBlog
    WebServerNode -->|"renders views"| PublicarArticulo
    WebServerNode -->|"renders views"| EditarArticulo
    WebServerNode -->|"renders views"| EliminarArticulo
    WebServerNode -->|"renders views"| ConfirmacionReserva
    WebServerNode -->|"renders views"| CerrarSesion

    WebServerNode -->|"calls controllers"| ProcesarLogin
    WebServerNode -->|"calls controllers"| ProcesarRegistro
    WebServerNode -->|"calls controllers"| ProcesarArticulo
    WebServerNode -->|"calls controllers"| ProcesarPublicarArticulo
    WebServerNode -->|"calls controllers"| ProcesarEditarArticulo
    WebServerNode -->|"calls controllers"| ProcesarLike
    WebServerNode -->|"calls controllers"| ProcesarReserva

    ProcesarLogin -->|"SQL queries via conexion.php"| Conexion
    ProcesarRegistro -->|"SQL queries via conexion.php"| Conexion
    ProcesarArticulo -->|"SQL queries via conexion.php"| Conexion
    ProcesarPublicarArticulo -->|"SQL queries via conexion.php"| Conexion
    ProcesarEditarArticulo -->|"SQL queries via conexion.php"| Conexion
    ProcesarLike -->|"SQL queries via conexion.php"| Conexion
    ProcesarReserva -->|"SQL queries via conexion.php"| Conexion

    ProcesarArticulo -->|"read/write images"| FileSystem
    ProcesarPublicarArticulo -->|"read/write images"| FileSystem
    ProcesarEditarArticulo -->|"read/write images"| FileSystem

    ProcesarReserva -->|"triggers email"| SendEmail
    ProcesarRegistro -->|"triggers email"| SendEmail

    SendEmail -->|"uses PHPMailer classes"| PHPMailerLib
    SendEmail -->|"SMTP: send confirmation"| SMTP

    WebServerNode -->|"serves static assets"| Scripts
    WebServerNode -->|"serves static assets"| Styles
    WebServerNode -->|"serves images"| FileSystem

    WebServerNode -->|"HTML/CSS/JS response"| Browser

    %% Click Events
    click Scripts "https://github.com/agustinalopez23/proyectoliceo/blob/main/scripts.js"
    click Styles "https://github.com/agustinalopez23/proyectoliceo/blob/main/styles.css"
    click ProyectoLiceo "https://github.com/agustinalopez23/proyectoliceo/blob/main/ProyectoLiceo.php"
    click Blog "https://github.com/agustinalopez23/proyectoliceo/blob/main/blog.php"
    click Articulo "https://github.com/agustinalopez23/proyectoliceo/blob/main/articulo.php"
    click AdminBlog "https://github.com/agustinalopez23/proyectoliceo/blob/main/admin_blog.php"
    click Login "https://github.com/agustinalopez23/proyectoliceo/blob/main/login.php"
    click Registro "https://github.com/agustinalopez23/proyectoliceo/blob/main/registro.php"
    click PanelUsuario "https://github.com/agustinalopez23/proyectoliceo/blob/main/panel_usuario.php"
    click PublicarArticulo "https://github.com/agustinalopez23/proyectoliceo/blob/main/publicar_articulo.php"
    click EditarArticulo "https://github.com/agustinalopez23/proyectoliceo/blob/main/editar_articulo.php"
    click EliminarArticulo "https://github.com/agustinalopez23/proyectoliceo/blob/main/eliminar_articulo.php"
    click ConfirmacionReserva "https://github.com/agustinalopez23/proyectoliceo/blob/main/confirmacion_reserva.php"
    click CerrarSesion "https://github.com/agustinalopez23/proyectoliceo/blob/main/cerrar_sesion.php"
    click ProcesarLogin "https://github.com/agustinalopez23/proyectoliceo/blob/main/procesar_login.php"
    click ProcesarRegistro "https://github.com/agustinalopez23/proyectoliceo/blob/main/procesar_registro.php"
    click ProcesarArticulo "https://github.com/agustinalopez23/proyectoliceo/blob/main/procesar_articulo.php"
    click ProcesarPublicarArticulo "https://github.com/agustinalopez23/proyectoliceo/blob/main/procesar_publicar_articulo.php"
    click ProcesarEditarArticulo "https://github.com/agustinalopez23/proyectoliceo/blob/main/procesar_editar_articulo.php"
    click ProcesarLike "https://github.com/agustinalopez23/proyectoliceo/blob/main/procesar_like.php"
    click ProcesarReserva "https://github.com/agustinalopez23/proyectoliceo/blob/main/procesar_reserva.php"
    click Conexion "https://github.com/agustinalopez23/proyectoliceo/blob/main/conexion.php"
    click SendEmail "https://github.com/agustinalopez23/proyectoliceo/blob/main/send_email.php"
    click PHPMailerLib "https://github.com/agustinalopez23/proyectoliceo/tree/main/phpmailer/PHPMailer-master/"

    %% Styles
    classDef client fill:#D0E8FF,stroke:#2E8BFF,color:#000
    classDef server fill:#DFFFD0,stroke:#4CAF50,color:#000
    classDef storage fill:#FFE8A0,stroke:#FF8C00,color:#000
    classDef external fill:#E8D0FF,stroke:#800080,color:#000
    class browser client
    class WebServerNode,ProyectoLiceo,Blog,Articulo,AdminBlog,Login,Registro,PanelUsuario,PublicarArticulo,EditarArticulo,EliminarArticulo,ConfirmacionReserva,CerrarSesion,ProcesarLogin,ProcesarRegistro,ProcesarArticulo,ProcesarPublicarArticulo,ProcesarEditarArticulo,ProcesarLike,ProcesarReserva,Conexion,SendEmail,PHPMailerLib server
    class Database,FileSystem storage
    class SMTP external
```
