How hiptran24/smart-recruitment-platform works
Smart Recruitment is a recruitment-platform foundation: its backend defines persisted identity, candidate, company, job, and application domains with lifecycle rules, while the frontend is an admin-console UI currently backed by mock data. The visible user workflow is navigation through recruiter and administrative views to inspect recruiting operations and manage platform domains. The README describes a secure-by-default HTTP boundary, but authenticated business APIs are not yet implemented. Backend coverage is therefore modeled as domain persistence and security configuration, not as an end-to-end recruitment API; unsampled capabilities are shown only where documented.
Main entry points: App.tsx Console router · mock.ts Mock domain data · BaseEntity.java Persistence base · JobApplication.java Application lifecycle
Components 28
Admin console
- Console router
frontend/src/App.tsx - Admin shell
frontend/src/components/layout/AdminLayout.tsx - Recruiter dashboard
frontend/src/pages/RecruiterDashboard.tsx - Platform console
frontend/src/pages/AdminConsole.tsx - Job management
frontend/src/pages/JobManagement.tsx - Application management
frontend/src/pages/ApplicationManagement.tsx - Candidate directory
frontend/src/pages/CandidateDirectory.tsx - User directory
frontend/src/pages/UserDirectory.tsx - Role management
frontend/src/pages/UserRoleManagement.tsx - Skill taxonomy
frontend/src/pages/SkillTaxonomy.tsx - Audit explorer
frontend/src/pages/AuditEventExplorer.tsx - Settings
frontend/src/pages/SettingsConfiguration.tsx - Mock domain data
frontend/src/data/mock.ts - UI domain types
frontend/src/types/index.ts
Backend foundation
- Spring Boot runtime
src/main/java/com/recruitment/app/Application.java - HTTP security boundary
src/main/java/com/recruitment/app/common/security/SecurityConfiguration.java
Recruitment domains
- Identity records
src/main/java/com/recruitment/app/modules/identity/infrastructure/persistence/entity/User.java - Candidate profile
src/main/java/com/recruitment/app/modules/candidates/infrastructure/persistence/entity/CandidateProfile.java - Candidate details
src/main/java/com/recruitment/app/modules/candidates/infrastructure/persistence/entity/CandidateEducation.java - Company records
src/main/java/com/recruitment/app/modules/companies/infrastructure/persistence/entity/Company.java - Job records
src/main/java/com/recruitment/app/modules/jobs/infrastructure/persistence/entity/Job.java - Application lifecycle
src/main/java/com/recruitment/app/modules/applications/infrastructure/persistence/entity/JobApplication.java - Application screening
src/main/java/com/recruitment/app/modules/applications/infrastructure/persistence/entity/ApplicationScreening.java - Status history
src/main/java/com/recruitment/app/modules/applications/infrastructure/persistence/entity/ApplicationStatusHistory.java
Shared infrastructure
- Persistence base
src/main/java/com/recruitment/app/common/infrastructure/persistence/BaseEntity.java
Other components
- Console user
- HTTP client
- MySQL
Connections 34
- Console user → Console router: opens console
frontend/src/App.tsx - Console router → Admin shell: wraps routes
frontend/src/App.tsx - Console router → Recruiter dashboard: routes to
frontend/src/App.tsx - Console router → Platform console: routes to
frontend/src/App.tsx - Console router → Job management: routes to
frontend/src/App.tsx - Console router → Application management: routes to
frontend/src/App.tsx - Console router → Candidate directory: routes to
frontend/src/App.tsx - Console router → User directory: routes to
frontend/src/App.tsx - Console router → Role management: routes to
frontend/src/App.tsx - Console router → Skill taxonomy: routes to
frontend/src/App.tsx - Console router → Audit explorer: routes to
frontend/src/App.tsx - Console router → Settings: routes to
frontend/src/App.tsx - Admin shell → Console user: presents UI
frontend/src/components/layout/AdminLayout.tsx - Recruiter dashboard → Mock domain data: reads
frontend/src/pages/RecruiterDashboard.tsx - Platform console → Mock domain data: reads
frontend/src/pages/AdminConsole.tsx - User directory → Mock domain data: reads
frontend/src/pages/UserDirectory.tsx - Application management → Mock domain data: reads
frontend/src/pages/ApplicationManagement.tsx - Audit explorer → Mock domain data: reads
frontend/src/pages/AuditEventExplorer.tsx - Mock domain data → UI domain types: uses types
frontend/src/data/mock.ts - Spring Boot runtime → HTTP security boundary: configures boundary
- HTTP client → HTTP security boundary: meets boundary
README.md - Identity records → Persistence base: extends
src/main/java/com/recruitment/app/modules/identity/infrastructure/persistence/entity/User.java - Candidate profile → Persistence base: extends
src/main/java/com/recruitment/app/modules/candidates/infrastructure/persistence/entity/CandidateProfile.java - Candidate profile → Candidate details: owns details
src/main/java/com/recruitment/app/modules/candidates/infrastructure/persistence/entity/CandidateProfile.java - Company records → Persistence base: extends
src/main/java/com/recruitment/app/modules/companies/infrastructure/persistence/entity/Company.java - Job records → Persistence base: extends
src/main/java/com/recruitment/app/modules/jobs/infrastructure/persistence/entity/Job.java - Application lifecycle → Persistence base: extends
src/main/java/com/recruitment/app/modules/applications/infrastructure/persistence/entity/JobApplication.java - Application lifecycle → Status history: records transitions
src/main/java/com/recruitment/app/modules/applications/infrastructure/persistence/entity/JobApplication.java - Application lifecycle → Application screening: has screenings
src/main/java/com/recruitment/app/modules/applications/infrastructure/persistence/entity/ApplicationScreening.java - MySQL → Identity records: persists schema
README.md - MySQL → Candidate profile: persists schema
README.md - MySQL → Company records: persists schema
README.md - MySQL → Job records: persists schema
README.md - MySQL → Application lifecycle: persists schema
README.md