📄 Report Generator
Executive rapor ve dokümantasyon rehberi.
📋 Report Türleri
| Tür | Hedef Kitle | Uzunluk |
|---|---|---|
| Executive Summary | C-level | 1-2 sayfa |
| Technical Report | Engineers | 5-10 sayfa |
| Project Status | Stakeholders | 1-3 sayfa |
| Analysis Report | Decision makers | 3-5 sayfa |
🔧 Executive Report Template
# [Report Title]
**Date:** [Date]
**Author:** [Name]
**Status:** Draft | Final
---
## Executive Summary
[2-3 paragraf - key points only]
## Background
[Neden bu rapor yazıldı]
## Key Findings
1. **Finding 1**: [Özet]
2. **Finding 2**: [Özet]
3. **Finding 3**: [Özet]
## Recommendations
| # | Recommendation | Priority | Timeline |
|---|----------------|----------|----------|
| 1 | [Action] | High | Q1 |
| 2 | [Action] | Medium | Q2 |
## Next Steps
1. [Step 1]
2. [Step 2]
## Appendix
[Detaylı data, charts]
📊 Visual Elements
Data Presentation
Use charts for:
- Trends → Line chart
- Comparisons → Bar chart
- Parts of whole → Pie chart
- Relationships → Scatter plot
Status Indicators
- 🟢 On track / Positive
- 🟡 At risk / Neutral
- 🔴 Off track / Negative
🎯 Writing Tips
| Do | Don't |
|---|---|
| Lead with insights | Bury key points |
| Use bullet points | Write long paragraphs |
| Include visuals | Text-only walls |
| Action-oriented | Passive voice |
| Specific numbers | Vague statements |
Report Generator v1.1 - Enhanced
🔄 Workflow
Kaynak: Pandas Reporting & WeasyPrint Docs
Aşama 1: Data Preparation (Automated)
- Validation: Gelen veriyi (CSV/JSON/SQL) Pydantic veya Pandera ile şema kontrolünden geçir.
- Aggregation: Detay veriyi (Raw Data) özetle (Pivot Table, GroupBy). Asla milyon satırı rapora basma.
- Anonymization: Hassas verileri (PII) maskele veya hashle.
Aşama 2: Generation Architecture
- Template Engine: Jinja2 (Python) veya Handlebars (JS) kullanarak logik ile sunumu ayır.
- Format Agnostic: İçeriği Markdown veya HTML olarak üret, sonra PDF/Excel'e çevir (Single Source).
- Styling: CSS (Print CSS) kullanarak sayfa yapısını (@page), header/footer'ı yönet.
Aşama 3: Delivery & Feedback
- Compression: Çıktı dosyalarını (PDF/HTML) sıkıştır.
- Distribution: Raporu otomatik e-posta, Slack veya S3 bucket'a gönder.
- Actionable: Raporun başına "Executive Summary" ve "Action Items" ekle.
Kontrol Noktaları
| Aşama | Doğrulama |
|---|---|
| 1 | Rapor oluşturma süresi kabul edilebilir mi? (Async Job kullanılıyor mu?). |
| 2 | Mobil cihazlarda okunabilir mi? (HTML raporlar için Responsive Design). |
| 3 | Veriler güncel mi? (Rapor tarihi ve Veri çekim zamanı raporda yazıyor mu?). |