<?php

declare(strict_types=1);

namespace App\Models;

use App\Enums\ContributionType;
use App\Traits\MultiTenantScope;
use App\ValueObjects\Money;
use Carbon\Carbon;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;

/**
 * Aporte de Capital de un Socio/Inversionista.
 *
 * Cada aporte:
 * - Incrementa el capital de trabajo de la compania
 * - Se registra como un Income (capital_injection / investor_contribution)
 * - Es EQUITY, no ingreso operativo (no afecta utilidades)
 *
 * @property int $id
 * @property int $company_id
 * @property int $partner_id
 * @property string $amount
 * @property ContributionType $type
 * @property string|null $method
 * @property Carbon $operation_date
 * @property string|null $reference
 * @property string|null $notes
 * @property array|null $metadata
 * @property int|null $income_id
 * @property int $user_id
 * @property bool $is_locked
 * @property Carbon|null $locked_at
 */
class CapitalContribution extends Model
{
    use MultiTenantScope;

    protected $fillable = [
        'company_id',
        'partner_id',
        'amount',
        'type',
        'method',
        'operation_date',
        'reference',
        'notes',
        'metadata',
        'income_id',
        'user_id',
        'is_locked',
        'locked_at',
        'idempotency_key',
    ];

    protected $casts = [
        'amount' => 'decimal:2',
        'type' => ContributionType::class,
        'operation_date' => 'date',
        'metadata' => 'array',
        'is_locked' => 'boolean',
        'locked_at' => 'datetime',
    ];

    protected $attributes = [
        'type' => 'additional',
        'is_locked' => false,
    ];

    // ═══════════════════════════════════════════════════════════════════════
    // RELATIONSHIPS
    // ═══════════════════════════════════════════════════════════════════════

    public function company(): BelongsTo
    {
        return $this->belongsTo(Company::class);
    }

    public function partner(): BelongsTo
    {
        return $this->belongsTo(Partner::class);
    }

    public function income(): BelongsTo
    {
        return $this->belongsTo(Income::class);
    }

    public function user(): BelongsTo
    {
        return $this->belongsTo(User::class);
    }

    // ═══════════════════════════════════════════════════════════════════════
    // HELPERS
    // ═══════════════════════════════════════════════════════════════════════

    public function getAmountMoney(): Money
    {
        return Money::of($this->amount);
    }
}