feat: [approval] 결재관리 시스템 MNG 스타일로 전면 개선

- 보류/보류해제 기능 추가 (hold, releaseHold)
- 전결 기능 추가 (preDecide - 이후 결재 건너뛰고 최종 승인)
- 복사 재기안 기능 추가 (copyForRedraft)
- 반려 후 재상신 로직 (rejection_history 저장, resubmit_count 증가)
- 결재자 스냅샷 저장 (approver_name, department, position)
- 완료함 목록/현황 API 추가 (completed, completedSummary)
- 뱃지 카운트 API 추가 (badgeCounts)
- 완료함 일괄 읽음 처리 (markCompletedAsRead)
- 위임 관리 CRUD API 추가 (delegations)
- Leave 연동 (승인/반려/회수/삭제 시 휴가 상태 동기화)
- ApprovalDelegation 모델 신규 생성
- STATUS_ON_HOLD 상수 추가 (Approval, ApprovalStep)
- isEditable/isSubmittable 반려 상태 허용으로 확장
- isCancellable 보류 상태 포함
- 회수 시 첫 번째 결재자 처리 여부 검증 추가
- i18n 에러/메시지 키 추가
This commit is contained in:
김보곤
2026-03-11 16:57:54 +09:00
parent f662a389f7
commit 100a78b6e5
9 changed files with 1076 additions and 27 deletions

View File

@@ -24,10 +24,12 @@
class ApprovalStep extends Model
{
use Auditable;
protected $table = 'approval_steps';
protected $casts = [
'step_order' => 'integer',
'parallel_group' => 'integer',
'acted_at' => 'datetime',
'is_read' => 'boolean',
'read_at' => 'datetime',
@@ -41,8 +43,14 @@ class ApprovalStep extends Model
'status',
'comment',
'acted_at',
'acted_by',
'is_read',
'read_at',
'parallel_group',
'approval_type',
'approver_name',
'approver_department',
'approver_position',
];
protected $attributes = [
@@ -62,11 +70,14 @@ class ApprovalStep extends Model
public const STATUS_SKIPPED = 'skipped'; // 건너뜀
public const STATUS_ON_HOLD = 'on_hold'; // 보류
public const STATUSES = [
self::STATUS_PENDING,
self::STATUS_APPROVED,
self::STATUS_REJECTED,
self::STATUS_SKIPPED,
self::STATUS_ON_HOLD,
];
// =========================================================================
@@ -89,6 +100,14 @@ public function approver(): BelongsTo
return $this->belongsTo(User::class, 'approver_id');
}
/**
* 실제 처리자 (위임 결재 시 대리자)
*/
public function actedBy(): BelongsTo
{
return $this->belongsTo(User::class, 'acted_by');
}
// =========================================================================
// 스코프
// =========================================================================
@@ -164,6 +183,7 @@ public function getStatusLabelAttribute(): string
self::STATUS_APPROVED => '승인',
self::STATUS_REJECTED => '반려',
self::STATUS_SKIPPED => '건너뜀',
self::STATUS_ON_HOLD => '보류',
default => $this->status,
};
}