Files
sam-api/app/Models/ItemMaster/ItemSection.php
권혁성 189b38c936 feat: Auditable 트레이트 구현 및 97개 모델 적용
- Auditable 트레이트 신규 생성 (bootAuditable 패턴)
  - creating: created_by/updated_by 자동 채우기
  - updating: updated_by 자동 채우기
  - deleting: deleted_by 채우기 + saveQuietly()
  - created/updated/deleted: audit_logs 자동 기록
- 기존 AuditLogger 패턴과 동일한 try/catch 조용한 실패
- 변경된 필드만 before/after 기록 (updated 이벤트)
- auditExclude 프로퍼티로 모델별 제외 필드 설정 가능
- 제외 대상: Attendance, StockTransaction, TodayIssue 등 고빈도/시스템 모델

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 15:33:54 +09:00

158 lines
4.4 KiB
PHP

<?php
namespace App\Models\ItemMaster;
use App\Traits\Auditable;
use App\Traits\BelongsToTenant;
use App\Traits\ModelTrait;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\SoftDeletes;
class ItemSection extends Model
{
use Auditable, BelongsToTenant, ModelTrait, SoftDeletes;
protected $fillable = [
'tenant_id',
'group_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',
];
/**
* 관련 엔티티(fields, bomItems) 로드
*
* entity_relationships 기반이므로 일반 Eloquent load() 대신 사용
*
* @return $this
*/
public function loadRelatedEntities(): self
{
$this->setRelation('fields', $this->linkedFields()->orderBy('order_no')->get());
$this->setRelation('bomItems', $this->linkedBomItems()->orderBy('id')->get());
return $this;
}
/**
* 섹션과 연결된 필드 관계 목록 (링크 테이블 기반)
*/
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);
}
}