fix: Renewal·OCR·문서 미리보기 E2E 화면 정합성 보강

[hywznn]

한 줄 요약

데모 계정, Renewal 진행 상태, 다국어 안내 검토, OCR 결과 표시, 생성 문서 미리보기를 최신 Server 계약에 맞춰 하나의 화면 흐름으로 통합합니다.

Refs fowoco/server#10

왜 필요한가요?

• Client 데모 계정과 배포 Server의 Demo Seed 값이 다르면 한 번 클릭 로그인이 실패합니다.
• Renewal 재실행 뒤 안내 생성 실패를 일반 NEEDS_INFO처럼 보여 주면 HR이 다음 행동을 판단하기 어렵습니다.
• OCR 내부 오류 키가 그대로 노출되면 사용자가 어떤 항목을 확인해야 하는지 알기 어렵습니다.
• PDF 문서는 다운로드 전에 내용을 확인할 방법이 없어 HR 검토 흐름이 끊깁니다.

무엇이 바뀌나요?

데모 로그인

• 데모 계정 이메일과 비밀번호를 VITE_DEMO_ACCOUNT_EMAIL, VITE_DEMO_ACCOUNT_PASSWORD 환경변수로 분리합니다.
• 기본값은 기존 데모 계정을 유지하고 .env.example에 Server Seed와 맞추는 방법을 안내합니다.

Renewal·안내 검토

• Server가 안내 검토 필요 상태를 반환하면 자동 발송을 중단하고 HR 수동 검토 경로를 표시합니다.
• 대상 근로자의 선호 언어를 조회하고, 비한국어 안내에는 한국어 기본 문구를 자동 입력하지 않습니다.
• HR 입력 Slot을 임금·근로시간·계약일 등 사용자용 이름과 입력 형식으로 표시합니다.
• 실행 결과가 도착하면 Task·문서·활동·준비도를 즉시 다시 조회합니다.
• Renewal 실행 중에는 SSE와 polling을 함께 사용해 terminal event를 놓쳐도 화면이 멈추지 않도록 합니다.

OCR·문서 미리보기

• OCR 원본 대조 사유를 내부 키 대신 사용자용 한글 항목명으로 표시합니다.
• Renewal이 요청한 OCR Slot을 여권·외국인등록증 요청 초안에 반영합니다.
• WorkerDocument의 source와 신원보증서 문서 유형을 Server 계약에 맞춥니다.
• Server의 /files/{fileId}/preview를 호출하고 PDF를 화면 안에서 미리 봅니다.
• 업무별 문서만 조회하도록 taskId 필터를 사용합니다.

선행 작업 반영

• Client fix: 안내 생성 실패를 HR 수동 검토 화면에 연결 #345 다국어 안내 실패 차단·HR 검토 흐름 병합
• Client fix(document): 문서함 전체 페이지 조회 지원 #348 문서 목록 정합성 병합
• Server feat: SIGN-UP 화면 Figma PWF v3 정합 #187 파일 미리보기 API 병합
• Server [Refactor] SET-001 승인 정책 카드 단일 승인자 모델로 정정 + 초기 데이터 가져오기 탭 추가 #195 Renewal 생성 문서·OCR 후속 상태 계약 병합
• 최신 main 반영 및 충돌 해결

검증

• 전체 Client 테스트 — 84개 파일, 467개 테스트 성공
• 프로덕션 빌드 성공
• 린트 오류 0건 (기존 Fast Refresh 경고 13건)
• 안내 검토·Renewal Slot·OCR 라벨·PDF 미리보기 회귀 테스트
• GitHub CI 전체 통과
• 배포 환경에서 실제 AI·OCR Provider를 활성화한 대표 시나리오 E2E

병합 후 확인

• 배포 Client의 데모 로그인
• Case 상세 Renewal 실행과 HR Slot 보완
• PDF 미리보기
• 모바일 링크 제출 후 HR 회수
• 실제 Provider 사용 시 OCR → Renewal 재개 → 생성 문서 연결