Files
sam-api/app/Models/ItemMaster/ItemSection.php
hskwon bccfa19791 feat: Item Master 하이브리드 구조 전환 및 독립 API 추가
- CASCADE FK → 독립 엔티티 + entity_relationships 링크 테이블
- 독립 API 10개 추가 (섹션/필드/BOM CRUD, clone, usage)
- SectionTemplate 모델 제거 → ItemSection.is_template 통합
- 페이지-섹션, 섹션-필드, 섹션-BOM 링크/언링크 API 14개 추가
- Swagger 문서 업데이트
2025-11-26 14:09:31 +09:00

167 lines
4.5 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 ItemSection extends Model
{
use BelongsToTenant, ModelTrait, SoftDeletes;
protected $fillable = [
'tenant_id',
'group_id',
'page_id',
'title',
'type',
'order_no',
'is_template',
'is_default',
'description',
'created_by',
'updated_by',
'deleted_by',
];
protected $casts = [
'group_id' => 'integer',
'order_no' => 'integer',
'is_template' => 'boolean',
'is_default' => 'boolean',
'created_at' => 'datetime',
'updated_at' => 'datetime',
'deleted_at' => 'datetime',
];
/**
* 템플릿만 조회하는 스코프
*/
public function scopeTemplates($query)
{
return $query->where('is_template', true);
}
/**
* 일반 섹션만 조회하는 스코프 (템플릿 제외)
*/
public function scopeNonTemplates($query)
{
return $query->where('is_template', false);
}
protected $hidden = [
'deleted_by',
'deleted_at',
];
/**
* 소속 페이지 (기존 FK 기반 - 하위 호환성)
*/
public function page()
{
return $this->belongsTo(ItemPage::class, 'page_id');
}
/**
* 섹션의 필드 목록 (기존 FK 기반 - 하위 호환성)
*/
public function fields()
{
return $this->hasMany(ItemField::class, 'section_id')->orderBy('order_no');
}
/**
* 섹션의 BOM 항목 목록 (기존 FK 기반 - 하위 호환성)
*/
public function bomItems()
{
return $this->hasMany(ItemBomItem::class, 'section_id');
}
/**
* 섹션과 연결된 필드 관계 목록 (링크 테이블 기반)
*/
public function fieldRelationships()
{
return $this->hasMany(EntityRelationship::class, 'parent_id')
->where('parent_type', EntityRelationship::TYPE_SECTION)
->where('child_type', EntityRelationship::TYPE_FIELD)
->orderBy('order_no');
}
/**
* 섹션과 연결된 BOM 관계 목록 (링크 테이블 기반)
*/
public function bomRelationships()
{
return $this->hasMany(EntityRelationship::class, 'parent_id')
->where('parent_type', EntityRelationship::TYPE_SECTION)
->where('child_type', EntityRelationship::TYPE_BOM)
->orderBy('order_no');
}
/**
* 섹션에 연결된 필드들 조회 (링크 테이블 기반)
*/
public function linkedFields()
{
return ItemField::whereIn('id', function ($query) {
$query->select('child_id')
->from('entity_relationships')
->where('parent_type', EntityRelationship::TYPE_SECTION)
->where('parent_id', $this->id)
->where('child_type', EntityRelationship::TYPE_FIELD);
});
}
/**
* 섹션에 연결된 BOM 항목들 조회 (링크 테이블 기반)
*/
public function linkedBomItems()
{
return ItemBomItem::whereIn('id', function ($query) {
$query->select('child_id')
->from('entity_relationships')
->where('parent_type', EntityRelationship::TYPE_SECTION)
->where('parent_id', $this->id)
->where('child_type', EntityRelationship::TYPE_BOM);
});
}
/**
* 이 섹션이 연결된 페이지들 조회 (링크 테이블 기반)
*/
public function linkedPages()
{
return ItemPage::whereIn('id', function ($query) {
$query->select('parent_id')
->from('entity_relationships')
->where('parent_type', EntityRelationship::TYPE_PAGE)
->where('child_type', EntityRelationship::TYPE_SECTION)
->where('child_id', $this->id);
});
}
/**
* 섹션의 모든 자식 관계 목록 조회 (필드 + BOM)
*/
public function allChildRelationships()
{
return $this->hasMany(EntityRelationship::class, 'parent_id')
->where('parent_type', EntityRelationship::TYPE_SECTION)
->orderBy('order_no');
}
/**
* 섹션의 모든 부모 관계 목록 조회
*/
public function allParentRelationships()
{
return EntityRelationship::where('child_type', EntityRelationship::TYPE_SECTION)
->where('child_id', $this->id);
}
}