mivita/app/Console/Commands/StripeBackfillCustomers.php

<?php

namespace App\Console\Commands;

use App\Models\ShoppingPayment;
use App\Models\ShoppingUser;
use App\Services\Payment\Stripe\StripeClientWrapper;
use App\Services\Payment\Stripe\StripeCustomerService;
use Illuminate\Console\Command;

/**
 * Trägt Name und Rechnungsanschrift an bestehenden Stripe-Customern nach
 * (Plan dev/2026-08-26-stripe/, Phase SE1.5).
 *
 * Hintergrund: Vor SE1 legte Stripe die Customer für Abo-Zahlungen selbst an
 * (`customer_creation: 'always'`) — ohne Namen. In der Buchhaltung stand
 * deshalb nur die E-Mail. Dieses Command verknüpft die vorhandenen Customer
 * mit unseren Kundendatensätzen und aktualisiert sie.
 *
 * Mit `--refresh` werden stattdessen die bereits verknüpften Customer neu
 * beschrieben — nötig, wenn sich das Namensformat ändert.
 */
class StripeBackfillCustomers extends Command
{
    protected $signature = 'stripe:backfill-customers
        {--refresh : Auch bereits verknüpfte Customer aktualisieren (z. B. nach einer Änderung des Namensformats)}
        {--dry-run : Nichts an Stripe senden, nur anzeigen was passieren würde}
        {--limit=0 : Maximale Anzahl bearbeiteter Kunden (0 = alle)}';

    protected $description = 'Trägt Name/Anschrift an bestehenden Stripe-Customern nach (Phase SE1)';

    public function handle(StripeClientWrapper $stripe, StripeCustomerService $customerService): int
    {
        if (! $stripe->isConfigured()) {
            $this->error('STRIPE_SECRET ist nicht gesetzt.');

            return self::FAILURE;
        }

        $dryRun = (bool) $this->option('dry-run');
        $limit = (int) $this->option('limit');

        $refresh = (bool) $this->option('refresh');

        $query = ShoppingUser::query()->orderBy('id');

        if ($refresh) {
            // Bereits verknüpfte Kunden neu an Stripe schreiben.
            $query->whereNotNull('stripe_customer_id');
        } else {
            // Noch nicht verknüpfte Kunden, für die Stripe selbst einen
            // (namenlosen) Customer angelegt hat.
            $query->whereNull('stripe_customer_id')
                ->whereHas('shopping_orders.shopping_payments', function ($q) {
                    $q->where('payment_provider', 'stripe')->whereNotNull('stripe_customer_id');
                });
        }

        $linked = 0;
        $updated = 0;
        $failed = 0;

        $query->chunkById(100, function ($shoppingUsers) use (&$linked, &$updated, &$failed, $customerService, $dryRun, $limit, $refresh): bool {
            foreach ($shoppingUsers as $shoppingUser) {
                $customerId = $refresh
                    ? $shoppingUser->stripe_customer_id
                    : $this->existingCustomerIdFor($shoppingUser);

                if ($customerId === null) {
                    continue;
                }

                $this->line(sprintf(
                    '#%d %s → %s',
                    $shoppingUser->id,
                    StripeCustomerService::customerNameFor($shoppingUser) ?? '(ohne Namen)',
                    $customerId,
                ));

                if ($dryRun) {
                    $linked++;

                    continue;
                }

                try {
                    if (! $refresh) {
                        $shoppingUser->forceFill(['stripe_customer_id' => $customerId])->save();
                    }
                    $linked++;
                    $customerService->updateCustomer($customerId, $customerService->customerPayloadFor($shoppingUser));
                    $updated++;
                } catch (\Throwable $e) {
                    $failed++;
                    $this->error(sprintf('Kunde #%d (%s): %s', $shoppingUser->id, $customerId, $e->getMessage()));
                }

                if ($limit > 0 && $linked >= $limit) {
                    return false;
                }
            }

            return true;
        });

        $this->info(sprintf(
            '%s: %d %s, %d bei Stripe aktualisiert, %d fehlgeschlagen.',
            $dryRun ? 'Probelauf' : 'Fertig',
            $linked,
            $refresh ? 'geprüft' : 'verknüpft',
            $updated,
            $failed,
        ));

        return $failed > 0 ? self::FAILURE : self::SUCCESS;
    }

    /**
     * Die Stripe-Customer-ID, die Stripe bei einer früheren Zahlung dieses
     * Kunden selbst angelegt hat (jüngste zuerst).
     */
    private function existingCustomerIdFor(ShoppingUser $shoppingUser): ?string
    {
        $orderIds = $shoppingUser->shopping_orders()->pluck('id');

        if ($orderIds->isEmpty()) {
            return null;
        }

        return ShoppingPayment::whereIn('shopping_order_id', $orderIds)
            ->whereNotNull('stripe_customer_id')
            ->latest('id')
            ->value('stripe_customer_id');
    }
}