Files
sam-docs/dev/history/2025-11/front-requests/[API-2025-11-26] item-master-api-changes.md
권혁성 db63fcff85 refactor: [docs] 팀별 폴더 구조 재편 (공유/개발/프론트/기획)
- 개발팀 전용 폴더 dev/ 생성 (standards, guides, quickstart, changes, deploys, data, history, dev_plans 이동)
- 프론트엔드 전용 폴더 frontend/ 생성 (api/ → frontend/api-specs/)
- 기획팀 폴더 requests/ 생성
- plans/ → dev/dev_plans/ 이름 변경
- README.md 신규 (사람용 안내), INDEX.md 재작성 (Claude Code용)
- resources.md 신규 (노션 링크용, assets/brochure 이관 예정)
- CURRENT_WORKS.md 삭제, TODO.md → dev/ 이동
- 전체 참조 경로 업데이트

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-05 16:46:03 +09:00

2.6 KiB

Item Master API 변경사항

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


구조 변경

section_templates 테이블 삭제item_sectionsis_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": "스펙정보" }]
}