""" PDF Service - Zentrale PDF-Generierung für BreakPilot. Shared Service für: - Letters (Elternbriefe) - Zeugnisse (Schulzeugnisse) - Correction (Korrektur-Übersichten) Verwendet WeasyPrint für PDF-Rendering und Jinja2 für Templates. Split structure: - pdf_models.py: Data classes (SchoolInfo, LetterData, CertificateData, etc.) - pdf_templates.py: Inline HTML templates (letter, certificate, correction) - pdf_service.py: Core PDFService class + convenience functions (this file) """ import logging from datetime import datetime from pathlib import Path from typing import Any, Dict, Optional from jinja2 import Environment, FileSystemLoader, select_autoescape from weasyprint import HTML, CSS from weasyprint.text.fonts import FontConfiguration from .pdf_models import ( SchoolInfo, LetterData, CertificateData, StudentInfo, CorrectionData, ) from .pdf_templates import ( get_letter_template_html, get_certificate_template_html, get_correction_template_html, ) logger = logging.getLogger(__name__) # Template directory TEMPLATES_DIR = Path(__file__).parent.parent / "templates" / "pdf" class PDFService: """ Zentrale PDF-Generierung für BreakPilot. Unterstützt: - Elternbriefe mit GFK-Prinzipien und rechtlichen Referenzen - Schulzeugnisse (Halbjahr, Jahres, Abschluss) - Korrektur-Übersichten für Klausuren """ def __init__(self, templates_dir: Optional[Path] = None): self.templates_dir = templates_dir or TEMPLATES_DIR self.templates_dir.mkdir(parents=True, exist_ok=True) self.jinja_env = Environment( loader=FileSystemLoader(str(self.templates_dir)), autoescape=select_autoescape(['html', 'xml']), trim_blocks=True, lstrip_blocks=True ) self.jinja_env.filters['date_format'] = self._date_format self.jinja_env.filters['grade_color'] = self._grade_color self.font_config = FontConfiguration() logger.info(f"PDFService initialized with templates from {self.templates_dir}") @staticmethod def _date_format(value: str, format_str: str = "%d.%m.%Y") -> str: """Formatiert Datum für deutsche Darstellung.""" if not value: return "" try: dt = datetime.fromisoformat(value.replace("Z", "+00:00")) return dt.strftime(format_str) except (ValueError, AttributeError): return value @staticmethod def _grade_color(grade: str) -> str: """Gibt Farbe basierend auf Note zurück.""" grade_colors = { "1": "#27ae60", "2": "#2ecc71", "3": "#f1c40f", "4": "#e67e22", "5": "#e74c3c", "6": "#c0392b", "A": "#27ae60", "B": "#2ecc71", "C": "#f1c40f", "D": "#e74c3c", } return grade_colors.get(str(grade), "#333333") def _get_base_css(self) -> str: """Gibt Basis-CSS für alle PDFs zurück.""" return """ @page { size: A4; margin: 2cm 2.5cm; @top-right { content: counter(page) " / " counter(pages); font-size: 9pt; color: #666; } } body { font-family: 'DejaVu Sans', 'Liberation Sans', Arial, sans-serif; font-size: 11pt; line-height: 1.5; color: #333; } h1, h2, h3 { font-weight: bold; margin-top: 1em; margin-bottom: 0.5em; } h1 { font-size: 16pt; } h2 { font-size: 14pt; } h3 { font-size: 12pt; } .header { border-bottom: 2px solid #2c3e50; padding-bottom: 15px; margin-bottom: 20px; } .school-name { font-size: 18pt; font-weight: bold; color: #2c3e50; } .school-info { font-size: 9pt; color: #666; } .letter-date { text-align: right; margin-bottom: 20px; } .recipient { margin-bottom: 30px; } .subject { font-weight: bold; margin-bottom: 20px; } .content { text-align: justify; margin-bottom: 30px; } .signature { margin-top: 40px; } .legal-references { font-size: 9pt; color: #666; border-top: 1px solid #ddd; margin-top: 30px; padding-top: 10px; } .gfk-badge { display: inline-block; background: #e8f5e9; color: #27ae60; font-size: 8pt; padding: 2px 8px; border-radius: 10px; margin-right: 5px; } .certificate-header { text-align: center; margin-bottom: 30px; } .certificate-title { font-size: 20pt; font-weight: bold; margin-bottom: 10px; } .student-info { margin-bottom: 20px; padding: 15px; background: #f9f9f9; border-radius: 5px; } .grades-table { width: 100%; border-collapse: collapse; margin-bottom: 20px; } .grades-table th, .grades-table td { border: 1px solid #ddd; padding: 8px 12px; text-align: left; } .grades-table th { background: #2c3e50; color: white; } .grades-table tr:nth-child(even) { background: #f9f9f9; } .grade-cell { text-align: center; font-weight: bold; font-size: 12pt; } .attendance-box { background: #fff3cd; padding: 15px; border-radius: 5px; margin-bottom: 20px; } .signatures-row { display: flex; justify-content: space-between; margin-top: 50px; } .signature-block { text-align: center; width: 40%; } .signature-line { border-top: 1px solid #333; margin-top: 40px; padding-top: 5px; } .exam-header { background: #2c3e50; color: white; padding: 15px; margin-bottom: 20px; } .result-box { background: #e8f5e9; padding: 20px; text-align: center; margin-bottom: 20px; border-radius: 5px; } .result-grade { font-size: 36pt; font-weight: bold; } .result-points { font-size: 14pt; color: #666; } .corrections-list { margin-bottom: 20px; } .correction-item { border: 1px solid #ddd; padding: 15px; margin-bottom: 10px; border-radius: 5px; } .correction-question { font-weight: bold; margin-bottom: 5px; } .correction-feedback { background: #fff8e1; padding: 10px; margin-top: 10px; border-left: 3px solid #ffc107; font-size: 10pt; } .stats-table { width: 100%; margin-top: 20px; } .stats-table td { padding: 5px 10px; } """ def generate_letter_pdf(self, data: LetterData) -> bytes: """Generiert PDF für Elternbrief.""" logger.info(f"Generating letter PDF for student: {data.student_name}") template = self._get_letter_template() html_content = template.render(data=data, generated_at=datetime.now().strftime("%d.%m.%Y %H:%M")) css = CSS(string=self._get_base_css(), font_config=self.font_config) pdf_bytes = HTML(string=html_content).write_pdf(stylesheets=[css], font_config=self.font_config) logger.info(f"Letter PDF generated: {len(pdf_bytes)} bytes") return pdf_bytes def generate_certificate_pdf(self, data: CertificateData) -> bytes: """Generiert PDF für Schulzeugnis.""" logger.info(f"Generating certificate PDF for: {data.student_name}") template = self._get_certificate_template() html_content = template.render(data=data, generated_at=datetime.now().strftime("%d.%m.%Y %H:%M")) css = CSS(string=self._get_base_css(), font_config=self.font_config) pdf_bytes = HTML(string=html_content).write_pdf(stylesheets=[css], font_config=self.font_config) logger.info(f"Certificate PDF generated: {len(pdf_bytes)} bytes") return pdf_bytes def generate_correction_pdf(self, data: CorrectionData) -> bytes: """Generiert PDF für Korrektur-Übersicht.""" logger.info(f"Generating correction PDF for: {data.student.name}") template = self._get_correction_template() html_content = template.render(data=data, generated_at=datetime.now().strftime("%d.%m.%Y %H:%M")) css = CSS(string=self._get_base_css(), font_config=self.font_config) pdf_bytes = HTML(string=html_content).write_pdf(stylesheets=[css], font_config=self.font_config) logger.info(f"Correction PDF generated: {len(pdf_bytes)} bytes") return pdf_bytes def _get_letter_template(self): """Gibt Letter-Template zurück (inline falls Datei nicht existiert).""" template_path = self.templates_dir / "letter.html" if template_path.exists(): return self.jinja_env.get_template("letter.html") return self.jinja_env.from_string(get_letter_template_html()) def _get_certificate_template(self): """Gibt Certificate-Template zurück.""" template_path = self.templates_dir / "certificate.html" if template_path.exists(): return self.jinja_env.get_template("certificate.html") return self.jinja_env.from_string(get_certificate_template_html()) def _get_correction_template(self): """Gibt Correction-Template zurück.""" template_path = self.templates_dir / "correction.html" if template_path.exists(): return self.jinja_env.get_template("correction.html") return self.jinja_env.from_string(get_correction_template_html()) # ============================================================================= # Convenience functions for direct usage # ============================================================================= _pdf_service: Optional[PDFService] = None def get_pdf_service() -> PDFService: """Gibt Singleton-Instanz des PDF-Service zurück.""" global _pdf_service if _pdf_service is None: _pdf_service = PDFService() return _pdf_service def generate_letter_pdf(data: Dict[str, Any]) -> bytes: """Convenience function zum Generieren eines Elternbrief-PDFs.""" service = get_pdf_service() school_info = None if data.get("school_info"): school_info = SchoolInfo(**data["school_info"]) letter_data = LetterData( recipient_name=data.get("recipient_name", ""), recipient_address=data.get("recipient_address", ""), student_name=data.get("student_name", ""), student_class=data.get("student_class", ""), subject=data.get("subject", ""), content=data.get("content", ""), date=data.get("date", datetime.now().strftime("%d.%m.%Y")), teacher_name=data.get("teacher_name", ""), teacher_title=data.get("teacher_title"), school_info=school_info, letter_type=data.get("letter_type", "general"), tone=data.get("tone", "professional"), legal_references=data.get("legal_references"), gfk_principles_applied=data.get("gfk_principles_applied") ) return service.generate_letter_pdf(letter_data) def generate_certificate_pdf(data: Dict[str, Any]) -> bytes: """Convenience function zum Generieren eines Zeugnis-PDFs.""" service = get_pdf_service() school_info = None if data.get("school_info"): school_info = SchoolInfo(**data["school_info"]) cert_data = CertificateData( student_name=data.get("student_name", ""), student_birthdate=data.get("student_birthdate", ""), student_class=data.get("student_class", ""), school_year=data.get("school_year", ""), certificate_type=data.get("certificate_type", "halbjahr"), subjects=data.get("subjects", []), attendance=data.get("attendance", {"days_absent": 0, "days_excused": 0, "days_unexcused": 0}), remarks=data.get("remarks"), class_teacher=data.get("class_teacher", ""), principal=data.get("principal", ""), school_info=school_info, issue_date=data.get("issue_date", datetime.now().strftime("%d.%m.%Y")), social_behavior=data.get("social_behavior"), work_behavior=data.get("work_behavior") ) return service.generate_certificate_pdf(cert_data) def generate_correction_pdf(data: Dict[str, Any]) -> bytes: """Convenience function zum Generieren eines Korrektur-PDFs.""" service = get_pdf_service() student = StudentInfo( student_id=data.get("student_id", "unknown"), name=data.get("student_name", data.get("name", "")), class_name=data.get("student_class", data.get("class_name", "")) ) max_points = data.get("max_points", data.get("total_points", 0)) achieved_points = data.get("achieved_points", 0) percentage = data.get("percentage", (achieved_points / max_points * 100) if max_points > 0 else 0.0) correction_data = CorrectionData( student=student, exam_title=data.get("exam_title", ""), subject=data.get("subject", ""), date=data.get("date", data.get("exam_date", "")), max_points=max_points, achieved_points=achieved_points, grade=data.get("grade", ""), percentage=percentage, corrections=data.get("corrections", []), teacher_notes=data.get("teacher_notes", data.get("teacher_comment", "")), ai_feedback=data.get("ai_feedback", ""), grade_distribution=data.get("grade_distribution"), class_average=data.get("class_average") ) return service.generate_correction_pdf(correction_data)