Teren-app/app/Services/Contact/EmailSelector.php

<?php

namespace App\Services\Contact;

use App\Models\Email;
use App\Models\Person\Person;

class EmailSelector
{
    /**
     * Select the best email for a person following priority rules.
     * Priority:
     * 1) verified primary email that is active
     * 2) primary email that is active
     * 3) any active and valid email
     * 4) first active email
     *
     * Returns an array shape: ['email' => ?Email, 'reason' => ?string]
     */
    public function selectForPerson(Person $person): array
    {
        $emails = Email::query()
            ->where('person_id', $person->id)
            ->where('is_active', true)
            ->orderBy('is_primary', 'desc')
            ->orderBy('id')
            ->get();

        if ($emails->isEmpty()) {
            return ['email' => null, 'reason' => 'no_active_emails'];
        }

        // 1) verified primary
        $email = $emails->first(fn (Email $e) => $e->is_primary && $e->verified_at !== null);
        if ($email) {
            return ['email' => $email, 'reason' => null];
        }

        // 2) primary (any verification)
        $email = $emails->first(fn (Email $e) => $e->is_primary);
        if ($email) {
            return ['email' => $email, 'reason' => null];
        }

        // 3) valid (any)
        $email = $emails->first(fn (Email $e) => $e->valid);
        if ($email) {
            return ['email' => $email, 'reason' => null];
        }

        // 4) first active
        return ['email' => $emails->first(), 'reason' => null];
    }
}