JWC — Jira Worklog Calculator

Jira sprint'lerindeki worklog'ları topluca görüntülemek ve Excel'e aktarmak için komut satırından açılan web uygulaması.

npm install -g @osman-koc/jwc
jwc

Özellikler

• Aktif sprint otomatik seçili gelir, dropdown'dan diğer sprint'lere geçilebilir
• Sana atanmış task'lar listelenir; her birinin worklog kayıtları tarih/saat ve süre olarak gösterilir
• Task bazında ara toplam, tüm sprint için genel toplam hesaplanır
• Worklog girilmemiş task'lar da listelenir
• Raporun oluşturulma tarihi/saati gösterilir
• Excel (.xlsx) olarak dışa aktarma — task grupları, ara toplamlar ve genel toplam dahil
• Expand/Collapse ile task detaylarını gizle/göster

Kurulum

Gereksinimler

• Node.js v18 veya üzeri
• Jira'ya erişim ve kişisel API token'ı

1. Global Kur

npm install -g @osman-koc/jwc

Kurulum sırasında terminal sırasıyla şu bilgileri ister:

| Bilgi | Açıklama | |-------|----------| | Jira kullanıcı adı | JIRA hesabındaki kullanıcı adı (orn: JOHNSMITH) | | Jira token | Personal Access Token (bkz. aşağıda) | | Jira base URL | Şirkete ait Jira adresi (orn: https://jira.sirket.com) | | Proje anahtarı | Jira proje kodu (orn: PW, DEV, MYAPP) |

Kurulum tamamlandığında yapılandırma global kurulum dizinindeki .env dosyasına kaydedilir.

2. Çalıştır

jwc

Uygulama başladığında tarayıcı otomatik olarak açılır.

3. Yapılandırmayı sonradan güncelle

Kurulum scriptini tekrar çalıştırmak için:

npx @osman-koc/jwc setup

Ya da global kurulum dizinindeki .env dosyasını elle düzenleyebilirsin:

JIRA_USER=kullanici_adiniz
JIRA_TOKEN=token_degeri
JIRA_BASE_URL=https://jira.sirketiniz.com
JIRA_PROJECT=PROJE
PORT=3000

4. Personal Access Token (PAT) nasıl alınır?

1. Jira arayüzüne giriş yap
2. Sağ üst köşedeki profil resmine tıkla → Profile
3. Sol menüden Personal Access Tokens bölümüne git
4. Create token butonuna tıkla
5. Token'a bir isim ver ve isteğe bağlı bir son kullanım tarihi belirle
6. Create butonuna tıkla ve oluşan token'ı kopyala — bir daha gösterilmez!
7. Kopyaladığın değeri .env dosyasındaki JIRA_TOKEN= satırına yapıştır

Şirket içi Jira kurulumlarında bu menü farklı bir yerde olabilir; sistem yöneticinizden de token oluşturmasını isteyebilirsiniz.

5. Jira proje anahtarını bul

Jira'da task URL'lerine bak. Örneğin https://jira.sirket.com/browse/PW-1234 adresindeysen proje anahtarın PW'dir.

Kullanım

1. Sayfa yüklendiğinde aktif sprint otomatik olarak seçilir ve worklog verileri çekilir
2. Sol paneldeki dropdown'dan farklı bir sprint seçip Yükle butonuna tıkla
3. Tablo; task ID, başlık, durum, tarih/saat, süre ve yorum sütunlarını gösterir
4. Her task satırındaki ▲ Gizle / ▼ Göster butonuyla detayları kapat/aç
5. Excel İndir butonuyla mevcut raporun .xlsx dosyasını indir

Notlar

• Uygulama, Jira'nın Agile Board API'sine erişim gerektirmez. Sprint verileri customfield_10020 üzerinden JQL ile çekilir; bu nedenle kısıtlı izinlerde de çalışır.
• Gösterilen worklog'lar yalnızca JIRA_USER değerinde belirtilen kullanıcıya aittir. Aynı task'a başka kişiler log atmışsa bunlar filtrelenir.
• .env dosyasını asla git'e commit'leme.

Geliştirici olarak kaynak kodundan çalıştırmak için bkz. DEVELOPMENT.md

Kullanılan Teknolojiler

• Express.js — HTTP sunucu
• tsx — TypeScript çalıştırıcı
• ExcelJS — Excel dışa aktarma
• dotenv — Ortam değişkeni yönetimi
• Vanilla HTML/CSS/JS — Framework'süz frontend