Files

50 lines
6.9 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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).