feat:E-Sign 전자계약 서명 솔루션 백엔드 구현

- 마이그레이션 4개 (esign_contracts, esign_signers, esign_sign_fields, esign_audit_logs) - 모델 4개 (EsignContract, EsignSigner, EsignSignField, EsignAuditLog) - 서비스 4개 (EsignContractService, EsignSignService, EsignPdfService, EsignAuditService) - 컨트롤러 2개 (EsignContractController, EsignSignController) - FormRequest 4개 (ContractStore, FieldConfigure, SignSubmit, SignReject) - Mail 1개 (EsignRequestMail + 이메일 템플릿) - API 라우트 (인증 계약 관리 + 토큰 기반 서명 프로세스) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-12 07:02:39 +09:00
parent 818f764aa5
commit 6958be1fd8
22 changed files with 1673 additions and 0 deletions
--- a/app/Models/ESign/EsignContract.php
+++ b/app/Models/ESign/EsignContract.php
@@ -0,0 +1,133 @@
+<?php
+
+namespace App\Models\ESign;
+
+use App\Models\Members\User;
+use App\Traits\Auditable;
+use App\Traits\BelongsToTenant;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+class EsignContract extends Model
+{
+    use Auditable, BelongsToTenant, SoftDeletes;
+
+    protected $table = 'esign_contracts';
+
+    // 상태 상수
+    public const STATUS_DRAFT = 'draft';
+    public const STATUS_PENDING = 'pending';
+    public const STATUS_PARTIALLY_SIGNED = 'partially_signed';
+    public const STATUS_COMPLETED = 'completed';
+    public const STATUS_EXPIRED = 'expired';
+    public const STATUS_CANCELLED = 'cancelled';
+    public const STATUS_REJECTED = 'rejected';
+
+    public const STATUSES = [
+        self::STATUS_DRAFT,
+        self::STATUS_PENDING,
+        self::STATUS_PARTIALLY_SIGNED,
+        self::STATUS_COMPLETED,
+        self::STATUS_EXPIRED,
+        self::STATUS_CANCELLED,
+        self::STATUS_REJECTED,
+    ];
+
+    // 서명 순서 상수
+    public const SIGN_ORDER_COUNTERPART_FIRST = 'counterpart_first';
+    public const SIGN_ORDER_CREATOR_FIRST = 'creator_first';
+
+    public const SIGN_ORDERS = [
+        self::SIGN_ORDER_COUNTERPART_FIRST,
+        self::SIGN_ORDER_CREATOR_FIRST,
+    ];
+
+    protected $fillable = [
+        'tenant_id',
+        'contract_code',
+        'title',
+        'description',
+        'sign_order_type',
+        'original_file_path',
+        'original_file_name',
+        'original_file_hash',
+        'original_file_size',
+        'signed_file_path',
+        'signed_file_hash',
+        'status',
+        'expires_at',
+        'completed_at',
+        'created_by',
+        'updated_by',
+        'deleted_by',
+    ];
+
+    protected $casts = [
+        'original_file_size' => 'integer',
+        'expires_at' => 'datetime',
+        'completed_at' => 'datetime',
+    ];
+
+    // === Relations ===
+
+    public function signers(): HasMany
+    {
+        return $this->hasMany(EsignSigner::class, 'contract_id');
+    }
+
+    public function signFields(): HasMany
+    {
+        return $this->hasMany(EsignSignField::class, 'contract_id');
+    }
+
+    public function auditLogs(): HasMany
+    {
+        return $this->hasMany(EsignAuditLog::class, 'contract_id');
+    }
+
+    public function creator(): BelongsTo
+    {
+        return $this->belongsTo(User::class, 'created_by');
+    }
+
+    // === Scopes ===
+
+    public function scopeStatus($query, string $status)
+    {
+        return $query->where('status', $status);
+    }
+
+    public function scopeActive($query)
+    {
+        return $query->whereNotIn('status', [
+            self::STATUS_CANCELLED,
+            self::STATUS_EXPIRED,
+            self::STATUS_REJECTED,
+        ]);
+    }
+
+    // === Helpers ===
+
+    public function isExpired(): bool
+    {
+        return $this->expires_at && $this->expires_at->isPast();
+    }
+
+    public function canSign(): bool
+    {
+        return in_array($this->status, [
+            self::STATUS_PENDING,
+            self::STATUS_PARTIALLY_SIGNED,
+        ]) && ! $this->isExpired();
+    }
+
+    public function getNextSigner(): ?EsignSigner
+    {
+        return $this->signers()
+            ->whereIn('status', [EsignSigner::STATUS_WAITING, EsignSigner::STATUS_NOTIFIED, EsignSigner::STATUS_AUTHENTICATED])
+            ->orderBy('sign_order')
+            ->first();
+    }
+}