50 lines
6.9 KiB
Markdown
50 lines
6.9 KiB
Markdown
# 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).
|