Files
skrift-programme/Docker/directus/bootstrap
Lucas Orth 1d5c1a14d4 Public-API, mehrseitige Schriftstücke, manuelle Aufträge & Mailer
Public-API (neu, directus-extension-skrift-api):
- Versionierter /v1-Namespace: POST /v1/orders, GET /v1/orders/:nr (Status
  pending/processing/shipped/cancelled), POST /v1/files (nur PDF, ≤80 MB).
- Auth über X-Api-Key (Authorization ist von Directus reserviert), SHA-256-Hash.
- Produkt-gebunden; Kuvert-only-Produkttyp; Kuvertformat automatisch (A4→DIN Lang, sonst C6);
  kein Platzhalter, kein Kunden-multipage/font_scale; Versandart englisch (single/bulk).
- Selbst gehostete Swagger-UI-Doku (/docs) + OpenAPI (/v1/openapi.json), englisch/technisch.
- Key-Hook (directus-extension-skrift-apikey): erzeugt Key automatisch, zeigt ihn
  einmalig in key_plain.

Mehrseitige Schriftstücke:
- generateLetterPages (Auto-Fluss, [[seitenumbruch]], Leerseiten-Filter).
- Preview/Order-Generierung schreiben letter_NNN_pM.svg; Seiten-Übersicht im Neuauftrag.
- Agent (skrift-agent): Seiten je Brief absteigend an den Plotter (Stapel-Reihenfolge).
- countLetterPages + /api/order/pagecount für die Seiten-Vorschau.

Manuelle Aufträge:
- Schriftgröße (Brief/Kuvert), Signatur auf dem Brief mit X/Y/Größe-Feinjustierung,
  realistische Handschrift bis in den finalen Druck durchgereicht.
- Spalten-Einfügen in der Empfängertabelle (Excel-Spalte je Zelle).

Mailer: Text-Alternative + Reply-To (Zustellbarkeit).

App: Freitext in Musteranfrage, Konfigurator-Reset, Lightbox-Seitenverhältnis +
Bild-Download, Sticky-Vorschau-Fix, Tab-Eingabe + Rechtsbündigkeit, Leerzeilen-Trim.

Bootstrap: neue Felder (font_scale_*, signatures_manual, multi_page, page_count,
realistic, shipping_day, api_client) + Collections api_clients, Produkttyp envelope.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-08-18 10:01:53 +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.