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>
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 installnö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_itemsmit den Konfigurator-Preisen,pricing_settingsinkl. Zeichen-Whitelist (1:1 aus job-manager).
Nach dem Lauf – manuell
- Service-Token: Nutzer in Rolle Service anlegen, statischen Token erzeugen und in
die
.envvon skrift-backend und skrift-produktion eintragen. - Preise prüfen:
price_itemsmit Preis0(Schreib-/Gestaltungsservice, Motiv-Upload) und die Produkt-Basispreise im Admin auf die echten Werte setzen. - Preisformel:
pricing_settings.formulaist 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.