soeren/fotospiel-app
1
0
Fork 0
Code Issues Pull Requests Actions 2 Packages Projects Releases Wiki Activity
Files
b3ea522e31a73f404113a97164f52f14b59f08c7
fotospiel-app/docs/archive/process/todo/package-limit-experience-overhaul.md
Codex Agent 6afa44d947 huge documentaton restructure for docusaurus
2025-11-20 10:44:29 +01:00

3.5 KiB
Raw Blame History

Package Limit Experience Overhaul

Status: Planned
Owner: Codegen Agent
Related Areas: Packages, Tenant Admin PWA, Guest PWA, Notifications

Motivation

  • Uneinheitliche Limit-Prüfungen (Public Upload vs. Admin Upload vs. Event-Erstellung).
  • Fehlende, generische oder kryptische Fehlermeldungen im Admin-Frontend.
  • Keine Frühwarnungen bei 80 %/95 % Auslastung, kein Countdown für Galerien.
  • Fehlende Automatisierung für E-Mail-/In-App-Warnungen bei kritischen Zuständen.

High-Level Goals

  1. Konsistente Limit-Prüfungen & Fehlercodes im Backend.
  2. Verbesserte UX in Guest & Tenant Admin PWA (Warnungen, klare Fehlermeldungen).
  3. Proaktive Benachrichtigungen (E-Mail, In-App) bei bevorstehenden Grenzwerten / Ablauf.
  4. Monitoring, Dokumentation, Tests für alle neuen Abläufe.

Work Breakdown

1. Backend Unification

  • Paket-Limit-Service erstellen (Fotos, Gäste, Aufgaben, Events/Jahr, Galerie-Laufzeit). (Initial evaluator + Middleware Integration für Events/Fotos)
  • Public Uploads um Paketlimit-Prüfung erweitern (inkl. Events ohne Aktivpaket blockieren). (Guest Upload prüft & erhöht Zähler)
  • Konsistentes Fehler-Response-Schema (code, title, message, meta) implementieren.
  • Domain-Events für Grenzwerte & Ablaufzustände emitten.
  • Feature-/Unit-Tests für neue Services & Events.

2. Threshold Detection & Storage

  • Schwellenwerte konfigurieren (Fotos/Gäste, Gallery D-7/D-1).
  • Scheduler/Jobs für regelmäßige Galerie-Checks.
  • Persistenz für Galerie-Benachrichtigungen (warning/expired timestamps).

3. Guest PWA Improvements

  • Limit-Status im Upload-Flow anzeigen (Warnbanner + Sperrzustände).
  • Upload-Fehlercodes auswerten und freundliche Dialoge zeigen.
  • Galerie-Countdown/Badge für Ablaufdatum + Call-to-Action.
  • E2E-Tests für Limitwarnungen & abgelaufene Galerie aktualisieren.

4. Tenant Admin PWA Improvements

  • Dashboard-Karten & Event-Header mit Ampelsystem für Limitfortschritt.

  • Event-Formular: Warnhinweise bei 80 %/95 % + Upgrade-CTA.

  • Globale Fehlerzustände aus Fehlerkontrakt (Toast/Dialog).

  • Übersetzungen für alle neuen Messages hinzufügen.

  • E-Mail-Schablonen & Notifications für Foto- und Gäste-Schwellen/Limits.

  • Galerie-Warnungen (D-7/D-1) & Ablauf-Mails + Cron Task.

  • Weitere Benachrichtigungen (Paket-Ablauf, Reseller-Eventlimit, Credits fast leer).

  • Opt-in/Opt-out-Konfiguration pro Tenant implementieren.

  • In-App/Toast-Benachrichtigungen für Admin UI (und optional Push/Slack intern).

  • Audit-Log & Retry-Logik für gesendete Mails.

6. Monitoring, Docs & Support

  • Prometheus/Grafana-Metriken für Paketnutzung & Warns triggern. (PackageLimitMetrics + php artisan metrics:package-limits Snapshot)
  • PRP & API-Doku mit neuem Fehlerschema & Limitverhalten aktualisieren.
  • Support-Playbook & FAQ für Limitwarnungen erweitern. (docs/prp/06 Tenant Admin Playbook Abschnitt)

Dependencies & Notes

  • Bestehende Credit-Logik parallel weiter unterstützen (Legacy-Kunden).
  • Paddle/E-Mail-Dienste müssen auf Sandbox getestet werden.
  • Mehrsprachigkeit (de/en) sicherstellen.

Definition of Done

  • Alle relevanten Grenzwerte serverseitig validiert und getestet.
  • Frontends zeigen spezifische Warnungen + Handlungsanweisungen.
  • Benachrichtigungssystem verschickt Mails bei konfigurierten Schwellen.
  • Monitoring & Dokumentation sind aktualisiert.
  • Regressionstests und neue Tests laufen grün.
Reference in New Issue View Git Blame Copy Permalink