How bharath-bit-byte/hamarashops works
HamaraShops.ai is a recruitment and candidate-management platform. A user registers or logs in, creates a profile with a resume, and administrators review candidates, change statuses, and retain shortlist history. The React client reaches Spring services through the API Gateway; candidate and authentication data are persisted, while resume files use Google Cloud Storage. The repository also includes a broader AI-services marketing site. Edges follow the sampled imports and README-documented flows; unsampled implementation details are not inferred.
Main entry points: App.jsx Routes and App · ApiGatewayApplication.java API Gateway · CandidateController.java Candidate Endpoints · AdminService.java Shortlist and Status
Components 21
React Client
- Routes and App
Frontend/client/src/App.jsx - Registration and Login
Frontend/client/src/components/Register.jsx - Profile Creation
Frontend/client/src/components/CreateProfile.jsx - Candidate Dashboard
Frontend/client/src/components/CandidateDashboard.jsx - Admin Dashboards
Frontend/client/src/components/Dashboard.jsx - API URL Configuration
Frontend/client/src/services/api.js - Candidate API Client
Frontend/client/src/services/candidates.js
API Entry
- API Gateway
Backend/ApiGateway/src/main/java/com/hamarashops/gateway/ApiGatewayApplication.java
Identity Service
- Auth Endpoints
Backend/AuthService/src/main/java/com/hamarashops/auth/controller/AuthController.java - User Authentication
Backend/AuthService/src/main/java/com/hamarashops/auth/service/UserService.java - User Repository
Backend/AuthService/src/main/java/com/hamarashops/auth/repository/UserRepository.java
Candidate Service
- Candidate Endpoints
Backend/CandidateService/src/main/java/com/hamarashops/candidate/controller/CandidateController.java - Profile Management
Backend/CandidateService/src/main/java/com/hamarashops/candidate/service/CandidateService.java - Candidate Repository
Backend/CandidateService/src/main/java/com/hamarashops/candidate/repository/CandidateProfileRepository.java - Resume Cloud Storage
Backend/CandidateService/src/main/java/com/hamarashops/candidate/service/CloudStorageService.java
Admin Workflows
- Admin Endpoints
Backend/AdminService/src/main/java/com/hamarashops/admin/controller/AdminController.java - Shortlist and Status
Backend/AdminService/src/main/java/com/hamarashops/admin/service/AdminService.java - Candidate Service Client
Backend/AdminService/src/main/java/com/hamarashops/admin/client/CandidateClient.java - Shortlist History
Backend/AdminService/src/main/java/com/hamarashops/admin/repository/ShortlistSnapshotRepository.java
Other components
- Applicant / Admin
- Google Cloud Storage
Connections 22
- Applicant / Admin → Routes and App: uses
- Routes and App → Registration and Login: routes to
Frontend/client/src/App.jsx - Routes and App → Profile Creation: routes to
Frontend/client/src/App.jsx - Routes and App → Candidate Dashboard: routes to
Frontend/client/src/App.jsx - Routes and App → Admin Dashboards: routes to
Frontend/client/src/App.jsx - Candidate Dashboard → Candidate API Client: calls
Frontend/client/src/components/CandidateDashboard.jsx - Admin Dashboards → API URL Configuration: uses
Frontend/client/src/components/Dashboard.jsx - Candidate API Client → API URL Configuration: uses
Frontend/client/src/services/candidates.js - API URL Configuration → API Gateway: targets
Frontend/client/src/services/api.js - API Gateway → Auth Endpoints: routes auth
- API Gateway → Candidate Endpoints: routes candidates
- API Gateway → Admin Endpoints: routes admin
- Auth Endpoints → User Authentication: delegates to
Backend/AuthService/src/main/java/com/hamarashops/auth/controller/AuthController.java - User Authentication → User Repository: reads and saves
Backend/AuthService/src/main/java/com/hamarashops/auth/service/UserService.java - Candidate Endpoints → Profile Management: delegates to
Backend/CandidateService/src/main/java/com/hamarashops/candidate/controller/CandidateController.java - Profile Management → Candidate Repository: reads and saves
Backend/CandidateService/src/main/java/com/hamarashops/candidate/service/CandidateService.java - Candidate Endpoints → Resume Cloud Storage: uploads and retrieves
Backend/CandidateService/src/main/java/com/hamarashops/candidate/controller/CandidateController.java - Resume Cloud Storage → Google Cloud Storage: stores files
Backend/CandidateService/src/main/java/com/hamarashops/candidate/service/CloudStorageService.java - Admin Endpoints → Shortlist and Status: delegates to
Backend/AdminService/src/main/java/com/hamarashops/admin/controller/AdminController.java - Shortlist and Status → Candidate Service Client: calls
Backend/AdminService/src/main/java/com/hamarashops/admin/service/AdminService.java - Shortlist and Status → Shortlist History: saves and reads
Backend/AdminService/src/main/java/com/hamarashops/admin/service/AdminService.java - Candidate Service Client → Candidate Endpoints: calls remotely