Files
sam-api/app/Models/Tenants/ApprovalLine.php
hskwon b43796a558 feat: [approval] 전자결재 모듈 API 구현
- 마이그레이션 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개 등록
2025-12-17 23:23:20 +09:00

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();
}
}