Files
sam-manage/app/Models/DevTools/ApiDeprecation.php

116 lines
2.8 KiB
PHP

<?php
namespace App\Models\DevTools;
use App\Models\User;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
/**
* API 폐기 후보 모델
*
* @property int $id
* @property string $endpoint
* @property string $method
* @property string $status
* @property string|null $reason
* @property \Illuminate\Support\Carbon|null $scheduled_date
* @property \Illuminate\Support\Carbon|null $deprecated_date
* @property int|null $created_by
* @property \Illuminate\Support\Carbon $created_at
* @property \Illuminate\Support\Carbon $updated_at
*/
class ApiDeprecation extends Model
{
protected $table = 'admin_api_deprecations';
protected $fillable = [
'endpoint',
'method',
'status',
'reason',
'scheduled_date',
'deprecated_date',
'created_by',
];
protected $casts = [
'scheduled_date' => 'date',
'deprecated_date' => 'date',
];
/**
* 상태 상수
*/
public const STATUS_CANDIDATE = 'candidate'; // 삭제 후보
public const STATUS_SCHEDULED = 'scheduled'; // 삭제 예정
public const STATUS_DEPRECATED = 'deprecated'; // 폐기됨 (사용 중단)
public const STATUS_REMOVED = 'removed'; // 완전 삭제
/**
* 상태 라벨
*/
public static function statusLabels(): array
{
return [
self::STATUS_CANDIDATE => '삭제 후보',
self::STATUS_SCHEDULED => '삭제 예정',
self::STATUS_DEPRECATED => '폐기됨',
self::STATUS_REMOVED => '삭제됨',
];
}
/**
* 상태 라벨 접근자
*/
public function getStatusLabelAttribute(): string
{
return self::statusLabels()[$this->status] ?? $this->status;
}
/**
* 상태 색상 접근자
*/
public function getStatusColorAttribute(): string
{
return match ($this->status) {
self::STATUS_CANDIDATE => 'yellow',
self::STATUS_SCHEDULED => 'orange',
self::STATUS_DEPRECATED => 'red',
self::STATUS_REMOVED => 'gray',
default => 'gray',
};
}
/**
* 생성자 관계
*/
public function creator(): BelongsTo
{
return $this->belongsTo(User::class, 'created_by');
}
/**
* 후보 상태 스코프
*/
public function scopeCandidates($query)
{
return $query->where('status', self::STATUS_CANDIDATE);
}
/**
* 활성 상태 스코프 (삭제되지 않은 것들)
*/
public function scopeActive($query)
{
return $query->whereIn('status', [
self::STATUS_CANDIDATE,
self::STATUS_SCHEDULED,
self::STATUS_DEPRECATED,
]);
}
}