Sprint 1 Issue Tracker

Known Issues Tracker

Sprint 1 데모 개발과 검증 중 발견한 기능 이슈를 추적한다. 현재 기준은 데모앱 commit cc7abb9 이후 상태다.

10tracked issues
5resolved
1diagnosed
4Sprint 2 follow-up

상태 기준

해결은 현재 데모앱 또는 문서/자산에서 수정이 반영된 상태다. 진단은 원인을 확인했지만 Sprint 1에서는 사용하지 않는 경로로 결정한 상태다. 미해결은 Sprint 2 데이터, 모델 구조, Flutter 온디바이스 통합에서 이어갈 항목이다.

이슈 목록

# 분류 증상 상태 현재 처리 다음 액션
#1 Text search 경복궁 검색에서 MMCA가 1위로 올라옴. 해결 MMCA catalog의 위치 설명이 검색어를 오염시킨 것으로 보고 해당 표현을 정리했다. catalog에 위치 정보와 시각 특징을 섞지 않는 라벨링 가이드를 유지.
#2 Text search 한복 입고 사진 찍는 곳이 궁궐 계열보다 MMCA로 기울 수 있음. 미해결 영어 중심 CLIP text space에서 한국어 사진 표현이 picture/art 계열로 흔들리는 케이스로 분류. 한국어 caption, user query, hard negative query를 보강하고 Flutter 검색 UI에서는 Top-3 후보 선택형으로 처리.
#3 ONNX text ONNX 모드 자연어 검색이 keyword 중심으로만 동작. 해결 text encoder ONNX를 export하고 ONNX/INT8 경로에서 OnnxTextEncoder를 로드하도록 반영했다. Flutter에서는 image encoder 이후 text encoder 탑재 순서로 단계화.
#4 Image search 광화문 wide shot에서 청와대/경복궁 배경이 섞이면 점수가 흔들림. 미해결 대상이 크게 잡힌 광화문 crop은 안정화됐지만, wide shot은 hard case로 남긴다. view_type별 prototype, parent landmark, 광화문 wide/close-up 데이터 보강.
#5 Quantization AI Hub w8a16 INT8 모델의 임베딩 공간이 붕괴. 진단 calibration 15장과 260장 모두 실패, 같은 디바이스 FP32는 cosine 0.9995로 정상. PTQ 알고리즘과 ViT-S4 분포 적합도 문제로 판단. Sprint 1 정확도 모델은 ORT dynamic INT8/FP32를 사용. Sprint 2에서 AIMET QAT 또는 mixed precision 검토.
#6 Reliability 화면 캡처나 지원 범위 밖 이미지가 확정 답처럼 보일 수 있음. 해결 matched, ambiguous, out_of_scope, low_quality 정책과 OOS fixture를 적용했다. Sprint 2에서 실제 OOS negative set을 늘려 calibration을 재조정.
#7 Handoff config.onnx.toml, config.int8.toml이 개인 D: 경로를 참조. 해결 데모앱 commit cc7abb9에서 ./mobile_artifacts, ./mobile_artifacts_int8 상대경로로 수정. artifact 압축 전달 시 폴더가 repo root 바로 아래에 놓이는지 확인.
#8 UI routing 자연어 검색 결과에서 자세히 보기가 상세 페이지로 들어가지 않음. 해결 데모앱 commit 4631502에서 session_state 라우팅에 ?landmark_id=... query param을 추가했다. Flutter에서는 상세 이동을 route argument로 넘기고, 검색 결과 DTO를 화면 상태에 보존.
#9 Image search 근정문/근정전 계열 이미지가 1위여도 점수가 낮아 거절 또는 애매로 처리됨. 미해결 현재 라벨링은 근정문과 근정전을 같은 경복궁 중심 권역으로 본다. class 내부 외관 폭이 넓어 prototype 대표성이 약한 상태. 표시명을 경복궁 근정문·근정전으로 정리하고, gate/hall/courtyard prototype 분할을 검토.
#10 Text search text encoder 한국어/영어 후보 간 점수 폭이 좁음. 미해결 keyword/alias matching이 안전장치 역할을 하지만, semantic 점수만으로는 클래스 간 분리가 약한 query가 있다. 한국어/영어 query catalog를 확장하고, 앱에서는 애매한 결과를 Top-3 후보 선택형으로 표시.

로컬 환경 메모

Windows paging file 오류, C 드라이브 scratch 공간 부족, 대용량 ONNX external data 복사 문제는 제품 기능 이슈가 아니라 개발 환경 이슈로 분류한다. 팀원 실행 기준은 repo-local config와 별도 전달 artifact 폴더다.