📄 Report Generator

Executive rapor ve dokümantasyon rehberi.

📋 Report Türleri

🔧 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

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ı