100a78b6e5
- 보류/보류해제 기능 추가 (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 에러/메시지 키 추가
446 lines
11 KiB
PHP
446 lines
11 KiB
PHP
<?php
|
|
|
|
namespace App\Models\Tenants;
|
|
|
|
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\Relations\MorphTo;
|
|
use Illuminate\Database\Eloquent\SoftDeletes;
|
|
|
|
/**
|
|
* 결재 문서 모델
|
|
*
|
|
* @property int $id
|
|
* @property int $tenant_id
|
|
* @property string $document_number
|
|
* @property int $form_id
|
|
* @property string $title
|
|
* @property array $content
|
|
* @property string $status
|
|
* @property int $drafter_id
|
|
* @property \Carbon\Carbon|null $drafted_at
|
|
* @property \Carbon\Carbon|null $completed_at
|
|
* @property int $current_step
|
|
* @property array|null $attachments
|
|
* @property int|null $created_by
|
|
* @property int|null $updated_by
|
|
* @property int|null $deleted_by
|
|
*/
|
|
class Approval extends Model
|
|
{
|
|
use Auditable, BelongsToTenant, SoftDeletes;
|
|
|
|
protected $table = 'approvals';
|
|
|
|
protected $casts = [
|
|
'content' => '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,
|
|
];
|
|
}
|
|
}
|