portal/app/app/Models/SalesSmsSender.php

<?php

declare(strict_types=1);

namespace App\Models;

use Carbon\Carbon;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Support\Collection;

/**
 * Имя отправителя СМС. Регистрируется у каждого провайдера отдельно и
 * проходит модерацию оператора — пока status !== 'active', рассылка не стартует.
 *
 * tenant_id = NULL означает «Лидерра сама» (см. спеку §5).
 *
 * @property int $id
 * @property int|null $tenant_id
 * @property string $name
 * @property string $provider_key
 * @property string $status
 * @property int|null $monthly_fee_kopecks
 * @property Carbon|null $submitted_at
 * @property Carbon|null $approved_at
 * @property string|null $rejected_reason
 * @mixin IdeHelperSalesSmsSender
 */
class SalesSmsSender extends Model
{
    public const STATUS_ACTIVE = 'active';

    protected $connection = 'pgsql_supplier';

    protected $table = 'sales_sms_senders';

    protected $fillable = [
        'tenant_id', 'name', 'provider_key', 'status',
        'monthly_fee_kopecks', 'submitted_at', 'approved_at', 'rejected_reason',
    ];

    protected $casts = [
        'submitted_at' => 'datetime',
        'approved_at' => 'datetime',
    ];

    public function isActive(): bool
    {
        return $this->status === self::STATUS_ACTIVE;
    }

    /**
     * Активные имена отправителя по каналам (provider_key => sender).
     * Глобальные (tenant_id NULL, «Лидерра сама») видны всегда; собственные
     * имена tenant'а перекрывают глобальные по тому же каналу.
     *
     * @return Collection<string, self>
     */
    public static function activeByProviderKey(?int $tenantId = null): Collection
    {
        // collect(...->all()) намеренно: Eloquent Collection::merge() перевязывает
        // по первичному ключу и возвращает array_values() — теряя keyBy('provider_key').
        // Base Collection::merge() — обычный array_merge, ключи-каналы целы.
        $global = collect(
            self::query()->where('status', self::STATUS_ACTIVE)->whereNull('tenant_id')->get()->keyBy('provider_key')->all()
        );

        if ($tenantId === null) {
            return $global;
        }

        $own = self::query()
            ->where('status', self::STATUS_ACTIVE)
            ->where('tenant_id', $tenantId)
            ->get()
            ->keyBy('provider_key');

        return $global->merge($own);
    }
}