Staj Raporu Üreticisi

GitHub commit geçmişinden otomatik olarak Türkçe staj raporu üretir. Tamamen ücretsiz — ücretli API veya kredi kartı gerekmez.

Şu an yalnızca macOS desteklenmektedir.

---

Başlangıç

Terminale aşağıdaki komutları sırayla yapıştırın, her şey otomatik kurulur:

git clone https://github.com/EfeGuler00/rapor-cli.git
cd rapor-cli
npm install
node scripts/rapor.mjs

Kurulum sihirbazı açılır ve sırasıyla iki şey ister:

1. Groq API Key — ücretsiz, kart gerekmez → https://console.groq.com/keys adresine git · "Create API Key" · kopyala · yapıştır

2. GitHub Token — opsiyonel, önerilir → https://github.com/settings/tokens/new adresine git → Scope: yalnızca public_repo altındaki read kutucuğunu işaretle → Boş bırakırsan günde 60 GitHub isteğiyle çalışır (genellikle yeterli)

Kurulum tamamlanınca rapor komutu otomatik olarak sisteme eklenir. Yeni bir terminal aç ve kullanmaya başla:

rapor <github-kullanici-adi> <YYYY-MM-DD>

---

Kullanım

# Günlük rapor
rapor EfeGuler00 2026-02-20

# Ek notlarla
rapor EfeGuler00 2026-02-20 --notes "Bugün ekip toplantısına katıldım"

# Haftalık özet (o haftanın Pzt-Cum tüm commit'lerini toplar)
rapor ozet EfeGuler00 2026-02-20

Komut	Kaydedilen dosya
rapor	Masaüstü → GG-AA-YYYY staj raporu.txt
rapor ozet	Masaüstü → Hafta-NN-YYYY haftalık staj raporu.txt

---

Nasıl çalışır?

1. GitHub'dan o güne ait commit'leri çeker
2. Opsiyonel ek notlarla birleştirir
3. Groq API (Llama 3.1-8b, ücretsiz) ile insan gibi Türkçe rapor üretir
4. Masaüstüne .txt olarak kaydeder

---

Ayarlar

Key'leri güncellemek veya kurulumu tekrar yapmak için:

rapor

---

Lisans

MIT © 2026 EfeGuler00