Gorev Task Management Server

# Kullanım Kılavuzu > **Versiyon**: Bu dokümantasyon v0.11.1 için geçerlidir. > **Son Güncelleme**: 19 August 2025 Gorev ile görev yönetiminin temelleri ve yeni template alias sistemi. ## 🎯 Temel Kavramlar ### Görev (Task) - Yapılacak işlerin temel birimi - Her görevin benzersiz bir ID'si vardır - Durum: `beklemede`, `devam_ediyor`, `tamamlandi` - Öncelik: `dusuk`, `orta`, `yuksek` ### Proje (Project) - Görevleri gruplamak için kullanılır - Birden fazla görev içerebilir - İsteğe bağlıdır ## 🔧 Komut Satırı Kullanımı ### Sunucuyu Başlatma ```bash # Normal modda başlat gorev serve # Debug modunda başlat gorev serve --debug # Özel veri dizini ile gorev serve --data-dir /path/to/data ``` ### Versiyon Kontrolü ```bash gorev version ``` ### Template Alias Sistemi (v0.11.1+) ```bash # Template alias'larını görüntüle gorev template aliases # Template'leri listele gorev template list # Belirli template'i incele gorev template show bug ``` **Mevcut Template Alias'ları:** - `bug` - Bug Raporu - `bug2` - Gelişmiş Bug Raporu - `feature` - Özellik İsteği - `research` - Araştırma Görevi - `spike` - Spike Araştırma - `security` - Güvenlik Düzeltmesi - `performance` - Performans Sorunu - `refactor` - Refactoring - `debt` - Teknik Borç ## 💬 Claude ile Kullanım ### Görev Oluşturma **⚠️ Önemli**: v0.10.0+ sürümlerinde tüm görevler template kullanılarak oluşturulmalıdır. **Template ile basit görev:** ``` Bug template'i kullanarak görev oluştur: Başlık: Giriş sayfasında düğme çalışmıyor Açıklama: Ana sayfadaki giriş düğmesi tıklanmıyor Modül: Frontend Ortam: production ``` **Template alias kullanarak:** ``` "feature" template'i ile yeni özellik görevi oluştur: Başlık: Kullanıcı profil sayfası Açıklama: Kullanıcıların profillerini düzenleyebilecekleri sayfa ``` **Mevcut template'leri görmek için:** ``` Kullanılabilir template'leri listele ``` ### Görevleri Listeleme **Tüm görevler:** ``` Görevleri listele ``` **Duruma göre filtreleme:** ``` Beklemedeki görevleri göster Devam eden görevleri listele Tamamlanmış görevleri göster ``` ### Görev Durumu Güncelleme ``` [görev-id] görevini "devam ediyor" olarak güncelle [görev-id] görevini tamamlandı olarak işaretle ``` ### Proje Yönetimi **Proje oluşturma:** ``` "Web Uygulaması" adında yeni bir proje oluştur ``` **Proje özeti:** ``` Proje özetini göster Genel durumu özetle ``` ## 📊 Gelişmiş Kullanım ### Görev Organizasyonu 1. **Proje Bazlı Çalışma:** ``` 1. "Backend API" projesi oluştur 2. Bu proje için görevler ekle: - Kullanıcı authentication endpoint'i - Veritabanı migration'ları - API dokümantasyonu ``` 2. **Öncelik Yönetimi:** ``` Yüksek öncelikli görevleri listele En acil 3 görevi göster ``` 3. **Durum Takibi:** ``` Bugün tamamlanan görevleri göster Devam eden görevlerin özetini ver ``` ### Workflow Örnekleri #### Sprint Planlama ``` 1. "Sprint 1" projesi oluştur 2. Sprint görevlerini ekle (her biri için tahmini süre) 3. Görevleri öncelik sırasına göre listele 4. İlk görevi "devam ediyor" olarak işaretle ``` #### Bug Takibi ``` 1. "Buglar" projesi oluştur 2. Yüksek öncelikli bug görevi ekle: - Başlık: "Login sayfası 404 hatası" - Açıklama: "Production'da login sayfası açılmıyor" 3. Görevi "devam ediyor" olarak güncelle 4. Çözüldüğünde "tamamlandı" olarak işaretle ``` #### Günlük Planlama ``` 1. Bugünkü görevleri listele 2. En yüksek öncelikli görevi seç 3. "Devam ediyor" olarak işaretle 4. Tamamlandığında güncelle 5. Günlük özet raporu al ``` ## 🎨 İpuçları ve Püf Noktaları ### 1. Etkili Görev Başlıkları - ❌ "Bug fix" - ✅ "Kullanıcı giriş formunda email validasyonu düzelt" ### 2. Açıklama Kullanımı - Bağlam bilgisi ekleyin - Kabul kriterleri belirtin - İlgili kaynakları not edin ### 3. Öncelik Stratejisi - **Yüksek**: Acil ve önemli (production buglar, kritik özellikler) - **Orta**: Önemli ama acil değil (yeni özellikler, iyileştirmeler) - **Düşük**: Ne acil ne önemli (nice-to-have özellikler) ### 4. Durum Yönetimi - Aynı anda sadece 1-3 görev "devam ediyor" durumunda olmalı - Görevleri küçük, yönetilebilir parçalara bölün - Tamamlanan görevleri düzenli olarak gözden geçirin ## 🔍 Sık Kullanılan Komutlar ### Hızlı Başlangıç ``` "Todo uygulaması" projesi oluştur ve şu görevleri ekle: - Frontend tasarımı (orta öncelik) - Backend API geliştirme (yüksek öncelik) - Veritabanı şeması (yüksek öncelik) - Test yazma (orta öncelik) - Deployment setup (düşük öncelik) ``` ### Durum Raporu ``` Şu bilgileri ver: - Toplam görev sayısı - Duruma göre dağılım - Önceliğe göre dağılım - Aktif proje sayısı ``` ### Temizlik ``` Tamamlanmış görevleri listele ve hangilerinin arşivlenebileceğini belirt ``` ## ❓ Sorun Giderme ### Görev ID'si Bulma ``` "API test" içeren görevi bul ve ID'sini göster ``` ### Toplu Güncelleme ``` "Backend" projesindeki tüm bekleyen görevleri listele ``` ### Veri Yedekleme Gorev otomatik olarak SQLite veritabanını kullanır. Yedekleme için: ```bash cp ~/.gorev/data/gorev.db ~/.gorev/data/gorev.db.backup ``` ## 🆕 Gelişmiş Özellikler ### Görev Şablonları Hazır şablonlar kullanarak tutarlı görevler oluşturabilirsiniz: ``` "Bug raporu şablonundan yeni görev oluştur" "Feature request şablonunu kullanarak yeni özellik isteği oluştur" "Mevcut görev şablonlarını listele" ``` ### Son Tarih ve Filtreleme Görevlerinize son tarih ekleyip, acil görevleri filtreleyebilirsiniz: ``` "25 Temmuz 2025 tarihine kadar bitirilmesi gereken yeni görev oluştur" "Acil görevleri listele" (7 gün içinde bitenler) "Gecikmiş görevleri göster" "Görevleri son tarihe göre sırala" ``` ### Etiketleme Görevleri etiketlerle kategorize edebilirsiniz: ``` "Frontend ve kritik etiketleriyle yeni görev oluştur" "Frontend etiketli görevleri listele" ``` ### Görev Bağımlılıkları Görevler arası bağımlılıklar tanımlayabilirsiniz: ``` "3 numaralı görev 1 ve 2 numaralı görevlere bağımlı olsun" "5 numaralı görevin bağımlılıklarını göster" ``` ## 🚀 Sonraki Adımlar - [MCP Araçları Referansı](mcp-tools.md) - Tüm komutların detaylı açıklaması - [Örnekler](../../tr/ornekler.md) - Gerçek kullanım senaryoları - [Mimari](../../architecture/technical-specification-v2.md) - Sistem nasıl çalışır?