Detaillierte PRP für Tenant Admin App (Capacitor + Framework7)

Status

Aktualisiert: 2025-10-17 (Onboarding Fusion & QR Revamp)
Version: 1.2.0
Autor: Core Platform Team (Codex)
Supersedes: docs/prp/06-tenant-admin-pwa.md (legacy Framework7 reference)

Überblick

Diese detaillierte Product Requirement Plan (PRP) beschreibt die Spezifikationen für die Tenant Admin App. Die App ist eine store-ready mobile Anwendung, die mit Capacitor für iOS und Trusted Web Activity (TWA) für Android gepackt wird. Die UI basiert auf Framework7 für ein natives Mobile-Erlebnis. Die App ermöglicht Tenant-Admins (z.B. Event-Organisatoren) die vollständige Verwaltung ihrer Events, Galerien, Mitglieder, Einstellungen und Käufe über eine API-first Backend-Integration.

Die App ersetzt das frühere Filament-basierte Tenant-Panel und fokussiert auf eine Mobile-First-UX mit Offline-Fähigkeiten, Push-Notifications und sicherer Authentifizierung. Sie respektiert das Multi-Tenancy-Modell und GDPR-Anforderungen. Seit Oktober 2025 wird das UI in React 19 + Vite + Tailwind/shadcn/ui umgesetzt; die alte Framework7-Schicht bleibt nur als historische Referenz erhalten.

Aktuelle Highlights (Q4 2025)

Geführtes Onboarding: /event-admin/welcome/* orchestriert den Welcome Flow (Hero → How-It-Works → Paketwahl → Zusammenfassung → Event Setup). Guarding erfolgt über onboarding_completed_at.
Direkter Checkout: Paddle sind in die Paketwahl des Welcome Flows eingebettet; Fortschritt wird im Onboarding-Context persistiert.
Filament Wizard: Für Super-Admins existiert ein paralleler QR/Join-Token-Wizard in Filament (Token-Generierung, Layout-Downloads, Rotation).
Join Tokens only: Gäste erhalten ausschließlich join-token-basierte Links/QRs; slug-basierte URLs wurden deaktiviert. QR-Drucklayouts liegen unter resources/views/pdf/join-tokens/*.
Auth Alignment: Sanctum-PATs über /api/v1/tenant-auth/login + /tenant-auth/exchange; siehe docs/prp/tenant-app-specs/api-usage.md.

Kernziele

Deliverables: Voll funktionsfähige App mit CRUD-Operationen für Tenant-Ressourcen (Events, Photos, Tasks, etc.).
UI/UX: Framework7-Komponenten für konsistente, native Mobile-Interfaces (iOS/Android).
Technologie-Stack: React/Vite (Core), Framework7 (UI), Capacitor (Native), Sanctum PATs (Auth).
Distribution: App Store (iOS), Google Play (Android), PWA-Install (Web).

Struktur dieser PRP

README.md: Dieser Überblick.
functional-specs.md: Funktionale Anforderungen, Capabilities und API-Integration.
pages-ui.md: Detaillierte Seitenbeschreibungen, Framework7-Komponenten und Wireframe-Ideen.
settings-config.md: App- und Tenant-spezifische Einstellungen, Capacitor-Plugins.
capacitor-setup.md: Packaging, Distribution und Native-Features.

Referenzen

Haupt-PRP: docs/prp/README.md
Tenancy: docs/prp/02-tenancy.md
API: docs/prp/03-api.md
Bestehende Tenant PWA: docs/prp/06-tenant-admin-pwa.md
Addendum: docs/prp-addendum-2025-09-08-tenant-admin-pwa.md
ADR: docs/adr/ADR-0006-tenant-admin-pwa.md
Billing: docs/prp/08-billing.md
Glossar: docs/prp/99-glossary.md

Änderungen und Erweiterungen

Diese PRP erweitert die knappe Beschreibung in 06-tenant-admin-pwa.md um:

Spezifische Seiten und UI-Elemente mit Framework7.
Detaillierte Settings und Capacitor-Integration.
Mobile-spezifische Features wie Push-Notifications und Offline-Sync.

Für Feedback oder Änderungen: Siehe TODO.md oder Issues.

3.5 KiB Raw Blame History