Briefdesign v2

1. 1

   Verfügbarkeit für kontrollierte Tests

   Letter Designer v2 ist für kontrollierte Tests code-complete. Die v2-Werkzeuge sind nur sichtbar, wenn LETTER_DESIGN_V2_ENABLED=true in einer isolierten Stage- oder privaten Umgebung gesetzt ist. Fehlt letter_design_list_presets, ist der v2-Rollout aus und letter_design_save sowie letter_design_preview veröffentlichen weiter nur schemaVersion 1. Diese Freigabe erlaubt keinen produktionsweiten Go-live.

2. 2

   Immer mit einer Vorlage beginnen

   Rufe zuerst letter_design_list_presets ohne presetId für die günstige Liste auf. Sichtbar und anwendbar sind ausschließlich vom Owner freigegebene Kandidaten. Bis die aktuelle Owner-Kuratierung abgeschlossen ist, ist die Liste deshalb absichtlich leer. Danach liefert presetId das vollständige native v2-JSON und eine echte Inline-Vorschau. Der Apply-Flow kopiert das Design atomar und legt bei Bedarf ein Brand Kit an.

   letter_design_list_presets
   {
     "presetId": "minimal-rule",
     "resolution": "thumb",
     "pages": 1
   }

3. 3

   Native v2-Quelle speichern

   letter_design_save erwartet name, das komplette design und bei Anlage oder geänderter Marke brandingOwnershipConfirmed=true. Ein natives Design hat schemaVersion 2, zones und body; jede Zone trägt reservedBox und geordnete Elemente. Mit designId aktualisierst du ein Arbeitsdesign. Marken- und Designänderung werden atomar gespeichert und auditierbar attestiert. Kompatibilitätsdaten aus einer v1-Migration sind als Eingabe nicht erlaubt.

   letter_design_save
   {
     "name": "Kanzlei Briefpapier v2",
     "design": "<vollstaendiges preset.design kopieren und nur unterstuetzte v2-Felder anpassen>",
     "brandingOwnershipConfirmed": true,
     "reasoning": "Minimalen Ausgangspunkt an vorhandenes Briefpapier angepasst."
   }

4. 4

   Ansehen, korrigieren, wiederholen

   letter_design_preview nimmt genau eine Quelle an, designId oder ein ungespeichertes design. Die Vorschau nutzt echte Partner-Absenderdaten, einen klar fiktiven Empfänger und denselben Composer wie der Versand. Die Antwort enthält ein Inline-PNG, signierte pngUrl und pdfUrl, designIdentity, designRender, geometryManifest mit boxes, violations, warnings und bodyCapacity. Die Links gelten 15 Minuten. Seite 2 wird nur bei continuationHeader und pages=2 geliefert. Vorschau und Speichern belasten das Wallet nicht. Wiederholungen nutzen einen Vollartefakt-Cache, unterschiedliche Misses sind begrenzt. Cache und Rate-Cap sind aktuell prozess-lokal und nur für die kontrollierte Test-Lane geeignet.

   letter_design_preview
   {
     "designId": "<designId aus letter_design_save>",
     "reference": {
       "vorgangsnummer": "2026-0042"
     },
     "resolution": "thumb",
     "pages": 1
   }

5. 5

   Im Dashboard zur Prüfung übergeben

   Öffne nach der letzten Vorschau /dashboard/designs/<designId>. Der native v2-Editor zeigt die annotierten PNG-Seiten und das vollständige PDF zuerst. Danach kann ein Admin Farben, Schrift, Logo, Texte, Größe und 0,5-/5-mm-Nudges ändern. Speichern bleibt gesperrt, bis genau der aktuelle Design-und-Brand-Kit-Fingerprint erfolgreich gerendert und geladen wurde.

6. 6

   Das geprüfte Arbeitsdesign verwenden

   Übergib designId und die benötigten reference-Werte an order_send, order_send_batch oder letter_draft. Fehlende Pflichtwerte und Postzonen-Konflikte stoppen vor jeder Belastung. Bei der ersten dauerhaften Nutzung wird eine unveränderliche Version inklusive Brand Kit und Assets gemünzt und per design_version_id gepinnt. Bis SQL, Deploy und Human-Gates abgeschlossen sind, bleibt v2 in der kontrollierten Testumgebung.

   order_send
   {
     "clientOrderId": "einspruch-schmidt-2026-08-02",
     "subject": "Einspruch gegen Steuerbescheid",
     "content": "Sehr geehrte Damen und Herren, ...",
     "recipientCompany": "Finanzamt Muenchen-Land",
     "recipientStreet": "Postfach 12 52",
     "recipientZip": "80292",
     "recipientCity": "Muenchen",
     "recipientCountry": "DE",
     "designId": "<gepruefte designId>",
     "reference": {
       "vorgangsnummer": "2026-0042"
     }
   }

Tool-Referenz ansehen →Fehlerkatalog ansehen →