# blaiken/menstrutrack-pt2 architecture

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

- Interactive diagram: https://gitdiagram.com/blaiken/menstrutrack-pt2
- Repository: https://github.com/blaiken/menstrutrack-pt2

## Overview

##### Project type and purpose
- This is a Java desktop (Swing) application built in NetBeans, following an MVC pattern.
- Purpose: help a school-based gynecologist register students, track menstrual cycles, generate small diagnostics, and produce/send PDF guides.

##### File-structure analysis
- Top level:
- src/controller – all controller classes (user-actions → business logic)
- src/modelo – domain objects and services (cycle calculation, diagnostics, history, backup)
- src/vista – Swing forms and view logic
- src/vista/img – UI images
- src/controlador (compiled), src/modelo, src/vista under build/classes – compiled classes
- dist/lib – external jars (MySQL connector, iText PDF, JavaMail, JSF API, JCalendar)
- build.xml / nbproject – NetBeans build scripts & project metadata
- proyectot2.sql – database schema

##### Architecture and tech stack (from README + structure)
- MVC layered monolith: View (Swing forms) → Controller (event handling) → Model (business rules + persistence)
- Persistence: MySQL via JDBC (conexion_bd.java)
- PDF generation: iText (generarpdf.java, guiapdf.java)
- Email sending: JavaMail (EnviarCorreo.java)
- Deployment: single JAR (ProyectoT2.jar) with embedded libs

##### Detailed capture of essential elements
- Build/deploy toolchain: Ant → ProyectoT2.jar → dist/lib

## Diagram (Mermaid)

```mermaid
graph TD
    %% UI Layer
    subgraph "UI Layer" 
        direction TB
        LoginP["LoginP"]:::ui
        MenuInicio["MenuInicio"]:::ui
        MenuSalud["MenuSalud"]:::ui
        vCicloMenstrual["vCicloMenstrual"]:::ui
        vDiagnostico["vDiagnostico"]:::ui
        vHistorialCiclo["vHistorialCiclo"]:::ui
        EditarDatosAcceso["EditarDatosAcceso"]:::ui
        EditarPerfil["EditarPerfil"]:::ui
        FechaUP["FechaUP"]:::ui
        EnviarCorreo["EnviarCorreo"]:::ui
        validaciones["validaciones"]:::ui
    end

    %% Controller Layer
    subgraph "Controller Layer"
        direction TB
        arranque["arranque"]:::controller
        controlador["controlador"]:::controller
        control_dp["control_dp"]:::controller
        control_ep["control_ep"]:::controller
        control_ec["control_ec"]:::controller
        control_cm["control_cm"]:::controller
        control_diagnostico["control_diagnostico"]:::controller
        control_historial["control_historial"]:::controller
        conexion_bd["conexion_bd"]:::controller
        generarpdf["generarpdf"]:::controller
        guiapdf["guiapdf"]:::controller
    end

    %% Model Layer
    subgraph "Model Layer"
        direction TB
        CalcularCiclo["CalcularCiclo"]:::model
        CambioMenstruacion["CambioMenstruacion"]:::model
        CicloMenstrual["CicloMenstrual"]:::model
        Diagnostico["Diagnostico"]:::model
        HistorialCiclo["HistorialCiclo"]:::model
        RespaldoSeguridad["RespaldoSeguridad"]:::model
        EstudianteF["EstudianteF"]:::model
    end

    %% External Libraries & Systems
    subgraph "External Libraries & Systems"
        direction TB
        MySQLDB[(MySQL Database)]:::external
        SMTP[(SMTP Server)]:::external
        iTextLib[(iText PDF 5.5.x)]:::lib
        JavaMailLib[(JavaMail)]:::lib
        JCalendarLib[(JCalendar)]:::lib
        MySQLConnector[(MySQL Connector/J)]:::lib
    end

    %% Build & Deployment
    subgraph "Build & Deployment"
        direction TB
        buildXML["build.xml"]:::utility
        nbproject["nbproject/"]:::utility
        ProyectoJar["ProyectoT2.jar"]:::utility
    end

    %% Data Flows
    subgraph "Data Flows"
        direction TB
        UI["UI Layer"] -->|"user events"| Controller["Controller Layer"]
        Controller -->|"invokes"| Model["Model Layer"]
        conexion_bd -->|"JDBC"| MySQLConnector
        conexion_bd -->|"connects to"| MySQLDB
        generarpdf -->|"uses"| iTextLib
        guiapdf -->|"uses"| iTextLib
        FechaUP -->|"date picker"| JCalendarLib
        EnviarCorreo -->|"sends via"| SMTP
        Controller --> ProyectoJar
        buildXML --> ProyectoJar
        nbproject --> ProyectoJar
    end

    %% Click Events
    click LoginP "https://github.com/blaiken/menstrutrack-pt2/blob/main/src/vista/LoginP.java"
    click MenuInicio "https://github.com/blaiken/menstrutrack-pt2/blob/main/src/vista/MenuInicio.java"
    click MenuSalud "https://github.com/blaiken/menstrutrack-pt2/blob/main/src/vista/MenuSalud.java"
    click vCicloMenstrual "https://github.com/blaiken/menstrutrack-pt2/blob/main/src/vista/vCicloMenstrual.java"
    click vDiagnostico "https://github.com/blaiken/menstrutrack-pt2/blob/main/src/vista/vDiagnostico.java"
    click vHistorialCiclo "https://github.com/blaiken/menstrutrack-pt2/blob/main/src/vista/vHistorialCiclo.java"
    click EditarDatosAcceso "https://github.com/blaiken/menstrutrack-pt2/blob/main/src/vista/EditarDatosAcceso.java"
    click EditarPerfil "https://github.com/blaiken/menstrutrack-pt2/blob/main/src/vista/EditarPerfil.java"
    click FechaUP "https://github.com/blaiken/menstrutrack-pt2/blob/main/src/vista/FechaUP.java"
    click EnviarCorreo "https://github.com/blaiken/menstrutrack-pt2/blob/main/src/vista/EnviarCorreo.java"
    click validaciones "https://github.com/blaiken/menstrutrack-pt2/blob/main/src/vista/validaciones.java"
    click arranque "https://github.com/blaiken/menstrutrack-pt2/blob/main/src/controlador/arranque.java"
    click controlador "https://github.com/blaiken/menstrutrack-pt2/blob/main/src/controlador/controlador.java"
    click control_dp "https://github.com/blaiken/menstrutrack-pt2/blob/main/src/controlador/control_dp.java"
    click control_ep "https://github.com/blaiken/menstrutrack-pt2/blob/main/src/controlador/control_ep.java"
    click control_ec "https://github.com/blaiken/menstrutrack-pt2/blob/main/src/controlador/control_ec.java"
    click control_cm "https://github.com/blaiken/menstrutrack-pt2/blob/main/src/controlador/control_cm.java"
    click control_diagnostico "https://github.com/blaiken/menstrutrack-pt2/blob/main/src/controlador/control_diagnostico.java"
    click control_historial "https://github.com/blaiken/menstrutrack-pt2/blob/main/src/controlador/control_historial.java"
    click conexion_bd "https://github.com/blaiken/menstrutrack-pt2/blob/main/src/controlador/conexion_bd.java"
    click generarpdf "https://github.com/blaiken/menstrutrack-pt2/blob/main/src/controlador/generarpdf.java"
    click guiapdf "https://github.com/blaiken/menstrutrack-pt2/blob/main/src/controlador/guiapdf.java"
    click CalcularCiclo "https://github.com/blaiken/menstrutrack-pt2/blob/main/src/modelo/CalcularCiclo.java"
    click CambioMenstruacion "https://github.com/blaiken/menstrutrack-pt2/blob/main/src/modelo/CambioMenstruacion.java"
    click CicloMenstrual "https://github.com/blaiken/menstrutrack-pt2/blob/main/src/modelo/CicloMenstrual.java"
    click Diagnostico "https://github.com/blaiken/menstrutrack-pt2/blob/main/src/modelo/Diagnostico.java"
    click HistorialCiclo "https://github.com/blaiken/menstrutrack-pt2/blob/main/src/modelo/HistorialCiclo.java"
    click RespaldoSeguridad "https://github.com/blaiken/menstrutrack-pt2/blob/main/src/modelo/RespaldoSeguridad.java"
    click EstudianteF "https://github.com/blaiken/menstrutrack-pt2/blob/main/src/modelo/EstudianteF.java"
    click MySQLConnector "https://github.com/blaiken/menstrutrack-pt2/blob/main/dist/lib/mysql-connector-j-9.0.0.jar"
    click iTextLib "https://github.com/blaiken/menstrutrack-pt2/blob/main/dist/lib/itextpdf-5.5.13.4.jar"
    click JavaMailLib "https://github.com/blaiken/menstrutrack-pt2/blob/main/dist/lib/mail.jar"
    click JCalendarLib "https://github.com/blaiken/menstrutrack-pt2/blob/main/dist/lib/jcalendar-1.4.jar"
    click buildXML "https://github.com/blaiken/menstrutrack-pt2/blob/main/build.xml"
    click nbproject "https://github.com/blaiken/menstrutrack-pt2/tree/main/nbproject/"
    click ProyectoJar "https://github.com/blaiken/menstrutrack-pt2/blob/main/dist/ProyectoT2.jar"

    %% Styles
    classDef ui fill:#cce5ff,stroke:#333,stroke-width:1px
    classDef controller fill:#d4edda,stroke:#333,stroke-width:1px
    classDef model fill:#fff3cd,stroke:#333,stroke-width:1px
    classDef external fill:#f8d7da,stroke:#333,stroke-width:1px
    classDef lib fill:#e2e3e5,stroke:#333,stroke-width:1px
    classDef utility fill:#d1ecf1,stroke:#333,stroke-width:1px
```
