JWT Metadata 기반 Onboarding 상태 관리로 DB Read 최적화

Context

기존 Auth flow의 선제적 가입 요구로 인한 Conversion rate 저하 문제 발생. Onboarding 완료 여부 확인을 위해 모든 Protected route에서 DB Read를 수행하는 비효율적 구조의 한계 직면.

Technical Solution

• 가치 제공 후 계정 생성을 유도하는 'Create Invoice First, Auth Later' flow로 전환하여 사용자 이탈 방지
• DB Read 부하 제거를 위해 Onboarding 상태값을 Clerk의 User Metadata에 저장하는 구조 채택
• JWT 내에 Onboarding 상태를 포함시켜 Middleware 단계에서 DB 호출 없이 즉시 상태 검증 구현
• Invoice 필드 간 높은 의존성 해결을 위해 Stepper 방식 대신 Split-panel 뷰를 통한 실시간 Preview 동기화 설계
• Prop Drilling로 인한 User 객체 undefined 버그 해결을 위해 Type 정의 통합 및 데이터 전달 구조 최적화