fotospiel-app/docs/todo/tenant-admin-onboarding-fusion.md

Tenant Admin Onboarding Fusion TODO

Created: 2025-10-10 Owner: Codex (handoff)

Context

• Blend the immersive welcome + ordering journey from fotospiel-tenant-app/tenant-admin-app with the new management modules under /event-admin.
• Align with the detailed PRP (docs/prp/tenant-app-specs/*.md) and onboarding plan notes (docs/changes/2025-10-10-tenant-admin-onboarding-plan.md).
• Preserve existing dashboard/events/tasks/billing screens while introducing a guided first-run experience and mobile-first polish.

References

• docs/prp/tenant-app-specs/README.md
• docs/prp/tenant-app-specs/pages-ui.md
• docs/prp/tenant-app-specs/functional-specs.md
• docs/changes/2025-10-10-tenant-admin-onboarding-plan.md
• resources/js/admin/router.tsx
• resources/js/admin/components/AdminLayout.tsx
• resources/js/admin/pages/DashboardPage.tsx
• fotospiel-tenant-app/tenant-admin-app/src/App.tsx (legacy welcome flow)

Priority: Now ( unblock design + scope )

• Audit the legacy Capacitor app assets (intro carousel, package picker, CTA cards, animation helpers) and list what should be ported or rebuilt in Tailwind/React. Capture findings in docs/changes/2025-10-10-tenant-admin-onboarding-plan.md with component parity notes. See "Component Audit - 2025-10-10".
• Define shared onboarding design primitives inside Laravel PWA (e.g. gradient backgrounds, full-height hero layout, swipeable stepper). Propose implementation sketch for new components such as TenantWelcomeLayout and WelcomeStepCard. Documented under "Proposed Laravel PWA Welcome Primitives".

Priority: Next ( build the welcome flow )

• Introduce /event-admin/welcome/* routes and constants, plus a lightweight layout distinct from AdminLayout. Update resources/js/admin/router.tsx and resources/js/admin/constants.ts accordingly.
• Implement onboarding steps (Hero, HowItWorks, PackageSelection, OrderSummary, FirstEventSetup) that reuse existing APIs (getTenantPackagesOverview, createEvent, checkout helpers). Landing, package, summary, and setup screens are live; summary links to Billing for payments, direct in-flow checkout still TBD.
• Persist onboarding progress (e.g. useOnboardingProgress in auth context or dedicated store) and add guard logic so tenants without active events land on the welcome flow after login. Provide a way to resume the flow from the dashboard CTA.
• Refresh DashboardPage.tsx to surface the new welcome CTA ("Plan your first event") and quick links back into the guided flow without breaking existing management cards. Guided setup card and header action now link to /event-admin/welcome.

Priority: Later ( polish + delivery )

• Align theming, typography, and transitions with the legacy mobile look (consider porting key styles from fotospiel-tenant-app/tenant-admin-app/src/styles). Tenant admin layout now reuses marketing brand palette, fonts, and gradient utilities; Tailwind variables capture the shared tokens.
• Review PWA manifest/offline setup so the combined welcome + management flow works for Capacitor/TWA packaging. Note required updates in public/manifest.json and build scripts.
• Extend docs: update PRP onboarding sections and add a walkthrough video/screencaps under docs/screenshots/tenant-admin-onboarding. Capture test scope for future Playwright/E2E coverage.
• Add automated coverage (React Testing Library for step flows, feature tests for routing guard) once implementation stabilises. Playwright spec tests/e2e/tenant-onboarding-flow.test.ts now executes with seeded creds—extend it to cover Stripe/PayPal happy paths and guard edge cases.
• Finalise direct checkout in the welcome summary. Stripe + PayPal hooks are live; add mocked/unit coverage and end-to-end assertions before rolling out broadly.
• Lokalisierung ausbauen: Landing-, Packages-, Summary- und Event-Setup-Screens sind nun DE/EN übersetzt; Copy-Review für weitere Module (Tasks/Billing/Members) bleibt offen.

Risks & Open Questions

• Confirm checkout UX expectations (Stripe vs PayPal) before wiring package purchase into onboarding.
• Validate whether onboarding flow must be localized at launch; coordinate mit den neuen i18n JSONs und fehlenden Übersetzungen.
• Determine deprecation plan for fotospiel-tenant-app/tenant-admin-app once the merged flow ships.