'array', 'attachments' => 'array', 'rejection_history' => 'array', 'is_urgent' => 'boolean', 'drafted_at' => 'datetime', 'completed_at' => 'datetime', 'drafter_read_at' => 'datetime', 'current_step' => 'integer', 'resubmit_count' => 'integer', ]; protected $fillable = [ 'tenant_id', 'document_number', 'form_id', 'line_id', 'title', 'content', 'body', 'status', 'is_urgent', 'drafter_id', 'department_id', 'drafted_at', 'completed_at', 'drafter_read_at', 'current_step', 'resubmit_count', 'rejection_history', 'recall_reason', 'parent_doc_id', 'attachments', 'linkable_type', 'linkable_id', 'created_by', 'updated_by', 'deleted_by', ]; protected $attributes = [ 'status' => 'draft', 'current_step' => 0, 'resubmit_count' => 0, ]; // ========================================================================= // 상태 상수 // ========================================================================= public const STATUS_DRAFT = 'draft'; // 임시저장 public const STATUS_PENDING = 'pending'; // 결재 진행중 public const STATUS_APPROVED = 'approved'; // 승인 완료 public const STATUS_REJECTED = 'rejected'; // 반려 public const STATUS_CANCELLED = 'cancelled'; // 회수/취소 public const STATUS_ON_HOLD = 'on_hold'; // 보류 public const STATUSES = [ self::STATUS_DRAFT, self::STATUS_PENDING, self::STATUS_APPROVED, self::STATUS_REJECTED, self::STATUS_CANCELLED, self::STATUS_ON_HOLD, ]; // ========================================================================= // 관계 정의 // ========================================================================= /** * 결재 양식 */ public function form(): BelongsTo { return $this->belongsTo(ApprovalForm::class, 'form_id'); } /** * 결재선 템플릿 */ public function line(): BelongsTo { return $this->belongsTo(ApprovalLine::class, 'line_id'); } /** * 기안자 */ public function drafter(): BelongsTo { return $this->belongsTo(User::class, 'drafter_id'); } /** * 기안 부서 */ public function department(): BelongsTo { return $this->belongsTo(Department::class, 'department_id'); } /** * 원본 문서 (복사 재기안 시) */ public function parentDocument(): BelongsTo { return $this->belongsTo(self::class, 'parent_doc_id'); } /** * 하위 문서들 (이 문서에서 복사된 문서들) */ public function childDocuments(): HasMany { return $this->hasMany(self::class, 'parent_doc_id'); } /** * 결재 단계들 */ public function steps(): HasMany { return $this->hasMany(ApprovalStep::class, 'approval_id')->orderBy('step_order'); } /** * 결재자 단계들 (참조 제외) */ public function approverSteps(): HasMany { return $this->hasMany(ApprovalStep::class, 'approval_id') ->whereIn('step_type', [ApprovalLine::STEP_TYPE_APPROVAL, ApprovalLine::STEP_TYPE_AGREEMENT]) ->orderBy('step_order'); } /** * 참조자 단계들 */ public function referenceSteps(): HasMany { return $this->hasMany(ApprovalStep::class, 'approval_id') ->where('step_type', ApprovalLine::STEP_TYPE_REFERENCE) ->orderBy('step_order'); } /** * 연결 대상 (Document 등) */ public function linkable(): MorphTo { return $this->morphTo(); } /** * 생성자 */ public function creator(): BelongsTo { return $this->belongsTo(User::class, 'created_by'); } /** * 수정자 */ public function updater(): BelongsTo { return $this->belongsTo(User::class, 'updated_by'); } // ========================================================================= // 스코프 // ========================================================================= /** * 특정 상태 */ public function scopeWithStatus($query, string $status) { return $query->where('status', $status); } /** * 임시저장 */ public function scopeDraft($query) { return $query->where('status', self::STATUS_DRAFT); } /** * 결재 진행중 */ public function scopePending($query) { return $query->where('status', self::STATUS_PENDING); } /** * 승인 완료 */ public function scopeApproved($query) { return $query->where('status', self::STATUS_APPROVED); } /** * 반려 */ public function scopeRejected($query) { return $query->where('status', self::STATUS_REJECTED); } /** * 완료됨 (승인, 반려, 회수) */ public function scopeCompleted($query) { return $query->whereIn('status', [self::STATUS_APPROVED, self::STATUS_REJECTED, self::STATUS_CANCELLED]); } /** * 보류 상태 */ public function scopeOnHold($query) { return $query->where('status', self::STATUS_ON_HOLD); } /** * 특정 기안자 */ public function scopeByDrafter($query, int $userId) { return $query->where('drafter_id', $userId); } // ========================================================================= // 헬퍼 메서드 // ========================================================================= /** * 수정 가능 여부 (임시저장 또는 반려 상태) */ public function isEditable(): bool { return in_array($this->status, [self::STATUS_DRAFT, self::STATUS_REJECTED]); } /** * 상신 가능 여부 (임시저장 또는 반려 상태 = 재상신) */ public function isSubmittable(): bool { return in_array($this->status, [self::STATUS_DRAFT, self::STATUS_REJECTED]); } /** * 승인/반려 가능 여부 */ public function isActionable(): bool { return $this->status === self::STATUS_PENDING; } /** * 회수 가능 여부 (기안자만, 진행중 또는 보류 상태) */ public function isCancellable(): bool { return in_array($this->status, [self::STATUS_PENDING, self::STATUS_ON_HOLD]); } /** * 보류 가능 여부 (진행중 상태만) */ public function isHoldable(): bool { return $this->status === self::STATUS_PENDING; } /** * 보류 해제 가능 여부 (보류 상태만) */ public function isHoldReleasable(): bool { return $this->status === self::STATUS_ON_HOLD; } /** * 복사 재기안 가능 여부 (완료/반려/회수 상태) */ public function isCopyable(): bool { return in_array($this->status, [self::STATUS_APPROVED, self::STATUS_REJECTED, self::STATUS_CANCELLED]); } /** * 삭제 가능 여부 * 일반 사용자: 임시저장만 * 관리자: 별도 isDeletableBy 사용 */ public function isDeletable(): bool { return $this->status === self::STATUS_DRAFT; } /** * 사용자 기준 삭제 가능 여부 * 기안자: 임시저장/반려만 삭제 가능 */ public function isDeletableBy(int $userId): bool { if ($this->drafter_id !== $userId) { return false; } return in_array($this->status, [self::STATUS_DRAFT, self::STATUS_REJECTED]); } /** * 상태 라벨 */ public function getStatusLabelAttribute(): string { return match ($this->status) { self::STATUS_DRAFT => '임시저장', self::STATUS_PENDING => '진행', self::STATUS_APPROVED => '완료', self::STATUS_REJECTED => '반려', self::STATUS_CANCELLED => '회수', self::STATUS_ON_HOLD => '보류', default => $this->status, }; } /** * 상태 색상 (UI 배지용) */ public function getStatusColorAttribute(): string { return match ($this->status) { self::STATUS_DRAFT => 'gray', self::STATUS_PENDING => 'blue', self::STATUS_APPROVED => 'green', self::STATUS_REJECTED => 'red', self::STATUS_CANCELLED => 'yellow', self::STATUS_ON_HOLD => 'orange', default => 'gray', }; } /** * 현재 결재자 확인 */ public function getCurrentApproverStep(): ?ApprovalStep { return $this->steps() ->whereIn('step_type', [ApprovalLine::STEP_TYPE_APPROVAL, ApprovalLine::STEP_TYPE_AGREEMENT]) ->where('status', ApprovalStep::STATUS_PENDING) ->orderBy('step_order') ->first(); } /** * 특정 사용자가 현재 결재자인지 확인 */ public function isCurrentApprover(int $userId): bool { $currentStep = $this->getCurrentApproverStep(); return $currentStep && $currentStep->approver_id === $userId; } /** * 특정 사용자가 참조자인지 확인 */ public function isReferee(int $userId): bool { return $this->referenceSteps() ->where('approver_id', $userId) ->exists(); } /** * 결재 진행률 */ public function getProgressAttribute(): array { $totalSteps = $this->approverSteps()->count(); $completedSteps = $this->approverSteps() ->whereIn('status', [ApprovalStep::STATUS_APPROVED, ApprovalStep::STATUS_REJECTED]) ->count(); return [ 'total' => $totalSteps, 'completed' => $completedSteps, 'percentage' => $totalSteps > 0 ? round(($completedSteps / $totalSteps) * 100) : 0, ]; } }