<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\HasMany;

/**
 * Columnas del kanban de negocios. Catálogo editable desde Ajustes:
 * `deals.status` guarda la `key` de una de estas filas.
 *
 * `outcome` ('open' | 'won' | 'lost') alimenta "negocio ganado" y
 * "pipeline abierto". Usar esa bandera, nunca la key literal.
 *
 * OJO: la tabla no tiene columna `id`; la clave primaria es `key` (text).
 */
class DealStage extends Model
{
    protected $table = 'deal_stages';

    protected $primaryKey = 'key';

    protected $keyType = 'string';

    public $incrementing = false;

    protected $guarded = [];

    /** La tabla solo tiene created_at. */
    const UPDATED_AT = null;

    /**
     * @return array<string, string>
     */
    protected function casts(): array
    {
        return [
            'position' => 'integer',
            'is_active' => 'boolean',
            'created_at' => 'datetime',
        ];
    }

    public function deals(): HasMany
    {
        return $this->hasMany(Deal::class, 'status', 'key');
    }

    /**
     * Opciones key => name para los Select de Filament.
     *
     * @return array<string, string>
     */
    public static function options(): array
    {
        return static::query()
            ->where('is_active', true)
            ->orderBy('position')
            ->pluck('name', 'key')
            ->all();
    }
}