📋 Görev Takip Sistemi | Task Tracking System

Modern, ölçeklenebilir ve kurumsal mimari pratiklerine uygun olarak geliştirilmiş RESTful Görev & Proje Yönetim Sistemi arka yüz (backend) uygulaması.

Bu proje; ekiplerin projeler oluşturmasını, kullanıcıları projelere dahil etmesini, Kanban metodolojisine uygun görevler tanımlayıp yönetmesini ve görevler üzerinde tartışabilmesini sağlayan bir iş yönetim platformunun arka yüz çekirdeğidir.

• Doğal Anahtar Soyutlaması (Public UUID Pattern): Veritabanı içindeki ardışık birincil anahtarlar (id - Long) dış dünyaya asla sızdırılmaz. Tüm REST haberleşmesi güvenli, tahmin edilemez publicId (UUID v4) üzerinden yürütülür.
• Güçlü Veri Bütünlüğü ve İş Kuralları: Bir göreve atanacak kullanıcının mutlaka o projenin üyesi olması gibi kritik iş kuralları servis katmanında sıkı bir şekilde denetlenir.
• Değişmezlik (Immutability): DTO katmanında Java record tipleri kullanılarak veri transfer nesnelerinin güvenliği ve değişmezliği garanti altına alınmıştır.
• Clean Architecture & Clean Code: SonarQube kalite kurallarına ve katmanlı mimari prensiplerine tam uyum.

• 📁 Proje Yönetimi: Proje oluşturma, tüm projeleri listeleme ve UUID üzerinden detay sorgulama.
• 👥 Kullanıcı & Üyelik Sistemi: Kullanıcı tanımlama, kullanıcıları projelere atama (Many-to-Many) ve bir projenin üyelerini sorgulama.
• 📌 Görev Yaşam Döngüsü (Task Lifecycle):
  • Görev oluşturma, detaylandırma, önceliklendirme (LOW, MEDIUM, HIGH).
  • Kanban durum geçişleri (TODO ➔ IN_PROGRESS ➔ COMPLETED).
  • Projeye veya atanan kullanıcıya göre görevleri filtreleme.
  • Göreve yetkili kullanıcı atama.
• 💬 Yorum & Tartışma Sistemi: Görevler altına kullanıcı bazlı anlık yorum ekleme ve yorum akışını listeleme.
• ⏱️ HTTP Metrik & İstek Günlüğü: Özel RequestLoggingFilter ile gelen her HTTP isteğinin metodu, yolu, yanıt statüsü ve milisaniye cinsinden işlem süresi anlık loglanır.

com.ismailcolak.gorev_takip_sistemi/
├── config/              # CORS ve Filter konfigürasyonları
├── controllers/         # REST API uç noktaları (HTTP istek/yanıt yönetimi)
├── dto/
│   ├── request/         # İstemciden gelen veri modelleri (Jakarta Validation anotasyonlu Record'lar)
│   └── response/        # İstemciye dönen saf veri modelleri (Record'lar)
├── entities/            # JPA Veritabanı varlıkları ve Enum'lar
├── exceptions/          # Merkezi hata yakalama mekanizması (@RestControllerAdvice)
├── filters/             # HTTP İstek/Yanıt loglama filtreleri
├── repositories/        # Spring Data JPA veri erişim arayüzleri
└── services/            # İş mantığı, validasyonlar ve transaction yönetimi

erDiagram
    PROJECT ||--o{ TASK : "içerir (1:N)"
    USER ||--o{ TASK : "atanır (0..1:N)"
    USER }|--|{ PROJECT : "üyedir (N:M - user_projects)"
    TASK ||--o{ COMMENT : "yorumlanır (1:N)"
    USER ||--o{ COMMENT : "yazar (1:N)"

    PROJECT {
        bigint project_id PK
        varchar public_id UK "UUID"
        varchar project_name
    }

    USER {
        bigint user_id PK
        varchar public_id UK "UUID"
        varchar user_name
    }

    TASK {
        bigint task_id PK
        varchar public_id UK "UUID"
        varchar task_name
        text task_detail
        varchar status "TODO, IN_PROGRESS, COMPLETED"
        varchar priority "LOW, MEDIUM, HIGH"
        bigint project_id FK
        bigint assigned_user_id FK "nullable"
    }

    COMMENT {
        bigint comment_id PK
        varchar public_id UK "UUID"
        text comment_detail
        bigint task_id FK
        bigint user_id FK
    }

Tüm istek ve yanıtlar application/json formatındadır.

{
  "projectName": "E-Ticaret Mikroservis Dönüşümü"
}

{
  "userName": "ismailcolak"
}

{
  "taskName": "Ödeme Servisi Entegrasyonu",
  "taskDetail": "Iyzico / Stripe webhook entegrasyonu tamamlanacak.",
  "priority": "HIGH",
  "projectPublicId": "58e1eb6a-8b89-42b7-8a39-fb1d668fc79e",
  "assignedUserPublicId": "9d1bf762-23c3-4d40-bfae-22da56291a10"
}

{
  "status": "IN_PROGRESS"
}

(Kabul edilen değerler: TODO, IN_PROGRESS, COMPLETED)

{
  "commentDetail": "Sandbox test ortamında ödeme akışı başarıyla doğrulandı.",
  "userPublicId": "9d1bf762-23c3-4d40-bfae-22da56291a10"
}

Uygulama, hataları yakalayarak istemciye tutarlı ve standart bir hata şeması (ErrorResponse) döner:

Form alanları boş bırakıldığında veya karakter sınırlarına uymadığında alan bazlı hata haritası ile döner:

{
  "timestamp": "2026-09-05T15:30:00Z",
  "status": 400,
  "error": "Bad Request",
  "message": "Girdi alanları geçersiz",
  "path": "/api/tasks/123/comments",
  "validationErrors": {
    "commentDetail": "yorum boş olamaz"
  }
}

{
  "timestamp": "2026-09-05T15:30:00Z",
  "status": 404,
  "error": "Not Found",
  "message": "Görev bulunamadı",
  "path": "/api/tasks/unknown-uuid",
  "validationErrors": null
}

Örn: Kullanıcı projede yer almadığı halde göreve atanmaya çalışıldığında:

{
  "timestamp": "2026-09-05T15:30:00Z",
  "status": 400,
  "error": "Bad Request",
  "message": "Kullanıcı bu projede yok",
  "path": "/api/tasks/uuid/assign/user-uuid",
  "validationErrors": null
}

Projede Unit (Birim) ve Integration (Entegrasyon) testleri titizlikle kurgulanmıştır.

• Mocking & Isolation: Mockito ve @ExtendWith(MockitoExtension.class) ile servis katmanları bağımsız test edilmiştir.
• SonarQube Kalite Kuralları: java:S5778 gibi kural ihlalleri refactor edilmiş, temiz kod prensiplerine uyulmuştur.
• JaCoCo Test Coverage:
  • TaskService.java: %100 Instructions, %100 Branches, %100 Lines, %100 Methods

# Tüm testleri çalıştırmak için:
cd backend
./mvnw test

# JaCoCo test kapsamı raporunu üretmek için:
./mvnw test jacoco:report
# Rapor konumu: backend/target/site/jacoco/index.html

• Java JDK 17+
• Docker & Docker Compose
• Maven (Projeye dahil olan ./mvnw kullanılabilir)
• Node.js 18+ (İsteğe bağlı - frontend/ arayüzü için)

git clone https://github.com/ismailcolak/gorev-takip-sistemi.git
cd gorev-takip-sistemi

docker compose up -d mysql

(MySQL localhost:3306 portunda hazır olacaktır)

cd backend
./mvnw clean spring-boot:run

Uygulama http://localhost:8080 portundan yayına başlayacaktır.

docker compose up -d sonarqube

cd backend
./mvnw clean verify sonar:sonar \
  -Dsonar.projectKey=gorev-takip-sistemi \
  -Dsonar.host.url=http://localhost:9000 \
  -Dsonar.login=YOUR_SONARQUBE_TOKEN

Projede backend ile doğrudan konuşabilen bir React + TypeScript + Vite + Tailwind CSS Kanban panosu (frontend/ dizininde) yer almaktadır.

cd frontend
npm install
npm run dev

Arayüz http://localhost:5173 adresinde açılacaktır.

A modern, enterprise-grade, and scalable RESTful Task & Project Management System backend application developed following Clean Architecture and Domain-Driven design principles.

This platform serves as the central backend engine for team-based task tracking. It enables teams to create projects, associate members, manage tasks across Kanban workflow lifecycles, and collaborate through task comment threads.

• Natural Key Abstraction (Public UUID Pattern): Internal sequential database primary keys (id - Long) are never exposed through APIs. All public REST communication uses random, non-guessable publicId (UUID v4) values.
• Strict Domain Integrity & Business Rules: Critical constraints—such as preventing a user from being assigned to a task unless they are an active member of that project—are enforced at the service layer.
• Immutability: Java record types are utilized across the entire DTO layer to guarantee thread-safe, immutable data transfers.
• Clean Code & SonarQube Compliance: Zero code smells, fully compliant with SonarQube rules (e.g. java:S5778), and comprehensive test coverage.

• 📁 Project Management: Create projects, list all projects, and fetch details by UUID.
• 👥 User & Membership System: Register users, assign users to projects (Many-to-Many), and query project members.
• 📌 Task Lifecycle Management:
  • Task creation with priorities (LOW, MEDIUM, HIGH).
  • Kanban status transitions (TODO ➔ IN_PROGRESS ➔ COMPLETED).
  • Query tasks filtered by project or assigned user.
  • Assign validated project members to tasks.
• 💬 Discussion & Comments: Post comments on tasks and retrieve historical discussion streams.
• ⏱️ HTTP Performance Logging: Custom RequestLoggingFilter logs incoming HTTP method, URI, response status code, and latency in milliseconds.

com.ismailcolak.gorev_takip_sistemi/
├── config/              # CORS and Filter configuration beans
├── controllers/         # REST API endpoints (HTTP request/response handling)
├── dto/
│   ├── request/         # Incoming request models (Immutable Records with Jakarta Validation)
│   └── response/        # Outgoing response models (Immutable Records)
├── entities/            # JPA Domain Entities and Enums
├── exceptions/          # Centralized exception handling (@RestControllerAdvice)
├── filters/             # Custom HTTP request/response latency logging filter
├── repositories/        # Spring Data JPA data access layer
└── services/            # Business logic, domain rules, and transactional boundaries

erDiagram
    PROJECT ||--o{ TASK : "contains (1:N)"
    USER ||--o{ TASK : "assigned to (0..1:N)"
    USER }|--|{ PROJECT : "member of (N:M - user_projects)"
    TASK ||--o{ COMMENT : "has (1:N)"
    USER ||--o{ COMMENT : "authors (1:N)"

    PROJECT {
        bigint project_id PK
        varchar public_id UK "UUID"
        varchar project_name
    }

    USER {
        bigint user_id PK
        varchar public_id UK "UUID"
        varchar user_name
    }

    TASK {
        bigint task_id PK
        varchar public_id UK "UUID"
        varchar task_name
        text task_detail
        varchar status "TODO, IN_PROGRESS, COMPLETED"
        varchar priority "LOW, MEDIUM, HIGH"
        bigint project_id FK
        bigint assigned_user_id FK "nullable"
    }

    COMMENT {
        bigint comment_id PK
        varchar public_id UK "UUID"
        text comment_detail
        bigint task_id FK
        bigint user_id FK
    }

All requests and responses use the application/json format.

{
  "projectName": "E-Commerce Microservices Migration"
}

{
  "userName": "ismailcolak"
}

{
  "taskName": "Payment Gateway Integration",
  "taskDetail": "Implement webhook listeners for Stripe / Iyzico.",
  "priority": "HIGH",
  "projectPublicId": "58e1eb6a-8b89-42b7-8a39-fb1d668fc79e",
  "assignedUserPublicId": "9d1bf762-23c3-4d40-bfae-22da56291a10"
}

{
  "status": "IN_PROGRESS"
}

(Accepted values: TODO, IN_PROGRESS, COMPLETED)

{
  "commentDetail": "Payment workflow verified in sandbox staging.",
  "userPublicId": "9d1bf762-23c3-4d40-bfae-22da56291a10"
}

All unexpected conditions and validation errors return an RFC-compliant, predictable ErrorResponse schema:

Returns a structured map of field errors:

{
  "timestamp": "2026-09-05T15:30:00Z",
  "status": 400,
  "error": "Bad Request",
  "message": "Girdi alanları geçersiz",
  "path": "/api/tasks/123/comments",
  "validationErrors": {
    "commentDetail": "yorum boş olamaz"
  }
}

{
  "timestamp": "2026-09-05T15:30:00Z",
  "status": 404,
  "error": "Not Found",
  "message": "Görev bulunamadı",
  "path": "/api/tasks/unknown-uuid",
  "validationErrors": null
}

E.g., attempting to assign a user who is not a member of the project:

{
  "timestamp": "2026-09-05T15:30:00Z",
  "status": 400,
  "error": "Bad Request",
  "message": "Kullanıcı bu projede yok",
  "path": "/api/tasks/uuid/assign/user-uuid",
  "validationErrors": null
}

The backend features both isolated Unit tests and complete Integration test suites.

• Mockito & Isolation: @ExtendWith(MockitoExtension.class) for fast, isolated service layer testing.
• SonarQube Compliance: Zero code smells and clean-as-you-code architecture.
• JaCoCo Test Coverage:
  • TaskService.java: 100% Instructions, 100% Branches, 100% Lines, 100% Methods

# Execute test suite:
cd backend
./mvnw test

# Generate JaCoCo coverage report:
./mvnw test jacoco:report
# Report output: backend/target/site/jacoco/index.html

• Java JDK 17+
• Docker & Docker Compose
• Maven (Bundled ./mvnw is recommended)
• Node.js 18+ (Optional - for running the frontend/ UI)

git clone https://github.com/ismailcolak/gorev-takip-sistemi.git
cd gorev-takip-sistemi

docker compose up -d mysql

(MySQL service starts at localhost:3306)

cd backend
./mvnw clean spring-boot:run

The REST API server will run on http://localhost:8080.

docker compose up -d sonarqube

cd backend
./mvnw clean verify sonar:sonar \
  -Dsonar.projectKey=gorev-takip-sistemi \
  -Dsonar.host.url=http://localhost:9000 \
  -Dsonar.login=YOUR_SONARQUBE_TOKEN

The repository includes a decoupled React + TypeScript + Vite + Tailwind CSS Kanban frontend inside the frontend/ directory.

cd frontend
npm install
npm run dev

Access the client dashboard at http://localhost:5173.

Created for portfolio and enterprise-architecture demonstration. Free to explore and adapt.