Kevin Adametz
d548f4b235
Tarif-Datenmodell (Decision-Update): - plans: Starter/Business/Pro/Agency mit Monats-/Jahrespreis (Jahres = 10 x Monat), PM-Kontingent, Tageslimit, Stripe-IDs; idempotenter Seeder - single_purchases: Einzel-PM, Extra-PM, Boost, PDF-Nachweis mit Status-Lifecycle und Stripe-Checkout-Referenzen - laravel/cashier ^16.5 installiert (freigegeben); User ist Billable, Cashier-Migrationen published + ausgefuehrt; lokale invoices()-Relation ueberschreibt bewusst die Cashier-Methode Hybride Rechnungskreise (Entscheidung 12.06.2026): - invoice_number_sequences + InvoiceNumberGenerator: atomare fortlaufende Nummern pro Kreis (STR- fuer den neuen Stripe-Shop, MAN- fuer den manuellen Legacy-Kreis); Alt-Archiv legacy_invoices bleibt unveraendert - ManualInvoiceService + billing:generate-manual-invoices (Scheduler taeglich 04:30): prueft aktive/grandfathered user_payment_options ohne Stripe-Subscription auf erreichtes Periodenende, friert die Rechnungsadresse als Snapshot ein, stellt die MAN-Rechnung aus (Zahlungsziel billing.manual_due_days) und schaltet die Periode weiter; Konditions-Overrides via legacy_conditions, sonst Netto-Preis + billing.vat_rate; nicht abrechenbare Faelle werden geloggt und beim naechsten Lauf erneut geprueft Submit-Gate: - User::hasActiveBooking() prueft jetzt echt (hinter billing.enforce_booking): Cashier-Abo, bezahlter Einzel-/Extra-PM-Kauf oder laufende Legacy-Vereinbarung (MAN-Kreis) Suite: 468 passed, 4 skipped (17 neue Billing-Tests). Pint clean. Offen fuer 9E: Stripe-Checkout/Webhooks, STR-Spiegelung, Slot-Logik auf Plan-Kontingent, Migration der aktiven Legacy-Zahlungen in user_payment_options. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
70 lines
2.2 KiB
PHP
70 lines
2.2 KiB
PHP
<?php
|
|
|
|
namespace App\Console\Commands;
|
|
|
|
use App\Services\Billing\ManualInvoiceService;
|
|
use Illuminate\Console\Command;
|
|
|
|
/**
|
|
* Fälligkeitsprüfung des manuellen Rechnungskreises (MAN-).
|
|
*
|
|
* Läuft täglich über den Scheduler und stellt für aktive Legacy-
|
|
* Zahlungsvereinbarungen (ohne Stripe-Subscription) die fälligen
|
|
* Rechnungen aus — wie im Legacy-System. Nicht abrechenbare
|
|
* Vereinbarungen (fehlende Rechnungsadresse o. ä.) werden geloggt und
|
|
* beim nächsten Lauf erneut geprüft.
|
|
*/
|
|
class GenerateManualInvoices extends Command
|
|
{
|
|
protected $signature = 'billing:generate-manual-invoices
|
|
{--dry-run : Nur anzeigen, was fällig ist}
|
|
{--limit=50 : Maximale Anzahl Vereinbarungen pro Lauf}';
|
|
|
|
protected $description = 'Stellt fällige Rechnungen des manuellen Legacy-Rechnungskreises (MAN-) aus';
|
|
|
|
public function handle(ManualInvoiceService $service): int
|
|
{
|
|
$dryRun = (bool) $this->option('dry-run');
|
|
$limit = max(1, (int) $this->option('limit'));
|
|
|
|
$due = $service->duePaymentOptions(limit: $limit);
|
|
|
|
if ($due->isEmpty()) {
|
|
$this->info('Keine fälligen Zahlungsvereinbarungen gefunden.');
|
|
|
|
return self::SUCCESS;
|
|
}
|
|
|
|
$created = 0;
|
|
$skipped = 0;
|
|
|
|
foreach ($due as $option) {
|
|
if ($dryRun) {
|
|
$this->line(sprintf(
|
|
'[dry-run] Fällig: Vereinbarung #%d (User #%s, Periode bis %s)',
|
|
$option->id,
|
|
$option->user_id,
|
|
$option->current_period_end->toDateString(),
|
|
));
|
|
|
|
continue;
|
|
}
|
|
|
|
$invoice = $service->invoiceFor($option);
|
|
|
|
if ($invoice) {
|
|
$created++;
|
|
$this->line(sprintf('Rechnung %s für Vereinbarung #%d erstellt.', $invoice->number, $option->id));
|
|
} else {
|
|
$skipped++;
|
|
$this->warn(sprintf('Vereinbarung #%d übersprungen (siehe Log).', $option->id));
|
|
}
|
|
}
|
|
|
|
if (! $dryRun) {
|
|
$this->info(sprintf('%d Rechnung(en) erstellt, %d übersprungen.', $created, $skipped));
|
|
}
|
|
|
|
return self::SUCCESS;
|
|
}
|
|
}
|