Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/VA-P30b.md
T

53 lines
4.4 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.
# VA-P30b · P30 Querschnitt: Notif-Bündelung/Quiet-Hours (M117) + Sprach-Wechsler/EN (M029)
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Akeshan |
| **Phase** | P30 — Komfort & Querschnitt · v2-P10 |
| **Cycle/Fenster** | v2-W3 — Admin/Help/Dashboard/v2-Launch · fällig 2026-07-31 |
| **Status** | geplant |
## Abhängigkeiten & Parallelität
- **Blocked by:** `AK-P3` (Notification-Center — `notify()`/Notification-Modell aus v1), `R-P1b` (i18n-Library + DE-Locale aus v1)
- **Blocks:** —
- **Läuft parallel zu:** `VA-P30a` (Dashboard-Deluxe — gleiche Phase, getrennte Domänen), sowie `VA-P28b`/`VA-P29` im W3-Slot. Additive v2-Tabellen + i18n-JSON-Files.
- **Konflikt-Risiko:** gering — **Delta-Phase, kein Neubau**; `notify()` und i18n-Library stehen aus v1, hier nur Bündel-/Quiet-Hours-Resolver + EN-Locale.
## Was wir bauen
Zwei Querschnitts-Komfort-Deltas (M117/M029, kein Neubau): **Notification-Bündelung** (gleicher `event_type_group` in 5-Min-Window → **1 Push/Mail mit count**) + **Quiet-Hours** (queued, **Urgent-Override**) + pro-User-Präferenzen **Event×Kanal**; sowie ein **Sprach-Wechsler** (Profil + Public) und ein per **DeepL (DE→EN, mit Review)** befülltes **EN-Locale** mit Build-Validierung, Fallback DE und **Empfänger-Sprach-Auflösung** für Outbound-Mails.
## Benötigte Screens (Backend bedient — Design liefert `D-P30`)
| Screen [Route] | Kern-Inhalt |
|---|---|
| Notification-Präferenzen-Editor [`/settings/notifications`] | Matrix **Event×Kanal** (an/aus), Bündelungs-Verhalten |
| Quiet-Hours-Einstellung [`/settings/notifications`] | Ruhezeit-Fenster, **Urgent-Override**-Regel |
| Sprach-Wechsler [Profil + Public] | Sprachauswahl im Profil und im Public-Bereich, Fallback-Hinweis DE |
| Tenant-Default-Sprache [`/admin/settings`] | Tenant-weite Default-Sprache, **Empfänger-Sprach-Auflösung Outbound** |
## Definition of Done
- [ ] **Notif-Bündelung** (gleicher `event_type_group` in 5-Min-Window → **1 Push/Mail mit count**)
- [ ] **Quiet-Hours** (queued, **Urgent-Override**) + Pro-User-Präferenzen **Event×Kanal**
- [ ] **Sprach-Wechsler** + **EN-Locale** (DeepL DE→EN mit Review) + **Empfänger-Sprach-Auflösung**
- [ ] Vollständige **Build-Validierung** der Locales + **Fallback DE**
- [ ] Wiederverwendung v1: `notify()` (AK-P3), i18n-Library + DE-Locale (R-P1b)
- [ ] **RLS** auf `NotificationPreference`/`NotificationQuietHours`
## Technische Bausteine
- **Entities** (Delta, AD-21): `Notification` (recipient_user_id, event_type, title/body, deeplink, priority, read_at, **bundle_id**), `NotificationPreference` (user_id, event_type, channel_in_app/email/push, priority_threshold), `NotificationBundle` **[v2]** (event_type_group, count, bundle_window_seconds), `NotificationQuietHours` **[v2]** (user_id, weekday, start/end_time, urgent_override). i18n: **keine eigene Tabelle** — Strings in JSON-Files; Felder `User.language`, `Tenant.default_language`, `Kontakt.language`.
- **Bundle-Manager:** 5-Min-Window-Aggregation gleicher `event_type_group` → 1 Push/Mail mit count, persistiert über `bundle_id`.
- **Quiet-Hours-Resolver:** queued außerhalb des Fensters; **Urgent-Override** bricht Quiet-Hours; Pro-User-Präferenzen Event×Kanal aus `NotificationPreference`.
- **i18n:** EN-Locale via **DeepL (DE→EN) mit Review**; **Build-Validierung** (vollständige Keys, Fallback DE); Sprach-Wechsler (Profil + Public); **Empfänger-Sprach-Auflösung** Outbound (User.language / Tenant.default_language / Kontakt.language). Chat-Auto-Übersetzung koppelt an M13 + EU-LLM (P4) — hier nur i18n-Fundament.
## Quellen (granular)
- `ROADMAP-V2.md` → **§v2-P10 Komfort & Querschnitt** (Notif-/i18n-Teil = Hauptquelle; Recut „Delta, kein Neubau")
- `ENTITY-MODEL.md` → **Domäne 2: Querschnitt** (`Notification`/`NotificationPreference`/`NotificationBundle`/`NotificationQuietHours`; i18n = JSON-Files + `User.language`/`Tenant.default_language`/`Kontakt.language`)
- `ROADMAP.md` → Phase 30 · `PHASE-SOURCES.md` → Phase 30 (M117 Notif-Bündelung + Quiet-Hours, M029 Sprach-Wechsler + EN)
- `designer-briefs/P30-dashboard-deluxe-querschnitt.md` (Notif-Präferenz-Matrix, Quiet-Hours, Sprach-Wechsler, Empfänger-Sprach-Auflösung)
- `_bmad-output/specs/M22-notifications.md` (Bündelung), `M30-i18n.md` (Wechsler/EN)
## Dev-Nachzug (nach Davids `D-P30`-Delta)
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
- [ ] Plane-Ticket `VA-P30b` aktualisiert