ETR-77 Feat: /predict 단일 엔드포인트에 mode/options로 정밀 모드 분기 추가 #13
Description
상위 작업 Jira Ticket Number
No response
이슈 설명
배경
현재 /predict는 단일 파이프라인(프레임 균등 샘플링 → dlib 검출 → Xception 추론)만 지원합니다.
현장 피드백(강한 햇빛/저조도 환경에서의 강건성)과 “단일 메뉴 + 고급 설정” UX를 위해 동일 엔드포인트에서
정밀 모드(illumination correction, TTA, detector fallback, smoothing 등)를 토글할 수 있어야 합니다.
제안
- /predict 하나만 유지하고,
mode(default|precision)와 개별options로 동작 분기 - precision 모드에서 전처리/추론 보강 기능을 활성화
- 조명 보정(CLAHE + gray-world WB + mild gamma)
- Test-Time Augmentation(좌우반전/밝기±/감마)
- 얼굴 검출기 백업(OpenCV DNN, dlib 실패 시)
- 결과 스무딩(이동 평균)
- 균등 샘플링 개선(개수 지정)
체크리스트
-
/predict가mode=default로 호출되면 기존과 동등한 결과/레이턴시 -
mode=precision에서 조명 보정, TTA, DNN 백업, smoothing이 활성화 - 응답 JSON에
options_used와taskId포함 - 기존 클라이언트(파라미터 미전달)와 완전 호환