Reports

Genel Bakış

Reports, uygulama genelindeki analiz, issue, görev, değişiklik ve kanıt verisinden standart rapor paketleri (JSON manifest + HTML + PDF) üreten dışa aktarma ve denetim (audit) merkezidir. Her rapor, o anki analiz/issue/görev/değişiklik verisinden anlık olarak derlenir ve indirilebilir bir paket kimliğiyle (package_id) kayıt altına alınır.

Temel Kavramlar

• Rapor Kataloğu — 5 hazır rapor şablonu: BOM Reconciliation Report (EBOM/MBOM/ERP farkları, revizyon, maliyet, önerilen aksiyonlar), Visual Evidence Report (viewer snapshot + issue + aksiyon + kanıt paketi), Localization/Yerlilik Report (ağırlıklı yerlilik oranı, ithal kritik parça, alternatif kaynak), PLM Readiness Report (Windchill/Teamcenter/ENOVIA/Codebeamer karşılaştırması ve gap listesi), Spec2Action Kickoff Pack (gereksinim adayları, belirsizlikler, departman görevleri).
• Rapor Paketi (Package) — bir raporun tek seferlik üretimi; RPT-{RAPOR_ID}-{sıra_no} biçiminde bir paket kimliği, özet (issue/kritik/görev/kanıt/değişiklik sayısı) ve son 20 audit kaydını içerir.
• Export Manifest — bir paketin JSON/HTML/PDF çıktı dosyalarının yollarını tutan kayıt; her rapor üretimi bu üç dosyayı sunucuda oluşturur.
• Audit Trail — her rapor üretimi, kimin/hangi rolle/hangi paketi oluşturduğu bilgisiyle denetim günlüğüne düşer (audit:export izni gerektirir).

Tipik Kullanım Akışı

1. Sol menüden Reports'u açın; katalogdaki 5 rapor şablonundan birini seçin.
2. Rapor Oluştur'a tıklayın — sistem o anki son analiz, açık issue'lar, görevler ve değişiklik taleplerinden raporu anlık derler.
3. Oluşan paketi özet KPI'larıyla (issue/kritik/görev/kanıt/değişiklik sayısı) inceleyin.
4. JSON manifest, HTML raporu veya PDF raporu olarak indirin.
5. Gerekirse aynı rapor şablonunu farklı bir analiz çalıştırmasından sonra tekrar üretip önceki paketle karşılaştırın (her üretim yeni bir paket kimliği alır, geçmiş paketler silinmez).

Özellik Referansı

• Rapor kataloğu listesi ve daha önce üretilmiş paketlerin listesi (/api/reports/catalog)
• Rapor paketi üretimi (/api/reports/{report_id}/generate) — anlık analiz/issue/görev/değişiklik verisinden derleme
• Her rapor şablonu için özel bölüm içeriği (örn. Localization raporunda yerlilik KPI'ları ve alternatif kaynak önerileri; Visual Evidence raporunda snapshot listesi)
• JSON manifest + HTML rapor + minimal PDF rapor otomatik dosya üretimi
• Özet istatistikler: issue/kritik issue/görev/kanıt snapshot/değişiklik talebi sayısı
• Son 20 audit kaydının rapora gömülmesi
• Yetkilendirme: rapor üretimi audit:export izni gerektirir ve audit log'a düşer

Kısıtlar / Bilinen Sınırlar

• XLSX çıktısı bir placeholder'dır: rapor paketinin indirilebilir dosya listesinde yer alır ancak sunucu tarafında gerçek bir Excel dosyası oluşturulmaz — yalnızca JSON, HTML ve PDF dosyaları gerçekten üretilir.
• PDF rapor "minimal" düzeydedir (başlık + açıklama içeren basit bir belge); gelişmiş tablo/grafik içeren kurumsal PDF şablonu üretim fazında ayrıca geliştirilmelidir.
• Raporlar demo/bellek içi (in-memory) analiz ve issue verisine dayanır; kalıcı bir veri ambarına (data warehouse) bağlı tarihsel/karşılaştırmalı raporlama henüz yoktur.