Konsolidierter Entwicklungsplan aus den zwei Analyse-Dokumenten plus
Umsetzung der Phase-0-Massnahmen (Korrektheit/Security, je mit Tests):
0.1 BasicAuth: timing-sicherer Vergleich (hash_equals, beide Felder ohne
Short-Circuit); Enabled-Check zur Laufzeit via config('auth.basic.*')
statt env() im Bootstrap-Closure (greift jetzt unter config:cache);
Config-Block + .env.example. Fund: auth.basic.* war nie als Config
definiert, Gate war faktisch unkonfigurierbar.
0.2 Legacy-Invoice-"latest"-Abfrage zentralisiert (LegacyInvoice::
scopeLatestFirst + User::latestLegacyInvoice); beide Consumer N+1-frei
umgestellt; unterschiedliches null-Verhalten bewusst erhalten.
0.3 Payment-Option-Eligibility vereinheitlicht (period-aware, strikt):
UserPaymentOption::scopeActiveNow/grandfatheredNow + User::
hasActivePaymentOption; hasActiveBooking/hasUnlimitedPressReleaseQuota
und ApiAccessEligibilityService darauf umgestellt; $hasGrandfathered-
Mislabel behoben.
0.4 Theme->Portal-Vokabular: totes, projektfremdes ThemeMiddleware
geloescht; Mapping in Portal::fromTheme() zentralisiert; fremden
b2in-Default im ThemeServiceProvider auf Portal-Default korrigiert.
0.5 InvoiceNumberGenerator: Erst-Insert race-sicher via insertOrIgnore
(Unique-Index auf circle existiert bereits). CreditWalletService war
bereits abgesichert (Unique-Index + createOrFirst).
Tests: 4 neue Dateien, 5 bestehende auf gueltiges grandfathered_until
angepasst. Volle Suite gruen (793 passed, 1 skipped).
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
68 lines
2.2 KiB
PHP
68 lines
2.2 KiB
PHP
<?php
|
|
|
|
namespace App\Services\Billing;
|
|
|
|
use Illuminate\Support\Facades\DB;
|
|
use InvalidArgumentException;
|
|
|
|
/**
|
|
* Vergibt fortlaufende Rechnungsnummern pro Rechnungskreis (hybrides Modell):
|
|
*
|
|
* - `STR` — neuer Stripe-Shop-Kreislauf (alle neuen Abschlüsse/Zahlungen)
|
|
* - `MAN` — manueller Legacy-Kreis ab Relaunch (laufende Alt-Zahlungen
|
|
* werden weiter per Rechnung abgerechnet)
|
|
*
|
|
* Die Vergabe läuft atomar über einen Row-Lock auf der Sequenz-Tabelle,
|
|
* damit Nummern auch bei parallelen Prozessen (Webhook + Scheduler)
|
|
* lückenlos und eindeutig bleiben.
|
|
*/
|
|
class InvoiceNumberGenerator
|
|
{
|
|
public const CIRCLE_STRIPE = 'STR';
|
|
|
|
public const CIRCLE_MANUAL = 'MAN';
|
|
|
|
public function nextStripeNumber(): string
|
|
{
|
|
return $this->next(self::CIRCLE_STRIPE);
|
|
}
|
|
|
|
public function nextManualNumber(): string
|
|
{
|
|
return $this->next(self::CIRCLE_MANUAL);
|
|
}
|
|
|
|
public function next(string $circle): string
|
|
{
|
|
if (! in_array($circle, [self::CIRCLE_STRIPE, self::CIRCLE_MANUAL], true)) {
|
|
throw new InvalidArgumentException("Unbekannter Rechnungskreis: {$circle}");
|
|
}
|
|
|
|
$number = DB::transaction(function () use ($circle): int {
|
|
// Sequenz-Zeile race-sicher sicherstellen: insertOrIgnore nutzt den
|
|
// Unique-Index auf `circle`, sodass parallele Erstaufrufe nicht in
|
|
// doppelte Zeilen (und damit doppelte Nummern) laufen.
|
|
DB::table('invoice_number_sequences')->insertOrIgnore([
|
|
'circle' => $circle,
|
|
'next_number' => 1,
|
|
'created_at' => now(),
|
|
'updated_at' => now(),
|
|
]);
|
|
|
|
$sequence = DB::table('invoice_number_sequences')
|
|
->where('circle', $circle)
|
|
->lockForUpdate()
|
|
->first();
|
|
|
|
DB::table('invoice_number_sequences')
|
|
->where('id', $sequence->id)
|
|
->update(['next_number' => $sequence->next_number + 1, 'updated_at' => now()]);
|
|
|
|
return (int) $sequence->next_number;
|
|
});
|
|
|
|
$padding = (int) config('billing.invoice_number_padding', 5);
|
|
|
|
return sprintf('%s-%s', $circle, str_pad((string) $number, $padding, '0', STR_PAD_LEFT));
|
|
}
|
|
}
|