HRMS (Human Resource Management System)

Mevcut Diller / Available Languages

🇹🇷 Türkçe | 🇬🇧 English

---

Demo Video

Türkçe

Proje Açıklaması

HRMS (İnsan Kaynakları Yönetim Sistemi) projesi, iş ilanlarının, iş başvurularının, işveren ve iş arayan bilgilerinin yönetildiği, Spring Boot tabanlı bir web servis uygulamasıdır.
Proje, REST API mimarisi ile geliştirilmiş olup, DTO, Request-Response Pattern, Validation ve Global Exception Handling gibi modern yazılım geliştirme tekniklerini içermektedir.

---

Özellikler

• Şehir Yönetimi: Şehir ekleme, listeleme.
• İş Pozisyonu Yönetimi: Yeni iş pozisyonu ekleme, listeleme.
• İşveren Yönetimi: İşveren kaydı, listeleme.
• Aday Yönetimi: Aday kaydı, listeleme.
• İş İlanı Yönetimi: İş ilanı ekleme, listeleme, filtreleme.
• İş Başvurusu Yönetimi: Adayların iş ilanlarına başvuru yapabilmesi.
• Hata Yönetimi: @ControllerAdvice ile global exception handling.
• Validasyon: @NotBlank, @Size gibi anotasyonlarla alan doğrulama.

---

Kullanılan Teknolojiler

• Java 17
• Spring Boot
• Spring Data JPA (Hibernate)
• PostgreSQL
• Lombok
• Validation API (Jakarta Validation)
• Jackson
• Postman (API Testleri için)

---

Proje Katmanları

• Entity: Veritabanı tablolarını temsil eden sınıflar.
• DTO: Kullanıcıya döndürülecek veri transfer objeleri.
• Request: Kullanıcıdan alınacak verileri temsil eden sınıflar.
• Service: İş mantığı katmanı.
• Repository (DAO): Veritabanı erişim katmanı.
• Controller: API uç noktalarının bulunduğu katman.
• Core Utilities: Result, DataResult, SuccessResult, ErrorResult gibi ortak dönüş yapıları.

Result Yapısı:

• Result: İşlem sonucu (başarılı / başarısız) ve mesaj döner.
• DataResult<T>: İşlem sonucu + veri döner.
• SuccessResult, ErrorResult: Başarılı veya hatalı işlem durumları için hazır sınıflar.

---

Örnek API Endpoint'leri

HTTP	Endpoint	Açıklama
POST	/api/employers/register	Yeni işveren kaydı
GET	/api/employers/getAll	Tüm işverenleri listele
POST	/api/candidateController/register	Yeni aday kaydı
GET	/api/candidateController/getAll	Tüm adayları listele
POST	/api/jobAdvertisements/add	Yeni iş ilanı ekle
GET	/api/jobAdvertisements/getAll	Tüm iş ilanlarını listele
POST	/api/jobApplications/apply	Adayın ilana başvurması

---

Örnek JSON İstekleri

İşveren Kayıt:

{
    "name": "Aysu",
    "lastName": "Ay",
    "nationalId": "12345678901",
    "birthDate": 2000,
    "email": "[email protected]",
    "password": "password123",
    "confirmPassword": "password123"
}

English

HRMS (Human Resource Management System)

Project Description

HRMS (Human Resource Management System) is a Spring Boot-based web service application designed for managing job postings, applications, employer and candidate information.
It follows the REST API architecture and implements DTO, Request-Response Pattern, Validation, and Global Exception Handling.

---

Features

• City Management: Add and list cities.
• Job Position Management: Add and list job positions.
• Employer Management: Register and list employers.
• Candidate Management: Register and list job seekers.
• Job Advertisement Management: Add, list, and filter job ads.
• Job Application Management: Allow candidates to apply for job ads.
• Error Handling: Global exception handling with @ControllerAdvice.
• Validation: Field validation with annotations like @NotBlank, @Size.

---

Technologies Used

• Java 17
• Spring Boot
• Spring Data JPA (Hibernate)
• PostgreSQL
• Lombok
• Validation API (Jakarta Validation)
• Jackson
• Postman for API testing

---

Project Layers

• Entity: Represents database tables.
• DTO: Data Transfer Objects for API responses.
• Request: Classes for incoming API data.
• Service: Business logic layer.
• Repository (DAO): Database access layer.
• Controller: REST API endpoints.
• Core Utilities: Common response classes like Result, DataResult, SuccessResult, ErrorResult.

Result Structure:

• Result: Returns success/failure status and a message.
• DataResult<T>: Returns status + data.
• SuccessResult, ErrorResult: Ready-made classes for success/error cases.

---

Sample API Endpoints

HTTP	Endpoint	Description
POST	/api/employers/register	Register a new employer
GET	/api/employers/getAll	Get all employers
POST	/api/candidateController/register	Register a new candidate
GET	/api/candidateController/getAll	Get all candidates
POST	/api/jobAdvertisements/add	Add a new job advertisement
GET	/api/jobAdvertisements/getAll	Get all job advertisements
POST	/api/jobApplications/apply	Apply for a job advertisement

---

Sample JSON Requests

Employer Registration:

{
  "companyName": "Tech Solutions Ltd.",
  "companyWebPage": "https://techsolutions.com",
  "email": "[email protected]",
  "phoneNumber": "+1-555-123-4567",
  "password": "password123",
  "confirmPassword": "password123"
}

Candidate Registration:

{
    "name": "Aysu",
    "lastName": "Ay",
    "nationalId": "12345678901",
    "birthDate": 2000,
    "email": "[email protected]",
    "password": "password123",
    "confirmPassword": "password123"
}