<?php

namespace App\Models;

use App\Enums\CompanyAddressClass;
use Illuminate\Database\Eloquent\Model;

/**
 * Klassifizierung einer Firmen-E-Mail-Adresse (Roadmap 1a.2).
 *
 * Geschrieben von `companies:classify-addresses`, gelesen von der
 * Zusammenführung (1a.3) und der laufenden Zuordnung (1a.4). Die Firmen einer
 * Gruppe findet man über ihre normalisierte Adresse — siehe
 * `Company::emailKey()`.
 */
class CompanyEmailGroup extends Model
{
    protected $fillable = [
        'email',
        'classification',
        'manual_classification',
        'companies_count',
        'distinct_names',
        'published_companies_count',
        'threshold',
        'classified_at',
    ];

    /**
     * @return array<string, string>
     */
    protected function casts(): array
    {
        return [
            'classification' => CompanyAddressClass::class,
            'manual_classification' => CompanyAddressClass::class,
            'classified_at' => 'datetime',
        ];
    }

    /**
     * Die Klasse, die gilt: die von Hand gesetzte, sonst die berechnete. Wer
     * über eine Adresse entscheidet, fragt IMMER hier — nie die berechnete
     * Spalte direkt.
     */
    public function effectiveClassification(): CompanyAddressClass
    {
        return $this->manual_classification ?? $this->classification;
    }

    public function isMergeable(): bool
    {
        return $this->effectiveClassification()->isMergeable();
    }

    public static function forEmail(?string $email): ?self
    {
        $key = Company::emailKey($email);

        if ($key === null) {
            return null;
        }

        return static::query()->where('email', $key)->first();
    }
}