docs(p15): finalize team chat handoff

This commit is contained in:
david committed 2026-08-08 01:26:20 +02:00
1 parent 108a0c0437
commit 05d2d5777f
50 files changed
+1798 -29

No files matched your search

@@ -0,0 +1,41 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: P15 Team-Chat
package: WF-P15 Team-Chat
id: M01
screen: Gruppe Aktion bestaetigen
typ: Modal
status: Bereit zur Validierung
source: Subframe
subframe_id: 036fbb92-7c48-4610-8735-890632be53f0
subframe: "https://app.subframe.com/f023064a5ca0/design/036fbb92-7c48-4610-8735-890632be53f0/edit"
synced: 2026-08-06
---
# M01 — Gruppenaktion bestätigen
> [!info] Single Source of Truth
> [Subframe öffnen](https://app.subframe.com/f023064a5ca0/design/036fbb92-7c48-4610-8735-890632be53f0/edit)
![Subframe-Screenshot](https://egniatlvhajtqurt.public.blob.vercel-storage.com/prod/39410/screenshots/036fbb92-7c48-4610-8735-890632be53f0-1786024606884.png)
## Zweck und Zustand
Bestätigungsmodal für die gefährlichen Gruppenaktionen „Gruppe verlassen“ und „Gruppe archivieren/löschen“.
## Hauptaktionen
- Aktion auswählen
- Abbrechen
- Verlassen oder Löschen bestätigen
## Verbindungen
- Aufruf und Abbruch → [[S01e Gruppeneinstellungen]]
## Für die Validierung
- [ ] Sollte ein Modal wirklich zwei unterschiedliche gefährliche Aktionen gleichzeitig anbieten?
- [ ] Ist der Unterschied zwischen Archivieren und Löschen eindeutig genug?
- [ ] Sind Buttontext und gewählte Option immer konsistent?
@@ -0,0 +1,44 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: P15 Team-Chat
package: WF-P15 Team-Chat
id: S01a
screen: Neuer Chat
typ: Auswahlpanel
status: Bereit zur Validierung
source: Subframe
subframe_id: d3000532-c695-404c-a719-95eb0c6e04b6
subframe: "https://app.subframe.com/f023064a5ca0/design/d3000532-c695-404c-a719-95eb0c6e04b6/edit"
synced: 2026-08-06
---
# S01a — Neuer Chat
> [!info] Single Source of Truth
> [Subframe öffnen](https://app.subframe.com/f023064a5ca0/design/d3000532-c695-404c-a719-95eb0c6e04b6/edit)
![Subframe-Screenshot](https://egniatlvhajtqurt.public.blob.vercel-storage.com/prod/39410/screenshots/d3000532-c695-404c-a719-95eb0c6e04b6-1786024557206.png)
## Zweck und Zustand
Einstieg in das Erstellen einer Unterhaltung. Das Panel trennt drei klare Wege: Gruppe, Projektunterhaltung und Direktnachricht.
## Hauptaktionen
- Nach Personen, Gruppen oder Projekten suchen
- Neue Gruppe anlegen
- Projektbezogene Unterhaltung starten
- Einzelnen Kontakt direkt anschreiben
## Verbindungen
- Direktnachricht → [[S01b Neuer Chat - Auswahl]]
- Neue Gruppe → [[S01c Neue Gruppe]]
- Projektunterhaltung → [[S01d Neue Projektunterhaltung]]
- Schließen → [[S01 Team Chat - Kein Chat ausgewaehlt]]
## Für die Validierung
- [ ] Verstehen Nutzer den Unterschied zwischen Gruppe und Projektunterhaltung sofort?
- [ ] Ist die Kontaktsuche trotz der drei Einstiegsmöglichkeiten eindeutig?
@@ -0,0 +1,41 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: P15 Team-Chat
package: WF-P15 Team-Chat
id: S01b
screen: Neuer Chat - Auswahl
typ: Auswahlpanel
status: Bereit zur Validierung
source: Subframe
subframe_id: ca942cef-fb00-4026-a709-a9d45db5b021
subframe: "https://app.subframe.com/f023064a5ca0/design/ca942cef-fb00-4026-a709-a9d45db5b021/edit"
synced: 2026-08-06
---
# S01b — Neuer Chat: Auswahl
> [!info] Single Source of Truth
> [Subframe öffnen](https://app.subframe.com/f023064a5ca0/design/ca942cef-fb00-4026-a709-a9d45db5b021/edit)
![Subframe-Screenshot](https://egniatlvhajtqurt.public.blob.vercel-storage.com/prod/39410/screenshots/ca942cef-fb00-4026-a709-a9d45db5b021-1786024569128.png)
## Zweck und Zustand
Auswahl genau eines Kontakts für eine Direktnachricht. Der ausgewählte Kontakt wird unten bestätigt, bevor der Chat geöffnet wird.
## Hauptaktionen
- Kontakt suchen und auswählen
- Auswahl ändern
- Direktnachricht über „Chat öffnen“ starten
## Verbindungen
- Zurück → [[S01a Neuer Chat]]
- „Chat öffnen“ → [[S02e Team Chat - Private DM offen 2]]
## Für die Validierung
- [ ] Ist der Einzelauswahl-Modus klar genug?
- [ ] Ist die Auswahlbestätigung vor dem Öffnen hilfreich oder unnötig doppelt?
@@ -0,0 +1,46 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: P15 Team-Chat
package: WF-P15 Team-Chat
id: S04
screen: Medien - Medienuebersicht
typ: Medienverwaltung
status: Bereit zur Validierung
source: Subframe
subframe_id: 4a3be00f-a23c-4f39-b4ad-e57e58a13617
subframe: "https://app.subframe.com/f023064a5ca0/design/4a3be00f-a23c-4f39-b4ad-e57e58a13617/edit"
synced: 2026-08-06
---
# S04 — Medien: Medienübersicht
> [!info] Single Source of Truth
> [Subframe öffnen](https://app.subframe.com/f023064a5ca0/design/4a3be00f-a23c-4f39-b4ad-e57e58a13617/edit)
![Subframe-Screenshot](https://egniatlvhajtqurt.public.blob.vercel-storage.com/prod/39410/screenshots/4a3be00f-a23c-4f39-b4ad-e57e58a13617-1786024542225.png)
## Zweck und Zustand
Globale Medienübersicht über alle Chats. Inhalte sind nach Datum gruppiert und werden als visuelles Raster mit Absender und Chatkontext gezeigt.
## Hauptaktionen
- Zwischen Medien, Dokumenten und Links wechseln
- Suchen und filtern
- Medien auswählen
- Einzelnes Bild im Viewer öffnen
## Verbindungen
- Dokumente → [[S04a Medien - Dokumente]]
- Links → [[S04b Medien - Links]]
- Suche und Filter → [[S04c Medien - Suche _ Filter]]
- Auswahlmodus → [[S04d Medien - Auswahl]]
- Bild öffnen → [[S05 Medienviewer - Bild geoeffnet]]
## Für die Validierung
- [ ] Ist „aus allen Chats“ als globaler Kontext klar?
- [ ] Sind Absender, Chat und Zeitpunkt im Raster ausreichend erkennbar?
- [ ] Sind Suche, Auswahl und Einstellungen passend priorisiert?
@@ -0,0 +1,43 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: P15 Team-Chat
package: WF-P15 Team-Chat
id: S04a
screen: Medien - Dokumente
typ: Medienverwaltung
status: Bereit zur Validierung
source: Subframe
subframe_id: 095d4cdf-f30a-4c94-aab3-df2e760505cb
subframe: "https://app.subframe.com/f023064a5ca0/design/095d4cdf-f30a-4c94-aab3-df2e760505cb/edit"
synced: 2026-08-06
---
# S04a — Medien: Dokumente
> [!info] Single Source of Truth
> [Subframe öffnen](https://app.subframe.com/f023064a5ca0/design/095d4cdf-f30a-4c94-aab3-df2e760505cb/edit)
![Subframe-Screenshot](https://egniatlvhajtqurt.public.blob.vercel-storage.com/prod/39410/screenshots/095d4cdf-f30a-4c94-aab3-df2e760505cb-1786024559156.png)
## Zweck und Zustand
Tabellarische Liste aller in Chats geteilten Dokumente mit Dateiinformation, Beschreibung, Absender und Datum.
## Hauptaktionen
- Dokument öffnen oder herunterladen
- Zwischen Medien und Links wechseln
- Suche, Sortierung oder Einstellungen erreichen
## Verbindungen
- Medien → [[S04 Medien - Medienuebersicht]]
- Links → [[S04b Medien - Links]]
- Suche und Filter → [[S04c Medien - Suche _ Filter]]
## Für die Validierung
- [ ] Sind Dateiname und Beschreibung gut scannbar?
- [ ] Reichen Absender und Datum als Herkunft oder fehlt der Chatkontext?
- [ ] Sind Öffnen und Herunterladen eindeutig unterscheidbar?
@@ -0,0 +1,43 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: P15 Team-Chat
package: WF-P15 Team-Chat
id: S04b
screen: Medien - Links
typ: Medienverwaltung
status: Bereit zur Validierung
source: Subframe
subframe_id: de93f3fa-a6d0-480e-b41f-b27b2e6d8b62
subframe: "https://app.subframe.com/f023064a5ca0/design/de93f3fa-a6d0-480e-b41f-b27b2e6d8b62/edit"
synced: 2026-08-06
---
# S04b — Medien: Links
> [!info] Single Source of Truth
> [Subframe öffnen](https://app.subframe.com/f023064a5ca0/design/de93f3fa-a6d0-480e-b41f-b27b2e6d8b62/edit)
![Subframe-Screenshot](https://egniatlvhajtqurt.public.blob.vercel-storage.com/prod/39410/screenshots/de93f3fa-a6d0-480e-b41f-b27b2e6d8b62-1786024578213.png)
## Zweck und Zustand
Liste aller in Chats geteilten Links mit Domain, Nachrichtenausschnitt, Absender und Zeitpunkt.
## Hauptaktionen
- Link öffnen
- Zur Ursprungsnachricht zurückfinden
- Zwischen Medien und Dokumenten wechseln
## Verbindungen
- Medien → [[S04 Medien - Medienuebersicht]]
- Dokumente → [[S04a Medien - Dokumente]]
- Suche und Filter → [[S04c Medien - Suche _ Filter]]
## Für die Validierung
- [ ] Ist die Kombination aus Domain und Nachrichtenausschnitt ausreichend eindeutig?
- [ ] Braucht jede Zeile eine explizite Aktion „Zur Nachricht“?
- [ ] Ist die Tabelle bei langen URLs stabil?
@@ -0,0 +1,41 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: P15 Team-Chat
package: WF-P15 Team-Chat
id: S04c
screen: Medien - Suche _ Filter
typ: Interaktionszustand
status: Bereit zur Validierung
source: Subframe
subframe_id: b18e02d7-7fe4-4058-8467-ca83bd287fa7
subframe: "https://app.subframe.com/f023064a5ca0/design/b18e02d7-7fe4-4058-8467-ca83bd287fa7/edit"
synced: 2026-08-06
---
# S04c — Medien: Suche und Filter
> [!info] Single Source of Truth
> Der Subframe-Name lautet exakt „S04c Medien - Suche _ Filter“. [Subframe öffnen](https://app.subframe.com/f023064a5ca0/design/b18e02d7-7fe4-4058-8467-ca83bd287fa7/edit)
![Subframe-Screenshot](https://egniatlvhajtqurt.public.blob.vercel-storage.com/prod/39410/screenshots/b18e02d7-7fe4-4058-8467-ca83bd287fa7-1786024583914.png)
## Zweck und Zustand
Geöffnete Suche mit Filtermenü über der Medienübersicht. Filterbar sind Absender und Sortierung nach Neueste, Älteste oder Größe.
## Hauptaktionen
- Nach Absender oder Beschreibung suchen
- Absendergruppe wählen
- Sortierung ändern oder Filter abbrechen
## Verbindungen
- Anwenden oder Abbrechen → [[S04 Medien - Medienuebersicht]]
## Für die Validierung
- [ ] Ist klar, ob Filter sofort oder erst nach Bestätigung wirken?
- [ ] Ist „Größe“ als Sortieroption für alle Medientypen sinnvoll?
- [ ] Genügt der Absenderfilter „Du/Andere“ oder braucht es Personen?
@@ -0,0 +1,37 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-CHAT + AK-P15b
package: WF-P15 Team-Chat
id: M01
screen: Neuer Channel / DM
typ: Modal
umsetzung: Bauen
status: Entwurf
route: "aus S01/S02"
subframe: ""
---
# M01 — Neuer Channel / DM
## Ziel
Ein neuer Gruppen-Channel oder eine Direktnachricht ist schnell erstellt, mit klarer Privatsphäre.
## Was das Tool können muss
- Umschalter: Gruppe / Direktnachricht
- Gruppe: Name, Beschreibung, öffentlich/privat, Mitglieder wählen
- DM: eine oder mehrere Personen suchen; bestehende DM erkennen und öffnen statt Duplikat
- Optional: Projekt verknüpfen nur, wenn aus Projekt-Kontext geöffnet
- Vorschau, wer Zugriff bekommt
- Validierung: Name fehlt, private Gruppe ohne Mitglieder, DM mit sich selbst, fehlende Berechtigung
- Nach Anlegen direkt zu S02
## Pattern / Archetyp
A5 Modal.
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,37 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-CHAT + AK-P15b
package: WF-P15 Team-Chat
id: M02
screen: DM-Audit-Begründung
typ: Modal
umsetzung: Bauen
status: Entwurf
route: "aus S08"
subframe: ""
---
# M02 — DM-Audit-Begründung
## Ziel
Admin-Einsicht in Direktnachrichten ist eine Ausnahmehandlung, nicht normales Browsing.
## Was das Tool können muss
- Zeigt betroffene DM, Mitglieder und Zweck der Einsicht
- Pflichtfeld: Begründung
- Hinweis: Einsicht wird audit-geloggt und im DM sichtbar markiert
- Optional: Session-Dauer anzeigen
- Bestätigen öffnet S02 mit Admin-Audit-Banner
- Abbrechen zurück zu S08
- Validierung: Begründung fehlt/zu kurz, keine `read_all_channels`-Berechtigung
## Pattern / Archetyp
A5 Confirm-/Reason-Modal.
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,40 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-CHAT + AK-P15b
package: WF-P15 Team-Chat
id: S01
screen: Chat-Index
typ: BESPOKE
umsetzung: Bauen
status: Entwurf
route: "/chat"
subframe: ""
---
# S01 — Chat-Index
## Ziel
Der Nutzer sieht sofort, wo etwas Neues passiert ist: ungelesene Channels, @Mentions, Projekt-Chats und DMs.
## Was das Tool können muss
- Channel-Liste mit Name, Avatar/Typ, Snippet, Zeitstempel, Unread-Badge, Mention-Marker, Pin-/Mute-Indikator
- Typen: Projekt-Channel, öffentliche Gruppe, private Gruppe, DM
- Projekt-Channels zeigen Projekt-Status/Stage und Link zum Projekt
- Filter: Alle, Ungelesen, Mentions, Projekt, Gruppen, DMs, Archiviert
- Suche innerhalb der Channel-Liste + Link zur globalen Suche S06
- Channel-Browser/Discover für öffentliche Gruppen
- Schnell-Aktionen je Zeile: anpinnen, stummschalten, als gelesen markieren, archivieren/verlassen je Berechtigung
- CTA: Neuer Channel / DM → M01
- Link: Meine Mentions → S05
- Zustände: keine Channels, nur archivierte Channels, laden, offline/reconnect, keine Berechtigung
## Pattern / Archetyp
BESPOKE-Chat-Index; kompakter, scannbarer Arbeitsbereich statt Marketing-Layout.
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,41 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-CHAT + AK-P15b
package: WF-P15 Team-Chat
id: S02
screen: Channel-Detail
typ: BESPOKE
umsetzung: Bauen
status: Entwurf
route: "/chat/:id"
subframe: ""
---
# S02 — Channel-Detail
## Ziel
Hier wird wirklich gearbeitet: Nachrichten lesen, antworten, Dateien teilen, Threads öffnen, Aufgaben erzeugen.
## Was das Tool können muss
- Header: Channel-Name, Typ, Member-Anzahl, Projekt-Link falls Projekt-Channel, Suche, Settings-Link S07
- Pinned-Preview: max. 3 angepinnte Nachrichten inline + »alle anzeigen« → S04
- Verlauf mit Datums-Trennern und System-Messages
- Nachricht: Avatar, Name, Zeit, Markdown-Body, Mentions, Anhänge, Link-Preview, Edited-/Lösch-Marker
- Reactions: Emoji + Anzahl + wer reagiert hat
- Thread-Indikator: Anzahl Antworten, letzter Reply, Klick → S03
- Read-Receipt: »X von Y gelesen«; DM zeigt gelesen/zugestellt kompakt
- Composer: Markdown, Emoji, @Mention-Autocomplete, Datei-Dropzone, Foto/Anhang, Draft-Autosave
- Typing-Indikator und Reconnect-Banner
- Per-Message-Menü: reagieren, Thread, pinnen, als Aufgabe markieren (WF-P4 M01), Link kopieren, bearbeiten, löschen
- Rechte/States: read-only archiviert, muted, reconnect, Upload-Fehler, pending message, keine Berechtigung
## Pattern / Archetyp
BESPOKE Real-Time-Chat. Stable Composer und Verlauf ohne Layoutsprünge sind wichtiger als dekorative Flächen.
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,37 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-CHAT + AK-P15b
package: WF-P15 Team-Chat
id: S03
screen: Thread-Detail
typ: BESPOKE Panel/Route
umsetzung: Bauen
status: Entwurf
route: "/chat/:id/thread/:thread_id"
subframe: ""
---
# S03 — Thread-Detail
## Ziel
Eine Nebendiskussion bleibt bei der Ausgangsnachricht, ohne den Hauptverlauf zu überfrachten.
## Was das Tool können muss
- Eltern-Nachricht oben vollständig anzeigen (inkl. Anhänge/Reactions)
- Replies chronologisch, mit denselben Message-Elementen wie S02
- Eigener Composer für Replies mit @Mentions, Emoji, Anhängen, Draft
- Link zurück zum Kontext im Channel
- Aktionen: reagieren, pinnen, als Aufgabe markieren, Link kopieren, bearbeiten/löschen je Recht
- Read-Receipt/Seen-Info für Thread-Replies
- Zustände: Thread gelöscht, Ausgangsnachricht gelöscht, keine Berechtigung, reconnect, leerer Thread
## Pattern / Archetyp
BESPOKE-Teilfläche. Kann als Side-Panel oder eigene Route gebaut werden; für die Planung eigener Nachweis-Frame.
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,36 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-CHAT + AK-P15b
package: WF-P15 Team-Chat
id: S04
screen: Angepinnte Nachrichten
typ: A2 Liste
umsetzung: Bauen
status: Entwurf
route: "/chat/:id/pinned"
subframe: ""
---
# S04 — Angepinnte Nachrichten
## Ziel
Wichtige Entscheidungen, Dateien und Hinweise im Channel sind schnell wieder auffindbar.
## Was das Tool können muss
- Liste aller Pins im Channel, max. 50
- Zeile: Nachrichtenausschnitt, Autor, Datum, Pin-Ersteller, Anhänge, Link zum Kontext
- Filter/Suche innerhalb der Pins
- Aktionen: entpinnen, Link kopieren, als Aufgabe markieren
- Hinweis, wenn Pin-Limit erreicht ist
- Zustände: keine Pins, Nachricht gelöscht, keine Berechtigung
## Pattern / Archetyp
A2 Liste als Nebenfläche aus dem Channel.
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,36 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-CHAT + AK-P15b
package: WF-P15 Team-Chat
id: S05
screen: Meine Mentions
typ: A2 Liste
umsetzung: Bauen
status: Entwurf
route: "/chat/mentions"
subframe: ""
---
# S05 — Meine Mentions
## Ziel
Alle @Erwähnungen über Channels hinweg an einem Ort, damit nichts untergeht.
## Was das Tool können muss
- Liste kanalübergreifender Mentions an mich
- Spalten/Zeile: Channel, Projekt falls vorhanden, Nachrichtenausschnitt, Autor, Zeitpunkt, gelesen/ungelesen
- Filter: ungelesen, Projekt, Gruppe, DM, Zeitraum
- Aktionen: öffnen im Kontext, als gelesen markieren, als Aufgabe markieren
- Gruppierung nach Heute / Gestern / Älter
- Zustände: keine Mentions, keine Berechtigung für Channel inzwischen verloren, laden, Fehler
## Pattern / Archetyp
A2 Liste, ähnlich Benachrichtigungen/Aufgaben, aber mit Chat-Kontext.
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,36 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-CHAT + AK-P15b
package: WF-P15 Team-Chat
id: S06
screen: Chat-Suche
typ: A2 Suche
umsetzung: Bauen
status: Entwurf
route: "/chat/search"
subframe: ""
---
# S06 — Chat-Suche
## Ziel
Nachrichten, Dateien und Entscheidungen über alle erlaubten Channels hinweg finden.
## Was das Tool können muss
- Suchfeld mit Ergebnisliste und Treffer-Kontext
- Filter: Channel, Typ, Projekt, Autor, Zeitraum, mit Anhang, nur Pins
- Ergebnis zeigt Snippet mit hervorgehobener Fundstelle, Channel, Autor, Datum, Anhänge
- Klick öffnet S02 an der richtigen Nachricht oder S03 im Thread
- Permission-sicher: nur erlaubte Channels durchsuchen
- Zustände: keine Treffer, zu kurze Suche, Suche läuft, Fehler
## Pattern / Archetyp
A2 Suche mit Chat-spezifischem Kontext.
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,37 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-CHAT + AK-P15b
package: WF-P15 Team-Chat
id: S07
screen: Channel-Einstellungen
typ: A6 Settings
umsetzung: Bauen
status: Entwurf
route: "/chat/:id/settings"
subframe: ""
---
# S07 — Channel-Einstellungen
## Ziel
Channel-Mitglieder, Privatsphäre und Archivierung werden kontrolliert, ohne den Chatverlauf zu beschädigen.
## Was das Tool können muss
- Grunddaten: Name, Beschreibung, Typ (öffentlich/privat/Projekt/DM), Projekt-Verknüpfung falls vorhanden
- Mitgliederliste mit Rolle, Status, zuletzt aktiv; hinzufügen/entfernen je Recht
- Projekt-Channel: Hinweis, dass Mitglieder aus dem Projekt synchronisiert werden
- Privacy-Einstellung für Gruppen (public/private) wenn erlaubt
- Optionen: stummschalten, anpinnen, verlassen, archivieren, wiederherstellen
- Gefahrenbereich: Channel archivieren mit Grund; DM nicht manuell erweiterbar
- Zustände: keine Admin-Rechte, Projekt-Sync überschreibt manuelle Änderung, archivierter Channel read-only
## Pattern / Archetyp
A6 Settings. DM-Settings bewusst reduziert.
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,37 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-CHAT + AK-P15b
package: WF-P15 Team-Chat
id: S08
screen: Admin-Chat-Übersicht
typ: A2/A3 Admin
umsetzung: Bauen
status: Entwurf
route: "/admin/chat"
subframe: ""
---
# S08 — Admin-Chat-Übersicht
## Ziel
Admins können Channels verwalten und im Ausnahmefall auditierbar prüfen, ohne heimliche DM-Einsicht zu ermöglichen.
## Was das Tool können muss
- Tabelle aller Channels: Name, Typ, Mitglieder, Projekt, letzte Nachricht, Status, Archiviert
- Filter: Typ, Projekt, archiviert, private Gruppen, DMs
- Aktionen: öffnen, Mitglieder korrigieren, archivieren, Force-Delete nur mit Berechtigung
- DM öffnen immer nur über M02 (Begründungspflicht)
- Nach Audit-Freigabe: S02 mit sichtbarem **Admin-Einsicht aktiv**-Banner
- Audit-Info: wer, wann, welche Begründung, Session-Ablauf
- Zustände: keine Admin-Berechtigung, Audit-Session abgelaufen, Channel gelöscht
## Pattern / Archetyp
A2/A3 Admin-Fläche mit explizitem Audit-Guard.
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,38 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-CHAT + AK-P15b
package: WF-P15 Team-Chat
id: V01
screen: Monteur-Handy-Chat
typ: BESPOKE-Mobile
umsetzung: Bauen
status: Entwurf
route: "Variante von S02"
subframe: ""
---
# V01 — Monteur-Handy-Chat 📱
## Ziel
Monteurinnen und Monteure schreiben im Projekt-Chat schnell vom Handy: lesen, antworten, Foto senden.
## Was das Tool können muss
- Mobile Channel-Detail-Ansicht mit Fokus auf Projekt-Chat
- Vereinfachter Header: Projekt/Channel, Zurück, Info
- Verlauf touch-tauglich, Anhänge/Fotos groß genug
- Composer mit Text, Foto-Direktupload, @Mention, Senden
- Push-/Unread-Hinweis, Scroll-to-bottom, neue Nachrichten
- Offline/Reconnect: Entwurf bleibt erhalten, Foto wartet auf Upload
- Reduzierte Aktionen: reagieren, Thread öffnen, Foto senden, als Aufgabe markieren
- Keine Admin-/Settings-Komplexität im Mobile-Hauptframe
## Pattern / Archetyp
BESPOKE-Mobile. Dicht und robust, optimiert für Baustelle statt Desktop-Vollumfang.
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,35 @@
{
"nodes": [
{"id":"md-paket","type":"file","file":"02 Wireframes/P15 Team-Chat/WF-P15 Team-Chat/Archiv/Stand vor Subframe-Abgleich 2026-08-06/WF-P15 Team-Chat.md","x":-80,"y":-440,"width":460,"height":280},
{"id":"group-main","type":"group","x":-80,"y":-100,"width":1740,"height":660,"label":"Chat Hauptfläche"},
{"id":"group-side","type":"group","x":1840,"y":-100,"width":1700,"height":660,"label":"Nebenflächen"},
{"id":"group-admin","type":"group","x":3720,"y":-100,"width":1180,"height":660,"label":"Admin & Modals"},
{"id":"note-entry","type":"text","text":"# Einstieg\n\nSidebar → Chat oder Projekt-Detail → Projekt-Channel.\n\nTelefonie bleibt eigenes Paket; dieser Flow ist nur Team-Chat.","x":0,"y":0,"width":360,"height":200},
{"id":"s01","type":"file","file":"02 Wireframes/P15 Team-Chat/WF-P15 Team-Chat/Archiv/Stand vor Subframe-Abgleich 2026-08-06/S01 Chat-Index.md","x":560,"y":0,"width":420,"height":200},
{"id":"s02","type":"file","file":"02 Wireframes/P15 Team-Chat/WF-P15 Team-Chat/Archiv/Stand vor Subframe-Abgleich 2026-08-06/S02 Channel-Detail.md","x":1120,"y":0,"width":420,"height":200},
{"id":"s03","type":"file","file":"02 Wireframes/P15 Team-Chat/WF-P15 Team-Chat/Archiv/Stand vor Subframe-Abgleich 2026-08-06/S03 Thread-Detail.md","x":1120,"y":300,"width":420,"height":200},
{"id":"v01","type":"file","file":"02 Wireframes/P15 Team-Chat/WF-P15 Team-Chat/Archiv/Stand vor Subframe-Abgleich 2026-08-06/V01 Monteur-Handy-Chat.md","x":560,"y":300,"width":420,"height":200},
{"id":"s04","type":"file","file":"02 Wireframes/P15 Team-Chat/WF-P15 Team-Chat/Archiv/Stand vor Subframe-Abgleich 2026-08-06/S04 Angepinnte Nachrichten.md","x":1920,"y":0,"width":420,"height":200},
{"id":"s05","type":"file","file":"02 Wireframes/P15 Team-Chat/WF-P15 Team-Chat/Archiv/Stand vor Subframe-Abgleich 2026-08-06/S05 Meine Mentions.md","x":2480,"y":0,"width":420,"height":200},
{"id":"s06","type":"file","file":"02 Wireframes/P15 Team-Chat/WF-P15 Team-Chat/Archiv/Stand vor Subframe-Abgleich 2026-08-06/S06 Chat-Suche.md","x":3040,"y":0,"width":420,"height":200},
{"id":"s07","type":"file","file":"02 Wireframes/P15 Team-Chat/WF-P15 Team-Chat/Archiv/Stand vor Subframe-Abgleich 2026-08-06/S07 Channel-Einstellungen.md","x":2480,"y":300,"width":420,"height":200},
{"id":"note-task","type":"text","text":"# Wiederverwendet\n\n»Als Aufgabe markieren« öffnet WF-P4 Aufgaben M01 vorbefüllt mit Nachricht, Channel und Link zum Kontext.","x":3040,"y":300,"width":420,"height":200},
{"id":"m01","type":"file","file":"02 Wireframes/P15 Team-Chat/WF-P15 Team-Chat/Archiv/Stand vor Subframe-Abgleich 2026-08-06/M01 Neuer Channel DM.md","x":3800,"y":0,"width":420,"height":200},
{"id":"s08","type":"file","file":"02 Wireframes/P15 Team-Chat/WF-P15 Team-Chat/Archiv/Stand vor Subframe-Abgleich 2026-08-06/S08 Admin-Chat.md","x":4360,"y":0,"width":420,"height":200},
{"id":"m02","type":"file","file":"02 Wireframes/P15 Team-Chat/WF-P15 Team-Chat/Archiv/Stand vor Subframe-Abgleich 2026-08-06/M02 DM-Audit-Begruendung.md","x":4360,"y":300,"width":420,"height":200}
],
"edges": [
{"id":"e-entry","fromNode":"note-entry","fromSide":"right","toNode":"s01","toSide":"left","toEnd":"arrow","styleAttributes":{"path":"dotted"}},
{"id":"e-open","fromNode":"s01","fromSide":"right","toNode":"s02","toSide":"left","toEnd":"arrow","label":"öffnen"},
{"id":"e-thread","fromNode":"s02","fromSide":"bottom","toNode":"s03","toSide":"top","toEnd":"arrow","label":"Thread"},
{"id":"e-mobile","fromNode":"s02","fromSide":"bottom","toNode":"v01","toSide":"top","toEnd":"arrow","label":"Handy"},
{"id":"e-pins","fromNode":"s02","fromSide":"right","toNode":"s04","toSide":"left","toEnd":"arrow","label":"Pins"},
{"id":"e-mentions","fromNode":"s01","fromSide":"right","toNode":"s05","toSide":"left","toEnd":"arrow","label":"Mentions"},
{"id":"e-search","fromNode":"s01","fromSide":"right","toNode":"s06","toSide":"left","toEnd":"arrow","label":"Suche"},
{"id":"e-settings","fromNode":"s02","fromSide":"right","toNode":"s07","toSide":"left","toEnd":"arrow","label":"Settings"},
{"id":"e-new","fromNode":"s01","fromSide":"right","toNode":"m01","toSide":"left","toEnd":"arrow","label":"neu"},
{"id":"e-admin-reason","fromNode":"s08","fromSide":"bottom","toNode":"m02","toSide":"top","toEnd":"arrow","label":"DM öffnen"},
{"id":"e-admin-open","fromNode":"m02","fromSide":"left","toNode":"s02","toSide":"right","toEnd":"arrow","label":"Audit-Banner"},
{"id":"e-task-note","fromNode":"note-task","fromSide":"left","toNode":"s02","toSide":"right","toEnd":"arrow","styleAttributes":{"path":"dotted"}}
]
}
@@ -0,0 +1,144 @@
---
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](<WF-P15 Team-Chat.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)*
@@ -0,0 +1,26 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: P15 Team-Chat
package: WF-P15 Team-Chat
id: S01h
screen: Admins festlegen
typ: Einstellungen
status: Archiviert
source: Subframe
subframe_id: e5dbaec6-4cbd-417d-8f9a-fee8544d12f1
subframe: "https://app.subframe.com/f023064a5ca0/design/e5dbaec6-4cbd-417d-8f9a-fee8544d12f1/edit"
synced: 2026-08-06
archived: 2026-08-07
replaced_by: "S01g Mitglieder verwalten"
---
# S01h — Admins festlegen (archivierter Stand)
Der separate Admin-Screen wurde am 07.08.2026 durch die direkte Admin-Spalte in [[../../Screens/S01g Mitglieder verwalten]] ersetzt. Die damalige Subframe-Seite wurde anschließend für „Chat-Einstellungen“ wiederverwendet.
![Subframe-Screenshot](https://egniatlvhajtqurt.public.blob.vercel-storage.com/prod/39410/screenshots/e5dbaec6-4cbd-417d-8f9a-fee8544d12f1-1786024616380.png)
## Früherer Zweck
Mehrfachauswahl der Gruppenadmins. Bestehende Admins und weitere Mitglieder waren getrennt; eine Zusammenfassung zeigte die aktuelle Auswahl.