autocrm/app/Models/Tenant/Client.php

<?php

namespace App\Models\Tenant;

use App\Models\Concerns\BelongsToTenant;
use App\Models\Concerns\Auditable;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\Relations\HasMany;
use Illuminate\Database\Eloquent\SoftDeletes;

class Client extends Model
{
    use Auditable, BelongsToTenant, SoftDeletes;

    protected $fillable = [
        'company_id', 'type', 'name', 'company_name',
        'phone', 'phone_alt', 'email',
        'telegram', 'telegram_chat_id', 'whatsapp', 'viber',
        'notify_prefs',
        'source', 'marketing_channel', 'status',
        'balance', 'discount_pct', 'notes',
        'assigned_to', 'last_contact_at',
    ];

    protected $casts = [
        'balance' => 'decimal:2',
        'discount_pct' => 'decimal:2',
        'last_contact_at' => 'datetime',
        'notify_prefs' => 'array',
    ];

    /** Normalize a phone number to E.164-ish digits for matching. */
    public static function normalizePhone(?string $phone): ?string
    {
        if (! $phone) return null;
        $digits = preg_replace('/[^0-9]/', '', $phone);
        return $digits ?: null;
    }

    public function vehicles(): HasMany
    {
        return $this->hasMany(Vehicle::class);
    }

    public function workOrders(): HasMany
    {
        return $this->hasMany(WorkOrder::class);
    }

    public function payments(): HasMany
    {
        return $this->hasMany(Payment::class);
    }

    public function assignedTo(): BelongsTo
    {
        return $this->belongsTo(User::class, 'assigned_to');
    }
}