# adamxstudio/mrm24 architecture

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

- Interactive diagram: https://gitdiagram.com/adamxstudio/mrm24
- Repository: https://github.com/adamxstudio/mrm24

## Overview

##### Project type and purpose
- This is a monolithic, desktop “full-stack” CRUD application for managing a medicalized retirement home.
- It uses JavaFX for the GUI, a DAO layer (Hibernate/JPA) for persistence, four business-model classes (Patient, Personnel, RendezVous, Chambre), and a MySQL database.

##### File structure
- Top-level modules:
- Conception/ – UML and use-case models
- mrm24console/ – Maven wrapper + embedded JavaFX SDK (assembly module to package/run JavaFX)
- mrm24jee/ – Core application source
- mrm24jee/src/main/java:
- gui/JavaFXMain.java – application entry point
- gui/controllers/*.java – JavaFX controllers
- model/*.java – JPA-annotated entity classes
- dao/*.java – DAO interfaces & implementations, all implementing GestionMaisonRetraite<T>
- mrm24jee/src/main/resources:
- persistence.xml – Hibernate/JPA configuration
- gui/views/*.fxml – JavaFX view definitions
- pom.xml files define dependencies on JavaFX, Hibernate, JPA, MySQL connector.

##### README for additional insights
- Confirms a three-tier GUI-DAO-Métier architecture.
- Lists the four domain entities and their attributes.
- Describes the common DAO interface GestionMaisonRetraite<T> and per-entity DAO classes.

a. Main components:
1. mrm24console module (JavaFX SDK + launcher)
2. mrm24jee module (application logic)
- Presentation Layer (JavaFX GUI + FXML views)
- Controller Layer (JavaFX controllers)
- Business/Model Layer (JPA entities: Patient, Personnel, RendezVous, Chambre)
- DAO Layer (Hibernate/JPA DAOs)
3. External MySQL database
b. Relationships & data flow:
- User events → JavaFX Views → Controllers
- Controllers → Business models + DAO interface calls
- DAOs → Hibernate Session → MySQL DB
- Query results → Model objects → Controller → View updates
c. Architectural patterns & principles:
- Layered architecture (Presentation → Controller → DAO → Database)
- DAO pattern for persistence abstraction
- JavaFX’s MVC-ish pattern (FXML view + controller)
- Common DAO interface (GestionMaisonRetraite<T>) for uniform CRUD operations
d. Technologies & frameworks:
- JavaFX 23 for GUI (in mrm24console’s embedded SDK)
- Hibernate 6 (JPA) for ORM
- MySQL (replacing Oracle in README)
- Maven for build/dependency management

##### Key details to capture
- The two-module setup: one for bundling JavaFX, one for application code.
- The GUI-Controller-Model-DAO layering and flow of data.
- The use of JPA entities and Hibernate SessionFactory.
- The uniform CRUD interface (GestionMaisonRetraite<T>) across all entities.
- FXML views and their controllers, showing how the presentation binds to business logic.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Modules
    subgraph "mrm24console Module"
        mConsole["mrm24console/pom.xml"]:::external
    end
    subgraph "mrm24jee Module"
        mJee["mrm24jee/pom.xml"]:::external
        JavaFXMain["JavaFXMain"]:::presentation
        %% Presentation Layer
        subgraph "Presentation Layer"
            %% Views
            MainLayoutFxml["MainLayout.fxml"]:::presentation
            PatientViewFxml["PatientView.fxml"]:::presentation
            PersonnelViewFxml["PersonnelView.fxml"]:::presentation
            ChambreViewFxml["ChambreView.fxml"]:::presentation
            RendezVousViewFxml["RendezVousView.fxml"]:::presentation
            %% Controllers
            MainLayoutController["MainLayoutController"]:::presentation
            PatientController["PatientController"]:::presentation
            PersonnelController["PersonnelController"]:::presentation
            ChambreController["ChambreController"]:::presentation
            RendezVousController["RendezVousController"]:::presentation
        end
        %% Business Model Layer
        subgraph "Business/Model Layer"
            Patient["Patient"]:::model
            Personnel["Personnel"]:::model
            Chambre["Chambre"]:::model
            RendezVous["RendezVous"]:::model
        end
        %% DAO Layer
        subgraph "DAO Layer"
            IClass["GestionMaisonRetraite<T>"]:::dao
            PatientDAO["PatientDAO"]:::dao
            PersonnelDAO["PersonnelDAO"]:::dao
            ChambreDAO["ChambreDAO"]:::dao
            RendezVousDAO["RendezVousDAO"]:::dao
        end
        %% Configuration
        Persistence["persistence.xml"]:::external
    end
    %% Design Artifacts
    subgraph "Conception Artifacts"
        UMLClass["class__gestionnaire_maison_retraite_médicalisée.moo"]:::external
        UMLUseCase["use_case_gestionnaire_maison_retraite_médicalisée.moo"]:::external
    end

    %% External DB
    MySQLDB["MySQL Database"]:::external

    %% Relationships
    mConsole -->|provides JavaFX SDK| JavaFXMain
    JavaFXMain -->|"loadFXML() MainLayout"| MainLayoutFxml
    MainLayoutFxml -->|"user event"| MainLayoutController
    PatientViewFxml -->|"user event"| PatientController
    PersonnelViewFxml -->|"user event"| PersonnelController
    ChambreViewFxml -->|"user event"| ChambreController
    RendezVousViewFxml -->|"user event"| RendezVousController

    MainLayoutController -->|"invoke CRUD"| IClass
    PatientController -->|"invoke CRUD"| IClass
    PersonnelController -->|"invoke CRUD"| IClass
    ChambreController -->|"invoke CRUD"| IClass
    RendezVousController -->|"invoke CRUD"| IClass

    IClass -->|"implemented by"| PatientDAO
    IClass -->|"implemented by"| PersonnelDAO
    IClass -->|"implemented by"| ChambreDAO
    IClass -->|"implemented by"| RendezVousDAO

    PatientDAO -->|"ORM via Hibernate"| Persistence
    PersonnelDAO -->|"ORM via Hibernate"| Persistence
    ChambreDAO -->|"ORM via Hibernate"| Persistence
    RendezVousDAO -->|"ORM via Hibernate"| Persistence

    Persistence -->|"SQL operations"| MySQLDB
    MySQLDB -->|"result sets"| Persistence

    %% Controllers interact with models
    MainLayoutController -->|"manipulate"| Patient
    MainLayoutController -->|"manipulate"| Personnel
    MainLayoutController -->|"manipulate"| Chambre
    MainLayoutController -->|"manipulate"| RendezVous
    PatientController -->|"manipulate"| Patient
    PersonnelController -->|"manipulate"| Personnel
    ChambreController -->|"manipulate"| Chambre
    RendezVousController -->|"manipulate"| RendezVous

    %% Click Events
    click mConsole "https://github.com/adamxstudio/mrm24/blob/main/mrm24console/pom.xml"
    click mJee "https://github.com/adamxstudio/mrm24/blob/main/mrm24jee/pom.xml"
    click JavaFXMain "https://github.com/adamxstudio/mrm24/blob/main/mrm24jee/src/main/java/gui/JavaFXMain.java"
    click MainLayoutFxml "https://github.com/adamxstudio/mrm24/blob/main/mrm24jee/src/main/resources/gui/views/MainLayout.fxml"
    click PatientViewFxml "https://github.com/adamxstudio/mrm24/blob/main/mrm24jee/src/main/resources/gui/views/PatientView.fxml"
    click PersonnelViewFxml "https://github.com/adamxstudio/mrm24/blob/main/mrm24jee/src/main/resources/gui/views/PersonnelView.fxml"
    click ChambreViewFxml "https://github.com/adamxstudio/mrm24/blob/main/mrm24jee/src/main/resources/gui/views/ChambreView.fxml"
    click RendezVousViewFxml "https://github.com/adamxstudio/mrm24/blob/main/mrm24jee/src/main/resources/gui/views/RendezVousView.fxml"
    click MainLayoutController "https://github.com/adamxstudio/mrm24/blob/main/mrm24jee/src/main/java/gui/controllers/MainLayoutController.java"
    click PatientController "https://github.com/adamxstudio/mrm24/blob/main/mrm24jee/src/main/java/gui/controllers/PatientController.java"
    click PersonnelController "https://github.com/adamxstudio/mrm24/blob/main/mrm24jee/src/main/java/gui/controllers/PersonnelController.java"
    click ChambreController "https://github.com/adamxstudio/mrm24/blob/main/mrm24jee/src/main/java/gui/controllers/ChambreController.java"
    click RendezVousController "https://github.com/adamxstudio/mrm24/blob/main/mrm24jee/src/main/java/gui/controllers/RendezVousController.java"
    click Patient "https://github.com/adamxstudio/mrm24/blob/main/mrm24jee/src/main/java/model/Patient.java"
    click Personnel "https://github.com/adamxstudio/mrm24/blob/main/mrm24jee/src/main/java/model/Personnel.java"
    click Chambre "https://github.com/adamxstudio/mrm24/blob/main/mrm24jee/src/main/java/model/Chambre.java"
    click RendezVous "https://github.com/adamxstudio/mrm24/blob/main/mrm24jee/src/main/java/model/RendezVous.java"
    click IClass "https://github.com/adamxstudio/mrm24/blob/main/mrm24jee/src/main/java/dao/IClass.java"
    click PatientDAO "https://github.com/adamxstudio/mrm24/blob/main/mrm24jee/src/main/java/dao/PatientDAO.java"
    click PersonnelDAO "https://github.com/adamxstudio/mrm24/blob/main/mrm24jee/src/main/java/dao/PersonnelDAO.java"
    click ChambreDAO "https://github.com/adamxstudio/mrm24/blob/main/mrm24jee/src/main/java/dao/ChambreDAO.java"
    click RendezVousDAO "https://github.com/adamxstudio/mrm24/blob/main/mrm24jee/src/main/java/dao/RendezVousDAO.java"
    click Persistence "https://github.com/adamxstudio/mrm24/blob/main/mrm24jee/src/main/resources/META-INF/persistence.xml"
    click UMLClass "https://github.com/adamxstudio/mrm24/blob/main/Conception/class__gestionnaire_maison_retraite_médicalisée.moo"
    click UMLUseCase "https://github.com/adamxstudio/mrm24/blob/main/Conception/use_case_gestionnaire_maison_retraite_médicalisée.moo"

    %% Styles
    classDef presentation fill:#cce5ff,stroke:#333,stroke-width:1px
    classDef model fill:#ccffcc,stroke:#333,stroke-width:1px
    classDef dao fill:#ffe5cc,stroke:#333,stroke-width:1px
    classDef external fill:#e0e0e0,stroke:#333,stroke-width:1px
```
