--- kind: screen project: HiveGrid Screen Project ticket: D-P12 package: WF-P12 Verwaltung id: S05a screen: Baustein-Konfig Vorplanung (Katalog aller Panels) typ: Vorplanung / Katalog umsetzung: Planen status: Subframe Draft / Review offen route: "Modal über dem Flow-Editor (Dialog-Komponente, Klick auf Baustein)" --- # S05a — Baustein-Konfig Vorplanung Vorplanung für **alle 31 Bausteine** aus der Baustein-Bibliothek (Stand Planung 2026-07-11, Screenshot-Abgleich). Ziel: je Baustein ein eigenes Konfig-Panel in Subframe ablegen, das später einzeln angepasst wird. Statt 31 Panels von null zu bauen: **9 Muster-Archetypen** definieren, je Archetyp ein Muster-Panel bauen, die restlichen Panels als Kopien mit angepassten Feldern ableiten. Verwandt: [[S05 Baustein-Konfig-Panels]] (die zwei existierenden Muster), [[S01 Flow-Editor]]. --- ## Farbschema der Kategorien (aus der Planung) | Kategorie | Farbe | Anzahl | |---|---|---| | Auslöser | Grün | 16 | | Aktionen: Daten & CRM | Rot | 2 | | Aktionen: Kommunikation | Blau | 1 | | Aktionen: Aufgaben | Gelb | 2 | | Logik | Violett | 8 | | Integration | Grau | 2 | > ⚠️ Abweichung: Die Subframe-Entwürfe von Baustein-Picker/Konfig (2026-07-11) nutzen Orange für Auslöser und Blau für alle Aktionen. Vor dem Weiterbauen auf dieses Schema (Grün/Rot/Blau/Gelb/Violett/Grau) vereinheitlichen. --- ## Archetypen (Muster-Panels) | # | Archetyp | Grundaufbau des Panels | |---|---|---| | T1 | Datensatz-Auslöser | Filter-Abschnitt: welche Datensätze zählen (Quelle, Pipeline, Feld). Kein Pflichtfeld nötig — läuft auch ungefiltert. | | T2 | Zeit-/Termin-Auslöser | Zeitbezug: Vorlauf (»3 Tage vorher«), Terminart, bzw. Wiederholungsregel beim Zeitplan. | | T3 | Eingangs-Auslöser (E-Mail/Formular/Webhook) | Quelle wählen (Postfach, Formular, Webhook-URL anzeigen) + Vorschau der ankommenden Daten (Payload-Felder als Chips für spätere Schritte). | | A1 | Datensatz-Aktion | Ziel-Datensatz wählen + Feld-Zuordnung (welches Feld bekommt welchen Wert, mit Platzhalter-Chips). | | A2 | Kommunikations-Aktion | Kanal (E-Mail/Push/intern), Empfänger, Betreff/Text mit Platzhalter-Chips. | | A3 | Aufgaben-Aktion | Muster existiert (S05): Titel, Verantwortlich (Pflicht), Fälligkeit, Priorität, Notiz. | | L1 | Bedingungs-Logik | Bedingungszeilen: Feld · Operator · Wert (+ Zeile hinzufügen). Klartext-Zusammenfassung. | | L2 | Ablauf-Logik | Ein Hauptwert: Dauer (Warten), Liste (Schleife), Variable + Wert (Wert setzen). | | I1 | Integration | Technischer: URL, Methode, Kopfzeilen/Payload — bewusst als »Profi-Baustein« gekennzeichnet. | Jedes Panel hat einheitlich: Kopf (Kategorie-farbiges Icon, Name, Klartext-Untertitel, Schließen), Suchfeld entfällt, Pflichtfeld-Validierung inline + Badge am Baustein, »So liest es sich«-Satz unten, Fuß mit Übernehmen/Abbrechen. --- ## Katalog: alle 31 Panels ### Auslöser (Grün) | Baustein | Kurzbeschreibung (Karte) | Ausgänge | Archetyp | Konfig-Felder (Panel) | |---|---|---|---|---| | Neuer Kontakt | Wenn ein Kontakt angelegt wird | 1 | T1 | Quelle (alle/manuell/Import/Formular), optional Tag-Filter | | Kontakt geändert | Wenn sich Kontaktdaten ändern | 1 | T1 | Welche Felder beobachten (alle oder Auswahl) | | Neue Anfrage | Wenn eine Anfrage eingeht | 1 | T1 | Quelle (Website-Formular/E-Mail/manuell), optional Bereich | | Lead qualifiziert | Wenn ein Lead qualifiziert wird | 1 | T1 | Pipeline, Qualifizierungs-Stufe | | Projekt gewonnen | Wenn ein Projekt gewonnen wird | 1 | T1 | Pipeline/Board, optional Mindestwert | | Status gewechselt | Wenn eine Karte die Spalte wechselt | 1 | T1 | Board, von Spalte (optional), nach Spalte | | Projekt angelegt | Wenn ein Projekt erstellt wird | 1 | T1 | Projektart/Board, optional Quelle | | Deadline naht | Wenn eine Frist bald abläuft | 1 | T2 | Fristtyp (Aufgabe/Projekt/Zahlungsziel), Vorlauf (z. B. 3 Tage vorher) | | E-Mail eingegangen | Wenn eine E-Mail ankommt | 1 | T3 | Postfach, optional Betreff-/Absender-Filter | | E-Mail unzustellbar | Wenn eine Kampagnen-Mail bounct | 1 | T3 | Kampagne (alle oder Auswahl), Bounce-Art (hart/weich) | | Formular abgeschickt | Wenn ein Formular eingeht | 1 | T3 | Formular wählen (aus D-FORM), Felder-Vorschau als Chips | | Termin gebucht | Wenn ein Termin gebucht wird | 1 | T2 | Terminart/Kalender, optional Mitarbeiter | | Termin storniert | Wenn ein Termin abgesagt wird | 1 | T2 | Terminart/Kalender, Storno durch (Kunde/intern/beide) | | Ereignis erstellt | Wenn ein Kalender-Eintrag entsteht | 1 | T2 | Kalender, Ereignisart | | Zeitplan | Zu festen Zeiten, z. B. montags 8 Uhr | 1 | T2 | Wiederholung (täglich/wöchentlich/monatlich), Wochentag(e), Uhrzeit | | Webhook empfangen | Wenn ein externes System ruft | 1 | T3 | Webhook-URL (generiert, kopierbar), Secret, Beispiel-Payload-Vorschau | ### Aktionen: Daten & CRM (Rot) | Baustein | Kurzbeschreibung | Ausgänge | Archetyp | Konfig-Felder | |---|---|---|---|---| | Kontakt ändern | Datensatz aktualisieren | 1 | A1 | Welcher Kontakt (aus Auslöser/suchen), Feld-Zuordnungen (Feld → neuer Wert, Platzhalter) | | Notiz anlegen | Notiz am Datensatz speichern | 1 | A1 | Ziel-Datensatz, Notiztext (Platzhalter), optional sichtbar für | ### Aktionen: Kommunikation (Blau) | Baustein | Kurzbeschreibung | Ausgänge | Archetyp | Konfig-Felder | |---|---|---|---|---| | Benachrichtigung senden | E-Mail, Push oder intern | 1 | A2 | Kanal (Pflicht), Empfänger (Person/Team/Kontakt aus Auslöser), Betreff, Text mit Platzhalter-Chips | ### Aktionen: Aufgaben (Gelb) | Baustein | Kurzbeschreibung | Ausgänge | Archetyp | Konfig-Felder | |---|---|---|---|---| | Aufgabe anlegen | Neue Aufgabe erstellen | 1 | A3 | Titel (Platzhalter), Verantwortlich (Pflicht), Fälligkeit, Priorität, Notiz — Muster existiert | | Aufgabe zuweisen | Person oder Team zuordnen | 1 | A3 | Welche Aufgabe (aus vorherigem Schritt), neue Person/Team (Pflicht), optional Benachrichtigung an | ### Logik (Violett) | Baustein | Kurzbeschreibung | Ausgänge | Archetyp | Konfig-Felder | |---|---|---|---|---| | Wenn-Dann | Verzweigt nach Bedingung | Ja / Nein | L1 | Bedingungszeilen (Feld · Operator · Wert) | | Oder | Wenn mind. eine Bedingung zutrifft | Ja / Nein | L1 | Bedingungszeilen, Hinweis »eine reicht« | | Und | Wenn alle Bedingungen zutreffen | Ja / Nein | L1 | Bedingungszeilen, Hinweis »alle nötig« | | Switch | Mehrere Pfade verzweigen | 1 / 2 / 3 … | L1 | Feld wählen + je Pfad ein Wert (+ Pfad hinzufügen, Sonst-Pfad) | | Filter | Datensätze filtern | 1 | L1 | Bedingungszeilen; Klartext »nur weiter, wenn …« | | Warten | Pausiert, z. B. 3 Tage | 1 | L2 | Dauer (Zahl + Einheit) oder bis Datum/Uhrzeit aus Feld | | Schleife | Für jedes Element wiederholen | Weiter / Fertig | L2 | Liste wählen (z. B. alle Aufgaben des Projekts), max. Durchläufe | | Wert setzen | Variable setzen oder lesen | 1 | L2 | Variablenname, Wert (Platzhalter erlaubt) | ### Integration (Grau) | Baustein | Kurzbeschreibung | Ausgänge | Archetyp | Konfig-Felder | |---|---|---|---|---| | HTTP-Anfrage | Externen Dienst aufrufen | 1 | I1 | URL (Pflicht), Methode, Kopfzeilen, Payload (Platzhalter), Antwort-Vorschau | | An KWP übergeben | Projekt an KWP senden | 1 | — | **ab v2** — nur Registry-Eintrag, kein Konfig-UI (v1-Grenze, s. S05-Notiz) | --- ## Vorgehen für Subframe 1. Farbschema im Picker/Konfig-Entwurf auf das Planungs-Schema angleichen (Grün/Rot/Blau/Gelb/Violett/Grau). 2. Je Archetyp **ein** Muster-Panel als eigene Subframe-Seite bauen (9 Seiten; A3 existiert als Basis aus der Konfig-Runde 2026-07-11). 3. Danach die restlichen 21 v1-Panels als Kopien der Muster-Seiten ablegen und Felder gemäß Katalog oben anpassen (30 Seiten gesamt, KWP entfällt in v1). 4. Benennung in Subframe: »K-T1 Neuer Kontakt«, »K-A2 Benachrichtigung senden« … (K = Konfig-Panel), eigener Flow oder Gruppe, damit der Editor-Flow übersichtlich bleibt. ## Umsetzungsstand Subframe (2026-07-12) - **Entscheidung (David, 2026-07-12): Konfig als MODAL** (Dialog-Komponente), nicht rechtes Panel/Drawer — n8n-Muster: Klick auf Baustein öffnet Dialog. - **Alle 30 v1-Panels gebaut** (Nacht-Build 02:37–03:00 Uhr, KWP entfällt v1-gemäß): Benennung »K- « im Flow [(MCP) HiveGrid Workflow Engine / Automationen P12](https://app.subframe.com/f023064a5ca0/flow/22d511a9-1d8f-4554-89ad-86729b8d7738/edit). - Muster/Blaupause: **K-T1 Neuer Kontakt** (Dialog.Content ohne Overrides = 560 px/16 px/24 px laut Layout-Regeln, Labels + Helptexte über Komponenten-Props, jede Feld-Erklärung als helpText, Erklärungs-Box mit Fragezeichen in Kategoriefarbe, Fuß rechts: Abbrechen/Übernehmen). Größere Panels (Kontakt ändern, Benachrichtigung, Aufgabe anlegen, Wenn-Dann, Switch, HTTP) mit `size="medium"` = 720 px. - Readback-Check aller 30 Seiten bestanden (Dialog.Content, keine p-0/gap-0-Overrides, helpTexts, Erklärungs-Box). **Händisches Review durch David steht aus.** ## Offene Fragen - Ausgänge-Darstellung im Panel (zeigt das Panel die Ausgänge Ja/Nein bzw. 1/2/3 als Info an?) — David - Switch: wie viele Pfade maximal in v1? - Webhook/HTTP: wie viel Technik zeigen wir Handwerkern (Profi-Kennzeichnung reicht?)