README.md

AI 학습용 '의류 대표 이미지' 선정 GUI 툴 명세서

1. 툴의 핵심 목적 (The Core Purpose)

이 툴은 "AI 모델 학습에 사용할 의류 대표 이미지를 가장 효율적으로 선정하기 위한 내부 검수 도구"입니다.

AI가 특정 옷의 특징을 정확하게 학습하고 좋은 설명을 생성하려면, 그 특징을 가장 잘 보여주는 '대표 사진'이 반드시 필요합니다. 이 툴은 작업자가 수많은 사진 중에서 가장 적합한 대표 사진을 쉽고 빠르게 선택, 수정, 관리할 수 있도록 돕는 것을 목표로 합니다.

2. 핵심 원리: 폴더 구조 기반 작업 환경

이 툴은 별도의 데이터베이스 설정 없이, 아래와 같은 폴더 구조를 직접 읽어들여 자동으로 작업 환경을 구성합니다.

3. 주요 목표: 최고의 대표 이미지 2장 선정

각 상품(제품 ID)의 색상별로 다음 두 가지 대표 이미지를 선정합니다.

• 모델 착용 (model): model 폴더 내에서 가장 이상적인 모델 착용 사진 1장
• 제품 단독 (product_only): product_only 폴더 내에서 가장 이상적인 제품 단독 사진 1장

4. 작업 흐름 (Workflow) 시나리오

1. 작업 폴더 열기

• 검수할 상품 폴더들이 들어있는 최상위_작업폴더를 툴로 불러옵니다.

2. 자동 분류 및 시각화

• 툴이 폴더 구조를 자동으로 분석하여 화면을 구성합니다.
  • (좌측) 제품 목록: 4059274, 5820193 등 제품 ID 목록이 표시됩니다.
  • (상단) 색상 탭: 좌측에서 제품 ID(4059274)를 클릭하면, 해당 제품의 색상(Black, Blue)들이 화면 상단에 탭 형태로 나타납니다.
  • (중앙) 이미지 패널: 색상 탭(Black)을 선택하면, 중앙 화면이 두 개의 패널로 나뉩니다.
    • '모델 착용' 패널: model 폴더의 이미지들이 표시됩니다.
    • '제품 단독' 패널: product_only 폴더의 이미지들이 표시됩니다.
  • (부가 정보) 만약 json 등 추가 데이터가 있다면, 크롤링된 색상 정보 등이 화면에 함께 표시됩니다.

3. 검수 작업 수행

• 이제 작업자는 각 패널에서 대표 이미지 1장씩을 선택하는 것을 목표로 검수를 시작합니다.
  • 3.1 대표 이미지 변경(더 적합한 사진이 있을 경우) : 해당 패널 안에서 마음에 드는 다른 사진을 마우스로 클릭합니다. 클릭 즉시 새로운 대표 이미지로 지정됩니다.
  • 3.2**. 대표 이미지 최초 선정**(아직 대표 이미지가 지정되지 않은 경우) : 각 패널에서 가장 적합한 사진을 마우스로 클릭하여 대표 이미지로 최초 선정합니다.
  • 3.3 이미지의 색상 그룹 이동('Black' 폴더에 'Blue' 사진이 있는 경우) : 해당 사진을 마우스로 드래그하여 상단의 올바른 색상 탭('Blue') 위로 옮깁니다.(실제 파일도 해당 색상 폴더로 이동됩니다.)
  • 3.4. 이미지의 카테고리 이동('모델 착용' 사진이 '제품 단독' 패널에 있는 경우) : 해당 사진을 마우스로 드래그하여 올바른 패널('모델 착용')으로 이동시킵니다. <br>(실제 파일도 model ↔ product_only 폴더 간에 이동됩니다.)
  • 3.5 불필요한 이미지 삭제<br>(상품과 무관하거나 품질이 매우 낮은 사진) : 해당 사진을 선택하고 삭제 버튼을 누릅니다. <br>(경고 메시지 확인 후 실제 파일이 영구 삭제됩니다.)
  • 3.6. 이미지 직접 편집 (자르기)<br>(세그멘테이션 오류 등으로 이미지를 잘라내야 할 경우) : 1. 해당 이미지를 더블클릭하거나 '편집' 버튼을 눌러 편집 화면으로 전환합니다.<br>2. 마우스로 원하는 영역을 드래그하여 직접 잘라내고(Crop) 저장합니다.<br>3. 편집된 이미지를 바탕으로 다시 대표 이미지 선정 작업을 진행합니다.

4. 최종 확정 및 저장

• 대표 이미지를 선택하거나 수정하면, 모든 변경사항(선정, 이동, 삭제, 편집)은 시스템에 자동으로 기록 및 저장됩니다.

5. 추가 기능 제안: 작업 효율 극대화를 위하여

1. 속도 및 효율성 향상

• 키보드 단축키 지원:
  • 방향키 (←, →): 이전/다음 상품으로 빠르게 이동
  • 방향키 (↑, ↓): 후보 이미지들 내에서 선택 포커스 이동
  • 스페이스 바 또는 Enter: 포커스된 이미지를 대표 이미지로 지정
  • Delete 키: 선택된 이미지 삭제
• 일괄 처리 (Batch Processing):
  • Shift 또는 Ctrl 키를 이용해 여러 이미지를 한 번에 선택하여 다른 색상 그룹으로 옮기거나 삭제하는 기능.
• 진행률 표시 및 필터링:
  • 전체 상품 대비 검수 완료 현황을 보여주는 진행률 표시줄(Progress Bar).
  • 검수 완료, 미완료, 플래그 지정 등 상태별로 상품 목록을 필터링하는 기능.

2. 데이터 품질 관리

• 품질 플래그(Flag) 기능:
  • 삭제하기는 애매하지만 품질에 이슈가 있는 이미지(예: 저화질, 흐릿함, 구도 불량)에 플래그를 지정하는 기능. 추후 플래그별로 모아보기 및 일괄 처리가 가능합니다.
• 상세 정보 표시 (툴팁):
  • 이미지 위에 마우스를 올리면 파일명, 해상도(1024x1024), 파일 크기 등 메타데이터를 보여주는 기능. 저화질 이미지를 직관적으로 식별하는 데 유용합니다.

3. 사용자 경험(UX) 개선

• 실행 취소 / 다시 실행 (Undo / Redo):
  • Ctrl+Z, Ctrl+Y를 통해 실수로 수행한 작업(이동, 삭제, 지정 등)을 되돌리거나 복원하는 필수 기능.
• 레이아웃 커스터마이징:
  • 이미지 썸네일 크기를 슬라이더로 조절하거나, 화면 패널의 너비를 조절하는 등 사용자 맞춤형 화면 구성 옵션.
• 테마 지원 (다크/라이트 모드):
  • 장시간 검수 시 작업자의 눈 피로를 덜어주기 위한 화면 테마 전환 기능.

4. 협업 및 관리

• 코멘트/메모 기능:
  • 특정 상품이나 이미지에 대해 텍스트 메모를 남기는 기능 (예: "이 상품은 재촬영 필요", "JSON 정보와 실제 색상 다름").
• 작업 내역 보고서 내보내기 (Export):
  • 검수 완료 후, 각 상품 및 색상별로 어떤 파일이 대표 이미지로 선정되었는지 목록을 CSV 또는 Excel 파일로 추출하는 기능. 최종 결과 정리 및 보고에 매우 유용합니다.