Kullanım kılavuzu
RepoMind'ın ne yaptığı, nasıl kullanıldığı ve ekip çalışma alanının kuralları.
RepoMind nedir?
RepoMind, GitHub repolarını analiz eden bir araçtır. Bir repoya 0–100 arası bir sağlık skoru verir, projeyi benzer projelerle karşılaştırır ve AI ile geliştirme önerileri sunar. Tek başına kullanabilir ya da ekibinle aynı projeleri birlikte takip edebilirsin.
Başlarken
- Ana sayfadan GitHub ile giriş yap. Ayrı bir şifre oluşturman gerekmez.
- İlk girişte nasıl kullanacağını seç: bireysel, ekip kuracağım ya da bir ekipten davetim var.
- Her yeni hesap 7 günlük deneme süresiyle başlar; bu sürede AI özellikleri günlük sınırlarla açıktır.
- Bir repo adı yaz (ör.
facebook/react) ve analizi başlat.
Sağlık skoru
Skor beş bölümün ağırlıklı ortalamasıdır. 80 ve üzeri sağlıklı, 60–79 orta, 60'ın altı dikkat isteyen bir proje demektir. Sağlık analizi her planda ücretsizdir.
| Bölüm | Ağırlık | Nasıl hesaplanır |
|---|---|---|
| Commit aktivitesi | %25 | Son 90 gündeki commit sayısı. 100 ve üzeri commit tam puan alır. |
| Issue yanıt süresi | %20 | Issue'ların ortalama kapanma süresi. 24 saatin altı tam puan alır. |
| PR merge hızı | %20 | Pull request'lerin ortalama merge süresi. 24 saatin altı tam puan alır. |
| Contributor sayısı | %20 | Katkı veren kişi sayısı. 20 ve üzeri tam puan alır. |
| Dokümantasyon | %15 | README (40), LICENSE (25), CONTRIBUTING (20) ve issue şablonu (15) puanı. |
AI özellikleri
✨ Proje analizi
Kod yapısını, son commit'leri ve açık issue'ları okur; projeye özel geliştirme önerileri sunar. Analizler kaydedilir: aynı commit için tekrar analiz istersen kayıtlı sonuç gelir ve hakkın düşmez. Eski analizleri geçmişten açabilirsin.
🔍 Benzer proje karşılaştırma
Kişisel alanda, projene benzeyen popüler repoları bulur ve onlarda olup sende olmayan özellikleri listeler. Sonuç kaydedilir; sen yeniden karşılaştır diyene kadar son sonuç gösterilir ve hakkın düşmez.
💬 Danışman
Proje hakkında soru sorabileceğin bir AI ürün danışmanı. Projenin kayıtlı son analizini kullanır; analizi ayrıca tekrar yapmaz. Dokümanları ücretsiz indekslersen README ve docs/ dosyalarından ilgili bölümleri de kullanır ve cevabın altında kaynak dosyaları gösterir.
📄 Proje dokümanı
Projenin mevcut özelliklerini ve teknoloji yığınını anlatan bir Word dokümanı hazırlar.
🗺️ Proje Haritası
Projenin modüllerini, özelliklerini, API endpoint'lerini ve veri modellerini tek sayfada gösterir; kimin hangi bölüme en çok katkı verdiğini ve yeni gelenin nereden başlaması gerektiğini söyler. Endpoint ve modeller koddan çıkarılır.
🌙 Günlük güncelleme
Kayıtlı analiz, harita ve karşılaştırmalar her gece kontrol edilir. Proje yeterince değiştiyse (en az 5 yeni commit) sonuç kendiliğinden yenilenir ve "otomatik güncellendi" etiketi görünür. Değişiklik azsa AI çalışmaz, hakkın düşmez.
AI özellikleri planındaki günlük ve aylık sınırlara tabidir. Danışman sohbetlerinin içeriği sunucuda saklanmaz. Proje analizleri saklanır: ekip projesinin analizlerini tüm ekip, kişisel analizlerini yalnızca sen görürsün.
Ekip çalışma alanı
Ekip sahibi ekibi kurar, ekibe proje (repo) ekler ve üyeleri GitHub kullanıcı adlarıyla davet eder. İstersen davetle birlikte bilgilendirme e-postası da gider. Ekip sahibi hem kişisel alanını hem de ekip alanını kullanır; üstteki seçiciyle ikisi arasında geçer.
Davetle gelen admin ve üyeleryalnızca ekip alanını görür: ekibin projelerini analiz eder, ekip panosunu birlikte kullanır. Her üyenin bir unvanı olabilir (ör. Backend Developer). Panodaki bir kart için "Kim uygun?" dediğinde RepoMind kartın iş alanına uygun unvanı olan ve açık işi az olan kişiyi önerir.
| Yetki | Sahip | Admin | Üye |
|---|---|---|---|
| Ekip projelerini analiz etmek, AI özelliklerini kullanmak | ✓ | ✓ | ✓ |
| Benzer proje karşılaştırması (yalnızca kişisel alanda) | Kişisel alanda | — | — |
| Sürümler sayfası ve sürüm bildirimleri | ✓ | ✓ | ✓ |
| Ekip panosuna kart eklemek ve durumunu değiştirmek | ✓ | ✓ | ✓ |
| Kartı birine atamak | ✓ | ✓ | Boştaki kartı üstlenir |
| Karttan GitHub issue'su açmak | ✓ | ✓ | Kendisine atanan kartlarda |
| Proje Haritası oluşturmak | ✓ | ✓ | Görür |
| Jira'yı bağlamak, proje ve kişi eşleştirmek | ✓ | ✓ | — |
| Kartı Jira'ya göndermek | ✓ | ✓ | ✓ |
| Üye davet etmek | ✓ | ✓ | — |
| Üye çıkarmak | ✓ | Yalnızca üyeleri | — |
| Ekibe proje eklemek / çıkarmak | ✓ | — | — |
| Rol değiştirmek, ekip planını ödemek | ✓ | — | — |
| Kişisel alan (her repoyu analiz etmek) | ✓ | — | — |
Pano, entegrasyonlar ve hatırlatmalar
👥 Atama ve "Kim uygun?"
Ekip sahibi ve adminler kartı herkese atar; üyeler boştaki bir kartı üstlenir ya da kendi kartını bırakır. "Kim uygun?" dediğinde RepoMind, kartın iş alanına uygun unvanı olan ve açık işi az olan kişiyi önerir. Panonun üstünde herkesin açık iş sayısı görünür.
🐙 GitHub issue
Karttan tek tıkla kartın reposunda issue açılır; kart kime atanmışsa issue da ona atanır. PR açıklamasına "Closes #42" yazılırsa PR merge olunca issue kapanır ve kart pano açıldığında kendiliğinden tamamlanır.
🟦 Jira
Ekip sahibi veya bir admin ekibi Jira'ya bir kez bağlar; projeleri ve kişileri eşleştirir. Sonra panodaki kart "Jira'ya gönder" ile Jira'da issue olur; gönderirken Jira projesinden kime atanacağını seçersin (üyeler kendilerini ya da kartın atanan kişisini seçebilir). Jira'da iş ilerleyince, bitince ya da başka birine atanınca kart da hemen güncellenir.
✅ Sana atanan işler
Ana sayfada (ekip hesabında ekip sayfasında) sana atanmış bitmemiş kartlar, GitHub'da sana atanmış açık issue'lar ve Jira'da sana atanmış açık işler tek listede görünür. Önceliği olanlar (Kritik, Yüksek, …) en üstte yer alır; GitHub'da P1, priority: high gibi etiketler de öncelik sayılır. Altında ekip projelerinin son staging ve main çıkışları görünür.
📂 Sol menü
Ekip alanında soldaki menüde ekibin projeleri listelenir: açık kart sayısı, son staging ya da main çıkışı ve son analiz tarihi. Bir projeye tıklayınca Harita, Sürümler ve Pano bağlantıları açılır. Altta sana atanan kart sayısı ve Jira bağlantı durumu görünür. Kişisel alanda menüde takip listen durur.
🏷️ Sürümler
Bir projenin staging ve main dallarına hangi PR'ın, kim tarafından, ne zaman çıktığını gösterir. Staging'de olup henüz main'e çıkmamış değişiklikleri de listeler. Veri en fazla 10 dakikada bir GitHub'dan okunur.
🔔 Bildirimler
Ekip davetleri bildirim ziline de düşer ve kabul ya da ret edilene kadar orada kalır. Bir ekip projesinde staging'e ya da main'e yeni bir PR çıkınca tüm ekibe bildirim gider; tıklayınca Sürümler sayfası açılır. Ekip panosunda bir kart sana atanınca, kartın durumu değişince (Jira'da, GitHub'da ya da başka bir üye tarafından) ve kartın Jira issue'suna yorum yazılınca da bildirim gelir; kendi yaptığın değişiklikler için bildirim gelmez. Zil ve davet bandı sayfayı yenilemeden, dakikada bir ve sekmeye dönünce güncellenir.
Planlar ve sınırlar
| Plan | Danışman mesajı | AI analiz / rapor |
|---|---|---|
| Deneme (7 gün) | Günde 15 | Günde 3 |
| Kişisel Pro | Günde 200 | Ayda 500 |
| Ekip Pro (ekip için ortak) | Günde 500 | Ayda 1000 |
| Deneme bitti, plan yok | Kapalı | Kapalı |
Ekip hesaplarında kullanım ekibin ortak havuzundan düşer. Ekip planını ekip sahibi yönetir.
Gizlilik ve güvenlik
- Private repolar hiçbir public sayfada görünmez ve giriş yapmamış ziyaretçiler tarafından analiz edilemez.
- Ekip hesapları yalnızca kendi ekiplerinin projelerine erişebilir.
- Üyelerin e-posta adreslerini yalnızca ekip sahibi ve adminler görür.
- Ekibe katılmadan önceki kişisel verilerin ekip sahibine gösterilmez.
- Giriş GitHub ile yapılır; RepoMind şifreni hiçbir zaman görmez.
- GitHub'a issue açmak yalnızca senin (ekip projelerinde ekip sahibinin) GitHub erişiminle ve repoda yazma yetkisi varsa yapılır; RepoMind kendi hesabıyla hiçbir repoya yazmaz.
- "Sana atanan işler" listesi senin GitHub erişiminle okunur ve yalnızca sana gösterilir.
- Jira bağlantısının erişim bilgileri şifreli saklanır ve hiçbir ekranda gösterilmez. Bağlantıyı yalnızca ekip sahibi ve adminler kurar ya da kaldırır.
- Proje analizleri ve Proje Haritası: ekip projesininkini tüm ekip, kişisel olanları yalnızca sen görürsün.
Ayrıntılar için Gizlilik Politikası ve Kullanım Şartları sayfalarına bak.
Sık sorulan sorular
Private repomu analiz edebilir miyim?
Evet. GitHub hesabınla erişebildiğin private repoları analiz edebilirsin. Private repolar hiçbir public sayfada (skor kartı, rozet, liste) görünmez.
Ekip üyelerinin GitHub'da repoya erişimi olmalı mı?
Hayır. Private bir ekip projesinin verisi ekip sahibinin GitHub erişimiyle okunur. Bu yüzden ekibe proje eklemeyi yalnızca ekip sahibi yapabilir.
Jira'yı nasıl bağlarım?
Ekip sayfasındaki Jira bölümünde "Jira'ya bağlan" de, Atlassian sayfasında izin ver. Sonra her ekip projesini bir Jira projesiyle, her üyeyi Jira hesabıyla eşleştir. Panodaki kartta "Jira'ya gönder" dediğinde issue o projede açılır ve kart kime atanmışsa ona atanır; Jira'da iş bitince kart da tamamlanır.
Karttan GitHub issue'su açınca ne olur?
Issue kartın reposunda açılır ve kart kime atanmışsa ona atanır. Atanan kişinin GitHub'da repoya erişimi yoksa issue atanmadan açılır ve uyarı gösterilir. PR açıklamasına "Closes #42" yazılırsa PR merge olunca issue kapanır, kart da pano açıldığında kendiliğinden tamamlanır.
Davet linkini başkası kullanabilir mi?
Hayır. Davet, davet edilen kişinin GitHub hesabına bağlıdır. Link başka birinin eline geçse bile o kişi daveti kabul edemez. Davetler 7 gün geçerlidir.
Deneme süresi bitince ne olur?
AI özellikleri kapanır; repo sağlık analizi ücretsiz kalmaya devam eder. Pro plana geçince AI özellikleri tekrar açılır.
Günlük hakkım ne zaman yenilenir?
Günlük sınırlar Türkiye saatiyle gece yarısı, aylık sınırlar her ayın başında yenilenir.
Bir ekibe katılınca kişisel verilerim ne olur?
Ekipteyken kişisel izleme listen ve kaydettiğin feature'lar gizlenir, silinmez. Ekipten ayrılınca hesabın tekrar bireysel olur ve verilerin geri gelir.
Ekipten nasıl ayrılırım?
Ekip sayfasındaki "Ekipten ayrıl" butonuyla. Ekip sahibi ekipten ayrılamaz.