first commit

2026-06-24 14:31:42 +00:00
parent 77f946a553
commit 22b05a7a1b
10 changed files with 456 additions and 0 deletions
@@ -0,0 +1,52 @@
+# 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
+
+```bash
+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:
+
+```bash
+curl -s http://localhost:8080/themes | python3 -m json.tool
+```
+
+Im Beispiel-Payload `design.theme` ändern oder alle Designs rendern:
+
+```bash
+bash examples/render-all-themes.sh
+```
+
+Der mitgelieferte visuelle Katalog liegt unter `output/theme-catalog/theme-gallery.pdf`.