# jacobo87/proyecto_asir architecture

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

- Interactive diagram: https://gitdiagram.com/jacobo87/proyecto_asir
- Repository: https://github.com/jacobo87/proyecto_asir

## Overview

##### Identificación del proyecto y su propósito
- Se trata de una aplicación web full-stack de ticketing Helpdesk, desarrollada en PHP (MVC), MySQL, con contenedores Docker y desplegada en AWS.
- Sirve para que clientes abran/incidan y administradores gestionen casos mediante una interfaz web rica en AJAX/JavaScript y CSS.

##### Análisis de la estructura de directorios
- Top-level:
- docker-compose.yml, .env → orquestación de contenedores (Apache + PHP, MySQL)
- apache/dockerfile → construcción del contenedor web
- db/*.sql → scripts de inicialización de base de datos
- scripts/*.sh → aprovisionamiento AWS (instances, security groups, IPs)
- src/ → código MVC y assets públicos
- src/configuración → datos de conexión
- src/modelos, src/controller, src/vistas → patrón MVC
- src/public → CSS, JS, imágenes, fuentes (front-end estático)

##### Claves extraídas del README
- Arquitectura LAMP en contenedores Docker con Docker-Compose
- Despliegue sobre AWS EC2 (scripts de AWS CLI)
- Base de datos MySQL con modelo ER sencillo (USUARIOS, CATEGORÍA, CASO, COMENTARIOS)
- Patrón MVC: flujo Vista → Controlador → Modelo → BD

##### Construcción del diagrama de sistema
a. Componentes principales
- Cliente (navegador)
- AWS EC2 (o grupo de EC2) con Docker-Compose
- Contenedor Apache+PHP (servidor web + lógica MVC)
- Contenedor MySQL (base de datos)
- Volúmenes Docker (persistencia de datos)
- Scripts de aprovisionamiento AWS (bastionado en un bloque “Infraestructura as Code”)
b. Relaciones e interacciones
- Flecha HTTP(S) del Cliente al balanceador/EC2
- Internamente: Apache ↔ PHP (peticiones MVC)
- PHP (PDO/MySQL) ↔ MySQL (consultas CRUD)
- Volúmenes Docker ↔ MySQL (datos persistentes)
- Scripts bash → AWS API (creación de security groups, instancias, EIPs)
c. Patrón y principios arquitectónicos
- Separación de capas (MVC)
- Contenerización (Docker, Docker-Compose)
- Infraestructura declarativa (scripts AWS CLI)
- Despliegue reproducible y portable
d. Tecnologías y librerías clave
- LAMP: Linux/Apache/PHP/MySQL
- Docker, Docker-Compose, Dockerfile
- AWS EC2, Security Groups, Elastic IPs
- AJAX (XMLHttpRequest) y librerías JS/CSS en src/public

##### Adaptación a un full-stack web
- Destacar capa “Cliente” (HTML/CSS/JS) vs capa “Servidor” (Apache+PHP MVC)
- Mostrar intermedio “API” (endpoints AJAX)
- Incluir la base de datos como servicio separado
- Añadir módulo “Infraestructura” para scripts de provisión AWS

##### Elementos visuales recomendados
- Etiquetas claras en cada rectángulo (componentes)
- Flechas con direccionalidad (request/response, lectura/escritura)
- Azul: front-end (navegador, JS, CSS)
- Verde: lógica servidor (Apache/PHP)
- Naranja: persistencia (MySQL, volúmenes)
- Gris: infraestructura (Docker, AWS CLI)
- Formas:
- Rectángulos para servicios
- Cilindros para bases de datos
- Documento o script para archivos de provisión

##### Consejos finales
- Sea detallado en las conexiones de red (puertos al AWS SG y Docker)
- No divida más allá de MVC y servicios Docker; agrupe librerías estáticas en “Asset Store”
- Indique versiones o paths críticos (docker-compose.yml, apache/dockerfile, db/*.sql)
- Refiérase al diagrama ER de la BD como un sub-diagrama de persistencia
- Verifique que los scripts bash aparezcan como componente “Infraestructura as Code”

Con esta guía el ingeniero senior dispondrá de un marco preciso para plasmar en un diagrama de sistema completo y fiel a la arquitectura real del proyecto Helpdesk.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Layer
    Client["Browser (HTML/CSS/JS)"]:::frontend

    %% Docker Deployment Layer
    subgraph "Docker Deployment"
        compose["Docker-Compose Orchestration"]:::infra
        env["Environment Configuration (.env)"]:::infra

        subgraph "Web Container"
            apache["Apache + PHP (MVC)"]:::server
            controllers["MVC Controllers"]:::server
            models["MVC Models"]:::server
        end

        subgraph "DB Container"
            mysql["MySQL Database"]:::db
            init1["db/db.sql"]:::db
            init2["db/dbdatos.sql"]:::db
            volumes["Docker Volumes"]:::db
        end
    end

    %% Infrastructure as Code Layer
    subgraph "Infrastructure as Code"
        script00["00-terminate_all_instances.sh"]:::infra
        script01["01-delete_all_security_groups.sh"]:::infra
        script02["02-delete_all_elastic_ips.sh"]:::infra
        script03["03-create_security_groups.sh"]:::infra
        script04["04-create_instances.sh"]:::infra
        script05["05-create_elastic_ip.sh"]:::infra
        deploy["deploy.sh"]:::infra
        install["install_app.sh"]:::infra
    end

    %% Connections
    Client -->|"HTTP(S) Request"| apache
    apache -->|"routes to Controllers"| controllers
    controllers -->|"use Models"| models
    models -->|"PDO Queries"| mysql
    mysql -->|"Persist Data"| volumes

    compose -->|"orchestrates"| apache
    compose -->|"orchestrates"| mysql
    compose -->|"mounts"| volumes
    compose -->|"uses"| env

    init1 --> mysql
    init2 --> mysql

    script00 -->|"AWS CLI"| script01
    script01 -->|"AWS CLI"| script02
    script02 -->|"AWS CLI"| script03
    script03 -->|"AWS CLI"| script04
    script04 -->|"AWS CLI"| script05
    script05 -->|"AWS CLI"| deploy
    deploy -->|"provisions"| install

    %% Click Events
    click compose "https://github.com/jacobo87/proyecto_asir/blob/main/docker-compose.yml"
    click apache "https://github.com/jacobo87/proyecto_asir/tree/main/apache/dockerfile"
    click init1 "https://github.com/jacobo87/proyecto_asir/blob/main/db/db.sql"
    click init2 "https://github.com/jacobo87/proyecto_asir/blob/main/db/dbdatos.sql"
    click script00 "https://github.com/jacobo87/proyecto_asir/blob/main/scripts/00-terminate_all_instances.sh"
    click script01 "https://github.com/jacobo87/proyecto_asir/blob/main/scripts/01-delete_all_security_groups.sh"
    click script02 "https://github.com/jacobo87/proyecto_asir/blob/main/scripts/02-delete_all_elastic_ips.sh"
    click script03 "https://github.com/jacobo87/proyecto_asir/blob/main/scripts/03-create_security_groups.sh"
    click script04 "https://github.com/jacobo87/proyecto_asir/blob/main/scripts/04-create_instances.sh"
    click script05 "https://github.com/jacobo87/proyecto_asir/blob/main/scripts/05-create_elastic_ips.sh"
    click deploy "https://github.com/jacobo87/proyecto_asir/blob/main/scripts/deploy.sh"
    click install "https://github.com/jacobo87/proyecto_asir/blob/main/scripts/install_app.sh"
    click env "https://github.com/jacobo87/proyecto_asir/blob/main/.env"
    click controllers "https://github.com/jacobo87/proyecto_asir/blob/main/src/controller/caso.php"
    click controllers "https://github.com/jacobo87/proyecto_asir/blob/main/src/controller/categoria.php"
    click models "https://github.com/jacobo87/proyecto_asir/blob/main/src/modelos/caso.php"
    click models "https://github.com/jacobo87/proyecto_asir/blob/main/src/modelos/categoria.php"
    click models "https://github.com/jacobo87/proyecto_asir/blob/main/src/modelos/usuario.php"

    %% Styles
    classDef frontend fill:#add8e6,stroke:#000,stroke-width:1px
    classDef server fill:#90ee90,stroke:#000,stroke-width:1px
    classDef db fill:#ffa500,stroke:#000,stroke-width:1px
    classDef infra fill:#d3d3d3,stroke:#000,stroke-width:1px
```
