Files
HiveGrid-Wireframes/02 Wireframes/P12 Automationen/WF-P12 Verwaltung/Screens/S05a Baustein-Konfig Vorplanung.md
T
dejanandClaude Opus 4.8 f4cb863b58 Validate P12 block K-A (actions), apply decisions
Validation of the 5 action dialogs (now 6). Findings fixed in Subframe,
decisions recorded.

Decisions (Dejan):
- "Kontakt ändern" → "Datensatz ändern" (also covers project/order)
- E-Mail vs. Benachrichtigung = two separate blocks: "Benachrichtigung
  senden" is now internal only (push/in-app); new "E-Mail senden" block
  built for customer emails
- Data-category red softened from danger tokens (feedback-negative) to
  category tokens (ui-red), matching how logic blocks use ui-purple —
  keeps red, no longer reads as an error
- Missing required fields marked: Notiztext, Benachrichtigung/Nachricht

Baukasten findings (D-D0b, not touched): BadgeFeedback and
IconWithBackground have no category red/yellow variant (only danger/
warning), so the 30 dialogs mix ui- and feedback- tokens. Full
consistency needs new ui-red/ui-yellow variants — flagged for a
standards round.

Still open by hand in Subframe: rename page "K-A1 Kontakt aendern" to
"Datensatz aendern".

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-16 17:48:22 +02:00

286 lines
25 KiB
Markdown
Raw 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.
---
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 |
> ✅ **Entschieden (Dejan, 2026-07-13, mit Mandat von David): Dieses Schema gilt.** Die 30 Konfig-Dialoge sind bereits konform (Auslöser grün, Aufgaben warning/gelb, Logik violett). Der **Baustein-Picker muss nachziehen** — er nutzt derzeit Orange für Auslöser, Blau für alle Aktionen und Neutral für Logik.
---
## 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
> Die Spalte »Konfig-Felder« beschreibt den **aktuell gebauten Stand**. Sie wird bei jeder Validierungsrunde nachgezogen. `*` = Pflichtfeld. Zuletzt aktualisiert 2026-07-13 (Blöcke K-T1 und K-T2).
### 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 | **Schalter »Alle Felder beobachten«** + Feld-Auswahl als Tags (ausgegraut, solange der Schalter an ist) — geändert 07-13 |
| 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 | **Board**, Qualifizierungs-Stufe — »Pipeline« umbenannt 07-13 |
| Projekt gewonnen | Wenn ein Projekt gewonnen wird | 1 | T1 | Board, optional Mindestwert (**Zahlenfeld**, nicht Text) — geändert 07-13 |
| Status gewechselt | Wenn eine Karte die Spalte wechselt | 1 | T1 | Board `*`, von Spalte (optional), nach Spalte `*` — Pflichtfelder ergänzt 07-13 |
| Projekt angelegt | Wenn ein Projekt erstellt wird | 1 | T1 | Board, optional Quelle |
| **Frist oder Termin** | Vor oder nach einer Frist / einem Termin | 1 | T2 | Bezug `*` (Aufgaben-Fälligkeit / Projekt-Deadline / Zahlungsziel / **Termin**), Abstand `*` (Zahl) + Einheit `*` (Stunden/Tage/Wochen **vorher oder danach**) — **ersetzt »Deadline naht« 07-13**; deckt Terminerinnerung und Mahnwesen mit ab |
| E-Mail eingegangen | Wenn eine E-Mail ankommt | 1 | T3 | Postfach, optional Betreff-/Absender-Filter. **Badge »Ab v2« + Hinweisbox**: braucht das Postfach (Postfach-Sync = v2, → P23). In v1 einrichtbar, aber nicht auslösbar. |
| E-Mail unzustellbar | Wenn eine Kampagnen-Mail bounct | 1 | T3 | Kampagne (alle oder Auswahl), Art der Unzustellbarkeit (dauerhaft/vorübergehend). **Abhängigkeit**: braucht D-KAMP (Kampagnen) + D-P14 (Bounce-Tracking) — beide v1, aber noch nicht gebaut. |
| Formular abgeschickt | Wenn ein Formular eingeht | 1 | T3 | Formular `*` (aus D-FORM), Felder-Vorschau als Chips — Pflichtfeld ergänzt 07-16 |
| Termin gebucht | Wenn ein Termin gebucht wird | 1 | T2 | Terminart, optional Mitarbeiter |
| Termin storniert | Wenn ein Termin abgesagt wird | 1 | T2 | Terminart, 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 `*`; **Felder wechseln je nach Wiederholung**: täglich → nur Uhrzeit `*`; wöchentlich → Wochentage `*` + Uhrzeit `*`; monatlich → Tag im Monat `*` + Uhrzeit `*`. Uhrzeit ist **vorläufig ein Dropdown** (dem Baukasten fehlt eine Uhrzeit-Komponente). Zustände »täglich« und »monatlich« noch nicht gezeichnet. |
| 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 |
|---|---|---|---|---|
| **Datensatz ändern** | Datensatz aktualisieren | 1 | A1 | Welcher Datensatz (Kontakt/Projekt/Auftrag, aus Auslöser/suchen), Feld-Zuordnungen (Feld → neuer Wert, Platzhalter) — **umbenannt von »Kontakt ändern« 07-16** |
| Notiz anlegen | Notiz am Datensatz speichern | 1 | A1 | Ziel-Datensatz, Notiztext `*` (Platzhalter), optional sichtbar für — Pflichtfeld ergänzt 07-16 |
### Aktionen: Kommunikation (Blau)
| Baustein | Kurzbeschreibung | Ausgänge | Archetyp | Konfig-Felder |
|---|---|---|---|---|
| Benachrichtigung senden | **Intern**: Push oder in der App | 1 | A2 | Weg (Push/In-App/Beide), Empfänger `*` (Ich/Person/Team/Verantwortliche aus Auslöser), Titel, Nachricht `*` — **auf intern beschränkt 07-16** (E-Mail an Kunden hat eigenen Baustein) |
| **E-Mail senden** | **Extern**: E-Mail an einen Kontakt | 1 | A2 | Empfänger `*` (Kontakt), Absender `*` (Postfach-Adresse), Betreff `*`, Nachricht `*` (Platzhalter), optional Anhang — **neuer Baustein 07-16** |
### 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-<Archetyp> <Name>« 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.**
## Subframe-Links aller 30 Dialoge (Stand 2026-07-13, per MCP verifiziert)
### Auslöser (16)
| Baustein | Subframe |
|---|---|
| K-T1 Neuer Kontakt (Blaupause) | [Dialog](https://app.subframe.com/f023064a5ca0/design/b826c642-9b14-4c83-98e0-dba33470852e/edit) |
| K-T1 Kontakt geaendert | [Dialog](https://app.subframe.com/f023064a5ca0/design/48d85ffd-c90c-4da0-b37a-6b3d2711299d/edit) |
| K-T1 Neue Anfrage | [Dialog](https://app.subframe.com/f023064a5ca0/design/0e6798e1-5daf-4cd4-ac37-0d3c53316ffb/edit) |
| K-T1 Lead qualifiziert | [Dialog](https://app.subframe.com/f023064a5ca0/design/168740c8-c344-40db-9a86-9b8dbb0b86f7/edit) |
| K-T1 Projekt gewonnen | [Dialog](https://app.subframe.com/f023064a5ca0/design/7dbedd13-7bd9-4203-ac4b-367fe98a0c90/edit) |
| K-T1 Status gewechselt | [Dialog](https://app.subframe.com/f023064a5ca0/design/4531af4b-270d-4338-a7aa-9bf9f22acb2a/edit) |
| K-T1 Projekt angelegt | [Dialog](https://app.subframe.com/f023064a5ca0/design/6ddca087-0655-4390-b365-47b46796520a/edit) |
| K-T2 Deadline naht | [Dialog](https://app.subframe.com/f023064a5ca0/design/4049387e-82e7-46d9-bcc8-1f0623212f4d/edit) |
| K-T2 Termin gebucht | [Dialog](https://app.subframe.com/f023064a5ca0/design/4f65190b-0088-4774-b0d4-47c2548b9e1f/edit) |
| K-T2 Termin storniert | [Dialog](https://app.subframe.com/f023064a5ca0/design/ecfcc5d9-fa76-401d-ba4f-cae76cbdff69/edit) |
| K-T2 Ereignis erstellt | [Dialog](https://app.subframe.com/f023064a5ca0/design/6dbde62e-a714-484a-a7c1-eeb45b281537/edit) |
| K-T2 Zeitplan | [Dialog](https://app.subframe.com/f023064a5ca0/design/69a04a7d-11e1-4507-97db-79556a4058a1/edit) |
| K-T3 E-Mail eingegangen | [Dialog](https://app.subframe.com/f023064a5ca0/design/19182d3b-ae54-4327-b8a7-bc2f7a525e8e/edit) |
| K-T3 E-Mail unzustellbar | [Dialog](https://app.subframe.com/f023064a5ca0/design/b53d974b-f3d4-43f8-9118-879d165c475f/edit) |
| K-T3 Formular abgeschickt | [Dialog](https://app.subframe.com/f023064a5ca0/design/ece5c3ef-81e4-430b-af86-6317c9921963/edit) |
| K-T3 Webhook empfangen | [Dialog](https://app.subframe.com/f023064a5ca0/design/cd8330f6-1acb-4dd2-bd56-7f2f159d506b/edit) |
### Aktionen (5)
| Baustein | Subframe |
|---|---|
| K-A1 Kontakt aendern | [Dialog](https://app.subframe.com/f023064a5ca0/design/69019ec4-d884-4d89-b699-d67a6ec99c7f/edit) |
| K-A1 Notiz anlegen | [Dialog](https://app.subframe.com/f023064a5ca0/design/a94188de-7a32-4e7d-a608-04cd47f2cbf2/edit) |
| K-A2 Benachrichtigung senden | [Dialog](https://app.subframe.com/f023064a5ca0/design/a0a46df7-4f24-4e36-98ab-c4772ecf2e63/edit) |
| K-A3 Aufgabe anlegen | [Dialog](https://app.subframe.com/f023064a5ca0/design/9d9f2a55-0d46-4644-ac9f-c63721262fdb/edit) |
| K-A3 Aufgabe zuweisen | [Dialog](https://app.subframe.com/f023064a5ca0/design/94ccafb9-b3d2-4256-907c-f7a95632945a/edit) |
### Logik (8)
| Baustein | Subframe |
|---|---|
| K-L1 Wenn-Dann | [Dialog](https://app.subframe.com/f023064a5ca0/design/7e6bcf69-2938-4cd3-b060-2e0a9695499f/edit) |
| K-L1 Und | [Dialog](https://app.subframe.com/f023064a5ca0/design/95c4b661-8070-4fb0-90e5-9a60910a7754/edit) |
| K-L1 Oder | [Dialog](https://app.subframe.com/f023064a5ca0/design/6c360480-f4cf-4f3f-85ff-2a9bab994ed0/edit) |
| K-L1 Switch | [Dialog](https://app.subframe.com/f023064a5ca0/design/879e169d-839c-450b-adc6-c01a9d3cc2fd/edit) |
| K-L1 Filter | [Dialog](https://app.subframe.com/f023064a5ca0/design/d7adb2e6-e7b2-412a-9b3e-884e1968c7d8/edit) |
| K-L2 Warten | [Dialog](https://app.subframe.com/f023064a5ca0/design/3b8067ec-1905-4fb6-bafd-e3e414c216b2/edit) |
| K-L2 Schleife | [Dialog](https://app.subframe.com/f023064a5ca0/design/de5b5fa7-bf30-4150-a5b5-5f27d7f37a87/edit) |
| K-L2 Wert setzen | [Dialog](https://app.subframe.com/f023064a5ca0/design/0c2fae48-e2ab-4103-b111-15a3e120adb1/edit) |
### Integration (1)
| Baustein | Subframe |
|---|---|
| K-I1 HTTP-Anfrage | [Dialog](https://app.subframe.com/f023064a5ca0/design/b41d53ea-a101-41c5-8950-cca4fc57ed90/edit) |
## Validierung der 30 Konfig-Dialoge
Läuft seit 2026-07-13. Validiert von **Dejan** (mit ausdrücklichem Mandat von David, 2026-07-13). Vorgehen: blockweise gegen `D-FLOW.md`/`D-P12.md`, den Baustein-Katalog oben und die Layout-Standards. Befunde werden direkt in Subframe behoben; alles, was eine Produktentscheidung ist, wird hier festgehalten.
### Geltende Muster (aus der Validierung abgeleitet)
| Regel | Wie |
|---|---|
| **Ansprache** | **Durchgehend duzen.** Entschieden 2026-07-13. Betrifft auch den Baustein-Picker (siezt noch) und potenziell das ganze Produkt. |
| **Board, nicht Pipeline** | Der Begriff heißt überall `Board`. Entschieden 2026-07-13. |
| **Pflichtfeld-Muster** | Sternchen im Label (`Verantwortlich *`) **plus** das Wort `Pflichtfeld.` am Ende des helpText. Vorbild: K-A3 Aufgabe anlegen. |
| **Erklär-Box** | Bleibt **handgebaut** — bewusste Ausnahme, entschieden 2026-07-13. Die Alert-Komponente kann die Kategoriefarben nicht (kein Violett, kein Gelb) und würde bei Daten-Bausteinen rot wie ein Fehler wirken. |
| **Ausgänge im Panel** | Bausteine mit mehreren Ausgängen zeigen sie unten im Dialog (Vorbild: K-L1 Wenn-Dann mit `Ja →` / `Nein →`). Damit ist die alte offene Frage »zeigt das Panel die Ausgänge?« beantwortet: **ja**. |
### Block K-T1 — Datensatz-Auslöser (7 Dialoge) — ✅ validiert und repariert 2026-07-13
Struktur, Farben, Abstände und Katalog-Treue waren durchgehend in Ordnung. Behoben wurden:
| Dialog | Befund | Behebung |
|---|---|---|
| Kontakt geändert | Zwei Felder für dieselbe Sache (Dropdown »Welche Felder beobachten« **und** Tag-Feld) | Dropdown entfernt. Neu: **Schalter »Alle Felder beobachten«** + Tag-Feld darunter. Aus = einzelne Felder wählbar, An = Tag-Feld ausgegraut. |
| Status gewechselt | `Board` und `Nach Spalte` faktisch Pflicht, aber nicht markiert | Beide auf Pflichtfeld-Muster umgestellt (`Board *`, `Nach Spalte *`). `Von Spalte` bleibt optional. |
| Lead qualifiziert | Nannte das Board »Pipeline« | Auf `Board` umgestellt. |
| Projekt angelegt | Siezte als einziger Dialog | Auf Duzen umgestellt. |
| Projekt gewonnen | Euro-Betrag als freies Textfeld; Label »Board« unsichtbar | Auf **Number Input** umgestellt; Label sichtbar geschaltet. |
| Neuer Kontakt (Blaupause) | Label »Quelle« unsichtbar (`showLabel` fehlte) | Label sichtbar geschaltet. |
**Offen aus diesem Block:**
- **»Kontakt geändert«**: Der ausgegraute Zustand (Schalter an → Tag-Feld gesperrt) ist bisher nur im helpText beschrieben, nicht als eigenes Frame gezeichnet. Entscheiden, ob das reicht.
- **Number Input ist auf 192 px Breite festgenagelt** (`max-w-[192px]` in der Komponente) und lässt sich nicht auf volle Feldbreite ziehen. Dadurch bricht der helpText darunter schmal um. → Befund am Baukasten, s. u.
### Block K-T2 — Zeit- und Termin-Auslöser (5 Dialoge) — ✅ validiert und repariert 2026-07-13
| Dialog | Befund | Behebung |
|---|---|---|
| **Deadline naht → »Frist oder Termin«** | Deckte nur »vorher« ab und kannte keinen Termin-Typ. Dadurch liefen die Picker-Einträge **»Termin in Kürze«** und **»Zahlungsziel überschritten«** ins Leere. | **Baustein erweitert statt zwei neue zu bauen** (entschieden Dejan 2026-07-13): Bezug bekommt zusätzlich `Termin`; die Zeitangabe bekommt `Stunden/Tage/Wochen danach` neben `vorher`. Deckt damit Terminerinnerung **und** Mahnwesen ab. Titel, Untertitel, Erklär-Box und Feldnamen (`Abstand` statt `Vorlauf`) nachgezogen; Bezug und Zeitangabe sind jetzt Pflichtfelder. |
| Termin gebucht | Beide Feld-Beschriftungen unsichtbar | Sichtbar geschaltet |
| Termin storniert | Beide Feld-Beschriftungen unsichtbar | Sichtbar geschaltet |
| Zeitplan | Uhrzeit als freies Textfeld (»morgens« wäre eingebbar) | **Vorläufig** Dropdown in 30-Minuten-Schritten, im helpText sichtbar als vorläufig markiert. Grund: dem Baukasten fehlt eine Uhrzeit-Komponente (s. u.). |
| Zeitplan | `Wochentage` immer sichtbar, obwohl nur bei »Wöchentlich« sinnvoll; Feld für den Tag im Monat fehlt ganz | **Entschieden (Dejan 2026-07-13): Felder wechseln je nach Wiederholung.** Täglich → nur Uhrzeit. Wöchentlich → Wochentage + Uhrzeit. Monatlich → Tag im Monat + Uhrzeit. **»Monatlich« ist als eigene Subframe-Seite `K-T2 Zeitplan monatlich` gezeichnet (2026-07-15).** »Täglich« ist trivial (ein Feld weniger) und wird nur beschrieben — folgt Davids Muster (bedeutsame Zustände = eigene Seite, triviale = nur dokumentiert). |
**Wichtig:** Die Subframe-Seite heißt weiterhin `K-T2 Deadline naht`, der Inhalt aber »Frist oder Termin«. **Die Seite muss in Subframe noch umbenannt werden** — per MCP nicht möglich, muss von Hand geschehen.
### Block K-T3 — Eingangs-Auslöser (4 Dialoge) — ✅ validiert und repariert 2026-07-16
Bester Block bisher — Struktur, Sichtbarkeit der Labels und Duzen durchgehend korrekt.
| Dialog | Befund | Behebung |
|---|---|---|
| Webhook empfangen | — | **Vorbildlich.** Beantwortet die offene Frage »wie viel Technik zeigen wir Handwerkern?«: zweites Badge »Profi-Baustein«, »Webhook-Adresse« statt »Endpoint«, »Sicherheitsschlüssel« mit Klartext, Kopier-Knöpfe, kein rohes JSON. Keine Änderung. |
| Formular abgeschickt | Formular-Feld faktisch Pflicht, aber nicht markiert | Auf Pflichtfeld-Muster umgestellt (`Formular *`). |
| E-Mail eingegangen | Braucht ein Postfach — das ist v2 | **Entschieden (Dejan 2026-07-16): drin lassen mit »Ab v2«-Kennzeichen.** Zweites Badge »Ab v2« + neutrale Hinweisbox oben (»braucht das Postfach, kommt später«). Dialog bleibt vollständig, wird aber ehrlich als noch-nicht-auslösbar markiert. |
| E-Mail unzustellbar | Braucht Kampagnen (D-KAMP) + Bounce-Tracking (D-P14), beide v1 aber ungebaut | **Entschieden (Dejan 2026-07-16): drin lassen, nur Abhängigkeit notieren** (keine v2-Kennzeichnung, da es v1 ist — nur eine Bau-Reihenfolge für den Entwickler). |
### Block K-A — Aktionen (5 → 6 Dialoge) — ✅ validiert und repariert 2026-07-16
| Dialog | Befund | Behebung |
|---|---|---|
| Kontakt ändern → **Datensatz ändern** | Name zu eng (kann auch Projekt/Auftrag) + Namens-Drift zum Picker (»Datensatz ändern«) | **Umbenannt in »Datensatz ändern«** (Entscheidung Dejan 07-16). Feld »Welcher Kontakt« → »Welcher Datensatz«, Untertitel angepasst. |
| Datensatz ändern | Rot mit **Gefahr-Optik** (destructive Icon + roter Fehler-Rahmen) | **Entschärft** (Entscheidung Dejan 07-16): Kategorie-Rot statt Gefahr-Rot — Icon und Erklär-Box auf `ui-red`-Tokens umgestellt, wie K-L1 Wenn-Dann es mit Violett vormacht. |
| Notiz anlegen | Gleiche Gefahr-Optik + Notiztext nicht als Pflicht markiert | Rot entschärft (wie oben) + `Notiztext *` als Pflichtfeld. |
| Benachrichtigung senden | Vermischte extern/intern; »E-Mail« als Kanal, obwohl Picker »E-Mail senden« separat führt; Nachricht nicht Pflicht | **Auf intern beschränkt** (Entscheidung Dejan 07-16: zwei getrennte Bausteine): Weg = Push/In-App, Empfänger nur intern (`*`), Nachricht (`*`). |
| **E-Mail senden** (neu) | Picker bot »E-Mail senden« an, es gab aber keinen Dialog | **Neuer Baustein gebaut** (Entscheidung Dejan 07-16): Empfänger `*` (Kontakt), Absender `*`, Betreff `*`, Nachricht `*`, optional Anhang. Optik = Benachrichtigung, blau. |
| Aufgabe anlegen / Aufgabe zuweisen | — | In Ordnung. »Aufgabe zuweisen« markiert sein Pflichtfeld (`Neue Verantwortung *`) bereits vorbildlich. |
**Wichtig für Subframe (von Hand):** Die Seite `K-A1 Kontakt aendern` sollte zu `K-A1 Datensatz aendern` umbenannt werden (Inhalt stimmt schon). Der Picker-Eintrag »E-Mail senden« bekommt jetzt einen echten Dialog; der neue Baustein ist auch im Picker als eigener Kommunikations-Eintrag zu führen.
### Befunde am Baukasten (nicht selbst ändern — Sperrgebiet)
| Komponente | Befund | Auswirkung |
|---|---|---|
| **Uhrzeit-Komponente fehlt komplett** | Der `Date Picker` ist ein reiner Kalender ohne Zeit. Es gibt kein Time-Picker-Bauteil. | Betrifft **nicht nur P12**: Plantafel (D-PLAN), Terminbuchung (D-BOOK) und Kalender brauchen es ebenfalls. In P12 vorläufig mit einem Dropdown überbrückt. → **Befund an D-D0b (UI-Baukasten)** |
| `Number Input` | Fest auf `min-w-[192px]` **und** `max-w-[192px]` — also exakt 192 px, weder schmaler noch breiter | Schmale Zahlenfelder (z. B. `Abstand` = »3«) sind unmöglich; volle Feldbreite ebenso. Bricht den Formular-Rhythmus. |
| `IconWithBackground` | Nur `destructive` (Gefahr-Rot) als Rot; kein Kategorie-Rot/Gelb-Variant | Daten-Bausteine (rot) und Logik (violett) brauchen einen handgeschriebenen `ui-*`-Farb-Override im Screen. |
| `BadgeFeedback` | Kein `subtle-red` und kein `subtle-yellow` (nur `subtle-negative`/`subtle-warning` = Gefahr/Warnung). `subtle-blue`/`subtle-purple` existieren. | Daten- und Aufgaben-Badges nutzen zwangsläufig die Feedback-Farben (Gefahr/Warnung) statt echter Kategorie-Farben. **Broader-Finding**: Die 30 Dialoge mischen `ui-*`- und `feedback-*`-Farbtoken. Für volle Einheitlichkeit müsste der Baukasten `ui-red`/`ui-yellow`-Badge- und Icon-Varianten bekommen. → eigene Standards-Runde mit David. |
## Lücken und Widersprüche (Abgleich 2026-07-13)
Der Baustein-Picker ([[S01 Flow-Editor]], Seite »Picker Kachel-Filter«) und dieser Katalog stimmen noch nicht überein:
| Befund | Was zu tun ist |
|---|---|
| ✅ Picker bot **»Termin in Kürze«** und **»Zahlungsziel überschritten«** an — kein Dialog vorhanden | **Gelöst 2026-07-13:** Beide Fälle deckt jetzt der erweiterte Baustein **»Frist oder Termin«** ab. Im Picker müssen die zwei Einträge durch **einen** Eintrag »Frist oder Termin« ersetzt werden. |
| Picker bietet **»E-Mail senden«** an — kein Konfig-Dialog vorhanden | Der Katalog kennt nur »Benachrichtigung senden« (Kanal E-Mail/Push/intern) — vermutlich derselbe Baustein unter zwei Namen. **Noch zu entscheiden** (kommt in Block K-A dran). |
| Picker sagt **»Datensatz ändern«**, der Dialog heißt **»Kontakt ändern«** | Auf einen Namen festlegen. Der Katalog meint den generischen Datensatz, der Dialog nur den Kontakt. **Noch zu entscheiden** (Block K-A). |
| Picker zeigt nur **12 Bausteine**, der Katalog kennt **30** | Picker vollständig füllen (mit Suche/Filter ist die Menge tragbar). |
| Picker-Farben weichen ab (Orange/Blau/Neutral) | Auf das S05a-Schema umstellen (entschieden 2026-07-13). |
| Picker **siezt** (»Wählen Sie einen Baustein«) | Auf Duzen umstellen (entschieden 2026-07-13). |
## 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?)