Snider
4e4337e412
feat(commerce): implement RFC.md — billing, subscriptions, Stripe + BTCPay, Commerce Matrix (#845)
Extends prior #860 DunningService with the full RFC.md surface.
Lands across 44 modified/new files:
* Contracts/PaymentGatewayContract.php — implemented by both
Services/StripeGateway.php and Services/BTCPayGateway.php
* Boot.php — provider bindings + route groups + Commerce Matrix training
mode middleware
* Services/WebhookService.php — DB::transaction wrapping + ProcessWebhookEvent
job dispatched ->afterCommit; idempotency via webhook_events unique
(gateway, event_id) — duplicates rejected silently
* Jobs/ProcessWebhookEvent.php
* DTOs/ — readonly PHP 8.2+ classes per RFC.dto.md
* Services/SubscriptionStateMachine.php — active → suspended (failed
payment) → cancelled → expired transitions
* Services/ProrationService.php — credit unused old plan time, charge
new plan remainder, applied via CreditNote + Invoice
* DunningService extended — 1d/3d/7d/14d retry config + cancel
* Migrations — guarded migrations for missing short-name billing tables
(orders/payments/invoices) + RFC compatibility columns
* routes/api.php — /v1/* endpoints
* Checkout success/cancel routes
* Commerce Matrix training-mode endpoint + record-permissions logic
* Console/Commands — RFC.commands.md signatures
* Events per RFC.events.md
* Models extended
php -l clean. composer validate passes. pest unrunnable in sandbox.
Co-authored-by: Codex <noreply@openai.com>
Closes tasks.lthn.sh/view.php?id=845