53 lines
4.4 KiB
Markdown
53 lines
4.4 KiB
Markdown
# 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
|