3D 에셋 라이브러리
개요
이 화면은 무엇인가요?
이 화면에서는 3D 에셋 라이브러리 데이터를 등록하고 관리합니다. 에셋유형(EQUIPMENT, FACILITY, SENSOR, PIPE 등)별로 분류할 수 있으며, 상태(active → inactive → under_review)를 추적합니다.
누가 사용하나요?
- 3D모델러: 3D 에셋 라이브러리 3D 에셋 등록, 모델 관리
- IoT엔지니어: 3D 에셋 라이브러리 등록, 설정 변경, 연결 관리
- XR개발자: 3D 에셋 라이브러리 XR 인터랙션 설정
언제 사용하나요?
- 신규 3D 에셋 라이브러리 데이터를 등록할 때
- 기존 3D 에 셋 라이브러리 정보를 수정하거나 이력을 확인할 때
- 3D 에셋 라이브러리의 상태를 변경하거나 진행 현황을 추적할 때
주요 기능
- 등록·조회: 3D 에셋 라이브러리 데이터의 신규 등록 및 목록 조회
- 유형별 분류: 에셋유형(EQUIPMENT , FACILITY , SENSOR 등)별 분류 및 필터
- 상태 추적: 상태 변경 이력 관리 및 현황 확인
- 파일 첨부: 관련 문서·이미지 업로드 및 관리
- 감사 추적: 데이터 변경 이력 자동 기록
업무 흐름에서의 위치
입력 항목 가이드
| 항목 | 설명 | 필수 | 입력 예시 |
|---|---|---|---|
| 에셋코드 | 고유 식별 코드 | ✅ | ASSET-CODE-001 |
| 에셋명 | 식별하기 쉬운 이름 | ✅ | (이름 입력) |
| 에셋유형 | 분류 구분 | ✅ | EQUIPMENT / FACILITY / SENSOR |
| 파일포맷 | 파일포맷 | ✅ | GLTF / GLB / FBX |
| 파일URL | 파일URL | ✅ | 텍스트 입력 |
| 썸네일URL | 썸네일URL | 텍스트 입력 | |
| 파일크기(바이트) | 파일크기(바이트) | 숫자 입력 | |
| 폴리곤수 | 폴리곤수 | 숫자 입력 | |
| 바운딩박스 | 바운딩박스 | 자유 텍스트 입력 | |
| LOD레벨 | LOD레벨 | 숫자 입력 | |
| 분류태그 | 분류 구분 | 자유 텍스트 입력 | |
| 버전 | 버전 | ✅ | 텍스트 입력 |
| 상태 | 현재 진행 상태 | ✅ | active / inactive / under_review |
| 업로더ID | 업로더ID | 목록에서 선택 |
자주 묻는 질문 (FAQ)
상태를 변경할 수 없습니다. 왜 그런가요?
워크플로우가 설정된 경우, 정해진 순서대로만 상태를 변경할 수 있습니다. 현재 상태에서 변경 가능한 다음 상태만 선택할 수 있으며, 필수 입력 항목이 누락되어 있지 않은지 확인해 주세요.
3D 에셋 라이브러리 데이터를 대량으로 등록하려면 어떻게 하나요?
CSV 가져오기 기능을 사용합니다. 먼저 CSV 내보내기로 템플릿을 다운로드한 후, 템플릿에 맞춰 데이터를 입력하고 CSV 가져오기로 일괄 등록합니다.
실무 시나리오
신규 3D 에셋 라이브러리 등록
상황: 새로운 3D 에셋 라이브러리 데이터를 등록해야 합니다.
처리 순서:
- 에셋코드를 입력하여 신규 데이터를 생성합니다
- 에셋유형을
EQUIPMENT으로 선택합니다 - 에셋명을(를) 입력합니다
- 상태를
active으로 설정합니다 - 저장하여 등록을 완료합니다
참고: 데이터 구조
테이블: dt_scene_3d_assets
| 컬럼명 | 한글명 | 타입 | 설명 |
|---|---|---|---|
asset_code | 에셋코드 | VARCHAR | *필수 |
asset_name | 에셋명 | VARCHAR | *필수 |
asset_type | 에셋유형 | EQUIPMENT / FACILITY / SENSOR / PIPE / STRUCTURE / ANNOTATION / ZONE / CUSTOM | *필수 |
file_format | 파일포맷 | GLTF / GLB / FBX / OBJ / STEP / IFC | *필수 |
file_url | 파일URL | VARCHAR | *필수 |
thumbnail_url | 썸네일URL | VARCHAR | |
file_size_bytes | 파일크기(바이트) | INT | |
polygon_count | 폴리곤수 | INT | |
bounding_box | 바운딩박스 | TEXT | |
lod_levels | LOD레벨 | INT | |
tags | 분류태그 | TEXT | |
version | 버전 | VARCHAR | *필수 |
status | 상태 | active / inactive / under_review | *필수 |
uploaded_by | 업로더ID | UUID |