## 잠금 기능 (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 속성 추가 - 프론트엔드 가이드 문서 추가
134 lines
3.8 KiB
PHP
134 lines
3.8 KiB
PHP
<?php
|
|
|
|
namespace App\Services\ItemMaster;
|
|
|
|
use App\Exceptions\BusinessException;
|
|
use App\Models\ItemMaster\EntityRelationship;
|
|
use App\Models\ItemMaster\ItemPage;
|
|
use App\Services\Service;
|
|
use App\Traits\LockCheckTrait;
|
|
use Illuminate\Support\Collection;
|
|
use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
|
|
|
|
class ItemPageService extends Service
|
|
{
|
|
use LockCheckTrait;
|
|
|
|
/**
|
|
* 페이지 목록 조회 (섹션/필드 중첩)
|
|
*/
|
|
public function index(?string $itemType = null): Collection
|
|
{
|
|
$tenantId = $this->tenantId();
|
|
|
|
$query = ItemPage::with([
|
|
'sections' => function ($query) {
|
|
$query->orderBy('order_no');
|
|
},
|
|
'sections.fields' => function ($query) {
|
|
$query->orderBy('order_no');
|
|
},
|
|
'sections.bomItems',
|
|
])
|
|
->where('tenant_id', $tenantId)
|
|
->where('is_active', 1);
|
|
|
|
if ($itemType) {
|
|
$query->where('item_type', strtoupper($itemType));
|
|
}
|
|
|
|
return $query->get();
|
|
}
|
|
|
|
/**
|
|
* 페이지 생성
|
|
*/
|
|
public function store(array $data): ItemPage
|
|
{
|
|
$tenantId = $this->tenantId();
|
|
$userId = $this->apiUserId();
|
|
|
|
$page = ItemPage::create([
|
|
'tenant_id' => $tenantId,
|
|
'page_name' => $data['page_name'],
|
|
'item_type' => $data['item_type'],
|
|
'absolute_path' => $data['absolute_path'] ?? null,
|
|
'is_active' => true,
|
|
'created_by' => $userId,
|
|
]);
|
|
|
|
// 관계 로드
|
|
$page->load(['sections']);
|
|
|
|
return $page;
|
|
}
|
|
|
|
/**
|
|
* 페이지 수정
|
|
*/
|
|
public function update(int $id, array $data): ItemPage
|
|
{
|
|
$tenantId = $this->tenantId();
|
|
$userId = $this->apiUserId();
|
|
|
|
$page = ItemPage::where('tenant_id', $tenantId)
|
|
->where('id', $id)
|
|
->first();
|
|
|
|
if (! $page) {
|
|
throw new NotFoundHttpException(__('error.not_found'));
|
|
}
|
|
|
|
$page->update([
|
|
'page_name' => $data['page_name'] ?? $page->page_name,
|
|
'absolute_path' => $data['absolute_path'] ?? $page->absolute_path,
|
|
'updated_by' => $userId,
|
|
]);
|
|
|
|
$page->load(['sections.fields', 'sections.bomItems']);
|
|
|
|
return $page;
|
|
}
|
|
|
|
/**
|
|
* 페이지 삭제 (Soft Delete)
|
|
*
|
|
* 독립 엔티티 아키텍처: 페이지만 삭제하고 연결된 섹션/필드는 unlink만 수행
|
|
*/
|
|
public function destroy(int $id): void
|
|
{
|
|
$tenantId = $this->tenantId();
|
|
$userId = $this->apiUserId();
|
|
|
|
$page = ItemPage::where('tenant_id', $tenantId)
|
|
->where('id', $id)
|
|
->first();
|
|
|
|
if (! $page) {
|
|
throw new NotFoundHttpException(__('error.not_found'));
|
|
}
|
|
|
|
// 잠금 체크: 이 페이지의 자식 관계 중 잠금된 것이 있는지 확인
|
|
$hasLockedChildren = EntityRelationship::where('parent_type', EntityRelationship::TYPE_PAGE)
|
|
->where('parent_id', $id)
|
|
->where('is_locked', true)
|
|
->exists();
|
|
|
|
if ($hasLockedChildren) {
|
|
throw new BusinessException(__('error.page_has_locked_children'));
|
|
}
|
|
|
|
// 1. entity_relationships에서 이 페이지의 모든 자식 관계 해제
|
|
// (page→section, page→field 관계 삭제)
|
|
// 주의: 잠금된 연결이 없는 상태에서만 진입
|
|
EntityRelationship::where('parent_type', EntityRelationship::TYPE_PAGE)
|
|
->where('parent_id', $id)
|
|
->where('is_locked', false)
|
|
->delete();
|
|
|
|
// 2. 페이지만 Soft Delete (섹션/필드는 독립 엔티티로 유지)
|
|
$page->update(['deleted_by' => $userId]);
|
|
$page->delete();
|
|
}
|
|
}
|