Files
skrift-programme/Docker/directus/bootstrap
Lucas Orth 57d48409e6 Kontakt-CRM, Chargen-Sammeldruck, API-Status & Auto-Generierung
Kontakte/CRM (Directus):
- Neue Collections `contacts` (Leads) + `contact_actions` (Rückruf/Angebot/Mail).
- Hook `skrift-contacts`: Kontakte werden nur auf Anforderung angelegt
  (Auftrag "In Kontakte speichern"); Rückruf-Erinnerung (Zeitplan) und
  Angebots-/Mail-an-mich-Mails; Auto-Löschung nur bei Lead-Status
  "kein_interesse" nach 30 Tagen; optionaler DSGVO-Strip (per Env, Dry-Run).
- Modul `skrift-kontakte`: handytaugliches Board (Anruf via groundwire:,
  Notizen mit Autosave, Durchblättern, CSV-Export, Aktionen als Buttons).

API-Chargen & PDF-Sammeldruck:
- Produktions-Board gruppiert API-Aufträge unter "Neu" zu Chargen
  (Kunde + Typ + Versandtag + Eingangstag), aufklappbar, mit "fällig bis"
  (Versandtag der übernächsten Woche).
- Mehrfachauswahl -> Sammel-PDF (Backend `pdf-lib`, /api/charge/merge-pdf,
  Directus-Proxy /skrift-orders/charge/pdf), Kuverts an Plotter und
  Sammel-Status; PDF- und Kuvert-Reihenfolge nach Auftragsnummer (Kollation).
- Mailer: keine Einzelmail je API-Auftrag mehr, stattdessen Tagesübersicht
  (18:00) pro Kunde, nach Versandtag aufgeschlüsselt.

Status-API & Generierung:
- Public-API-Status liest jetzt production_status (Board) statt nur
  kaufmännischem Status; neues Feld `status_since` in der Antwort.
- Auftrag stempelt `production_status_changed_at` bei jedem Statuswechsel.
- Generierung wird IMMER beim Eingang angestoßen (auch Datei-Produkte mit
  handgeschriebenem Kuvert), nicht nur bei letter/postcard.
- Versandtag im Produktionsdashboard sichtbar.

Rechte: Service-Rolle darf directus_files lesen (Backend lädt PDFs für den
Sammeldruck über /assets).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-08-21 08:53:08 +02:00
..

Directus Bootstrap

Legt das Skrift-Datenmodell (Collections, Beziehungen, Rollen/Rechte, Seed) idempotent in einer laufenden Directus-Instanz an. Mehrfach ausführbar – Vorhandenes wird übersprungen.

Voraussetzungen

  • Directus läuft (siehe ../docker-compose.yml) und ist erreichbar.
  • Node ≥ 18 (kein npm install nötig – nutzt nur Bordmittel).
  • Ein Admin-Zugang: entweder ein statischer Admin-Token oder Admin-E-Mail/Passwort.

Ausführen

Mit Token (empfohlen – Token im Directus-Admin unter dem Admin-Nutzer erzeugen):

DIRECTUS_URL=https://admin.skrift.de \
DIRECTUS_TOKEN=<admin-static-token> \
node bootstrap.mjs

Alternativ mit Login:

DIRECTUS_URL=https://admin.skrift.de \
ADMIN_EMAIL=admin@skrift.de \
ADMIN_PASSWORD=... \
node bootstrap.mjs

Nur Schema + Seed, ohne Rollen/Rechte (zum stufenweisen Testen):

SKIP_PERMISSIONS=1 DIRECTUS_URL=... DIRECTUS_TOKEN=... node bootstrap.mjs

Was es anlegt

  • Collections: customers, products, formats, motifs, price_items, pricing_settings, vouchers, voucher_redemptions, orders, order_entries, order_addons, jobs, status_history.
  • Rollen/Policies: Staff (volle Verwaltung), Customer (nur Eigenes + Katalog lesen), Public (aktive Kataloge lesen), Service (Backend/Produktion: lesen + Status schreiben).
  • Seed: Produkte (inkl. Kontakt-Produkte), Formate, price_items mit den Konfigurator-Preisen, pricing_settings inkl. Zeichen-Whitelist (1:1 aus job-manager).

Nach dem Lauf – manuell

  • Service-Token: Nutzer in Rolle Service anlegen, statischen Token erzeugen und in die .env von skrift-backend und skrift-produktion eintragen.
  • Preise prüfen: price_items mit Preis 0 (Schreib-/Gestaltungsservice, Motiv-Upload) und die Produkt-Basispreise im Admin auf die echten Werte setzen.
  • Preisformel: pricing_settings.formula ist ein Platzhalter – hier die reale Formel hinterlegen.

Hinweis: Das Skript zielt auf Directus 11 (Policy-Rechtemodell) und wurde nicht gegen eine Live-Instanz getestet. Falls beim Lauf ein Schritt fehlschlägt, die Konsolenausgabe schicken – dann wird die betroffene Stelle gezielt korrigiert.