Files
sam-api/app/Models/ItemMaster/ItemPage.php
hskwon efa2a84d2c feat(item-master): 잠금 기능 추가 및 FK 레거시 코드 정리
## 잠금 기능 (Lock Feature)
- entity_relationships 테이블에 is_locked, locked_by, locked_at 컬럼 추가
- EntityRelationship 모델에 잠금 관련 헬퍼 메서드 추가
- LockCheckTrait 생성 (destroy 시 잠금 체크 공통 로직)
- 각 Service의 destroy() 메서드에 잠금 체크 적용
- API 응답에 is_locked 필드 포함
- 한국어 에러 메시지 추가

## FK 레거시 코드 정리
- ItemMasterSeeder: entity_relationships 기반으로 전환
- ItemPage 모델: FK 기반 sections() 관계 제거
- ItemSectionService: clone() 메서드 FK 제거
- SectionTemplateService: page_id 컬럼 참조 제거
- EntityRelationship::link() 파라미터 순서 통일

## 기타
- Swagger 스키마에 is_locked 속성 추가
- 프론트엔드 가이드 문서 추가
2025-11-27 15:51:00 +09:00

99 lines
2.8 KiB
PHP

<?php
namespace App\Models\ItemMaster;
use App\Traits\BelongsToTenant;
use App\Traits\ModelTrait;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\SoftDeletes;
class ItemPage extends Model
{
use BelongsToTenant, ModelTrait, SoftDeletes;
protected $fillable = [
'tenant_id',
'group_id',
'page_name',
'item_type',
'absolute_path',
'is_active',
'created_by',
'updated_by',
'deleted_by',
];
protected $casts = [
'group_id' => 'integer',
'is_active' => 'boolean',
'created_at' => 'datetime',
'updated_at' => 'datetime',
'deleted_at' => 'datetime',
];
protected $hidden = [
'deleted_by',
'deleted_at',
];
/**
* 페이지와 연결된 섹션 관계 목록 (링크 테이블 기반)
*/
public function sectionRelationships()
{
return $this->hasMany(EntityRelationship::class, 'parent_id')
->where('parent_type', EntityRelationship::TYPE_PAGE)
->where('child_type', EntityRelationship::TYPE_SECTION)
->orderBy('order_no');
}
/**
* 페이지와 직접 연결된 필드 관계 목록 (링크 테이블 기반)
*/
public function fieldRelationships()
{
return $this->hasMany(EntityRelationship::class, 'parent_id')
->where('parent_type', EntityRelationship::TYPE_PAGE)
->where('child_type', EntityRelationship::TYPE_FIELD)
->orderBy('order_no');
}
/**
* 페이지에 연결된 섹션들 조회 (링크 테이블 기반)
*/
public function linkedSections()
{
return ItemSection::whereIn('id', function ($query) {
$query->select('child_id')
->from('entity_relationships')
->where('parent_type', EntityRelationship::TYPE_PAGE)
->where('parent_id', $this->id)
->where('child_type', EntityRelationship::TYPE_SECTION);
});
}
/**
* 페이지에 직접 연결된 필드들 조회 (링크 테이블 기반)
*/
public function linkedFields()
{
return ItemField::whereIn('id', function ($query) {
$query->select('child_id')
->from('entity_relationships')
->where('parent_type', EntityRelationship::TYPE_PAGE)
->where('parent_id', $this->id)
->where('child_type', EntityRelationship::TYPE_FIELD);
});
}
/**
* 페이지의 모든 관계 목록 조회 (섹션 + 직접 연결된 필드)
*/
public function allRelationships()
{
return $this->hasMany(EntityRelationship::class, 'parent_id')
->where('parent_type', EntityRelationship::TYPE_PAGE)
->orderBy('order_no');
}
}