# nicojg27/proyecto-gypsigram architecture

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

- Interactive diagram: https://gitdiagram.com/nicojg27/proyecto-gypsigram
- Repository: https://github.com/nicojg27/proyecto-gypsigram

## Overview

##### Project type and purpose
- This is a monolithic, full-stack Java web application built with Spring Boot and Maven.
- It implements an MVC pattern that manages domain entities such as Estudiante (Student), Empresa (Company), Instituto, Empleado, Certificación, Experiencia, Idioma, etc.
- Its primary purpose is to provide CRUD operations (and potentially authentication via LoginController) over those entities, serving both HTML pages and JSON endpoints.

##### File structure
- Top-level:
- pom.xml – Maven build file with all dependencies (Spring Boot, Spring Data JPA, Web)
- BD GypsyGram.sql – Database schema and seed scripts
- README.md – Project name
- src/main/java/com/GypsiGram/aplicacion:
- web – Controllers (REST or MVC endpoints)
- aplicacion – Service layer (business logic)
- dominio – JPA Entities and embeddable IDs
- infraestructura – Spring Data JPA Repositories
- GypsiGramApplication.java & ServletInitializer.java – Spring Boot entrypoints
- src/main/resources:
- application.properties – configuration (DB connection, ports)
- static/ – CSS, HTML, images (client-side assets)
- pages/registro*.html, vistaEmpresas.html, contactanos.html – UI templates

##### README
- We rely on the code layout to infer MVC layers and DB integration.

a. Main components:
1) Client (Web Browser)
2) Spring Boot Application
- Web Layer (Controllers)
- Service Layer (EmpleadoService, EstudianteService, etc.)
- Data Layer (Spring Data Repositories)
- Domain Model (JPA Entities)
3) Relational Database (MySQL/PostgreSQL/etc.)
4) Static Asset Store (served from /static folder)
5) External systems (optional—e.g., LDAP or OAuth if LoginController hooks into them)
b. Relationships and interactions:
- Browser → HTTP → Controllers → invoke Services → call Repositories → SQL → Database
- Controllers also serve static HTML/CSS/JS from the /static folder
- Entities map 1:1 to DB tables; Repositories handle CRUD via JPA
c. Architectural patterns/design principles:
- Layered MVC (Separation of concerns: Web / Business / Data)
- Dependency Injection (Spring Beans wired via @Service, @Repository, @Controller)
- Domain-Driven Design hints (rich domain model under dominio package)
- Convention over configuration (Spring Boot auto-configuration)
d. Key technologies and frameworks:
- Spring Boot (embedded Tomcat, auto-configuration)
- Spring MVC (Controllers, request mappings, view resolvers)
- Spring Data JPA (Repository interfaces, Entity classes)
- Maven (build lifecycle, dependency management)
- Thymeleaf or static templates (though `static` folder suggests plain HTML)
- Relational DB (SQL schema in BD GypsyGram.sql)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% User
    Browser["Web Browser"]:::user

    %% Spring Boot Application
    subgraph "Spring Boot Application"
        direction TB

        %% Entry Points
        subgraph "Entry Points"
            direction TB
            GypsiGramApp["GypsiGramApplication"]:::entry
            ServletInit["ServletInitializer"]:::entry
        end

        %% Configuration
        Config["application.properties"]:::config

        %% Web Layer
        subgraph "Web Layer"
            direction TB
            EmpleadoController["EmpleadoController"]:::web
            EmpresaControlador["EmpresaControlador"]:::web
            EstudianteControlador["EstudianteControlador"]:::web
            InstitutoControlador["InstitutoControlador"]:::web
            LoginController["LoginController"]:::web
        end

        %% Service Layer
        subgraph "Service Layer"
            direction TB
            EmpleadoService["EmpleadoService"]:::service
            EmpresaService["EmpresaService"]:::service
            EstudianteService["EstudianteService"]:::service
            InstitutoService["InstitutoService"]:::service
        end

        %% Data Layer
        subgraph "Data Layer"
            direction TB
            EmpleadoRepository["EmpleadoRepository"]:::data
            EmpresaRepository["EmpresaRepository"]:::data
            EstudianteRepository["EstudianteRepository"]:::data
            InstitutoRepository["InstitutoRepository"]:::data
        end

        %% Domain Model
        subgraph "Domain Model"
            direction TB
            Certificacion["Certificacion"]:::domain
            CertificacionEstudiante["CertificacionEstudiante"]:::domain
            CertificacionEstudianteId["CertificacionEstudianteId"]:::domain
            Ciclo["Ciclo"]:::domain
            Departamento["Departamento"]:::domain
            Empleado["Empleado"]:::domain
            Empresa["Empresa"]:::domain
            Estudiante["Estudiante"]:::domain
            EstudianteCicloInstituto["EstudianteCicloInstituto"]:::domain
            EstudianteCicloInstitutoId["EstudianteCicloInstitutoId"]:::domain
            Experiencia["Experiencia"]:::domain
            ExperienciaEstudiante["ExperienciaEstudiante"]:::domain
            ExperienciaEstudianteId["ExperienciaEstudianteId"]:::domain
            Idioma["Idioma"]:::domain
            IdiomaEstudiante["IdiomaEstudiante"]:::domain
            IdiomaEstudianteId["IdiomaEstudianteId"]:::domain
            Instituto["Instituto"]:::domain
            ProyectoPersonal["ProyectoPersonal"]:::domain
        end

        %% Static Assets
        StaticAssets["Static Assets (HTML/CSS/Images)"]:::static
    end

    %% Database and Scripts
    Database["Relational Database"]:::db
    BDScript["BD GypsyGram.sql"]:::script
    pom["pom.xml"]:::config

    %% Data Flows
    Browser -->|"HTTP"| EmpleadoController
    EmpleadoController -->|"calls"| EmpleadoService
    EmpleadoService -->|"uses"| EmpleadoRepository
    EmpleadoRepository -->|"JDBC"| Database

    Browser --> StaticAssets
    Config --> GypsiGramApp
    pom --> GypsiGramApp
    BDScript --> Database

    %% Click Events
    click GypsiGramApp "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/java/com/GypsiGram/aplicacion/GypsiGramAplication.java"
    click ServletInit "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/java/com/GypsiGram/aplicacion/ServletInitializer.java"
    click EmpleadoController "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/java/com/GypsiGram/aplicacion/web/EmpleadoController.java"
    click EmpresaControlador "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/java/com/GypsiGram/aplicacion/web/EmpresaControlador.java"
    click EstudianteControlador "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/java/com/GypsiGram/aplicacion/web/EstudianteControlador.java"
    click InstitutoControlador "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/java/com/GypsiGram/aplicacion/web/InstitutoControlador.java"
    click LoginController "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/java/com/GypsiGram/aplicacion/web/LoginController.java"
    click EmpleadoService "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/java/com/GypsiGram/aplicacion/aplicacion/EmpleadoService.java"
    click EmpresaService "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/java/com/GypsiGram/aplicacion/aplicacion/EmpresaService.java"
    click EstudianteService "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/java/com/GypsiGram/aplicacion/aplicacion/EstudianteService.java"
    click InstitutoService "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/java/com/GypsiGram/aplicacion/aplicacion/InstitutoService.java"
    click EmpleadoRepository "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/java/com/GypsiGram/aplicacion/infraestructura/EmpleadoRepository.java"
    click EmpresaRepository "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/java/com/GypsiGram/aplicacion/infraestructura/EmpresaRepository.java"
    click EstudianteRepository "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/java/com/GypsiGram/aplicacion/infraestructura/EstudianteRepository.java"
    click InstitutoRepository "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/java/com/GypsiGram/aplicacion/infraestructura/InstitutoRepository.java"
    click Certificacion "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/java/com/GypsiGram/aplicacion/dominio/Certificacion.java"
    click CertificacionEstudiante "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/java/com/GypsiGram/aplicacion/dominio/CertificacionEstudiante.java"
    click CertificacionEstudianteId "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/java/com/GypsiGram/aplicacion/dominio/CertificacionEstudianteId.java"
    click Ciclo "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/java/com/GypsiGram/aplicacion/dominio/Ciclo.java"
    click Departamento "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/java/com/GypsiGram/aplicacion/dominio/Departamento.java"
    click Empleado "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/java/com/GypsiGram/aplicacion/dominio/Empleado.java"
    click Empresa "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/java/com/GypsiGram/aplicacion/dominio/Empresa.java"
    click Estudiante "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/java/com/GypsiGram/aplicacion/dominio/Estudiante.java"
    click EstudianteCicloInstituto "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/java/com/GypsiGram/aplicacion/dominio/EstudianteCicloInstituto.java"
    click EstudianteCicloInstitutoId "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/java/com/GypsiGram/aplicacion/dominio/EstudianteCicloInstitutoId.java"
    click Experiencia "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/java/com/GypsiGram/aplicacion/dominio/Experiencia.java"
    click ExperienciaEstudiante "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/java/com/GypsiGram/aplicacion/dominio/ExperienciaEstudiante.java"
    click ExperienciaEstudianteId "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/java/com/GypsiGram/aplicacion/dominio/ExperienciaEstudianteId.java"
    click Idioma "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/java/com/GypsiGram/aplicacion/dominio/Idioma.java"
    click IdiomaEstudiante "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/java/com/GypsiGram/aplicacion/dominio/IdiomaEstudiante.java"
    click IdiomaEstudianteId "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/java/com/GypsiGram/aplicacion/dominio/IdiomaEstudianteId.java"
    click Instituto "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/java/com/GypsiGram/aplicacion/dominio/Instituto.java"
    click ProyectoPersonal "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/java/com/GypsiGram/aplicacion/dominio/ProyectoPersonal.java"
    click StaticAssets "https://github.com/nicojg27/proyecto-gypsigram/tree/main/src/main/resources/static"
    click Config "https://github.com/nicojg27/proyecto-gypsigram/blob/main/src/main/resources/application.properties"
    click BDScript "https://github.com/nicojg27/proyecto-gypsigram/blob/main/BD GypsyGram.sql"
    click pom "https://github.com/nicojg27/proyecto-gypsigram/blob/main/pom.xml"

    %% Styles
    classDef user fill:#B3E5FC,stroke:#0288D1,color:#000
    classDef web fill:#BBDEFB,stroke:#1976D2,color:#000
    classDef service fill:#C8E6C9,stroke:#388E3C,color:#000
    classDef data fill:#FFE0B2,stroke:#F57C00,color:#000
    classDef domain fill:#FFF9C4,stroke:#FBC02D,color:#000
    classDef static fill:#F8BBD0,stroke:#D81B60,color:#000
    classDef entry fill:#E1BEE7,stroke:#7B1FA2,color:#000
    classDef config fill:#CFD8DC,stroke:#455A64,color:#000
    classDef db fill:#FFCDD2,stroke:#D32F2F,color:#000
    classDef script fill:#D7CCC8,stroke:#5D4037,color:#000
```
