--- kind: wireframe-package project: HiveGrid Screen Project ticket: D-CHAT + AK-P15b package: WF-P15 Team-Chat typ: Flow status: Entwurf subframe: "" canvas: "WF-P15 Team-Chat.canvas" --- # WF-P15 Team-Chat Status: Entwurf (nicht mit David validiert) Subframe-Link: - Canvas: [Canvas]() Stand: 2026-07-09 --- ## 1. Kurzfassung Der interne Team-Chat: Channel-Liste, Echtzeit-Verlauf, Threads, Reaktionen, Pins, Anhänge, @-Erwähnungen, kanalübergreifende Suche und eine vereinfachte Monteur-Handy-Ansicht. Projekt-Channels hängen am Projekt und synchronisieren die Projektmitglieder. Admins können DMs nur über einen begründeten Audit-Modus einsehen; der Zugriff wird sichtbar markiert und protokolliert. --- ## 2. Intent Check | Frage | Antwort | |---|---| | Ticket/Modul | D-CHAT, Dev-Pendant AK-P15b | | Nutzer-Ziel | Schnell im Team, Projekt oder 1:1 schreiben, Kontext finden und nichts durch Mentions/Ungelesenheit verpassen | | Quellen geprüft | `ticket-docs/D-CHAT.md`, `ticket-docs/AK-P15b.md`, HiveGrid Map, Aufgaben-Muster für Mark-as-Task | | Sicher im Scope | Chat-Index, Channel-Detail, Thread, Pins, Mentions, Suche, Channel anlegen/settings, Admin-Audit, Mobile-Monteur | | Sicher nicht im Scope | Telefonie/AirCall (WF-P15 Telefonie), HalloPetra, WhatsApp/Unified Inbox, Whisper-Diktat | | Unsichere Annahmen | Projekt-Chat ist im Projekt-Detail eingebettet, aber die eigentliche Channel-View bleibt dieser Flow | --- ## 3. Scope | Punkt | Inhalt | |---|---| | Startpunkt | Sidebar »Chat« oder Projekt-Detail »Chat« | | Ziel | Nachricht gesendet/gelesen, Thread beantwortet, Channel gefunden/angelegt, Admin-Audit sauber begründet | | Haupt-Archetyp | **BESPOKE** Real-Time-Chat + A2/A6 Nebenflächen + A5 Modals | | Out of scope | Telefonie, externe Kundenkommunikation, WhatsApp, KI-Hilfe-Chat | --- ## 4. Entscheidungsentwurf (nicht validiert) | Entscheidung | Status | Notiz | |---|---|---| | Chat als eigener Bespoke-Flow | Entwurf | Real-Time-Layout ist kein Standard-A2/A3 | | Channel-Detail ist die Hauptarbeitsfläche | Entwurf | Header, Pinned-Preview, Verlauf, Composer, Thread/Info-Seitenflächen | | Thread als eigener nachweisbarer Screen | Entwurf | Kann später als Side-Panel oder Route umgesetzt werden; UX muss sichtbar sein | | Pins, Mentions und Suche als eigene Nebenflächen | Entwurf | Diese sind schnelle Arbeitslisten, nicht nur Filter im Channel | | Projekt-Channel ist entity-linked | Entwurf | Projektmitglieder werden synchronisiert; Einstieg im Projekt-Detail, View bleibt S02 | | Admin-DM-Audit ist kein normaler Admin-Browse | Entwurf | Pflicht-Begründung je Session + Banner im geöffneten DM + Audit-Log | | Monteur-Handy-Ansicht eigener Frame | Entwurf | Vereinfachte Navigation, Foto-Direktupload, Push/Offline-Hinweis | | Telefonie bleibt eigenes Paket | Entwurf | D-CHAT enthält keinen AirCall-Setup/Calls-Flow | ### Happy Path 1. Nutzer öffnet `/chat`, sieht Channels nach Ungelesenheit, Mentions und Pins sortiert. 2. Er öffnet einen Projekt-Channel, liest neue Nachrichten, antwortet mit @Mention und hängt ein Foto an. 3. Eine Nachricht braucht Nacharbeit → Hover-Menü »als Aufgabe markieren« öffnet den P4-Aufgaben-Dialog vorbefüllt. 4. Auf dem Handy nutzt der Monteur die vereinfachte Ansicht: Projekt-Chat öffnen, Foto hochladen, kurze Antwort senden. ### Meldungs-/Error-States (Entwurf) | Ereignis | UI-Form | Blockiert? | Bauen? | Copy/Notiz | |---|---|---|---|---| | Reconnect / WebSocket weg | Banner in S02/V01 | nein | Nur dokumentieren | »Verbindung unterbrochen — wir verbinden neu.« | | Nachricht noch nicht gesendet | Optimistic-Zustand in S02/V01 | nein | Nur dokumentieren | Uhr/Retry, kein Layoutsprung | | Upload fehlgeschlagen | Inline am Anhang | nein | Nur dokumentieren | erneut versuchen / entfernen | | Keine Channel-Berechtigung | 404/Permission-State | ja | Wiederverwenden | keine Channel-Details leaken | | Projekt-Channel ohne Projektzugriff | Permission-State | ja | Nur dokumentieren | Projektrechte gewinnen | | Zu viele Pins | Inline-Hinweis in S02/S04 | nein | Nur dokumentieren | max. 50 Pins je Channel | | DM-Audit ohne Begründung | M02 blockiert | ja | Bauen (M02) | Pflichtbegründung | | Admin liest DM | sichtbarer Banner in S02/S08 | nein | Bauen in S08/S02 | »Admin-Einsicht aktiv« | | Mobile offline | Banner in V01 | nein | Nur dokumentieren | Entwurf bleibt lokal | --- ## 7. Screen-Liste (Entwurf) | ID | Screen/Zustand | Typ | Umsetzung | Ort | Status | |---|---|---|---|---|---| | S01 | Chat-Index | BESPOKE | Bauen | `/chat` | Entwurf | | S02 | Channel-Detail | BESPOKE | Bauen | `/chat/:id` | Entwurf | | S03 | Thread-Detail | BESPOKE Panel/Route | Bauen | `/chat/:id/thread/:thread_id` | Entwurf | | S04 | Angepinnte Nachrichten | A2 Liste | Bauen | `/chat/:id/pinned` | Entwurf | | S05 | Meine Mentions | A2 Liste | Bauen | `/chat/mentions` | Entwurf | | S06 | Chat-Suche | A2 Suche | Bauen | `/chat/search` | Entwurf | | S07 | Channel-Einstellungen | A6 Settings | Bauen | `/chat/:id/settings` | Entwurf | | S08 | Admin-Chat-Übersicht | A2/A3 Admin | Bauen | `/admin/chat` | Entwurf | | V01 | Monteur-Handy-Chat | BESPOKE-Mobile | Bauen | Variante von S02 | Entwurf | | M01 | Neuer Channel / DM | Modal | Bauen | aus S01/S02 | Entwurf | | M02 | DM-Audit-Begründung | Modal | Bauen | aus S08 | Entwurf | | D01–D09 | Reconnect / Pending / Upload / Permission / Pins / Offline (s. Tabelle) | Inline/Zustand | Nur dokumentieren | — | Entwurf | --- ## 8. Grid ```text Sidebar -> S01 (Chat-Index) S01 -> S02 (Channel öffnen) S02 -> S03 (Thread öffnen) S02 -> S04 (Pins) S01/S02 -> S05 (Meine Mentions) S01/S02 -> S06 (Suche) S02 -> S07 (Channel-Einstellungen) S01/S02 -> M01 (neuer Channel / DM) S02 -> V01 (Handy-Variante) S08 Admin -> M02 (Begründung) -> S02 mit Audit-Banner S02 Hover-Menü -> WF-P4 Aufgaben M01 (Mark-as-Task, vorbefüllt) Projekt-Detail -> S02 (entity-linked Projekt-Channel) ``` --- ## 9. Screen-Pakete - [[S01 Chat-Index]] · [[S02 Channel-Detail]] · [[S03 Thread-Detail]] · [[S04 Angepinnte Nachrichten]] - [[S05 Meine Mentions]] · [[S06 Chat-Suche]] · [[S07 Channel-Einstellungen]] · [[S08 Admin-Chat]] - [[V01 Monteur-Handy-Chat]] · [[M01 Neuer Channel DM]] · [[M02 DM-Audit-Begruendung]] --- ## 10. Offene Fragen - Thread-Detail als Side-Panel oder eigene Route: Paket lässt beides zu; Subframe entscheidet nach Layout-Test. - Channel-Browser/Discover: v1 im Chat-Index als Bereich/Overlay, kein eigener Screen. - Read-Receipt-Kopie: »X von Y gelesen« reicht im Verlauf; Detail-Liste erst bei Bedarf. - Push-Verhalten für Monteure: mit Benachrichtigungen P3 abstimmen. ## Handoff-Check - [ ] Screen-Liste mit David validieren. - [ ] Meldungs-/Error-State-Matrix mit David validieren. - [ ] Subframe-Link ist eingetragen. *(Subframe erst nach explizitem OK)*