Credit-Wallet + Ledger + Tier-Preisableitung (Fundament)

Echte Credit-Wallet (1 Credit = 1 EUR) mit append-only Ledger als Basis fuer
die Credit-Oekonomie aus dem Decision-Update (Rev. 4):

- credit_wallets (denormalisierter Saldo) + credit_transactions (Ledger,
  vorzeichenbehaftet, balance_after, polymorphe reference)
- CreditWalletService: einziger Schreibpfad, atomar mit Row-Lock,
  InsufficientCreditsException mit shortfall fuer den Mini-Checkout
- Tier-Enum (Einzel/Starter/Business/Pro/Agency) + User::currentTier()
- CreditPricingService: tier-gestaffelte Ableitung aus config/credits.php
  (Extra-PM 19/15/12/10/8, Boost 12/20/35, PDF 3, Depublish 25, Pruef-Quota)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Kevin Adametz 2026-06-17 14:16:43 +00:00
parent 5a9aab7012
commit b63cd26326
15 changed files with 756 additions and 0 deletions

View file

@ -4,6 +4,7 @@ namespace App\Models;
use App\Enums\Portal;
use App\Enums\RegistrationType;
use App\Enums\Tier;
use App\Enums\UserPaymentOptionStatus;
use Database\Factories\UserFactory;
use Illuminate\Contracts\Auth\MustVerifyEmail;
@ -140,6 +141,15 @@ class User extends Authenticatable implements MustVerifyEmail
->first();
}
/**
* Abrechnungs-Tier für die Credit-Preisableitung. Ohne aktives Abo gilt
* `Tier::Einzel` (Pay-per-Release).
*/
public function currentTier(): Tier
{
return Tier::fromPlanSlug($this->currentPlan()?->slug);
}
/**
* Hat dieser User ein unbegrenztes PM-Kontingent?
*
@ -291,6 +301,25 @@ class User extends Authenticatable implements MustVerifyEmail
return $this->hasMany(SinglePurchase::class);
}
public function creditWallet(): HasOne
{
return $this->hasOne(CreditWallet::class);
}
public function creditTransactions(): HasMany
{
return $this->hasMany(CreditTransaction::class);
}
/**
* Aktuelles Credit-Guthaben (1 Credit = 1 ). 0, solange keine Wallet
* angelegt wurde.
*/
public function creditBalance(): int
{
return (int) ($this->creditWallet?->balance_credits ?? 0);
}
/**
* Lokale Rechnungen (STR- und MAN-Kreis). Überschreibt bewusst die
* gleichnamige Cashier-Methode Stripe-Rechnungen werden beim