3fd412f89d
- 보류/보류해제 기능 추가 (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 에러/메시지 키 추가
136 lines
3.4 KiB
PHP
136 lines
3.4 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\SoftDeletes;
|
|
|
|
/**
|
|
* 결재 양식 모델
|
|
*
|
|
* @property int $id
|
|
* @property int $tenant_id
|
|
* @property string $name
|
|
* @property string $code
|
|
* @property string|null $category
|
|
* @property array $template
|
|
* @property bool $is_active
|
|
* @property int|null $created_by
|
|
* @property int|null $updated_by
|
|
* @property int|null $deleted_by
|
|
*/
|
|
class ApprovalForm extends Model
|
|
{
|
|
use Auditable, BelongsToTenant, SoftDeletes;
|
|
|
|
protected $table = 'approval_forms';
|
|
|
|
protected $casts = [
|
|
'template' => 'array',
|
|
'is_active' => 'boolean',
|
|
];
|
|
|
|
protected $fillable = [
|
|
'tenant_id',
|
|
'name',
|
|
'code',
|
|
'category',
|
|
'template',
|
|
'body_template',
|
|
'is_active',
|
|
'created_by',
|
|
'updated_by',
|
|
'deleted_by',
|
|
];
|
|
|
|
protected $attributes = [
|
|
'is_active' => true,
|
|
];
|
|
|
|
// =========================================================================
|
|
// 카테고리 상수
|
|
// =========================================================================
|
|
|
|
public const CATEGORY_REQUEST = 'request'; // 품의서
|
|
|
|
public const CATEGORY_EXPENSE = 'expense'; // 지출결의서
|
|
|
|
public const CATEGORY_EXPENSE_ESTIMATE = 'expense_estimate'; // 지출 예상 내역서
|
|
|
|
public const CATEGORIES = [
|
|
self::CATEGORY_REQUEST,
|
|
self::CATEGORY_EXPENSE,
|
|
self::CATEGORY_EXPENSE_ESTIMATE,
|
|
];
|
|
|
|
// =========================================================================
|
|
// 관계 정의
|
|
// =========================================================================
|
|
|
|
/**
|
|
* 이 양식으로 생성된 결재 문서들
|
|
*/
|
|
public function approvals(): HasMany
|
|
{
|
|
return $this->hasMany(Approval::class, 'form_id');
|
|
}
|
|
|
|
/**
|
|
* 생성자
|
|
*/
|
|
public function creator(): BelongsTo
|
|
{
|
|
return $this->belongsTo(User::class, 'created_by');
|
|
}
|
|
|
|
/**
|
|
* 수정자
|
|
*/
|
|
public function updater(): BelongsTo
|
|
{
|
|
return $this->belongsTo(User::class, 'updated_by');
|
|
}
|
|
|
|
// =========================================================================
|
|
// 스코프
|
|
// =========================================================================
|
|
|
|
/**
|
|
* 활성 양식만
|
|
*/
|
|
public function scopeActive($query)
|
|
{
|
|
return $query->where('is_active', true);
|
|
}
|
|
|
|
/**
|
|
* 특정 카테고리
|
|
*/
|
|
public function scopeCategory($query, string $category)
|
|
{
|
|
return $query->where('category', $category);
|
|
}
|
|
|
|
// =========================================================================
|
|
// 헬퍼 메서드
|
|
// =========================================================================
|
|
|
|
/**
|
|
* 카테고리 라벨
|
|
*/
|
|
public function getCategoryLabelAttribute(): string
|
|
{
|
|
return match ($this->category) {
|
|
self::CATEGORY_REQUEST => '품의서',
|
|
self::CATEGORY_EXPENSE => '지출결의서',
|
|
self::CATEGORY_EXPENSE_ESTIMATE => '지출 예상 내역서',
|
|
default => $this->category ?? '',
|
|
};
|
|
}
|
|
}
|