sam-manage/app/Models/ESign/EsignSigner.php

<?php

namespace App\Models\ESign;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\Relations\HasMany;

class EsignSigner extends Model
{
    protected $table = 'esign_signers';

    // 역할 상수
    public const ROLE_CREATOR = 'creator';

    public const ROLE_COUNTERPART = 'counterpart';

    // 상태 상수
    public const STATUS_WAITING = 'waiting';

    public const STATUS_NOTIFIED = 'notified';

    public const STATUS_AUTHENTICATED = 'authenticated';

    public const STATUS_SIGNED = 'signed';

    public const STATUS_REJECTED = 'rejected';

    protected $fillable = [
        'tenant_id',
        'contract_id',
        'role',
        'sign_order',
        'name',
        'email',
        'phone',
        'access_token',
        'token_expires_at',
        'otp_code',
        'otp_expires_at',
        'otp_attempts',
        'auth_verified_at',
        'signature_image_path',
        'signed_at',
        'consent_agreed_at',
        'sign_ip_address',
        'sign_user_agent',
        'status',
        'rejected_reason',
    ];

    protected $casts = [
        'sign_order' => 'integer',
        'otp_attempts' => 'integer',
        'token_expires_at' => 'datetime',
        'otp_expires_at' => 'datetime',
        'auth_verified_at' => 'datetime',
        'signed_at' => 'datetime',
        'consent_agreed_at' => 'datetime',
    ];

    protected $hidden = [
        'access_token',
        'otp_code',
    ];

    public function contract(): BelongsTo
    {
        return $this->belongsTo(EsignContract::class, 'contract_id');
    }

    public function signFields(): HasMany
    {
        return $this->hasMany(EsignSignField::class, 'signer_id');
    }

    public function scopeForTenant($query, $tenantId)
    {
        return $query->where('tenant_id', $tenantId);
    }
}