How hammami-ghassen/pfe works
GRH MSP is a human-resources application: staff authenticate with OTP, obtain a role-scoped session, and use the React portal to manage leave, personnel corrections, administration, dashboards, and chat. Its Spring API connects those workflows to legacy personnel data and application persistence. A separate Airflow-oriented ETL pipeline extracts, transforms, and loads HR data for analytics; the README explicitly places it outside the main application architecture. The graph preserves documented capabilities, but several backend subsystems were not sampled, so their internal call paths are left unasserted.
Main entry points: App.js React routes · etl_dag.py ETL orchestration · AuthController.java Authentication API · OtpAuthService.java OTP workflow
Components 24
Web portal
- React routes
client/src/App.js - Auth context
client/src/context/AuthContext.jsx - OTP sign-in
client/src/pages/auth/LoginPage.jsx - Leave screens
client/src/pages/leave - Admin screens
client/src/pages/admin - Chat screen
client/src/pages/chat/ChatPage.jsx - Dashboards
client/src/pages/dashboard
Identity and access
- Authentication API
server/src/main/java/com/sante/app/controller/AuthController.java - OTP workflow
server/src/main/java/com/sante/app/service/OtpAuthService.java - Token lifecycle
server/src/main/java/com/sante/app/service/AuthTokenService.java - JWT provider
server/src/main/java/com/sante/app/security/jwt/JwtTokenProvider.java
HR operations
- Leave API
server/src/main/java/com/sante/app/controller/LeaveController.java - Leave rules and requests
server/src/main/java/com/sante/app/service/LeaveService.java - Personnel data
server/src/main/java/com/sante/app/repository/PersonnelRepository.java - Corrections and personnel admin
server/src/main/java/com/sante/app/controller/AdminCorrectionController.java - News and notifications
server/src/main/java/com/sante/app/controller/NewsController.java
Communication
- Chat API
server/src/main/java/com/sante/app/controller/chat/ChatController.java - Chat messaging
server/src/main/java/com/sante/app/service/chat/ChatService.java
Analytics ETL
- ETL orchestration
ETL_PFE/dags/etl_dag.py - Source extraction
ETL_PFE/etl/extract.py - HR transformations
ETL_PFE/etl/transform.py - Analytics loading
ETL_PFE/etl/load.py - Analytics store
Other components
- Staff / Admin
Connections 25
- Staff / Admin → React routes: uses portal
client/src/App.js - React routes → OTP sign-in: routes to
client/src/App.js - React routes → Leave screens: routes to
client/src/App.js - React routes → Admin screens: routes to
client/src/App.js - React routes → Chat screen: routes to
client/src/App.js - React routes → Dashboards: routes to
client/src/App.js - OTP sign-in → Authentication API: requests OTP
- Authentication API → OTP workflow: delegates to
server/src/main/java/com/sante/app/controller/AuthController.java - OTP workflow → Personnel data: checks staff
server/src/main/java/com/sante/app/service/OtpAuthService.java - OTP workflow → Token lifecycle: issues session
server/src/main/java/com/sante/app/service/OtpAuthService.java - Token lifecycle → JWT provider: generates tokens
server/src/main/java/com/sante/app/service/AuthTokenService.java - Authentication API → Auth context: returns session
- Leave screens → Leave API: calls API
- Leave API → Leave rules and requests: delegates to
server/src/main/java/com/sante/app/controller/LeaveController.java - Leave rules and requests → Personnel data: reads staff
server/src/main/java/com/sante/app/service/LeaveService.java - Admin screens → Corrections and personnel admin: submits admin actions
- Chat screen → Chat API: uses messaging
- Chat API → Chat messaging: delegates to
server/src/main/java/com/sante/app/controller/chat/ChatController.java - Chat messaging → Personnel data: looks up contacts
server/src/main/java/com/sante/app/service/chat/ChatService.java - Dashboards → News and notifications: shows updates
- ETL orchestration → Source extraction: runs extraction
ETL_PFE/dags/etl_dag.py - ETL orchestration → HR transformations: runs transforms
ETL_PFE/dags/etl_dag.py - ETL orchestration → Analytics loading: runs loading
ETL_PFE/dags/etl_dag.py - HR transformations → Analytics loading: produces datasets
ETL_PFE/etl/main.py - Analytics loading → Analytics store: writes analytics