sam-api/app/Models/Members/User.php

<?php

namespace App\Models\Members;

use App\Models\Commons\Role;
use App\Models\Commons\File;
use App\Models\Tenants\Tenant;
use App\Traits\ModelTrait;
use Illuminate\Database\Eloquent\SoftDeletes;
use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;
use Laravel\Sanctum\HasApiTokens;
use Illuminate\Database\Eloquent\Relations\BelongsToMany;

class User extends Authenticatable
{
    use HasApiTokens, Notifiable, SoftDeletes, ModelTrait;

    protected $fillable = [
        'name',
        'phone',
        'email',
        'options',
        'profile_photo_path',
    ];

    protected $guarded = [
        'id',
        'user_id',
        'password',
        'remember_token',
        'two_factor_secret',
        'two_factor_recovery_codes',
        'two_factor_confirmed_at',
        'email_verified_at',
        'last_login_at',
        'current_team_id',
        'deleted_at',
        'created_at',
        'updated_at',
    ];

    protected $casts = [
        'email_verified_at' => 'datetime',
        'last_login_at'     => 'datetime',
        'options'        => 'array',
        'deleted_at'        => 'datetime',
    ];

    protected $hidden = [
        'password', 'remember_token',
        'two_factor_secret', 'two_factor_recovery_codes', 'two_factor_confirmed_at',
        'deleted_at',
    ];

    public function userTenants()
    {
        return $this->hasMany(UserTenant::class);
    }

    public function userTenant()
    {
        return $this->hasOne(UserTenant::class)->where('is_active', 1);
    }

    public function userRoles()
    {
        return $this->hasMany(UserRole::class);
    }

    public function roles()
    {
        return $this->belongsToMany(Role::class, 'user_roles')->withPivot('tenant_id', 'assigned_at');
    }

    public function userTenantById($tenantId)
    {
        return $this->hasOne(UserTenant::class)->where('tenant_id', $tenantId);
    }

    public function files()
    {
        return $this->morphMany(File::class, 'fileable');
    }

    public function tenantsMembership(): BelongsToMany
    {
        return $this->belongsToMany(Tenant::class, 'user_tenants', 'user_id', 'tenant_id')
            ->as('membership') // pivot 대신 membership으로 표기
            ->withPivot(['is_active', 'is_default', 'joined_at', 'left_at', 'deleted_at'])
            ->wherePivotNull('deleted_at'); // 소프트삭제 제외
    }
}