https://github.com/eraycann/teamtaskflow
**TeamTaskFlow**: Spring Boot ile geliştirdiğim, takım görev akışlarını yöneten demo proje. RESTful API, JWT, veri yönetimi, pagination, Swagger ve global exception handling gibi teknolojileri uyguladım. 🚀
https://github.com/eraycann/teamtaskflow
git-flow global-exception-handling jwt-authentication pagination postgresql rest-api spring-boot spring-security swagger team-management
Last synced: 2 months ago
JSON representation
**TeamTaskFlow**: Spring Boot ile geliştirdiğim, takım görev akışlarını yöneten demo proje. RESTful API, JWT, veri yönetimi, pagination, Swagger ve global exception handling gibi teknolojileri uyguladım. 🚀
- Host: GitHub
- URL: https://github.com/eraycann/teamtaskflow
- Owner: Eraycann
- License: mit
- Created: 2024-12-07T15:05:53.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-02-28T12:39:41.000Z (over 1 year ago)
- Last Synced: 2025-06-17T18:51:55.882Z (about 1 year ago)
- Topics: git-flow, global-exception-handling, jwt-authentication, pagination, postgresql, rest-api, spring-boot, spring-security, swagger, team-management
- Language: Java
- Homepage:
- Size: 258 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# TeamTaskFlow 🚀
TeamTaskFlow, Spring Boot kullanarak geliştirdiğim ve takım görev akışlarını yöneten demo bir projedir. Bu projede modern web uygulamaları geliştirme sürecinde edindiğim teknolojileri ve kavramları uygulama fırsatı buldum. 😄
## Özellikler ✨
- **RESTful API:** Dinamik ve genişletilebilir API geliştirme deneyimi. 📡
- **Güvenlik & JWT:** Spring Security ile güvenli giriş, JWT ile token tabanlı kimlik doğrulama. 🔐
- **Veri Yönetimi:** Spring Data JPA ve PostgreSQL ile sağlam veri işlemleri. 💾
- **Pagination:** Büyük veri setlerinde verimli listeleme ve sayfalama imkanı. 📄
- **Swagger Dokümantasyonu:** Otomatik oluşturulan Swagger UI sayesinde API dokümantasyonuna kolay erişim. 📚
- **Global Exception Handling:** Uygulama genelinde hataların merkezi olarak yönetilmesi ile temiz ve anlaşılır hata mesajları. ⚠️
- **DTO Dönüşümleri:** MapStruct ile nesneler arası dönüşümleri kolaylaştırma. 🔄
- **Kod Temizliği:** Lombok sayesinde tekrarlayan kodları azaltarak daha okunabilir bir yapı. 🧹
## Öğrendiklerim 🎓
Bu projede çalışırken:
- **Java 17** ile modern Java özelliklerini keşfettim. ☕️
- **Spring Boot** sayesinde hızlı ve esnek uygulama geliştirme tecrübesi edindim. ⚡️
- **Spring Security & JWT** ile uygulamalara güvenlik katmanlarını nasıl entegre edeceğimi öğrendim. 🔒
- **Pagination** kullanarak büyük veri setlerini daha verimli yönetmeyi deneyimledim. 🗂️
- **Swagger** ile API dokümantasyonunu otomatikleştirmenin ne kadar pratik olduğunu gördüm. 📖
- **Global Exception Handling** sayesinde hataların merkezi yönetimini ve daha temiz hata raporlamayı öğrendim. 🚨
- **Spring Data JPA** ve **PostgreSQL** ile veritabanı işlemlerinde pratik yaptım. 🛢️
- **MapStruct** ve **Lombok** kullanarak kod yazımını hızlandırıp, daha temiz ve bakımı kolay hale getirdim. ✨
---
# Github Workflow Kullanımı Deneyimi 🚀
## 1. Branching Strategy (Dal Stratejisi) 🌳
- **Ana Dal (main/master):** Her zaman stabil ve production-ready kod burada tutulur. ✅
- **Feature Branches:** Yeni özellik eklerken, `feature/` formatında branch'ler oluşturuyorum.
*Örnek:* `feature/create-entities` ✨
- **Chore Branches:** Proje dosyalarını güncellemek, bağımlılıkları yenilemek veya lisans eklemek gibi rutin işler için `chore/` branch'leri kullanıyorum. 🔄
- **Commit ve Merge:** Her geliştirme aşamasında, ilgili branch üzerinde düzenli commit'ler alıyorum. Geliştirme tamamlandığında, branch'i ana dal ile birleştiriyorum. Böylece ana dal her zaman güncel ve stabil kalıyor. 🔀
## 2. Commit Message Conventions (Commit Mesajı Standartları) 💬
Commit mesajlarımda yapılan değişikliğin türünü açıkça ifade eden bir yapı kullanıyorum:
- **feat:** Yeni özellik eklemeleri için. 🌟
- **chore:** Bağımlılık güncellemeleri, proje dosyalarında değişiklikler veya lisans ekleme gibi rutin işler için. 🛠️
- **docs:** Dokümantasyon güncellemeleri için. 📚
- **fix:** Hata düzeltmeleri için. 🐞
---
## Kurulum ve Çalıştırma 🛠️
Projeyi yerel makinenizde çalıştırmak için şu adımları izleyebilirsiniz:
1. **Depoyu Klonlayın:**
```bash
git clone https://github.com/Eraycann/TeamTaskFlow.git
cd TeamTaskFlow
```
2. **Projeyi Derleyin:**
```bash
./mvnw clean install
```
(Alternatif olarak mvn clean install komutunu da kullanabilirsiniz.)
3. **Uygulamayı Başlatın:**
```bash
./mvnw spring-boot:run
```
(Uygulama, varsayılan olarak http://localhost:8080 adresinde çalışacaktır.)
## Yapılandırma ⚙️
Uygulamanın ayarlarını src/main/resources/application.properties veya application.yml dosyasında yapabilirsiniz. Örneğin, PostgreSQL yapılandırması şu şekilde olabilir:
```bash
spring.datasource.url=jdbc:postgresql://localhost:5432/teamtaskflow_db
spring.datasource.username=your_username
spring.datasource.password=your_password
spring.jpa.hibernate.ddl-auto=update
```
Ayrıca Swagger ve global exception handling ile ilgili ek ayarlar da bu dosyada yapılandırılabilir.
## Lisans 📄
Bu proje MIT Lisansı kapsamında lisanslanmıştır.