How shanthan-peshwaker/hrms-formi-9-use-case works
This is a new-hire compliance hub: the UI submits employee details and onboarding document text, then displays saved employees with I-9 and document-validation statuses and notes. The backend onboarding service coordinates I-9 verification, document validation, and persistence; the controller exposes create and employee-read endpoints. The tree includes both rule-based and AI-named validator implementations, but their internals and selection are not shown in the sampled source. The README provides no further capability detail, so uncertain validator and storage wiring is omitted.
Main entry points: EmployeeController.java Employee API · NewHireOnboardingService.java Onboarding workflow · App.jsx Employee form and list · DocumentValidator.java Document validator
Components 13
Web interface
- Employee form and list
hrt-newhire-hub/hrt-newhire-hub/frontend/src/App.jsx
API and onboarding
- Employee API
hrt-newhire-hub/hrt-newhire-hub/backend/src/main/java/com/hrthub/newhire/controller/EmployeeController.java - Hire request
hrt-newhire-hub/hrt-newhire-hub/backend/src/main/java/com/hrthub/newhire/dto/NewHireRequest.java - Employee response
hrt-newhire-hub/hrt-newhire-hub/backend/src/main/java/com/hrthub/newhire/dto/EmployeeResponse.java - Onboarding workflow
hrt-newhire-hub/hrt-newhire-hub/backend/src/main/java/com/hrthub/newhire/service/NewHireOnboardingService.java - API error handling
hrt-newhire-hub/hrt-newhire-hub/backend/src/main/java/com/hrthub/newhire/exception/GlobalExceptionHandler.java
Compliance checks
- I-9 verification
hrt-newhire-hub/hrt-newhire-hub/backend/src/main/java/com/hrthub/newhire/service/I9VerificationService.java - Document validator
hrt-newhire-hub/hrt-newhire-hub/backend/src/main/java/com/hrthub/newhire/service/DocumentValidator.java - Rule-based validator
hrt-newhire-hub/hrt-newhire-hub/backend/src/main/java/com/hrthub/newhire/service/RuleBasedDocumentValidator.java - AI validator
hrt-newhire-hub/hrt-newhire-hub/backend/src/main/java/com/hrthub/newhire/service/AiDocumentValidator.java
Employee persistence
- Employee record
hrt-newhire-hub/hrt-newhire-hub/backend/src/main/java/com/hrthub/newhire/entity/Employee.java - Employee repository
hrt-newhire-hub/hrt-newhire-hub/backend/src/main/java/com/hrthub/newhire/repository/EmployeeRepository.java
Other components
- HR user
Connections 13
- HR user → Employee form and list: enters details
- Employee form and list → Employee API: calls API
- Employee API → Hire request: binds input
- Employee API → Onboarding workflow: onboards or queries
- Onboarding workflow → I-9 verification: verifies I-9
- Onboarding workflow → Document validator: validates text
- Document validator → Rule-based validator: implemented by
- Document validator → AI validator: implemented by
- Onboarding workflow → Employee repository: saves or reads
- Employee repository → Employee record: persists record
- Employee API → Employee response: maps output
- Employee API → API error handling: handles exceptions
- Employee form and list → HR user: shows statuses