# mrpand-21/hrms_backend architecture

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

- Interactive diagram: https://gitdiagram.com/mrpand-21/hrms_backend
- Repository: https://github.com/mrpand-21/hrms_backend

## Overview

HRMS_Backend is a Java/Spring REST API for managing employers, job seekers, job listings, and related HR reference data. Users interact through the documented Swagger UI: requests enter domain controllers and are handled by business services; the job service, for example, assembles listings and approval records through data-access objects. The README also documents optional Mernis identity checking. The source excerpts do not show all controller-to-service wiring or persistence configuration, so those relationships are omitted or marked unverified rather than inferred.

Main entry points: [`src/main/java/kodlama/io/hrms/business/concretes/JobManager.java`](https://github.com/mrpand-21/hrms_backend/blob/master/src/main/java/kodlama/io/hrms/business/concretes/JobManager.java) (Job service), [`src/main/java/kodlama/io/hrms/api/controllers`](https://github.com/mrpand-21/hrms_backend/tree/master/src/main/java/kodlama/io/hrms/api/controllers) (Domain controllers), [`src/main/java/kodlama/io/hrms/business/concretes/JobSeekerManager.java`](https://github.com/mrpand-21/hrms_backend/blob/master/src/main/java/kodlama/io/hrms/business/concretes/JobSeekerManager.java) (Job seeker service), [`src/main/java/kodlama/io/hrms/business/concretes/EmployerManager.java`](https://github.com/mrpand-21/hrms_backend/blob/master/src/main/java/kodlama/io/hrms/business/concretes/EmployerManager.java) (Employer service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_controllers["Domain controllers"]
end

subgraph group_business["Business Services"]
  node_employer_service["Employer service"]
  node_job_service["Job service<br/>[JobManager.java]"]
  node_seeker_service["Job seeker service"]
  node_other_services["Reference services"]
  node_result_types["Result types"]
  node_messages["Business messages<br/>[Messages.java]"]
end

subgraph group_data["Domain and Data"]
  node_job_data["Job data access<br/>[JobDao.java]"]
  node_approval_data["Approval data access"]
  node_lookup_data["Job lookup DAOs"]
  node_domain_entities["HR domain entities"]
  node_job_dtos["Job listing DTOs"]
end

subgraph group_integrations["External Integrations"]
  node_identity_check["Identity check adapter"]
  node_email_adapter["Email adapter"]
  node_image_adapter["Cloudinary image adapter"]
end

node_users(("API users"))
node_postgres[("PostgreSQL")]

node_users -->|"make API requests"| node_controllers
node_controllers -->|"delegates"| node_employer_service
node_controllers -->|"delegates"| node_job_service
node_controllers -->|"delegates"| node_seeker_service
node_job_service -->|"reads and writes"| node_job_data
node_job_service -->|"records approval"| node_approval_data
node_job_service -->|"loads references"| node_lookup_data
node_job_service -->|"builds jobs"| node_domain_entities
node_job_service -->|"uses listing DTOs"| node_job_dtos
node_seeker_service -.->|"checks identity"| node_identity_check
node_seeker_service -.->|"verifies email"| node_email_adapter
node_controllers -.->|"persists domain data"| node_postgres

click node_controllers "https://github.com/mrpand-21/hrms_backend/tree/master/src/main/java/kodlama/io/hrms/api/controllers"
click node_employer_service "https://github.com/mrpand-21/hrms_backend/blob/master/src/main/java/kodlama/io/hrms/business/concretes/EmployerManager.java"
click node_job_service "https://github.com/mrpand-21/hrms_backend/blob/master/src/main/java/kodlama/io/hrms/business/concretes/JobManager.java"
click node_seeker_service "https://github.com/mrpand-21/hrms_backend/blob/master/src/main/java/kodlama/io/hrms/business/concretes/JobSeekerManager.java"
click node_other_services "https://github.com/mrpand-21/hrms_backend/tree/master/src/main/java/kodlama/io/hrms/business/concretes"
click node_job_data "https://github.com/mrpand-21/hrms_backend/blob/master/src/main/java/kodlama/io/hrms/dataAccess/abstracts/JobDao.java"
click node_approval_data "https://github.com/mrpand-21/hrms_backend/blob/master/src/main/java/kodlama/io/hrms/dataAccess/abstracts/ActivationPanelDao.java"
click node_lookup_data "https://github.com/mrpand-21/hrms_backend/tree/master/src/main/java/kodlama/io/hrms/dataAccess/abstracts"
click node_domain_entities "https://github.com/mrpand-21/hrms_backend/tree/master/src/main/java/kodlama/io/hrms/entities/concretes"
click node_job_dtos "https://github.com/mrpand-21/hrms_backend/blob/master/src/main/java/kodlama/io/hrms/entities/dtos/JobForGetAllDto.java"
click node_result_types "https://github.com/mrpand-21/hrms_backend/tree/master/src/main/java/kodlama/io/hrms/core/utilities/results"
click node_messages "https://github.com/mrpand-21/hrms_backend/blob/master/src/main/java/kodlama/io/hrms/business/constants/Messages.java"
click node_identity_check "https://github.com/mrpand-21/hrms_backend/blob/master/src/main/java/kodlama/io/hrms/core/utilities/adapters/adapters/concretes/MernisServiceAdapter.java"
click node_email_adapter "https://github.com/mrpand-21/hrms_backend/blob/master/src/main/java/kodlama/io/hrms/core/utilities/adapters/adapters/concretes/EmailServiceAdapterService.java"
click node_image_adapter "https://github.com/mrpand-21/hrms_backend/blob/master/src/main/java/kodlama/io/hrms/core/utilities/adapters/adapters/concretes/CloudinaryImageServiceAdapter.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_controllers,node_users toneBlue
class node_employer_service,node_job_service,node_seeker_service,node_other_services,node_result_types,node_messages,node_postgres toneAmber
class node_job_data,node_approval_data,node_lookup_data,node_domain_entities,node_job_dtos toneMint
class node_identity_check,node_email_adapter,node_image_adapter toneRose
```

## Components

### REST API

- [Domain controllers](https://github.com/mrpand-21/hrms_backend/tree/master/src/main/java/kodlama/io/hrms/api/controllers): `src/main/java/kodlama/io/hrms/api/controllers`

### Business Services

- [Employer service](https://github.com/mrpand-21/hrms_backend/blob/master/src/main/java/kodlama/io/hrms/business/concretes/EmployerManager.java): `src/main/java/kodlama/io/hrms/business/concretes/EmployerManager.java`
- [Job service](https://github.com/mrpand-21/hrms_backend/blob/master/src/main/java/kodlama/io/hrms/business/concretes/JobManager.java): `src/main/java/kodlama/io/hrms/business/concretes/JobManager.java`
- [Job seeker service](https://github.com/mrpand-21/hrms_backend/blob/master/src/main/java/kodlama/io/hrms/business/concretes/JobSeekerManager.java): `src/main/java/kodlama/io/hrms/business/concretes/JobSeekerManager.java`
- [Reference services](https://github.com/mrpand-21/hrms_backend/tree/master/src/main/java/kodlama/io/hrms/business/concretes): `src/main/java/kodlama/io/hrms/business/concretes`
- [Result types](https://github.com/mrpand-21/hrms_backend/tree/master/src/main/java/kodlama/io/hrms/core/utilities/results): `src/main/java/kodlama/io/hrms/core/utilities/results`
- [Business messages](https://github.com/mrpand-21/hrms_backend/blob/master/src/main/java/kodlama/io/hrms/business/constants/Messages.java): `src/main/java/kodlama/io/hrms/business/constants/Messages.java`

### Domain and Data

- [Job data access](https://github.com/mrpand-21/hrms_backend/blob/master/src/main/java/kodlama/io/hrms/dataAccess/abstracts/JobDao.java): `src/main/java/kodlama/io/hrms/dataAccess/abstracts/JobDao.java`
- [Approval data access](https://github.com/mrpand-21/hrms_backend/blob/master/src/main/java/kodlama/io/hrms/dataAccess/abstracts/ActivationPanelDao.java): `src/main/java/kodlama/io/hrms/dataAccess/abstracts/ActivationPanelDao.java`
- [Job lookup DAOs](https://github.com/mrpand-21/hrms_backend/tree/master/src/main/java/kodlama/io/hrms/dataAccess/abstracts): `src/main/java/kodlama/io/hrms/dataAccess/abstracts`
- [HR domain entities](https://github.com/mrpand-21/hrms_backend/tree/master/src/main/java/kodlama/io/hrms/entities/concretes): `src/main/java/kodlama/io/hrms/entities/concretes`
- [Job listing DTOs](https://github.com/mrpand-21/hrms_backend/blob/master/src/main/java/kodlama/io/hrms/entities/dtos/JobForGetAllDto.java): `src/main/java/kodlama/io/hrms/entities/dtos/JobForGetAllDto.java`

### External Integrations

- [Identity check adapter](https://github.com/mrpand-21/hrms_backend/blob/master/src/main/java/kodlama/io/hrms/core/utilities/adapters/adapters/concretes/MernisServiceAdapter.java): `src/main/java/kodlama/io/hrms/core/utilities/adapters/adapters/concretes/MernisServiceAdapter.java`
- [Email adapter](https://github.com/mrpand-21/hrms_backend/blob/master/src/main/java/kodlama/io/hrms/core/utilities/adapters/adapters/concretes/EmailServiceAdapterService.java): `src/main/java/kodlama/io/hrms/core/utilities/adapters/adapters/concretes/EmailServiceAdapterService.java`
- [Cloudinary image adapter](https://github.com/mrpand-21/hrms_backend/blob/master/src/main/java/kodlama/io/hrms/core/utilities/adapters/adapters/concretes/CloudinaryImageServiceAdapter.java): `src/main/java/kodlama/io/hrms/core/utilities/adapters/adapters/concretes/CloudinaryImageServiceAdapter.java`

### Other components

- **API users**
- **PostgreSQL**

## Connections

- API users → Domain controllers: make API requests
- Domain controllers → Employer service: delegates (evidence: `src/main/java/kodlama/io/hrms/api/controllers/EmployerController.java`)
- Domain controllers → Job service: delegates (evidence: `src/main/java/kodlama/io/hrms/api/controllers/JobController.java`)
- Domain controllers → Job seeker service: delegates (evidence: `src/main/java/kodlama/io/hrms/api/controllers/JobSeekersController.java`)
- Job service → Job data access: reads and writes (evidence: `src/main/java/kodlama/io/hrms/business/concretes/JobManager.java`)
- Job service → Approval data access: records approval (evidence: `src/main/java/kodlama/io/hrms/business/concretes/JobManager.java`)
- Job service → Job lookup DAOs: loads references (evidence: `src/main/java/kodlama/io/hrms/business/concretes/JobManager.java`)
- Job service → HR domain entities: builds jobs (evidence: `src/main/java/kodlama/io/hrms/business/concretes/JobManager.java`)
- Job service → Job listing DTOs: uses listing DTOs (evidence: `src/main/java/kodlama/io/hrms/business/concretes/JobManager.java`)
- Job seeker service → Identity check adapter: checks identity
- Job seeker service → Email adapter: verifies email
- Domain controllers → PostgreSQL: persists domain data
