<?php

namespace App\Models;

use App\Services\Billing\CreditWalletService;
use Database\Factories\CreditWalletFactory;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\Relations\HasMany;

/**
 * Credit-Guthaben eines Users. `balance_credits` ist der denormalisierte
 * Saldo (1 Credit = 1 €); die maßgebliche Wahrheit ist der Ledger in
 * `transactions`. Schreibzugriffe laufen ausschließlich über
 * {@see CreditWalletService} (atomar + gesperrt).
 */
class CreditWallet extends Model
{
    /** @use HasFactory<CreditWalletFactory> */
    use HasFactory;

    protected $fillable = [
        'user_id',
        'balance_credits',
    ];

    protected function casts(): array
    {
        return [
            'balance_credits' => 'integer',
        ];
    }

    /**
     * @return BelongsTo<User, $this>
     */
    public function user(): BelongsTo
    {
        return $this->belongsTo(User::class);
    }

    /**
     * @return HasMany<CreditTransaction, $this>
     */
    public function transactions(): HasMany
    {
        return $this->hasMany(CreditTransaction::class)->orderByDesc('created_at');
    }
}