How chafik-akmouche/pdph-backend works
PdPH is a hospital-staff scheduling backend: a client submits cycle length, constraint options, and input data; the service persists request files, invokes the scheduling solver, and exposes saved solutions as JSON. The solver parses staffing requirements and builds an optimization model using CPLEX. The graph also shows the separate solution-browsing and saved-parameter capabilities. Source excerpts establish the API, input preparation, solver invocation, and result parsing; the solver’s complete output-to-solution-file path is not shown, so that relationship is left unconnected.
Main entry points: Controller.java REST Controller · Response.java Solution Reader · Solver.java Schedule Optimizer · SolveurParam.java Solver Parameters
Components 13
HTTP API
- Spring Application
src/main/java/com/projet/annuel/pdph/PdPHBackend/PdPhBackendApplication.java - REST Controller
src/main/java/com/projet/annuel/pdph/PdPHBackend/Controller.java
Request Preparation
- Solver Parameters
src/main/java/com/projet/annuel/pdph/PdPHBackend/SolveurParam.java - Input and Config Files
src/main/java/com/projet/annuel/pdph/PdPHBackend/SolveurParam.java
Scheduling Optimization
- Solver Launcher
src/main/java/com/projet/annuel/pdph/PdPHBackend/CallSolver.java - Schedule Optimizer
src/main/java/com/projet/annuel/pdph/solveur/Solver.java - Input Parsing and Metrics
src/main/java/com/projet/annuel/pdph/solveur/Functions.java
Solution Browsing
- Saved Solution Files
src/main/java/com/projet/annuel/pdph/PdPHBackend/Response.java - Solution Reader
src/main/java/com/projet/annuel/pdph/PdPHBackend/Response.java - Schedule Slot DTO
src/main/java/com/projet/annuel/pdph/PdPHBackend/Creneau.java - Solution List DTO
src/main/java/com/projet/annuel/pdph/PdPHBackend/FilterParams.java
Other components
- API Client
- IBM CPLEX
Connections 14
- API Client → REST Controller: sends requests
src/main/java/com/projet/annuel/pdph/PdPHBackend/Controller.java - Spring Application → REST Controller: serves API
- REST Controller → Solver Parameters: accepts parameters
src/main/java/com/projet/annuel/pdph/PdPHBackend/Controller.java - REST Controller → Input and Config Files: persists request
src/main/java/com/projet/annuel/pdph/PdPHBackend/Controller.java - Solver Parameters → Input and Config Files: writes files
src/main/java/com/projet/annuel/pdph/PdPHBackend/SolveurParam.java - REST Controller → Solver Launcher: starts solve
src/main/java/com/projet/annuel/pdph/PdPHBackend/Controller.java - Solver Launcher → Schedule Optimizer: constructs solver
src/main/java/com/projet/annuel/pdph/PdPHBackend/CallSolver.java - Schedule Optimizer → Input Parsing and Metrics: parses inputs
src/main/java/com/projet/annuel/pdph/solveur/Solver.java - Schedule Optimizer → IBM CPLEX: solves model
src/main/java/com/projet/annuel/pdph/solveur/Solver.java - REST Controller → Solution Reader: reads solutions
src/main/java/com/projet/annuel/pdph/PdPHBackend/Controller.java - Solution Reader → Saved Solution Files: reads workbook
src/main/java/com/projet/annuel/pdph/PdPHBackend/Response.java - Solution Reader → Schedule Slot DTO: builds schedule slots
src/main/java/com/projet/annuel/pdph/PdPHBackend/Response.java - REST Controller → Solution List DTO: returns solution list
src/main/java/com/projet/annuel/pdph/PdPHBackend/Controller.java - Solution Reader → Solution List DTO: provides solution names
src/main/java/com/projet/annuel/pdph/PdPHBackend/Controller.java