monthly-report-kit/QUICKSTART.md

Schnellstart in 10 Schritten

1. Ordner auf deinen Docker-Host kopieren.
2. .env.example nach .env kopieren.
3. docker compose up -d --build starten.
4. http://HOST:8080/health pruefen.
5. examples/sample-report.json anpassen.
6. Mit /preview/html zuerst das HTML kontrollieren.
7. Mit /render das PDF erzeugen.
8. n8n/workflow-template.json in n8n importieren.
9. Anthropic-API-Key in n8n als Credential oder Secret hinterlegen.
10. Beispiel-Set-Node durch deine PostgreSQL-Abfragen ersetzen.

Minimaler Render-Aufruf

curl -sS \
  -X POST http://localhost:8080/render \
  -H 'Content-Type: application/json' \
  --data-binary @examples/sample-report.json \
  -o output/report.pdf

Dienste

• Report Renderer: http://localhost:8080
• Gotenberg: standardmaessig nur im internen Docker-Netz erreichbar

API-Routen

• GET /health
• GET /themes
• POST /validate
• POST /preview/html
• POST /render

Designs ansehen

Alle IDs abfragen:

curl -s http://localhost:8080/themes | python3 -m json.tool

Im Beispiel-Payload design.theme ändern oder alle Designs rendern:

bash examples/render-all-themes.sh

Der mitgelieferte visuelle Katalog liegt unter output/theme-catalog/theme-gallery.pdf.