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 속성 추가
- 프론트엔드 가이드 문서 추가
This commit is contained in:
2025-11-27 15:51:00 +09:00
parent 29fe1415e5
commit efa2a84d2c
35 changed files with 537 additions and 142 deletions

View File

@@ -2,14 +2,18 @@
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;
/**
* 페이지 목록 조회 (섹션/필드 중첩)
*/
@@ -104,10 +108,22 @@ public function destroy(int $id): void
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 (섹션/필드는 독립 엔티티로 유지)