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

Ö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

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"
}