51 lines
3.5 KiB
Markdown
51 lines
3.5 KiB
Markdown
# 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.
|