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
• Jira proje rollerinde sana veya grubuna atanmış projeler ekrandan listelenir; tek proje veya çoklu proje modu ile seçim yapılabilir
• Sana atanmış task'lar listelenir; her birinin worklog kayıtları tarih/saat ve süre olarak gösterilir
• Task bazında ara toplam, seçilen proje/sprint kapsamı 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) |

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
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.

Kullanım

1. Sayfa yüklendiğinde erişebildiğin Jira projeleri sol panelde listelenir
2. Tek proje modunda bir proje seç; aktif sprint otomatik seçilir ve worklog verileri çekilir
3. Çoklu proje modunda birden fazla proje seç; her proje için sprint seçip Yükle butonuna tıkla
4. Tablo; çoklu modda proje/sprint bilgisiyle birlikte task ID, başlık, durum, tarih/saat, süre ve yorum sütunlarını gösterir
5. Her task satırındaki ▲ Gizle / ▼ Göster butonuyla detayları kapat/aç
6. Excel İndir butonuyla mevcut raporun .xlsx dosyasını indir

Notlar

• Uygulama projeleri Jira REST API üzerinden listeler; sprint verileri customfield_10020 üzerinden JQL ile çekilir.
• 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.
• Sprint mail ekranı tek proje/tek sprint modunda çalışır; çoklu proje modunda devre dışı bırakılır.
• .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