9. 알려진 이슈 · 함정

인수자가 모르면 시간을 잃거나 사고를 낼 수 있는 것들.

9.1 함정(Gotchas)

• Auth 리다이렉트 루프: 인증 미완료 페이지(verify-email, consent)에서 로그인 이동 시 반드시 signOut() 후 이동. <NuxtLink> 직접 이동은 무한 루프.
• Tailwind v4 동적 클래스: JIT 정적 스캔만 — 동적 문자열 조합 금지, CVA 사용.
• 보고서 3중 동기화: 필드 추가 시 스키마 3 · 라우터 3 · 페이지 4 모두 수정.
• 출처: ARCHITECTURE.md §Invariants

9.2 문서/현실 드리프트

• 루트 README.md 상단이 제너릭 스타터 템플릿(포트 3000/3001, math·docs 앱)으로 실제(web 단일, 포트 3800)와 불일치했음 → 정리 완료 (CTO 요청, 별도 커밋).