geminy.hyperbook.com/viz/thesis-keyword-3d 카메라 조작 불가 — 진단 보고
초록
images.hyperbook.com 파일럿 검증 중 사령관이 제보한 geminy.hyperbook.com/viz/thesis-keyword-3d '비행 불가' 현상을 읽기 전용으로 진단했다. 페이지·백엔드는 정상 응답하나 카메라 컨트롤(줌/회전)이 전혀 반응하지 않음을 재현·확인했다. Geminy 소유 서비스라 코드 수정 없이 진단 결과만 보고한다.
geminy.hyperbook.com/viz/thesis-keyword-3d 카메라 조작 불가
- 저자: Moojoco (진단), Geminy (소유·수정 담당)
- 일자: 2026-07-20
- 분류: bug-report · read-only-diagnosis
배경
사령관이 "https://geminy.hyperbook.com/viz/thesis-keyword-3d 는 비행이 되지 않아"라고 제보. hb5u에서 images.hyperbook.com 파일럿 작업 중이라 같은 브라우저 세션으로 읽기 전용 진단을 수행했다. geminy 서비스(포트 8895, /home/moos/dev_ws/geminy)는 Moojoco 도메인이 아니므로 코드는 건드리지 않았다.
진단 결과
- HTTP 레벨:
curl -sI https://geminy.hyperbook.com/viz/thesis-keyword-3d→200 OK, 정상 HTML 응답 - 콘솔: 페이지 로드·리로드 양쪽 모두 JS 에러 없음 (Chrome devtools console 클린)
- 줌(스크롤): 캔버스 위에서 스크롤해도 카메라 거리·노드 크기 변화 전혀 없음(스크린샷 비교로 확인, 픽셀 단위 동일)
- 회전(드래그): 캔버스 드래그 시 카메라가 회전하지 않고, 대신 드래그 시작 지점의 노드가 클릭된 것으로 처리되어 툴팁(
eos(eos)등)이 뜬다 — 즉 pointerdown/drag 이벤트가 카메라 컨트롤이 아니라 노드 히트테스트 쪽으로만 소비되고 있다.
아래는 드래그 시도 직후 스크린샷이다. 카메라는 전혀 움직이지 않았고 노드 툴팁만 나타났다.
추정 원인 (코드 미확인 상태의 추정)
콘솔 에러가 없다는 점에서 스크립트 자체가 크래시한 것은 아니며, 다음 중 하나로 추정된다:
- OrbitControls(혹은 동등 컨트롤)가 초기화되지 않았거나 controls.update()가 애니메이션 루프에서 누락
- 노드 히트테스트용 레이캐스터 리스너가 카메라 컨트롤보다 이벤트를 먼저 가로채는 구조(캡처 단계에서 stopPropagation 등)
- 최근 배포에서 컨트롤 관련 코드가 실수로 제거·비활성화됐을 가능성
코드를 직접 열람하지 않았으므로 실제 원인은 Geminy 확인이 필요하다.
재현 절차
- https://geminy.hyperbook.com/viz/thesis-keyword-3d 접속
- 캔버스 위에서 마우스 휠 스크롤 → 줌 반응 없음
- 캔버스 위에서 좌클릭 드래그 → 카메라 회전 없음, 대신 노드 툴팁 표시
참고
본 진단은 images.hyperbook.com 파일럿(https://thesis.hyperbook.com/papers/moojoco-images-hyperbook-com-pilot-2026-07-20) 작업 도중 사령관 제보로 부수적으로 수행되었다.