Haftalık Jira changelog'u için en güvenilir JQL filtresi nedir?

`statusCategory = Done AND resolved >= startOfWeek(-7d) AND resolved < startOfWeek()` filtresidir. Doğrudan `statusCategory = Done` kullanmak, farklı ekiplerin 'Kapandı', 'Canlıda', 'Tamamlandı' gibi özel statü adlarını standart biçimde yakalar.

Dahili altyapı ve refactoring biletlerinin genel bültende yer alması nasıl önlenir?

Issue type ve etiket (label) bazlı kurallar kullanılır. 'Bug' ve 'Story' kullanıcıya dönük alanlara eşlenirken, 'Task' veya 'internal' etiketli biletler 'Altyapı' başlığına atanır ya da genel bülten dışı bırakılır.

Birden fazla Jira projesi tek bir haftalık bültende birleştirilebilir mi?

Evet. Deterministik eşleme kuralı her Jira proje anahtarını (örn: WEB, API, CORE) ilgili ürün başlığına atar ve tüm ekiplerin işlerini tek raporda toplar.

Jira webhook'ları ile geçmişe dönük aktarım (backfill) nasıl ayrışır?

Webhook'lar `jira:issue_updated` olayıyla anlık kapanışları yakalar; backfill ise bağlantı kurulduğu anda Jira REST API'si üzerinden son 14-30 günün tamamlanan işlerini tek seferde içe aktarır.

Jira'dan Durum Toplantısı Olmadan Haftalık Changelog Üretme

Q: Dahili altyapı ve refactoring biletlerinin genel bültende yer alması nasıl önlenir?

Issue type ve etiket (label) bazlı kurallar kullanılır. 'Bug' ve 'Story' kullanıcıya dönük alanlara eşlenirken, 'Task' veya 'internal' etiketli biletler 'Altyapı' başlığına atanır ya da genel bülten dışı bırakılır.

Q: Birden fazla Jira projesi tek bir haftalık bültende birleştirilebilir mi?

Evet. Deterministik eşleme kuralı her Jira proje anahtarını (örn: WEB, API, CORE) ilgili ürün başlığına atar ve tüm ekiplerin işlerini tek raporda toplar.

Q: Jira webhook'ları ile geçmişe dönük aktarım (backfill) nasıl ayrışır?

Webhook'lar `jira:issue_updated` olayıyla anlık kapanışları yakalar; backfill ise bağlantı kurulduğu anda Jira REST API'si üzerinden son 14-30 günün tamamlanan işlerini tek seferde içe aktarır.

Jira'dan güvenilir bir haftalık changelog üretmek üç kurala dayanır: çözümlenme tarihi filtresi, proje anahtarı eşlemesi ve issue type kategorizasyonu. İşte adım adım uygulama rehberi.

Soobrief Ekibi — Ürün ve Mühendislik, Sooapps · 2026-08-16

Kısaca

Güvenilir bir Jira changelog'u oluşturmanın kesin yolu, çözümlenme tarihi filtresi (`statusCategory = Done AND resolved >= -7d`), Jira proje anahtarlarının ürün alanlarıyla eşlenmesi ve issue type'ların kategorilere bölünmesidir. Bu deterministik kural seti kurulduğunda haftalık sürüm notları toplantı yapmadan otomatik üretilir.

Güvenilir bir Jira changelog'u oluşturmanın kesin yolu, çözümlenme tarihi filtresi (statusCategory = Done AND resolved >= -7d), Jira proje anahtarlarının ürün alanlarıyla eşlenmesi ve issue type'ların kategorilere bölünmesidir. Bu deterministik kural seti kurulduğunda haftalık sürüm notları toplantı yapmadan otomatik üretilir.

Yazılım ekipleri her Cuma günü Jira panolarından bilet numaralarını ve başlıklarını kopyalayıp Slack kanallarına veya e-postalara yapıştırmak için saatler harcar. Ekiplerin iş akışları farklılaştıkça, elle hazırlanan özetlerde biletler unutulur, teknik jargon tutarsızlaşır ve bültenler gecikir.

1. Adım: Kesin Çözümlenme Zaman Damgası Kuralı

Jira'da bir işin tamamlandığını belirleyen yegane güvenilir alan resolutiondate alanıdır. Özel durum isimlerine ("Test Edildi", "Canlıda", "Kapatıldı") güvenmek, pano iş akışı değiştiğinde sistemi bozar.

Haftalık periyot için en sağlam JQL sorgusu şöyledir:


project in (CORE, WEB, API) 
  AND statusCategory = Done 
  AND resolved >= startOfWeek(-7d) 
  AND resolved < startOfWeek()
ORDER BY resolved DESC

Filtre Kriteri	Önerilen Jira Alanı	Neden Kritik?
Tamamlanma Durumu	`statusCategory = Done`	Özel statüler değişse bile Jira tüm bitiş adımlarını Done kategorisinde eşitler.
Zaman Aralığı	`resolved >= -7d`	Oluşturulma veya güncellenme tarihini değil, gerçek tamamlanma anını baz alır.
Kapsam	`project in (...)`	Yalnızca müşteriyi ve ürünü ilgilendiren yazılım projelerini dahil eder.

2. Adım: Jira Verisinden Ürün Bültenine Deterministik Eşleme

Bir yapay zeka modelinin hangi işin hangi departmana ait olduğunu tahmin etmesine asla izin verilmemelidir. Gruplama kuralları sabittir:

Proje Anahtarı → Ürün Alanı: WEB -> "Web Uygulaması", API -> "Platform ve API Servisleri".
Issue Type → Kategori: Bug -> "Hata Düzeltmeleri", Story -> "Yeni Yetenekler", Task -> "Altyapı İyileştirmeleri".
Epic ve Etiketler → Alt Başlıklar: Epic'ler işin bağlamını sağlarken, security veya performance etiketleri kritik iyileştirmelerin öne çıkmasını sağlar.

3. Adım: Webhook ve Otomasyon Akışı

Jira REST API ve webhook mimarisi birlikte çalışır:

Geçmiş İçe Aktarım (Backfill): Entegrasyon bağlandığında son 30 günün tamamlanan işleri taranır ve ilk bülten hemen hazır hale gelir.
Canlı Webhook'lar: Jira jira:issue_updated bildirimini gönderir. Sistem statusCategory = Done geçişini yakalayarak veritabanına idempotent şekilde kaydeder.

Cuma günü geldiğinde tüm tamamlanan işler ürün bazında düzenlenmiş haldedir; ekibin tek yapması gereken onaylayıp paylaşmaktır.