# joaquinpralong2002/tallerpoo architecture

> Architecture diagram of the GitHub repository joaquinpralong2002/tallerpoo, 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/joaquinpralong2002/tallerpoo
- Repository: https://github.com/joaquinpralong2002/tallerpoo

## Overview

##### Project type and purpose
- This is a monolithic desktop application written in Java, using JavaFX for the UI and Hibernate (via a GlobalSessionFactory) for persistence.
- It follows an MVC-style pattern: FXML views + JavaFX controllers → business logic in controller classes → DAO layer for database access → MySQL backend.
- It was built as an Object-Oriented Programming workshop (“Taller de POO”) with optional test-data creation at startup.

##### File structure
- src/main/java/controllers: JavaFX controllers (divided into subpackages by role: Administración, AtencionPaciente, Enfermero, Médico, Sistemas, plus singletons).
- src/main/java/model: JPA/Hibernate entity classes and enums.
- src/main/java/datasource: DAO classes implementing database operations against MySQL, plus a GenericoDAO interface.
- src/main/java/util: GlobalSessionFactory, which boots up Hibernate and provides Session objects.
- src/main/java/org/example: Application.java and CreacionDatos.java (entrypoint and test-data generator).
- src/main/resources/views: FXML view files, organized by user role.
- pom.xml: Maven build and dependency management.

##### README for additional insights
- The application expects optional command-line args to control whether to seed test data, and to override DB URL/user/password.
- Defaults to “jdbc:mysql://localhost:3306/tallerdb” with a specified driver.
- JavaFX setup instructions via a referenced tutorial.

##### Main components & their relationships
a. UI Layer (JavaFX Desktop):
– FXML view files under src/main/resources/views
– ViewController classes in controllers/* that bind to the FXML
b. Controller Layer (Business Logic):
– Controllers coordinate user actions, validate inputs, orchestrate service calls.
– Singletons classes provide central entry-points per role.
c. Persistence Layer (DAO + Hibernate):
– DAO classes in datasource/ implement CRUD over model entities.
– GenericoDAO interface defines common methods.
– GlobalSessionFactory in util initializes Hibernate SessionFactory.
d. Model Layer:
– Entity classes (model/*.java) annotated for Hibernate.
– Enumerations define domain constants like Roles, Triage variables, etc.
e. Database:
– MySQL database “tallerdb” (or custom URL).
– Schema auto-generated or manually provisioned.
f. Bootstrap & Configuration:
– org.example.Application loads JavaFX and kicks off the first view.
– org.example.CreacionDatos optionally seeds test data.
g. Build & Deployment:
– pom.xml drives compilation, resource packaging, and dependency injection.

##### Important architectural patterns & design principles
- MVC (Model–View–Controller) separation: FXML+controllers vs. model vs. DAO.
- DAO pattern encapsulates all persistence logic, keeping controllers unaware of SQL.
- Singleton pattern for shared controller instances (SingletonUsuario, SingletonMedico, etc.).
- Factory/Utility (GlobalSessionFactory) to centralize Hibernate initialization.

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph "Desktop App (JavaFX + Controllers)"
        subgraph "UI Layer"
            FXML["FXML Views"]:::ui
        end
        subgraph "Controller Layer"
            AdminCtrl["Administración Controllers"]:::ctrl
            AtPacCtrl["AtencionPaciente Controllers"]:::ctrl
            EnfermeroCtrl["Enfermero Controllers"]:::ctrl
            MedController["MedicoController"]:::ctrl
            HistController["HistorialClinicoController"]:::ctrl
            SistemasCtrl["Sistemas Controllers"]:::ctrl
            SingletonCtrl["Singleton Controllers"]:::ctrl
            TriageCtrl["Triage Controllers"]:::ctrl
        end
    end

    subgraph "Persistence Layer"
        DAOImp["DAO Implementations"]:::dao
        GenDAO["GenericoDAO Interface"]:::dao
        SessionFactory["GlobalSessionFactory"]:::dao
    end

    DB["MySQL Database"]:::db

    Bootstrap["Application Entry Point"]:::ctrl
    Seeder["Test Data Seeder"]:::ctrl
    Build["pom.xml"]:::build

    %% Connections
    FXML -->|"loadView()"| AdminCtrl
    FXML -->|"loadView()"| AtPacCtrl
    FXML -->|"loadView()"| EnfermeroCtrl
    FXML -->|"loadView()"| MedController
    FXML -->|"loadView()"| HistController
    FXML -->|"loadView()"| SistemasCtrl
    FXML -->|"loadView()"| SingletonCtrl
    FXML -->|"loadView()"| TriageCtrl

    AdminCtrl -->|"handleAction()"| DAOImp
    AtPacCtrl -->|"handleAction()"| DAOImp
    EnfermeroCtrl -->|"handleAction()"| DAOImp
    MedController -->|"handleAction()"| DAOImp
    HistController -->|"handleAction()"| DAOImp
    SistemasCtrl -->|"handleAction()"| DAOImp
    SingletonCtrl -->|"handleAction()"| DAOImp
    TriageCtrl -->|"handleAction()"| DAOImp

    DAOImp -->|"openSession() / save()/query() "| SessionFactory
    GenDAO -->|"interface methods"| DAOImp
    SessionFactory -->|"JDBC Connection"| DB

    Bootstrap -->|"launch() UI"| FXML
    Bootstrap -->|"init Hibernate"| SessionFactory
    Seeder -->|"seedTestData()"| DAOImp
    Build -->|"build & package"| Bootstrap

    %% Click Events
    click FXML "https://github.com/joaquinpralong2002/tallerpoo/tree/main/src/main/resources/views"
    click AdminCtrl "https://github.com/joaquinpralong2002/tallerpoo/tree/main/src/main/java/controllers/Administracion"
    click AtPacCtrl "https://github.com/joaquinpralong2002/tallerpoo/tree/main/src/main/java/controllers/AtencionPaciente"
    click EnfermeroCtrl "https://github.com/joaquinpralong2002/tallerpoo/tree/main/src/main/java/controllers/Enfermero"
    click MedController "https://github.com/joaquinpralong2002/tallerpoo/blob/main/src/main/java/controllers/MedicoController.java"
    click HistController "https://github.com/joaquinpralong2002/tallerpoo/blob/main/src/main/java/controllers/HistorialClinicoController.java"
    click SistemasCtrl "https://github.com/joaquinpralong2002/tallerpoo/tree/main/src/main/java/controllers/Sistemas"
    click SingletonCtrl "https://github.com/joaquinpralong2002/tallerpoo/tree/main/src/main/java/controllers/Singletons"
    click TriageCtrl "https://github.com/joaquinpralong2002/tallerpoo/tree/main/src/main/java/controllers/Triage"
    click DAOImp "https://github.com/joaquinpralong2002/tallerpoo/tree/main/src/main/java/datasource"
    click GenDAO "https://github.com/joaquinpralong2002/tallerpoo/blob/main/src/main/java/datasource/interfaces/GenericoDAO.java"
    click SessionFactory "https://github.com/joaquinpralong2002/tallerpoo/blob/main/src/main/java/util/GlobalSessionFactory.java"
    click ModelLayer "https://github.com/joaquinpralong2002/tallerpoo/tree/main/src/main/java/model"
    click Bootstrap "https://github.com/joaquinpralong2002/tallerpoo/blob/main/src/main/java/org/example/Application.java"
    click Seeder "https://github.com/joaquinpralong2002/tallerpoo/blob/main/src/main/java/org/example/CreacionDatos.java"
    click Build "https://github.com/joaquinpralong2002/tallerpoo/blob/main/pom.xml"

    %% Styles
    classDef ui fill:#FFE5B4,stroke:#F5A623,stroke-width:2px
    classDef ctrl fill:#B3E5FC,stroke:#0288D1,stroke-width:2px
    classDef dao fill:#C8E6C9,stroke:#388E3C,stroke-width:2px
    classDef db fill:#2E7D32,stroke:#1B5E20,stroke-width:2px,shape:cylinder
    classDef build fill:#E0E0E0,stroke:#9E9E9E,stroke-width:2px
```
