first commit

2026-10-06 12:16:46 +09:00
commit 619d980098
415 changed files with 22283 additions and 0 deletions
@@ -0,0 +1,41 @@
+# Ref2 기준 재QA · 2026-09-14
+
+## 판정
+
+**시각 목표 미달.** 이전 빌드·기능 검증 통과는 유지되지만, 눈·코 식별과 레퍼런스 유사성에 대한 이전 합격 판단은 이번 결과로 정정한다.
+
+## 재현 조건
+
+- 사용자 첨부의 원본 사진은 로컬 `public/assets/qa/dog2.jpeg`와 일치한다.
+- 로컬 배포 미리보기 5175, Chrome, 1280×1000. 기본 조각 유리: Grid 10, Distortion .90, 굴곡 .65, 광택 .30.
+- 원본 전체 구도에서 평면 depth와 실제 AI depth를 각각 확인. 정면/드래그 출력을 캡처했다.
+- 별도로 사진 확대2.2, 가로 .4, 세로 -.4로 얼굴 구도를 만들고 Final / 광택0 / No Glass를 비교했다. 사용자 첨부의 정확한 설정값과 시점은 제공되지 않았으므로 픽셀 단위 동일 재현은 아니다.
+- 테스트 페이지의 UI만 조절했고 앱 소스와 셰이더를 변경하지 않았다.
+
+## 발견 사항
+
+1. **눈·코 조각 식별 실패 — 높음.** 전체 구도에서 검은 얼굴 띠와 작은 밝은 점이 주로 남는다. 얼굴을 확대해도 개별 눈·코 윤곽이 충분히 회복되지 않는다. Ref2의 확대된 눈·코 조각과 차이가 크다.
+2. **정보 손실 방식 부적합 — 높음.** 셀마다 선명한 특징 조각과 정보가 적은 면이 공존해야 하나, 현재는 얼굴·가슴·바닥이 넓은 흐릿한 패치로 보이는 비중이 크다. 확대 구도의 주둥이에 줄무늬/겹침 인상도 있다.
+3. **프레임 안쪽 빈 띠 — 높음.** 사용자 첨부의 왼쪽과 하단에 어두운 불규칙 틈이 보인다. 로컬 드래그에서도 왼쪽 빈 띠가 평면/AI depth 모두에서 나타났다. AI depth만의 문제로 볼 수 없다. 사용자 첨부만큼 큰 틈을 동일 설정으로 재현한 것은 아니다.
+4. **비교 구도 통제 부족.** Ref2는 얼굴 확대인데 사용자 결과는 전신이다. 이전의 흰 강아지 샘플 한 장 중심 판단으로 다른 사진의 실패를 놓쳤다. 얼굴 확대 후에도 실패가 남아 구도만 고쳐서는 해결되지 않는다.
+
+## 코드와 연결한 원인 가설
+
+- 대부분 셀의 샘플 폭은 .28–.48배인데 흐림 간격 .055–.13셀은 축소된 샘플 폭과 무관하다. 확대 셀의 정보까지 과하게 평균화할 수 있다. 9개 떨어진 샘플의 혼합이 줄무늬·겹침 인상에 기여하는지는 별도 분리 실험이 필요하다.
+- 샘플 제한은 RenderTarget 전체 UV에만 걸려 있다. 사진이 실제로 채우는 영역 밖의 배경을 읽는 경우를 막지 못한다. 사진/유리의 깊이 차이와 카메라 이동, 셀별 샘플 이동의 영향을 분리해야 한다.
+- AI depth를 켜도 셀 내부 정보 소실은 해결되지 않는다. 이번 원인은 모델 교체보다 유리 샘플링 설계에서 우선 찾아야 한다.
+
+## 다음 수정 순서와 합격 기준
+
+1. 같은 사진·얼굴 크기·정면으로 고정하고 흐림과 확대 효과를 각각 분리 비교한다. 선명한 눈·코 윤곽이 남는 셀과 저정보 셀이 공존하도록 샘플 범위에 맞춰 흐림을 조정한다.
+2. 프레임 내 유효 사진 영역을 검증하고 좌우 드래그 시 빈 띠가 나타나지 않도록 처리한다. 전체 UV clamp만으로 해결됐다고 판단하지 않는다.
+3. 흰 강아지와 검정·갈색 강아지 모두에서 눈 두 개와 코의 개별 식별을 확인한다. 광택0에서도 굴곡을 유지하고 Distortion0 원본 경로도 확인한다.
+4. Ref1/Ref2 비교 배치를 유지한다. 모델 추론 성공이나 셰이더 컴파일 성공을 시각 합격과 분리한다.
+
+증거: `dog2-flat-neutral.png`, `dog2-flat-drag.png`, `dog2-face-neutral.png`, `dog2-face-gloss0.png`, `dog2-face-noglass.png`, `dog2-ai-noglass.png`, `dog2-ai-neutral.png`, `dog2-ai-drag.png`.
+
+## 후속 보정: 과도한 흐림 축소
+
+사용자가 흐림으로 유리 느낌이 사라진다고 재지적하여 조각 유리의 필터만 수정했다. `src/shaders/mosaic.frag`에서 퍼짐 간격을 .055–.13셀에서 .006–.018셀로 줄이고, 9개 샘플 평균을 중심 .6 + 상하좌우 각 .1의 5개 샘플로 변경했다. 셀별 확대·중심 이동·곡면과 촘촘 유리는 유지했다.
+
+빌드/타입 검사 통과. 동일한 dog2 전체/확대 구도와 흰 강아지 샘플에서 브라우저 페이지 오류 없이 렌더링했다. `dog2-sharp-face.png`에서 이전보다 수염·코·눈 주변의 세부가 살아나는 것을 확인했다. `dog2-sharp-full.png`, `sample-sharp.png`도 확인했다. 작은 얼굴에서 눈이 셀 경계에 걸리는 문제와 드래그 시 가장자리 빈 띠까지 해결한 변경은 아니며 전체 Ref2 시각 QA 합격으로 판정하지 않는다.