How adamxstudio/mrm24 works
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.