Files
fotospiel-app/docs/changes/2025-10-05-checkout-refactor-todo.md
Codex Agent a949c8d3af - Wired the checkout wizard for Google “comfort login”: added Socialite controller + dependency, new Google env
hooks in config/services.php/.env.example, and updated wizard steps/controllers to store session payloads,
attach packages, and surface localized success/error states.
- Retooled payment handling for both Stripe and PayPal, adding richer status management in CheckoutController/
PayPalController, fallback flows in the wizard’s PaymentStep.tsx, and fresh feature tests for intent
creation, webhooks, and the wizard CTA.
- Introduced a consent-aware Matomo analytics stack: new consent context, cookie-banner UI, useAnalytics/
useCtaExperiment hooks, and MatomoTracker component, then instrumented marketing pages (Home, Packages,
Checkout) with localized copy and experiment tracking.
- Polished package presentation across marketing UIs by centralizing formatting in PresentsPackages, surfacing
localized description tables/placeholders, tuning badges/layouts, and syncing guest/marketing translations.
- Expanded docs & reference material (docs/prp/*, TODOs, public gallery overview) and added a Playwright smoke
test for the hero CTA while reconciling outstanding checklist items.
2025-10-19 11:41:03 +02:00

3.7 KiB

Checkout Refactor TODOs (2025-10-05)

Scope

  • Marketing checkout only; guest and admin PWAs stay untouched.
  • Replace existing marketing purchase wizard and supporting auth/payment endpoints.

Action Items

Wizard Foundations

  • Rebuild the package step with a side panel for comparable packages and reset payment state when the selected package changes (see resources/js/pages/marketing/checkout/steps/PackageStep.tsx).
  • Redesign the payment step: Stripe and PayPal happy path, failure, retry; add subscription handling for reseller plans. (Stripe intent lifecycle + PayPal subscription flow now share status alerts, retry logic, and plan gating in PaymentStep.tsx.)
  • Update the confirmation step and surface the admin link inside resources/js/pages/Profile/Index.tsx. (Handled via ConfirmationStep.tsx + wizard callbacks redirecting to /settings/profile and /event-admin.)

Authentication & Profile Data

  • Refactor resources/js/pages/auth/LoginForm.tsx and RegisterForm.tsx to hit the correct routes, surface inline validation errors, and provide success callbacks.
  • Add optional comfort login: Google sign-in and enrichment of missing registration fields via the payment provider, combining the prior step 2/3 concept.

Backend Alignment

  • Implement a dedicated CheckoutController plus marketing API routes, migrating any remaining checkout logic out of the marketing controller. (Controller + routes now live in app/Http/Controllers/CheckoutController.php / routes/web.php.)
  • Audit existing marketing payment flows (resources/js/pages/marketing/PurchaseWizard.tsx, PaymentForm.tsx) and plan removals or migration. (Legacy components removed; new wizard replaces them.)

Quality & Rollout

  • Expand automated coverage: Playwright end-to-end scenarios for auth, payment success/failure, Google login; PHPUnit and webhook tests for new checkout endpoints. (Feature + unit suites cover Stripe intents, PayPal webhooks, Google comfort login; Playwright CTA smoke in place—full payment journey available behind the checkout tag.)
  • Update docs (PRP, docs/changes) and plan a feature-flag rollout for the new wizard.

Notes

  • Wizard auth now uses /checkout/login and /checkout/register JSON endpoints handled by CheckoutController.
  • Ensure payment step parity during migration so existing paid funnels do not regress prior to feature flag activation.
  • 2025-10-05: Checkout wizard skeleton created (resources/js/pages/marketing/checkout/*); awaiting payment/Auth wiring and backend API handoff.
  • 2025-10-05: Payment architecture blueprint authored in docs/prp/marketing-checkout-payment-architecture.md.
  • 2025-10-05: checkout_sessions migration + service scaffolding committed (app/Models/CheckoutSession.php, app/Services/Checkout/*, config/checkout.php).

Payment Integration Plan

  • Define provider-agnostic payment state machine (intent creation, approval, capture, failure). See docs/prp/marketing-checkout-payment-architecture.md.
  • Scaffold checkout_sessions migration + service layer per docs/prp/marketing-checkout-payment-architecture.md.
  • Implement Stripe PaymentIntent endpoint returning client_secret scoped to wizard session. (Covered by CheckoutController::createPaymentIntent.)
  • Implement PayPal order creation/capture endpoints with metadata for tenant/package. (Routes now exposed in routes/web.php; controller derives tenant context for authenticated users.)
  • Add webhook handling matrix for Stripe invoice/payment events and PayPal subscription lifecycle.
  • Wire payment step UI to new endpoints with optimistic and retry handling. (See PaymentStep.tsx for Stripe intent loading + PayPal order/subscription creation and capture callbacks.)