feat: [approval] 전자결재 모듈 API 구현

- 마이그레이션 4개 (approval_forms, approval_lines, approvals, approval_steps) - 모델 4개 (ApprovalForm, ApprovalLine, Approval, ApprovalStep) - ApprovalService 비즈니스 로직 (양식/결재선 CRUD, 기안함/결재함/참조함, 결재 액션) - 컨트롤러 3개 (ApprovalFormController, ApprovalLineController, ApprovalController) - FormRequest 13개 (양식/결재선/문서 검증) - Swagger 문서 3개 (26개 엔드포인트) - i18n 메시지/에러 키 추가 - 라우트 26개 등록
2025-12-17 23:23:20 +09:00
parent 77914da7b7
commit b43796a558
33 changed files with 4067 additions and 2 deletions
--- a/app/Models/Tenants/ApprovalLine.php
+++ b/app/Models/Tenants/ApprovalLine.php
@@ -0,0 +1,119 @@
+<?php
+
+namespace App\Models\Tenants;
+
+use App\Models\Members\User;
+use App\Traits\BelongsToTenant;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+/**
+ * 결재선 템플릿 모델
+ *
+ * @property int $id
+ * @property int $tenant_id
+ * @property string $name
+ * @property array $steps
+ * @property bool $is_default
+ * @property int|null $created_by
+ * @property int|null $updated_by
+ * @property int|null $deleted_by
+ */
+class ApprovalLine extends Model
+{
+    use BelongsToTenant, SoftDeletes;
+
+    protected $table = 'approval_lines';
+
+    protected $casts = [
+        'steps' => 'array',
+        'is_default' => 'boolean',
+    ];
+
+    protected $fillable = [
+        'tenant_id',
+        'name',
+        'steps',
+        'is_default',
+        'created_by',
+        'updated_by',
+        'deleted_by',
+    ];
+
+    protected $attributes = [
+        'is_default' => false,
+    ];
+
+    // =========================================================================
+    // 단계 유형 상수
+    // =========================================================================
+
+    public const STEP_TYPE_APPROVAL = 'approval';       // 결재
+
+    public const STEP_TYPE_AGREEMENT = 'agreement';     // 합의
+
+    public const STEP_TYPE_REFERENCE = 'reference';     // 참조
+
+    public const STEP_TYPES = [
+        self::STEP_TYPE_APPROVAL,
+        self::STEP_TYPE_AGREEMENT,
+        self::STEP_TYPE_REFERENCE,
+    ];
+
+    // =========================================================================
+    // 관계 정의
+    // =========================================================================
+
+    /**
+     * 생성자
+     */
+    public function creator(): BelongsTo
+    {
+        return $this->belongsTo(User::class, 'created_by');
+    }
+
+    /**
+     * 수정자
+     */
+    public function updater(): BelongsTo
+    {
+        return $this->belongsTo(User::class, 'updated_by');
+    }
+
+    // =========================================================================
+    // 스코프
+    // =========================================================================
+
+    /**
+     * 기본 결재선만
+     */
+    public function scopeDefault($query)
+    {
+        return $query->where('is_default', true);
+    }
+
+    // =========================================================================
+    // 헬퍼 메서드
+    // =========================================================================
+
+    /**
+     * 결재선 단계 수
+     */
+    public function getStepCountAttribute(): int
+    {
+        return count($this->steps ?? []);
+    }
+
+    /**
+     * 결재자 목록 (user_id만)
+     */
+    public function getApproverIdsAttribute(): array
+    {
+        return collect($this->steps ?? [])
+            ->pluck('user_id')
+            ->filter()
+            ->values()
+            ->toArray();
+    }
+}