# juancarlos2v/gestor-talleres architecture

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

- Interactive diagram: https://gitdiagram.com/juancarlos2v/gestor-talleres
- Repository: https://github.com/juancarlos2v/gestor-talleres

## Overview

Para elaborar un diagrama de arquitectura claro y preciso del proyecto “Gestor de Talleres (Flask)”, sigue estos pasos:

##### Identifica el tipo de proyecto y su propósito
- Se trata de una aplicación web monolítica full-stack desarrollada en Python con Flask y SQLAlchemy.
- Gestiona tres entidades principales: Talleres, Alumnos e Inscripciones, con CRUD completo y ORM.

##### Analiza la estructura de carpetas
- app.py: punto de entrada donde se inicializa Flask y se registran Blueprints.
- config/database.py: configuración de conexión (SQLite en dev, MariaDB/MySQL en prod).
- controller/: define los Blueprints (AlumnoController, TallerController, InscripcionesController).
- services/: lógica de negocio por entidad.
- repositories/: capa de acceso a datos con SQLAlchemy.
- domain/: definición de entidades (modelos de datos).
- exceptions/: errores de negocio personalizados.
- templates/ y static/: vistas Jinja2 y assets CSS/JS (front-end).

##### Componentes principales (a dibujar como cajas separadas)
A. Cliente (navegador)
- HTML (templates Jinja2)
- CSS/JS (static/)
B. Web Server / Application Layer
- Flask App (app.py)
- Blueprints (controllers/)
C. Business Logic Layer
- Services (services/)
- Domain Models (domain/)
- Custom Exceptions (exceptions/)
D. Data Access Layer
- Repositories (repositories/)
- ORM: SQLAlchemy
- Configuración DB (config/database.py)
E. Base de Datos
- SQLite (dev) o MariaDB/MySQL (prod)

##### Relaciones e interacción entre componentes
1. El usuario envía peticiones HTTP desde el navegador.
2. Flask (app.py) enruta la petición al Blueprint correspondiente (controller).
3. El controller invoca un Service para procesar la lógica de negocio.
4. El Service utiliza Domain Models y lanza posibles Exceptions.
5. Para persistencia, el Service llama a un Repository que usa SQLAlchemy.
6. El Repository ejecuta consultas parametrizadas en la Base de Datos.
7. La respuesta vuelve por el mismo camino: Service → Controller → render_template → navegador.

##### Patrones y principios arquitectónicos
- Separación en capas (Controller – Service – Repository)
- MVC ligero (Vista: templates/static; Controlador: controllers; Modelo: domain + ORM)
- Inversión de dependencias: controllers dependen de servicios, servicios de repositorios.
- Uso de Blueprints para modularizar rutas.
- Manejo de errores con excepciones personalizadas (Separation of Concerns).

##### Tecnologías y frameworks relevantes
- Flask (web framework)
- Flask-SQLAlchemy (ORM)
- SQLite / MySQL/MariaDB (motor de base de datos)
- Jinja2 (sistema de plantillas)
- Blueprints (módulos de rutas)
- CSS/JS estático para UI

##### Guía para el diagrama (full-stack monolítico)
a. Dibuja capas horizontales o verticales para Cliente, App Server, Business Logic, Data Access y Base de Datos.
b. Dentro de cada capa, agrupa los componentes:
- Cliente: templates/, static/
- App Server: app.py, controllers/
- Business Logic: services/, domain/, exceptions/
- Data Access: repositories/, config/database.py
- DB: motor SQLite/MySQL
c. Usa flechas unidireccionales que muestren:
- HTTP → Controllers → Services → Repositories → DB
- DB → Repositories → Services → Controllers → HTTP (respuesta)
d. Aplica colores o formas:
- Azul para UI (templates/static)
- Verde para lógica de negocio (services/domain)
- Naranja para persistencia (repositories/ORM)
- Gris para infra (config, app.py)
- Rojo para Base de Datos
e. Etiqueta cada flecha con el tipo de interacción (por ejemplo, “render_template”, “consulta SQL”, “raise Exception”).

##### Elementos esenciales a incluir en el diagrama
- Nombre y responsabilidad de cada módulo/carpeta.
- Punto de entrada (app.py) y registro de Blueprints.
- Flujo de datos y control entre capas.
- Conexión a la base de datos y ORM.
- Módulos de UI (templates/static) separados de la lógica de servidor.

Siguiendo esta guía tendrás un diagrama detallado que refleja con fidelidad la arquitectura de “Gestor de Talleres (Flask)”.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client Layer
    Browser["Cliente (Navegador)"]:::ui
    Templates["Templates (Jinja2)"]:::ui
    Static["Static Assets (CSS/JS)"]:::ui

    Browser -->|HTTP Request| App
    App -->|render_template| Templates
    Templates --> Browser
    Static --> Browser

    %% Application Layer
    subgraph "Application Layer"
        App["Flask App (app.py)"]:::infra
        subgraph "Controllers (Blueprints)"
            AlumCtrl["AlumnoController"]:::infra
            TallerCtrl["TallerController"]:::infra
            InscrCtrl["InscripcionesController"]:::infra
        end
    end

    Browser -->|routes| AlumCtrl
    Browser -->|routes| TallerCtrl
    Browser -->|routes| InscrCtrl

    %% Business Logic Layer
    subgraph "Business Logic Layer"
        subgraph Services
            AlumService["AlumnoService"]:::logic
            TallerService["TallerService"]:::logic
            InscrService["InscripcionesService"]:::logic
        end
        subgraph "Domain Models"
            AlumDomain["Alumno"]:::logic
            TallerDomain["Taller"]:::logic
            InscrDomain["Inscripcion"]:::logic
        end
        subgraph "Exceptions"
            CupoError["CupoLlenoError"]:::logic
            DatosError["DatosInvalidosError"]:::logic
            DniError["DniDuplicadoError"]:::logic
            InscrDupError["InscripcionDuplicadaError"]:::logic
        end
    end

    AlumCtrl -->|calls| AlumService
    TallerCtrl -->|calls| TallerService
    InscrCtrl -->|calls| InscrService

    AlumService -->|uses| AlumDomain
    TallerService -->|uses| TallerDomain
    InscrService -->|uses| InscrDomain

    AlumService -->|raise| CupoError
    AlumService -->|raise| DatosError
    AlumService -->|raise| DniError
    InscrService -->|raise| InscrDupError

    %% Data Access Layer
    subgraph "Data Access Layer"
        ConfigDB["DB Config (database.py)"]:::infra
        subgraph Repositories
            AlumRepo["AlumnoRepository"]:::persistence
            TallerRepo["TallerRepository"]:::persistence
            InscrRepo["InscripcionRepository"]:::persistence
        end
    end

    AlumService -->|calls| AlumRepo
    TallerService -->|calls| TallerRepo
    InscrService -->|calls| InscrRepo

    ConfigDB -->|provides connection| AlumRepo
    ConfigDB -->|provides connection| TallerRepo
    ConfigDB -->|provides connection| InscrRepo

    %% Database
    DB["Base de Datos (SQLite/MySQL)"]:::db
    AlumRepo -->|SQL query| DB
    TallerRepo -->|SQL query| DB
    InscrRepo -->|SQL query| DB

    %% Click Events
    click Templates "https://github.com/juancarlos2v/gestor-talleres/tree/master/source/templates/"
    click Static "https://github.com/juancarlos2v/gestor-talleres/tree/master/source/static/"
    click App "https://github.com/juancarlos2v/gestor-talleres/blob/master/source/app.py"
    click ConfigDB "https://github.com/juancarlos2v/gestor-talleres/blob/master/source/config/database.py"
    click AlumCtrl "https://github.com/juancarlos2v/gestor-talleres/blob/master/source/controller/AlumnoController.py"
    click TallerCtrl "https://github.com/juancarlos2v/gestor-talleres/blob/master/source/controller/TallerController.py"
    click InscrCtrl "https://github.com/juancarlos2v/gestor-talleres/blob/master/source/controller/InscripcionesController.py"
    click AlumService "https://github.com/juancarlos2v/gestor-talleres/blob/master/source/services/AlumnoService.py"
    click TallerService "https://github.com/juancarlos2v/gestor-talleres/blob/master/source/services/TallerService.py"
    click InscrService "https://github.com/juancarlos2v/gestor-talleres/blob/master/source/services/InscripcionesService.py"
    click AlumDomain "https://github.com/juancarlos2v/gestor-talleres/blob/master/source/domain/Alumno.py"
    click TallerDomain "https://github.com/juancarlos2v/gestor-talleres/blob/master/source/domain/Taller.py"
    click InscrDomain "https://github.com/juancarlos2v/gestor-talleres/blob/master/source/domain/Inscripcion.py"
    click CupoError "https://github.com/juancarlos2v/gestor-talleres/blob/master/source/exceptions/CupoLlenoError.py"
    click DatosError "https://github.com/juancarlos2v/gestor-talleres/blob/master/source/exceptions/DatosInvalidosError.py"
    click DniError "https://github.com/juancarlos2v/gestor-talleres/blob/master/source/exceptions/DniDuplicadoError.py"
    click InscrDupError "https://github.com/juancarlos2v/gestor-talleres/blob/master/source/exceptions/InscripcionDuplicadaError.py"
    click AlumRepo "https://github.com/juancarlos2v/gestor-talleres/blob/master/source/repositories/AlumnoRepository.py"
    click TallerRepo "https://github.com/juancarlos2v/gestor-talleres/blob/master/source/repositories/TallerRepository.py"
    click InscrRepo "https://github.com/juancarlos2v/gestor-talleres/blob/master/source/repositories/InscripcionRepository.py"

    %% Styles
    classDef ui fill:#add8e6,stroke:#333,stroke-width:1px
    classDef infra fill:#d3d3d3,stroke:#333,stroke-width:1px
    classDef logic fill:#98fb98,stroke:#333,stroke-width:1px
    classDef persistence fill:#ffa500,stroke:#333,stroke-width:1px
    classDef db fill:#f08080,stroke:#333,stroke-width:1px
```
