# valenbaldo/pregunlam---proyecto-web-ii architecture

> Architecture diagram of the GitHub repository valenbaldo/pregunlam---proyecto-web-ii, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/valenbaldo/pregunlam---proyecto-web-ii
- Repository: https://github.com/valenbaldo/pregunlam---proyecto-web-ii

## Overview

##### Project Type and Purpose
- This is a monolithic, server-rendered full-stack web application written in PHP (PHP 7+) with a simple MVC-style folder structure.
- Its purpose is a basic “Pokédex” CRUD system used for teaching/refactoring exercises: user registration, login, listing entries, detailed views, and image uploads.

##### File Structure Analysis
- Top-level directories:
- config/ – stores database and application configuration (config.ini).
- controller/ – HTTP request handlers (AdminController, LoginController, JuegoController, etc.).
- model/ – data-access classes matching each controller (AdminModel, LoginModel, etc.), using mysqli.
- helper/ – utility classes for routing (NewRouter), DB connection (MyConexion), template rendering (MustacheRenderer, IncludeFileRenderer), config instantiation (ConfigFactory).
- vista/ – Mustache template files for view rendering (header, footer, various pages).
- public/ – publicly exposed assets (CSS, JavaScript).
- imagenes/ – image storage (placeholders and uploads).
- index.php – front controller / entry point for non-MVC legacy routes.
- database.sql – initial database schema.

##### Key Insights from README
- The system connects directly to MySQL without prepared statements; has repetitive connection code and plain-text passwords.
- Typical CRUD pages: index.php (list/search), ver.php (view), nuevo.php (create), editar.php (update), borrar.php (delete).
- Uses Mustache for templating, but no advanced layering.

##### Main Components
a. Client Browser
- Requests pages, submits forms, loads CSS/JS from public/.
b. Web Server
- Apache or built-in PHP server receives HTTP requests, directs to index.php or MVC router (NewRouter).
c. Routing Layer (helper/NewRouter.php)
- Maps URLs to controller methods.
d. Controller Layer (controller/*.php)
- Receives input, invokes helper classes, coordinates data fetch via models, selects templates.
e. Service/Helper Layer (helper/*.php)
- ConfigFactory: loads config.ini
- MyConexion: establishes mysqli connection
- MustacheRenderer/IncludeFileRenderer: renders .mustache templates
f. Model Layer (model/*.php)
- Executes SQL queries via mysqli, returns raw data arrays.
g. View Layer (vista/*.mustache)
- Templates for page layout, includes header.mustache and footer.mustache
h. File System Storage
- imagenes/ folder: stores uploaded images; file I/O by controllers/models.
i. Database
- MySQL/MariaDB instance storing tables created by database.sql

##### Relationships and Data Flow
- Browser → HTTP request → Web Server
- Web Server → NewRouter → Controller
- Controller ↔ MyConexion (via helper) ↔ MySQL Database
- Controller ↔ Model (fetch/save data)
- Controller → MustacheRenderer → View HTML
- Controller ↔ File System (image upload/delete in imagenes/)
- Browser ← HTML + CSS/JS ← Server

##### Architectural Patterns and Design Principles
- Layered (MVC-like) architecture separating Controllers, Models, Views.
- Single codebase monolith—no microservices.
- Helpers as thin service layer for cross-cutting concerns (config, DB, templating).

##### Technologies, Frameworks, Libraries
- PHP 7+ with mysqli extension
- MySQL/MariaDB database
- Mustache templating engine (helper/MustacheRenderer)
- Plain-text config in config/config.ini
- Static assets served from public/

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client Layer
    subgraph "Client"
        Browser["Browser"]:::client
    end

    %% Public Assets
    subgraph "Public Assets"
        CSS["estilo.css"]:::assets
        JS1["registro.js"]:::assets
        JS2["mapaRegistro.js"]:::assets
    end

    Browser -->|HTTP Request| WebServer["Web Server<br/>(Apache/PHP)"]:::server
    Browser -->|Load CSS/JS| CSS
    Browser -->|Load CSS/JS| JS1
    Browser -->|Load CSS/JS| JS2

    %% Entry Point and Routing
    WebServer --> FrontController["index.php"]:::server
    FrontController --> Router["NewRouter"]:::server

    %% Controllers
    subgraph "Controller Layer"
        AdminController["AdminController"]:::server
        EditorController["EditorController"]:::server
        HomeController["HomeController"]:::server
        JuegoController["JuegoController"]:::server
        LoginController["LoginController"]:::server
        PerfilController["PerfilController"]:::server
        ReporteController["ReporteController"]:::server
        UsuarioController["UsuarioController"]:::server
    end

    Router -->|route| AdminController
    Router -->|route| EditorController
    Router -->|route| HomeController
    Router -->|route| JuegoController
    Router -->|route| LoginController
    Router -->|route| PerfilController
    Router -->|route| ReporteController
    Router -->|route| UsuarioController

    %% Helper/Service Layer
    subgraph "Helper/Service Layer"
        ConfigFactory["ConfigFactory"]:::server
        MyConexion["MyConexion"]:::server
        MustacheRenderer["MustacheRenderer"]:::server
        IncludeFileRenderer["IncludeFileRenderer"]:::server
    end

    AdminController -->|load config| ConfigFactory
    EditorController -->|load config| ConfigFactory
    HomeController -->|load config| ConfigFactory
    JuegoController -->|load config| ConfigFactory
    LoginController -->|load config| ConfigFactory
    PerfilController -->|load config| ConfigFactory
    ReporteController -->|load config| ConfigFactory
    UsuarioController -->|load config| ConfigFactory

    AdminController -->|DB Conn| MyConexion
    EditorController -->|DB Conn| MyConexion
    HomeController -->|DB Conn| MyConexion
    JuegoController -->|DB Conn| MyConexion
    LoginController -->|DB Conn| MyConexion
    PerfilController -->|DB Conn| MyConexion
    ReporteController -->|DB Conn| MyConexion
    UsuarioController -->|DB Conn| MyConexion

    AdminController -->|render| MustacheRenderer
    EditorController -->|render| MustacheRenderer
    HomeController -->|render| MustacheRenderer
    JuegoController -->|render| MustacheRenderer
    LoginController -->|render| MustacheRenderer
    PerfilController -->|render| MustacheRenderer
    ReporteController -->|render| MustacheRenderer
    UsuarioController -->|render| MustacheRenderer

    AdminController -->|render| IncludeFileRenderer
    EditorController -->|render| IncludeFileRenderer
    HomeController -->|render| IncludeFileRenderer
    JuegoController -->|render| IncludeFileRenderer
    LoginController -->|render| IncludeFileRenderer
    PerfilController -->|render| IncludeFileRenderer
    ReporteController -->|render| IncludeFileRenderer
    UsuarioController -->|render| IncludeFileRenderer

    %% Model Layer
    subgraph "Model Layer"
        AdminModel["AdminModel"]:::server
        EditorModel["EditorModel"]:::server
        HomeModel["HomeModel"]:::server
        JuegoModel["JuegoModel"]:::server
        LoginModel["LoginModel"]:::server
        PerfilModel["PerfilModel"]:::server
        ReporteModel["ReporteModel"]:::server
        UsuarioModel["UsuarioModel"]:::server
    end

    AdminController -->|use| AdminModel
    EditorController -->|use| EditorModel
    HomeController -->|use| HomeModel
    JuegoController -->|use| JuegoModel
    LoginController -->|use| LoginModel
    PerfilController -->|use| PerfilModel
    ReporteController -->|use| ReporteModel
    UsuarioController -->|use| UsuarioModel

    ModelsGrp["Models<br/>(SQL via mysqli)"]:::server
    AdminModel & EditorModel & HomeModel & JuegoModel & LoginModel & PerfilModel & ReporteModel & UsuarioModel --> ModelsGrp
    ModelsGrp -->|SQL Queries| Database["MySQL Database"]:::datastore

    %% View Layer
    subgraph "View Layer"
        Views["Mustache Templates"]:::server
    end

    MustacheRenderer --> Views
    IncludeFileRenderer --> Views
    Views -->|HTML| Browser

    %% File Storage
    FileStorage["Folder: imagenes/"]:::datastore
    AdminController -->|file I/O| FileStorage
    EditorController -->|file I/O| FileStorage
    JuegoController -->|file I/O| FileStorage

    %% Configuration
    ConfigFactory --> Config["config/config.ini"]:::external

    %% Class Definitions
    classDef client fill:#f9f,stroke:#333,stroke-width:1px;
    classDef server fill:#ccf,stroke:#333,stroke-width:1px;
    classDef datastore fill:#cfc,stroke:#333,stroke-width:1px,stroke-dasharray: 5 5;
    classDef assets fill:#ff9,stroke:#333,stroke-width:1px;
    classDef external fill:#eee,stroke:#999,stroke-width:1px,stroke-dasharray: 2 2;

    %% Click Events
    click Config "https://github.com/valenbaldo/pregunlam---proyecto-web-ii/blob/main/config/config.ini"
    click FrontController "https://github.com/valenbaldo/pregunlam---proyecto-web-ii/blob/main/index.php"
    click Router "https://github.com/valenbaldo/pregunlam---proyecto-web-ii/blob/main/helper/NewRouter.php"
    click ConfigFactory "https://github.com/valenbaldo/pregunlam---proyecto-web-ii/blob/main/helper/ConfigFactory.php"
    click MyConexion "https://github.com/valenbaldo/pregunlam---proyecto-web-ii/blob/main/helper/MyConexion.php"
    click MustacheRenderer "https://github.com/valenbaldo/pregunlam---proyecto-web-ii/blob/main/helper/MustacheRenderer.php"
    click IncludeFileRenderer "https://github.com/valenbaldo/pregunlam---proyecto-web-ii/blob/main/helper/IncludeFileRenderer.php"
    click AdminController "https://github.com/valenbaldo/pregunlam---proyecto-web-ii/blob/main/controller/AdminController.php"
    click EditorController "https://github.com/valenbaldo/pregunlam---proyecto-web-ii/blob/main/controller/EditorController.php"
    click HomeController "https://github.com/valenbaldo/pregunlam---proyecto-web-ii/blob/main/controller/HomeController.php"
    click JuegoController "https://github.com/valenbaldo/pregunlam---proyecto-web-ii/blob/main/controller/JuegoController.php"
    click LoginController "https://github.com/valenbaldo/pregunlam---proyecto-web-ii/blob/main/controller/LoginController.php"
    click PerfilController "https://github.com/valenbaldo/pregunlam---proyecto-web-ii/blob/main/controller/PerfilController.php"
    click ReporteController "https://github.com/valenbaldo/pregunlam---proyecto-web-ii/blob/main/controller/ReporteController.php"
    click UsuarioController "https://github.com/valenbaldo/pregunlam---proyecto-web-ii/blob/main/controller/UsuarioController.php"
    click AdminModel "https://github.com/valenbaldo/pregunlam---proyecto-web-ii/blob/main/model/AdminModel.php"
    click EditorModel "https://github.com/valenbaldo/pregunlam---proyecto-web-ii/blob/main/model/EditorModel.php"
    click HomeModel "https://github.com/valenbaldo/pregunlam---proyecto-web-ii/blob/main/model/HomeModel.php"
    click JuegoModel "https://github.com/valenbaldo/pregunlam---proyecto-web-ii/blob/main/model/JuegoModel.php"
    click LoginModel "https://github.com/valenbaldo/pregunlam---proyecto-web-ii/blob/main/model/LoginModel.php"
    click PerfilModel "https://github.com/valenbaldo/pregunlam---proyecto-web-ii/blob/main/model/PerfilModel.php"
    click ReporteModel "https://github.com/valenbaldo/pregunlam---proyecto-web-ii/blob/main/model/ReporteModel.php"
    click UsuarioModel "https://github.com/valenbaldo/pregunlam---proyecto-web-ii/blob/main/model/UsuarioModel.php"
    click CSS "https://github.com/valenbaldo/pregunlam---proyecto-web-ii/blob/main/public/css/estilo.css"
    click JS1 "https://github.com/valenbaldo/pregunlam---proyecto-web-ii/blob/main/public/js/registro.js"
    click JS2 "https://github.com/valenbaldo/pregunlam---proyecto-web-ii/blob/main/public/js/mapaRegistro.js"
    click FileStorage "https://github.com/valenbaldo/pregunlam---proyecto-web-ii/tree/main/imagenes/"
```
