PDF-Reports¶

Vorschau-Funktion

PDF-Reports sind standardmäßig ausgeschaltet — Menüpunkt, Seite und API sind gesperrt, bis ein Super-Admin den Bereich unter Admin → System → Vorschau-Funktionen freischaltet. Der Bereich ist noch nicht stabil.

Statusberichte als PDF — automatisch generiert und per E-Mail versandt, oder manuell auf Abruf.

PDF-Reports sind Teil der lizenzpflichtigen Reports-Funktion (/reports → Reiter PDF, neben dem SLA-Reports-Reiter).

Report-Typen¶

Drei eingebaute Templates:

Typ	Inhalt
`executive`	Management-taugliche Kurzfassung: aktuelle Lage, Trend
`technical`	Detailreicher, inkl. Performance-Daten
`sla`	Verfügbarkeit pro Service, Vorfälle, Downtimes

Es gibt aktuell keinen eigenen Audit-Report-Typ und keine Möglichkeit, eigene HTML-Templates hochzuladen — die drei Typen sind fest im Produkt hinterlegt.

Geplante Reports¶

/reports → PDF → Neu:

Feld	Bedeutung
Name	„Acme SLA April"
Report-Typ	`executive` / `technical` / `sla`
Scope	Hosts und/oder Tags
Cron-Ausdruck	Standard-Cron-Syntax
Zeitzone	vorbelegt mit der Zeitzone der Instanz (Admin → Benachrichtigungen → E-Mail & Meldungen), sonst UTC
Empfänger	To/CC/BCC-Listen
Deckblatt-Text	optionaler Einleitungstext
Branding	Logo, Firmenname, Primärfarbe, Footer-Text
Aktiv	Schedule ein-/ausschalten

Beispiel:

name: "Acme Monthly SLA"
report_type: sla
cron_expression: "0 6 1 * *"   # erster Tag im Monat um 06:00
scope:
  tags: ["kunde-acme"]
recipients:
  to: ["acme-ops@example.com"]
  cc: ["acme-management@example.com"]
timezone: "Europe/Rome"

Manuelle Generierung¶

/reports → PDF → Vorschau oder Generieren: gleiche Parameter, sofortige Ausführung. Das PDF wird zum Download bereitgestellt und optional per Mail verschickt.

Render-Pipeline¶

flowchart LR
    SCHED[Scheduler] --> DATA[Daten holen]
    DATA --> HTML[HTML rendern — Jinja2]
    HTML --> PDF[PDF via WeasyPrint]
    PDF --> STORE[Ablage]
    PDF --> MAIL[E-Mail mit Anhang]

WeasyPrint braucht keine Headless-Browser-Engine — reine Python-Lib auf Pango/Cairo.

Logo-Upload¶

Eigenes Logo je Report-Schedule hochladbar (PNG/JPG/SVG, max. 2 MB).

Speicherort¶

Generierte PDFs landen im Reports-Datenverzeichnis des Containers und werden 90 Tage aufbewahrt, danach automatisch bereinigt. Über /reports durchsuch- und herunterladbar.

Mail-Versand¶

PDF als Anhang, Body als kurze HTML-Zusammenfassung mit Firmenname/Farbe aus dem Branding. Fehlgeschlagene Zustellungen lassen sich einzeln erneut versenden oder wiederholen (/reports → Verlauf).

Permission¶

Permission	Wirkung
`reports.view`	Reports einsehen, erstellen, planen, generieren, Vorschau, Logo hochladen, erneut versenden
`reports.delete`	einen Zeitplan löschen

Es gibt keine separate Permission für „nur planen" oder „Custom-Templates hochladen" — beides existiert entweder nicht (Custom-Templates) oder ist bereits mit reports.view abgedeckt.

Anschluss¶

SLA-Reports — Zahlen für den sla-Report-Typ
Audit-Log — eigener Bereich, nicht Teil der PDF-Reports