Files

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

2.6 KiB

Raw Blame History

Item Master API 변경사항

작성일: 2025-11-26 대상: 프론트엔드 개발팀 관련 문서: [API-2025-11-25] item-master-data-management-api-request.md

구조 변경

section_templates 테이블 삭제 → item_sections의 is_template=true로 통합

변경된 API

섹션 템플릿 필드/BOM API

요청서	실제 구현
`POST /section-templates/{id}/fields`	`POST /sections/{id}/fields`
`POST /section-templates/{id}/bom-items`	`POST /sections/{id}/bom-items`

→ 템플릿도 섹션이므로 동일 API 사용

신규 API

1. 독립 섹션 API

API	설명
`GET /sections?is_template=true`	템플릿 목록 조회
`GET /sections?is_template=false`	일반 섹션 목록
`POST /sections`	독립 섹션 생성
`POST /sections/{id}/clone`	섹션 복제
`GET /sections/{id}/usage`	사용처 조회 (어느 페이지에서 사용중인지)

Request (POST /sections):

{
  "group_id": 1,
  "title": "섹션명",
  "type": "fields|bom",
  "is_template": false,
  "is_default": false,
  "description": null
}

2. 독립 필드 API

API	설명
`GET /fields`	필드 목록
`POST /fields`	독립 필드 생성
`POST /fields/{id}/clone`	필드 복제
`GET /fields/{id}/usage`	사용처 조회

Request (POST /fields):

{
  "group_id": 1,
  "field_name": "필드명",
  "field_type": "textbox|number|dropdown|checkbox|date|textarea",
  "is_required": false,
  "default_value": null,
  "placeholder": null,
  "options": [],
  "properties": []
}

3. 독립 BOM API

API	설명
`GET /bom-items`	BOM 목록
`POST /bom-items`	독립 BOM 생성

Request (POST /bom-items):

{
  "group_id": 1,
  "item_code": null,
  "item_name": "품목명",
  "quantity": 0,
  "unit": null,
  "unit_price": 0,
  "spec": null,
  "note": null
}

4. 링크 관리 API

API	설명
`POST /pages/{id}/link-section`	페이지에 섹션 연결
`DELETE /pages/{id}/unlink-section/{sectionId}`	연결 해제
`POST /sections/{id}/link-field`	섹션에 필드 연결
`DELETE /sections/{id}/unlink-field/{fieldId}`	연결 해제
`GET /pages/{id}/structure`	페이지 전체 구조 조회

Request (link 계열):

{
  "target_id": 1,
  "order_no": 0
}

Response (usage 계열):

{
  "used_in_pages": [{ "id": 1, "page_name": "기본정보" }],
  "used_in_sections": [{ "id": 2, "title": "스펙정보" }]
}

2.6 KiB Raw Blame History