# bharath-bit-byte/hamarashops architecture

> Architecture diagram of the GitHub repository bharath-bit-byte/hamarashops, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bharath-bit-byte/hamarashops
- Repository: https://github.com/bharath-bit-byte/hamarashops

## Overview

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: [`Frontend/client/src/App.jsx`](https://github.com/bharath-bit-byte/hamarashops/blob/main/Frontend/client/src/App.jsx) (Routes and App), [`Backend/ApiGateway/src/main/java/com/hamarashops/gateway/ApiGatewayApplication.java`](https://github.com/bharath-bit-byte/hamarashops/blob/main/Backend/ApiGateway/src/main/java/com/hamarashops/gateway/ApiGatewayApplication.java) (API Gateway), [`Backend/CandidateService/src/main/java/com/hamarashops/candidate/controller/CandidateController.java`](https://github.com/bharath-bit-byte/hamarashops/blob/main/Backend/CandidateService/src/main/java/com/hamarashops/candidate/controller/CandidateController.java) (Candidate Endpoints), [`Backend/AdminService/src/main/java/com/hamarashops/admin/service/AdminService.java`](https://github.com/bharath-bit-byte/hamarashops/blob/main/Backend/AdminService/src/main/java/com/hamarashops/admin/service/AdminService.java) (Shortlist and Status)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React Client"]
  node_app["Routes and App<br/>[App.jsx]"]
  node_auth_ui["Registration and Login<br/>[Register.jsx]"]
  node_profile_ui["Profile Creation<br/>[CreateProfile.jsx]"]
  node_candidate_ui["Candidate Dashboard"]
  node_admin_ui["Admin Dashboards<br/>[Dashboard.jsx]"]
  node_frontend_api["API URL Configuration<br/>[api.js]"]
  node_candidate_api["Candidate API Client<br/>[candidates.js]"]
end

subgraph group_entry["API Entry"]
  node_gateway["API Gateway"]
end

subgraph group_identity["Identity Service"]
  node_auth_controller["Auth Endpoints"]
  node_user_service["User Authentication<br/>[UserService.java]"]
  node_user_store[("User Repository")]
end

subgraph group_candidates["Candidate Service"]
  node_candidate_controller["Candidate Endpoints"]
  node_candidate_service["Profile Management"]
  node_candidate_store[("Candidate Repository")]
  node_resume_store["Resume Cloud Storage"]
end

subgraph group_admin["Admin Workflows"]
  node_admin_controller["Admin Endpoints"]
  node_admin_service["Shortlist and Status<br/>[AdminService.java]"]
  node_candidate_client["Candidate Service Client"]
  node_snapshot_store[("Shortlist History")]
end

node_user(("Applicant / Admin"))
node_gcs[("Google Cloud Storage")]

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_auth_ui
node_app -->|"routes to"| node_profile_ui
node_app -->|"routes to"| node_candidate_ui
node_app -->|"routes to"| node_admin_ui
node_candidate_ui -->|"calls"| node_candidate_api
node_admin_ui -->|"uses"| node_frontend_api
node_candidate_api -->|"uses"| node_frontend_api
node_frontend_api -->|"targets"| node_gateway
node_gateway -->|"routes auth"| node_auth_controller
node_gateway -->|"routes candidates"| node_candidate_controller
node_gateway -->|"routes admin"| node_admin_controller
node_auth_controller -->|"delegates to"| node_user_service
node_user_service -->|"reads and saves"| node_user_store
node_candidate_controller -->|"delegates to"| node_candidate_service
node_candidate_service -->|"reads and saves"| node_candidate_store
node_candidate_controller -->|"uploads and retrieves"| node_resume_store
node_resume_store -->|"stores files"| node_gcs
node_admin_controller -->|"delegates to"| node_admin_service
node_admin_service -->|"calls"| node_candidate_client
node_admin_service -->|"saves and reads"| node_snapshot_store
node_candidate_client -->|"calls remotely"| node_candidate_controller

click node_app "https://github.com/bharath-bit-byte/hamarashops/blob/main/Frontend/client/src/App.jsx"
click node_auth_ui "https://github.com/bharath-bit-byte/hamarashops/blob/main/Frontend/client/src/components/Register.jsx"
click node_profile_ui "https://github.com/bharath-bit-byte/hamarashops/blob/main/Frontend/client/src/components/CreateProfile.jsx"
click node_candidate_ui "https://github.com/bharath-bit-byte/hamarashops/blob/main/Frontend/client/src/components/CandidateDashboard.jsx"
click node_admin_ui "https://github.com/bharath-bit-byte/hamarashops/blob/main/Frontend/client/src/components/Dashboard.jsx"
click node_frontend_api "https://github.com/bharath-bit-byte/hamarashops/blob/main/Frontend/client/src/services/api.js"
click node_candidate_api "https://github.com/bharath-bit-byte/hamarashops/blob/main/Frontend/client/src/services/candidates.js"
click node_gateway "https://github.com/bharath-bit-byte/hamarashops/blob/main/Backend/ApiGateway/src/main/java/com/hamarashops/gateway/ApiGatewayApplication.java"
click node_auth_controller "https://github.com/bharath-bit-byte/hamarashops/blob/main/Backend/AuthService/src/main/java/com/hamarashops/auth/controller/AuthController.java"
click node_user_service "https://github.com/bharath-bit-byte/hamarashops/blob/main/Backend/AuthService/src/main/java/com/hamarashops/auth/service/UserService.java"
click node_user_store "https://github.com/bharath-bit-byte/hamarashops/blob/main/Backend/AuthService/src/main/java/com/hamarashops/auth/repository/UserRepository.java"
click node_candidate_controller "https://github.com/bharath-bit-byte/hamarashops/blob/main/Backend/CandidateService/src/main/java/com/hamarashops/candidate/controller/CandidateController.java"
click node_candidate_service "https://github.com/bharath-bit-byte/hamarashops/blob/main/Backend/CandidateService/src/main/java/com/hamarashops/candidate/service/CandidateService.java"
click node_candidate_store "https://github.com/bharath-bit-byte/hamarashops/blob/main/Backend/CandidateService/src/main/java/com/hamarashops/candidate/repository/CandidateProfileRepository.java"
click node_resume_store "https://github.com/bharath-bit-byte/hamarashops/blob/main/Backend/CandidateService/src/main/java/com/hamarashops/candidate/service/CloudStorageService.java"
click node_admin_controller "https://github.com/bharath-bit-byte/hamarashops/blob/main/Backend/AdminService/src/main/java/com/hamarashops/admin/controller/AdminController.java"
click node_admin_service "https://github.com/bharath-bit-byte/hamarashops/blob/main/Backend/AdminService/src/main/java/com/hamarashops/admin/service/AdminService.java"
click node_candidate_client "https://github.com/bharath-bit-byte/hamarashops/blob/main/Backend/AdminService/src/main/java/com/hamarashops/admin/client/CandidateClient.java"
click node_snapshot_store "https://github.com/bharath-bit-byte/hamarashops/blob/main/Backend/AdminService/src/main/java/com/hamarashops/admin/repository/ShortlistSnapshotRepository.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_auth_ui,node_profile_ui,node_candidate_ui,node_admin_ui,node_frontend_api,node_candidate_api toneBlue
class node_gateway,node_gcs toneAmber
class node_auth_controller,node_user_service,node_user_store toneMint
class node_candidate_controller,node_candidate_service,node_candidate_store,node_resume_store toneRose
class node_admin_controller,node_admin_service,node_candidate_client,node_snapshot_store,node_user toneIndigo
```

## Components

### React Client

- [Routes and App](https://github.com/bharath-bit-byte/hamarashops/blob/main/Frontend/client/src/App.jsx): `Frontend/client/src/App.jsx`
- [Registration and Login](https://github.com/bharath-bit-byte/hamarashops/blob/main/Frontend/client/src/components/Register.jsx): `Frontend/client/src/components/Register.jsx`
- [Profile Creation](https://github.com/bharath-bit-byte/hamarashops/blob/main/Frontend/client/src/components/CreateProfile.jsx): `Frontend/client/src/components/CreateProfile.jsx`
- [Candidate Dashboard](https://github.com/bharath-bit-byte/hamarashops/blob/main/Frontend/client/src/components/CandidateDashboard.jsx): `Frontend/client/src/components/CandidateDashboard.jsx`
- [Admin Dashboards](https://github.com/bharath-bit-byte/hamarashops/blob/main/Frontend/client/src/components/Dashboard.jsx): `Frontend/client/src/components/Dashboard.jsx`
- [API URL Configuration](https://github.com/bharath-bit-byte/hamarashops/blob/main/Frontend/client/src/services/api.js): `Frontend/client/src/services/api.js`
- [Candidate API Client](https://github.com/bharath-bit-byte/hamarashops/blob/main/Frontend/client/src/services/candidates.js): `Frontend/client/src/services/candidates.js`

### API Entry

- [API Gateway](https://github.com/bharath-bit-byte/hamarashops/blob/main/Backend/ApiGateway/src/main/java/com/hamarashops/gateway/ApiGatewayApplication.java): `Backend/ApiGateway/src/main/java/com/hamarashops/gateway/ApiGatewayApplication.java`

### Identity Service

- [Auth Endpoints](https://github.com/bharath-bit-byte/hamarashops/blob/main/Backend/AuthService/src/main/java/com/hamarashops/auth/controller/AuthController.java): `Backend/AuthService/src/main/java/com/hamarashops/auth/controller/AuthController.java`
- [User Authentication](https://github.com/bharath-bit-byte/hamarashops/blob/main/Backend/AuthService/src/main/java/com/hamarashops/auth/service/UserService.java): `Backend/AuthService/src/main/java/com/hamarashops/auth/service/UserService.java`
- [User Repository](https://github.com/bharath-bit-byte/hamarashops/blob/main/Backend/AuthService/src/main/java/com/hamarashops/auth/repository/UserRepository.java): `Backend/AuthService/src/main/java/com/hamarashops/auth/repository/UserRepository.java`

### Candidate Service

- [Candidate Endpoints](https://github.com/bharath-bit-byte/hamarashops/blob/main/Backend/CandidateService/src/main/java/com/hamarashops/candidate/controller/CandidateController.java): `Backend/CandidateService/src/main/java/com/hamarashops/candidate/controller/CandidateController.java`
- [Profile Management](https://github.com/bharath-bit-byte/hamarashops/blob/main/Backend/CandidateService/src/main/java/com/hamarashops/candidate/service/CandidateService.java): `Backend/CandidateService/src/main/java/com/hamarashops/candidate/service/CandidateService.java`
- [Candidate Repository](https://github.com/bharath-bit-byte/hamarashops/blob/main/Backend/CandidateService/src/main/java/com/hamarashops/candidate/repository/CandidateProfileRepository.java): `Backend/CandidateService/src/main/java/com/hamarashops/candidate/repository/CandidateProfileRepository.java`
- [Resume Cloud Storage](https://github.com/bharath-bit-byte/hamarashops/blob/main/Backend/CandidateService/src/main/java/com/hamarashops/candidate/service/CloudStorageService.java): `Backend/CandidateService/src/main/java/com/hamarashops/candidate/service/CloudStorageService.java`

### Admin Workflows

- [Admin Endpoints](https://github.com/bharath-bit-byte/hamarashops/blob/main/Backend/AdminService/src/main/java/com/hamarashops/admin/controller/AdminController.java): `Backend/AdminService/src/main/java/com/hamarashops/admin/controller/AdminController.java`
- [Shortlist and Status](https://github.com/bharath-bit-byte/hamarashops/blob/main/Backend/AdminService/src/main/java/com/hamarashops/admin/service/AdminService.java): `Backend/AdminService/src/main/java/com/hamarashops/admin/service/AdminService.java`
- [Candidate Service Client](https://github.com/bharath-bit-byte/hamarashops/blob/main/Backend/AdminService/src/main/java/com/hamarashops/admin/client/CandidateClient.java): `Backend/AdminService/src/main/java/com/hamarashops/admin/client/CandidateClient.java`
- [Shortlist History](https://github.com/bharath-bit-byte/hamarashops/blob/main/Backend/AdminService/src/main/java/com/hamarashops/admin/repository/ShortlistSnapshotRepository.java): `Backend/AdminService/src/main/java/com/hamarashops/admin/repository/ShortlistSnapshotRepository.java`

### Other components

- **Applicant / Admin**
- **Google Cloud Storage**

## Connections

- Applicant / Admin → Routes and App: uses
- Routes and App → Registration and Login: routes to (evidence: `Frontend/client/src/App.jsx`)
- Routes and App → Profile Creation: routes to (evidence: `Frontend/client/src/App.jsx`)
- Routes and App → Candidate Dashboard: routes to (evidence: `Frontend/client/src/App.jsx`)
- Routes and App → Admin Dashboards: routes to (evidence: `Frontend/client/src/App.jsx`)
- Candidate Dashboard → Candidate API Client: calls (evidence: `Frontend/client/src/components/CandidateDashboard.jsx`)
- Admin Dashboards → API URL Configuration: uses (evidence: `Frontend/client/src/components/Dashboard.jsx`)
- Candidate API Client → API URL Configuration: uses (evidence: `Frontend/client/src/services/candidates.js`)
- API URL Configuration → API Gateway: targets (evidence: `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 (evidence: `Backend/AuthService/src/main/java/com/hamarashops/auth/controller/AuthController.java`)
- User Authentication → User Repository: reads and saves (evidence: `Backend/AuthService/src/main/java/com/hamarashops/auth/service/UserService.java`)
- Candidate Endpoints → Profile Management: delegates to (evidence: `Backend/CandidateService/src/main/java/com/hamarashops/candidate/controller/CandidateController.java`)
- Profile Management → Candidate Repository: reads and saves (evidence: `Backend/CandidateService/src/main/java/com/hamarashops/candidate/service/CandidateService.java`)
- Candidate Endpoints → Resume Cloud Storage: uploads and retrieves (evidence: `Backend/CandidateService/src/main/java/com/hamarashops/candidate/controller/CandidateController.java`)
- Resume Cloud Storage → Google Cloud Storage: stores files (evidence: `Backend/CandidateService/src/main/java/com/hamarashops/candidate/service/CloudStorageService.java`)
- Admin Endpoints → Shortlist and Status: delegates to (evidence: `Backend/AdminService/src/main/java/com/hamarashops/admin/controller/AdminController.java`)
- Shortlist and Status → Candidate Service Client: calls (evidence: `Backend/AdminService/src/main/java/com/hamarashops/admin/service/AdminService.java`)
- Shortlist and Status → Shortlist History: saves and reads (evidence: `Backend/AdminService/src/main/java/com/hamarashops/admin/service/AdminService.java`)
- Candidate Service Client → Candidate Endpoints: calls remotely
