- 마이그레이션 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개 등록
120 lines
2.8 KiB
PHP
120 lines
2.8 KiB
PHP
<?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();
|
|
}
|
|
}
|