Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/R-P12b-delta-abweichungen.md
T

6.9 KiB
Raw Blame History

Abweichungen der Node-Config-Deskriptoren gegenüber den Subframe-K-Karten

Quelle: Flow "(MCP) HiveGrid Workflow Engine / Automationen P12", 30 K-Karten. 25 Deskriptoren gebaut (nur Registry-Node-Types). Jede Abweichung mit Quell-Karte:

Update 2026-07-19 (R-P12c): „K-A2 E-Mail senden" hat jetzt ein Registry-Pendant (email.send_transactional, Gruppe email) samt schema-getriebenem Deskriptor und erscheint im Picker. Die Feld-Copy (An/Betreff/Nachricht + Hilfe-Box) ist funktional gesetzt; der 1:1-Copy-Abgleich mit Davids K-A2-Karte steht als Design-Nachzug aus. „Termin in Kürze" und „Zahlungsziel überschritten" bleiben ohne Registry-Pendant.

Ausgelassene Karten (kein Registry-Pendant)

  • K-L1 Und — kein Node-Type logic.and in der Registry; komplett ausgelassen (inkl. vorgebauter Bedingungs-Selects, "Alle nötig"-Badge, AUSGÄNGE-Karte).
  • K-L1 Oder — kein Node-Type logic.or; ausgelassen (inkl. ODER-Divider, "Eine reicht"-Badge, Ausgänge-Dots).
  • K-L1 Switch — kein Node-Type logic.switch; ausgelassen (inkl. "Wege"-Builder mit Weg-1/2/3-Zeilen und Sonst-Fallback).
  • K-L1 Filter — kein Node-Type logic.filter; ausgelassen (inkl. Bedingungs-Karte und "endet hier leise"-Hinweis).
  • K-L2 Wert setzen — kein Node-Type logic.set_value; ausgelassen (Name-des-Werts/Wert-Inputs).
  • kwp.push_project (Registry, extension_slot) — hat keine eigene Design-Karte; bewusst kein Deskriptor, bekommt den generischen Fallback.

Ausgelassene Design-Elemente ohne Backend

  • K-T3 Webhook empfangen — die beiden generierten Read-only-Felder "Webhook-Adresse" und "Sicherheitsschlüssel" (mit FeatherCopy-Affordance) sind serverseitig erzeugte Werte, keine Config-Eingaben; Deskriptor hat daher fields: [], nur Hilfe-Box + Profi-Baustein-Badge.
  • K-T3 Formular abgeschickt — die Read-only-Sektion "Daten aus dem Formular" (Tag-Chips Name/E-Mail/Telefon/Nachricht + Caption) ist reine Anzeige ohne Config-Key; ausgelassen.
  • K-A1 Kontakt aendern — Platzhalter-Chip {{Mitarbeiter aus Auslöser}}, Caption der Feld-Zuordnungs-Karte und Ghost-Button "Zuordnung hinzufügen" ausgelassen (siehe Vereinfachung unten).
  • K-L1 Wenn-Dann — Ghost-Button "Bedingung hinzufügen" und die "Ausgänge"-Box (grüner/neutraler Dot mit "Ja →"/"Nein →") ausgelassen; die Ja/Nein-Verzweigung erklärt stattdessen der Hilfe-Box-Text.
  • K-I1 HTTP-Anfrage — der wiederholbare "Kopfzeilen (optional)"-Key/Value-Builder (Name/Wert-Zeilen + "Kopfzeile hinzufügen") ausgelassen; Deskriptor enthält nur URL, Methode und Daten (Body).

Vereinfachungen (Struktur reduziert, Semantik erhalten)

  • K-A1 Kontakt aendern — die 2 wiederholbaren "Feld-Zuordnungen"-Zeilen (Feld-Select + Neuer-Wert-Input, erweiterbar) sind auf eine feste Feld/Wert-Kombination reduziert: Select feld (Werte exakt: kontaktStatus, vorname, nachname, orgName, primaerEmail, primaerTelefon, language) + Text wert. Das "Welcher Kontakt"-Select der Karte bleibt erhalten.
  • K-L1 Wenn-Dann — der Bedingungs-Builder mit 2 Zeilen (je Feld | Vergleich | Wert) ist auf eine Bedingungszeile reduziert (Select feld, Select vergleich, Text wert). Der Zeilen-bezogene Hilfetext "Jede Zeile ist eine Bedingung. Alle Zeilen müssen zutreffen." entfällt dadurch; Hilfe-Box-Text auf Singular angepasst ("wenn die Bedingung zutrifft").
  • K-L2 Warten — der ToggleGroup-Modus-Umschalter ("Feste Dauer" vs. "Bis Zeitpunkt aus Feld") entfällt; nur der ausgestaltete Feste-Dauer-Zustand ist abgebildet als ein number-unit-Feld dauer/dauerEinheit (Einheiten von der Karte: Minuten/Stunden/Tage/Wochen). defaultValue "2" laut Vorgabe (Karte zeigt Demo-Wert "3").
  • K-T2 Deadline naht — die Karten-Zeile Vorlauf-TextInput (w-24) + Einheit-Select ist als ein number-unit-Feld leadTime/leadTimeUnit modelliert (defaultValue "3"); der Einheit-Hilfetext "So lange vor Ablauf der Frist startet die Automation." hat im number-unit-Typ keinen Platz und entfällt.

MultiSelectTags-Behandlung

  • K-T1 Neuer Kontakt - Mit Beispiel — MultiSelectTags "Nur mit bestimmtem Tag (optional)" (Tag-Filter) ist per Vorgabe durch ein einfaches Textfeld tagFilter ersetzt (Label/Placeholder/Hilfetext der Karte übernommen).
  • K-T1 Kontakt geaendert — MultiSelectTags "Nur diese Felder (optional)" ist kein Tag-Filter (Feld-Picker) und überlappt semantisch mit dem Select "Welche Felder beobachten"; ersatzlos ausgelassen, nur das Select bleibt (beobachteteFelder).
  • K-T2 Zeitplan — der Scheduler ist seit 2026-08-01 gebaut. Statt MultiSelectTags nutzt der Dialog einen einzelnen Wochentag bei wöchentlicher und einen Monatstag (1–31) bei monatlicher Wiederholung; beide Werte werden serverseitig validiert und vom Scheduler ausgewertet.

Styling-Normalisierungen

  • K-L1 Oder / Und / Switch / Wenn-Dann / Schleife / Wert setzen — die Logik-Karten nutzen Purple-Styling (subtle-purple-Badge, purple IconWithBackground-ClassNames, bei "Oder" sogar einen handgebauten Icon-Div statt IconWithBackground). Der Deskriptor-Kontrakt kennt kein Purple: Logik-Nodes sind auf badgeFarbe: subtle-neutral, iconVariant: neutral und helpBox.tone: neutral normalisiert; Icons einheitlich als IconWithBackground-kompatible Feather-Komponente.
  • K-A1 Kontakt aendern — Badge der Karte ist subtle-negative ("Aktion"); per Vorgabe auf das Action-Standard-Badge subtle-blue normalisiert, das destruktive Icon (iconVariant: destructive) und die negative Hilfe-Box der Karte bleiben erhalten.
  • K-A1 Notiz anlegen — Karte zeigt ebenfalls destruktives Icon + subtle-negative-Badge + negative Hilfe-Box; mangels expliziter Ausnahme auf den Action-Standard normalisiert (iconVariant: information, subtle-blue, Hilfe-Box information).
  • K-T3 Webhook empfangen — das zweite Header-Badge "Profi-Baustein" (subtle-neutral) ist als proBadge: true-Flag modelliert (gemeinsamer i18n-Key badges.pro), ebenso bei K-I1 HTTP-Anfrage (Doppel-Badge Integration + Profi-Baustein).

Copy-Anpassungen (Hausstil)

  • Sie→Du: Hilfe-Box von "K-T1 Projekt angelegt" ("…grenzen Sie ein…") in Du-Form konvertiert ("…grenzt du ein…").
  • Em-Dashes ersetzt (— → Komma-Anschluss) in den Hilfe-Boxen von: "K-T2 Termin storniert", "K-T2 Deadline naht", "K-T2 Zeitplan", "K-T3 E-Mail unzustellbar", "K-T3 Webhook empfangen", "K-A1 Kontakt aendern", "K-A2 Benachrichtigung senden", "K-L2 Warten", "K-L2 Schleife" sowie im Methode-Hilfetext von "K-I1 HTTP-Anfrage".
  • Platzhalter mit konkreten Demo-Werten (z. B. Board-Select "Vertrieb" bei "K-T1 Status gewechselt", Postfach "info@betrieb.de" bei "K-T3 E-Mail eingegangen", Methode "POST" bei "K-I1 HTTP-Anfrage") haben keinen placeholderKey bekommen; nur generische Platzhalter ("Alle …", "… wählen") sind übernommen.
  • Dialog-Titel/Untertitel kommen nicht aus diesem Namespace, sondern aus den bestehenden Registry-Keys automation.nodes.<node>.title/.description (keine neuen Titel-Keys angelegt).