fotospiel-app/docs/changes/2025-10-05-checkout-refactor-todo.md

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.
• Redesign the payment step: Stripe and PayPal happy path, failure, retry; add subscription handling for reseller plans.
• Update the confirmation step and surface the admin link inside resources/js/pages/Profile/Index.tsx.

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.
• Audit existing marketing payment flows (resources/js/pages/marketing/PurchaseWizard.tsx, PaymentForm.tsx) and plan removals or migration.

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.
• 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.
• Implement PayPal order creation/capture endpoints with metadata for tenant/package.
• 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.