# sriramsanjeev100/job-portal architecture

> Architecture diagram of the GitHub repository sriramsanjeev100/job-portal, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sriramsanjeev100/job-portal
- Repository: https://github.com/sriramsanjeev100/job-portal

## Overview

This is a Spring-based job portal for job seekers and employers. The apparent user workflow is account authentication, job discovery and application for seekers, and job posting and application management for employers, with profile and skill management supporting both sides. The tree also indicates JWT authentication, refresh tokens, email, and file storage capabilities. No README or source excerpts were provided, so relationships below are dashed and unverified; implementation details and external providers cannot be confirmed.

Main entry points: [`src/main/java/com/example/job_portal/repository`](https://github.com/sriramsanjeev100/job-portal/tree/main/src/main/java/com/example/job_portal/repository) (Repositories), [`src/main/java/com/example/job_portal/controller/AuthController.java`](https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/controller/AuthController.java) (Authentication API), [`src/main/java/com/example/job_portal/service`](https://github.com/sriramsanjeev100/job-portal/tree/main/src/main/java/com/example/job_portal/service) (Profile Services), [`src/main/java/com/example/job_portal/service/JobService.java`](https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/service/JobService.java) (Job Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and Identity"]
  node_auth_api["Authentication API"]
  node_user_service["User Service<br/>[UserService.java]"]
  node_jwt_filter["JWT Filter"]
  node_jwt_service["JWT Service<br/>[JwtService.java]"]
  node_refresh_service["Refresh Tokens"]
  node_security["Security Config"]
end

subgraph group_jobs["Jobs and Applications"]
  node_job_api["Job API<br/>[JobController.java]"]
  node_job_service["Job Service<br/>[JobService.java]"]
  node_job_search["Job Search"]
  node_application_api["Application API"]
  node_application_service["Application Service"]
end

subgraph group_profiles["Profiles and Skills"]
  node_employer_api["Employer API"]
  node_seeker_api["Seeker API"]
  node_skill_api["Skill API"]
  node_profile_services["Profile Services"]
  node_file_storage["File Storage"]
  node_email_service["Email Service<br/>[EmailService.java]"]
end

subgraph group_data["Persistence"]
  node_portal_db[("Portal Database")]
  node_repositories["Repositories"]
end

node_seeker(("Job Seeker"))
node_employer(("Employer"))

node_seeker -.->|"authenticates"| node_auth_api
node_employer -.->|"authenticates"| node_auth_api
node_auth_api -.->|"delegates to"| node_user_service
node_user_service -.->|"uses"| node_repositories
node_security -.->|"configures"| node_jwt_filter
node_jwt_filter -.->|"validates with"| node_jwt_service
node_auth_api -.->|"handles refresh"| node_refresh_service
node_seeker -.->|"browses jobs"| node_job_api
node_employer -.->|"manages jobs"| node_job_api
node_job_api -.->|"delegates to"| node_job_service
node_job_service -.->|"filters with"| node_job_search
node_job_service -.->|"uses"| node_repositories
node_seeker -.->|"submits applications"| node_application_api
node_employer -.->|"manages applications"| node_application_api
node_application_api -.->|"delegates to"| node_application_service
node_application_service -.->|"uses"| node_repositories
node_employer -.->|"manages profile"| node_employer_api
node_seeker -.->|"manages profile"| node_seeker_api
node_seeker -.->|"manages skills"| node_skill_api
node_employer_api -.->|"delegates to"| node_profile_services
node_seeker_api -.->|"delegates to"| node_profile_services
node_skill_api -.->|"delegates to"| node_profile_services
node_profile_services -.->|"uses"| node_repositories
node_repositories -.->|"persists data"| node_portal_db

click node_auth_api "https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/controller/AuthController.java"
click node_user_service "https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/service/UserService.java"
click node_jwt_filter "https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/filter/JwtAuthenticationFilter.java"
click node_jwt_service "https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/service/JwtService.java"
click node_refresh_service "https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/service/RefreshTokenService.java"
click node_security "https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/config/SecurityConfig.java"
click node_job_api "https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/controller/JobController.java"
click node_job_service "https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/service/JobService.java"
click node_job_search "https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/specification/JobSpecification.java"
click node_application_api "https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/controller/JobApplicationController.java"
click node_application_service "https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/service/JobApplicationService.java"
click node_employer_api "https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/controller/EmployerController.java"
click node_seeker_api "https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/controller/JobSeekerController.java"
click node_skill_api "https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/controller/SkillController.java"
click node_profile_services "https://github.com/sriramsanjeev100/job-portal/tree/main/src/main/java/com/example/job_portal/service"
click node_file_storage "https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/service/FileStorageService.java"
click node_email_service "https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/service/EmailService.java"
click node_portal_db "https://github.com/sriramsanjeev100/job-portal/tree/main/src/main/resources/db/migration"
click node_repositories "https://github.com/sriramsanjeev100/job-portal/tree/main/src/main/java/com/example/job_portal/repository"

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_auth_api,node_user_service,node_jwt_filter,node_jwt_service,node_refresh_service,node_security toneBlue
class node_job_api,node_job_service,node_job_search,node_application_api,node_application_service toneAmber
class node_employer_api,node_seeker_api,node_skill_api,node_profile_services,node_file_storage,node_email_service toneMint
class node_portal_db,node_repositories toneRose
class node_seeker,node_employer toneIndigo
```

## Components

### Access and Identity

- [Authentication API](https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/controller/AuthController.java): `src/main/java/com/example/job_portal/controller/AuthController.java`
- [User Service](https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/service/UserService.java): `src/main/java/com/example/job_portal/service/UserService.java`
- [JWT Filter](https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/filter/JwtAuthenticationFilter.java): `src/main/java/com/example/job_portal/filter/JwtAuthenticationFilter.java`
- [JWT Service](https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/service/JwtService.java): `src/main/java/com/example/job_portal/service/JwtService.java`
- [Refresh Tokens](https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/service/RefreshTokenService.java): `src/main/java/com/example/job_portal/service/RefreshTokenService.java`
- [Security Config](https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/config/SecurityConfig.java): `src/main/java/com/example/job_portal/config/SecurityConfig.java`

### Jobs and Applications

- [Job API](https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/controller/JobController.java): `src/main/java/com/example/job_portal/controller/JobController.java`
- [Job Service](https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/service/JobService.java): `src/main/java/com/example/job_portal/service/JobService.java`
- [Job Search](https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/specification/JobSpecification.java): `src/main/java/com/example/job_portal/specification/JobSpecification.java`
- [Application API](https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/controller/JobApplicationController.java): `src/main/java/com/example/job_portal/controller/JobApplicationController.java`
- [Application Service](https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/service/JobApplicationService.java): `src/main/java/com/example/job_portal/service/JobApplicationService.java`

### Profiles and Skills

- [Employer API](https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/controller/EmployerController.java): `src/main/java/com/example/job_portal/controller/EmployerController.java`
- [Seeker API](https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/controller/JobSeekerController.java): `src/main/java/com/example/job_portal/controller/JobSeekerController.java`
- [Skill API](https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/controller/SkillController.java): `src/main/java/com/example/job_portal/controller/SkillController.java`
- [Profile Services](https://github.com/sriramsanjeev100/job-portal/tree/main/src/main/java/com/example/job_portal/service): `src/main/java/com/example/job_portal/service`
- [File Storage](https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/service/FileStorageService.java): `src/main/java/com/example/job_portal/service/FileStorageService.java`
- [Email Service](https://github.com/sriramsanjeev100/job-portal/blob/main/src/main/java/com/example/job_portal/service/EmailService.java): `src/main/java/com/example/job_portal/service/EmailService.java`

### Persistence

- [Portal Database](https://github.com/sriramsanjeev100/job-portal/tree/main/src/main/resources/db/migration): `src/main/resources/db/migration`
- [Repositories](https://github.com/sriramsanjeev100/job-portal/tree/main/src/main/java/com/example/job_portal/repository): `src/main/java/com/example/job_portal/repository`

### Other components

- **Job Seeker**
- **Employer**

## Connections

- Job Seeker → Authentication API: authenticates
- Employer → Authentication API: authenticates
- Authentication API → User Service: delegates to
- User Service → Repositories: uses
- Security Config → JWT Filter: configures
- JWT Filter → JWT Service: validates with
- Authentication API → Refresh Tokens: handles refresh
- Job Seeker → Job API: browses jobs
- Employer → Job API: manages jobs
- Job API → Job Service: delegates to
- Job Service → Job Search: filters with
- Job Service → Repositories: uses
- Job Seeker → Application API: submits applications
- Employer → Application API: manages applications
- Application API → Application Service: delegates to
- Application Service → Repositories: uses
- Employer → Employer API: manages profile
- Job Seeker → Seeker API: manages profile
- Job Seeker → Skill API: manages skills
- Employer API → Profile Services: delegates to
- Seeker API → Profile Services: delegates to
- Skill API → Profile Services: delegates to
- Profile Services → Repositories: uses
- Repositories → Portal Database: persists data
