fix: 펫 신원 인증 — 기준 프레임↔영상 동일 출처 검증(섀도) + 라이브니스 하한 재검토(도입 보류)

[seizeh]

배경

설계 리뷰에서 확인된 구멍: enroll-pet-identity가 영상만 Gemini로 검증하고 frames[]는 아무 검사 없이 기준셋으로 저장했다. 아무 라이브 영상 + 다른 개체 사진 조합의 직접 POST로 타 개체가 기준셋에 등록되면 이후 게시글 매칭 전체가 무력화된다.

변경 (커밋 3개)

23a7ed4 — 프레임↔영상 바인딩

• enroll-pet-identity: 기존 Gemini 호출 하나에 프레임을 함께 넣어 frames_from_video(같은 개체·배경·촬영 세션) 판정. 호출 횟수 그대로 1회.

23f4b52 — 측정 없는 하드 리젝 제거

• frames_from_video를 섀도 모드로(FRAMES_FROM_VIDEO_ENFORCE=false) — challenge 를 오탐으로 제거한 전례에 따라 오탐률 측정 후 활성화. 오탐 소지: 클라 프레임 추출 시각(800/2500/4000/5500ms)과 Gemini 1fps 샘플링 어긋남.
• verify-post-photo: 1차 커밋에서 켰던 real>=0.70 하한 되돌림 + AI_REAL_THRESHOLD 삭제. 사진 1장 판정은 저조도·역광·블러에 민감해 절대 하한 없이 is_real && real>fake만 사용(영상 11초 기반 enroll 과 모달리티가 달라 대칭 근거 없음).
• 인라인 페이로드 합계 19M chars 가드(video_too_large, Gemini 20MB 보호선).
• docs: supabase-api.md 갱신(+구버전 challenge 잔재 정리, species_mismatch 하드 게이트 반영), supabase-db.md purpose CHECK 'pet_identity' 누락 보정.

355a8d9 — 섀도 판정을 측정 가능하게

• 성공 등록마다 판정 1행을 photo_verifications에 기록 — 분모 = purpose='pet_identity' AND result='pass' 전체, 분자 = 그중 fail_reason='frames_not_from_video_shadow'. _shadow 접미사는 강제 전환 후의 실제 거절 행과의 영구 구분자. 즉시 만료+region_matched=false+image_url=null이라 게시 토큰으로 소비 불가.
• video_too_large 거절 시 inlineChars 실측 로그 + 실패 행 기록(발생 빈도 측정, 가드는 보호자 확인 뒤로).

신뢰 경계 — 이 PR이 막는 것과 못 막는 것

• 막는 것: 검증한 영상과 저장할 기준 프레임이 다른 조합(프레임 바꿔치기). 섀도 검증 후 활성화 시.
• 못 막는 것: 다운로드한 타인 반려동물 영상에서 프레임을 실제로 추출해 보내는 공격 — 영상은 실물·라이브 통과, 프레임도 같은 출처라 통과. 기기 촬영 사실 자체는 어떤 서버 검증으로도 확인 불가하며 App Attest/Play Integrity 가 유일한 해법(미도입, 백로그).
• 보호자 게이트는 이 위협에 무력 — 펫 등록 시 등록자가 자동으로 owner 보호자가 되므로(trg_pets_after_insert), 허위 매물 시나리오의 공격자는 자기가 만든 가짜 펫을 쓴다.
• isMocked/좌표는 클라이언트 자기신고(코드 주석으로 명시).

배포

enroll-pet-identity v23, verify-post-photo v19 ACTIVE (본 PR 최종 내용).

후속

• frames_from_video 섀도 → 강제 전환 (베타 표본 30건 도달 시 판단) #135 — 섀도 → 강제 전환 계획(측정 SQL·판단 기준·전환 절차, 게이트 로직 추출 + Deno 테스트 동반)
• video_too_large 근본 대응 — 클라 영상 압축 vs Gemini Files API #136 — video_too_large 근본 대응(클라 압축 vs Files API 트레이드오프)
• App Attest / Play Integrity 기기 증명, 재등록 시 Storage 고아 프레임 — 백로그

클라이언트 대응: seizeh/pmdart#212

🤖 Generated with Claude Code