🃏 Scrum Poker

Agile takımlar için geliştirilmiş, modern, gerçek zamanlı ve kullanıcı dostu bir Planning Poker (Efor Poker) uygulaması.

🚀 Proje Hakkında

Scrum Poker, yazılım geliştirme ekiplerinin "Sprint Planning" toplantılarında işlerin karmaşıklığını ve eforunu tahmin etmelerini sağlayan web tabanlı bir araçtır. Özellikle uzaktan (remote) çalışan ekipler için tasarlanmış olup, anlık etkileşim ve kolay kullanım sunar.

Geleneksel kağıt kartların yerini alan bu dijital çözüm, Socket.io altyapısı sayesinde tüm katılımcıların oylarını ve aksiyonlarını milisaniyeler içinde senkronize eder.

✨ Öne Çıkan Özellikler

• Gerçek Zamanlı İletişim: WebSocket teknolojisi ile oylar, katılımcılar ve durum güncellemeleri anında herkesin ekranına yansır.
• Rol Tabanlı Yönetim:
  • 👑 Yönetici (Admin): Odayı açan kişi. Konuyu belirler, referans linki ekler, oyları açar ve sıfırlar.
  • 🗳️ Seçmen (Voter): Ekipteki geliştiriciler. Efor puanı verir.
  • 👁️ İzleyici (Observer): Product Owner veya Scrum Master gibi oylamaya katılmayan paydaşlar.
• Modern Arayüz & UX:
  • Tailwind CSS ile geliştirilmiş şık ve responsive tasarım.
  • Mor tema.
  • Oylama kartlarında Risk/Efor detayları ve renk kodlamaları (Yeşil/Sarı/Kırmızı).
• Kullanım Kolaylığı:
  • Kayıt yok! Sadece bir oda oluşturun ve linki paylaşın.
  • Katılımcılar isim girerek anında dahil olur.
  • Link paylaşımı ile tek tıkla davet.
• Docker Desteği: Tek komutla sunucunuzda ayağa kaldırın.

🛠️ Teknolojiler

Bu proje, modern web geliştirme standartlarına uygun olarak en güncel teknolojilerle geliştirilmiştir:

• Frontend & Backend Framework: Next.js 16 (App Router)
• Dil: TypeScript
• Real-time Engine: Socket.io (Custom Server)
• Stil: Tailwind CSS & Lucide React (İkonlar)
• Containerization: Docker & Docker Compose

📦 Kurulum ve Çalıştırma

Projeyi yerel ortamınızda veya sunucunuzda çalıştırmak için aşağıdaki yöntemleri kullanabilirsiniz.

Seçenek 1: Docker ile Hızlı Kurulum (Önerilen)

En kolay yöntemdir. Sisteminizde Docker'ın kurulu olması yeterlidir.

1. Repoyu klonlayın:

   git clone https://github.com/kullaniciadi/scrum-poker.git
   cd scrum-poker

2. Uygulamayı başlatın:

   docker-compose up -d --build

3. Tarayıcıda açın: http://localhost:3001 adresine gidin.

Seçenek 2: Manuel Kurulum (Geliştirme)

Node.js (v18+) gerektirir.

1. Bağımlılıkları yükleyin:

   npm install

2. Geliştirme sunucusunu başlatın:

   npm run dev

   Not: Socket sunucusu server.ts üzerinden ayağa kalkar.

3. Production Build alıp çalıştırın:

   npm run build
   npm start

📸 Ekran Görüntüleri

Oylama Ekranı	Yönetim Paneli
Takım üyeleri kartlarını seçerken	Admin oyları yönetirken

🤝 Katkıda Bulunma

Bu proje açık kaynaklıdır ve katkılarınızı memnuniyetle bekleriz! Hata bildirimleri, yeni özellik istekleri veya Pull Request'ler için lütfen "Issues" sekmesini kullanın.

1. Bu repoyu fork'layın.
2. Yeni bir özellik dalı (feature branch) oluşturun (git checkout -b feature/YeniOzellik).
3. Değişikliklerinizi commit'leyin (git commit -m 'Yeni özellik: Harika buton eklendi').
4. Dalınızı push'layın (git push origin feature/YeniOzellik).
5. Bir Pull Request oluşturun.

📄 Lisans

Bu proje MIT lisansı ile lisanslanmıştır. Dilediğiniz gibi kullanabilir ve geliştirebilirsiniz.

---

👨‍💻 Geliştirici: [Abdullah Gökmen] 🌟 Beğendiyseniz yıldız vermeyi unutmayın!