Skip to content

fix: 안내 생성 실패를 HR 수동 검토 화면에 연결 - #345

Draft
hywznn wants to merge 1 commit into
mainfrom
feat/worker-guide-review-ui
Draft

fix: 안내 생성 실패를 HR 수동 검토 화면에 연결#345
hywznn wants to merge 1 commit into
mainfrom
feat/worker-guide-review-ui

Conversation

@hywznn

@hywznn hywznn commented Aug 15, 2026

Copy link
Copy Markdown
Contributor

왜 필요한가요?

Server #162/#179 이후 Renewal 실행은 근로자 안내 생성에 실패하면 guide_review_required=trueguide_failure_code를 반환하고, 안전하지 않은 안내 초안과 발송 링크를 만들지 않습니다.

하지만 Client는 두 필드를 응답 타입에 포함하지 않아 실패 상태를 버리고 있었습니다. 또한 저장된 초안이 없으면 브라우저가 한국어 안내문을 자동으로 채워, 베트남어 등 다른 언어를 사용하는 근로자에게 잘못된 문구가 확정될 수 있었습니다.

무엇이 바뀌나요?

1. Server 계약 수용

  • RenewalExecutionResponseguide_review_required, guide_failure_code 추가
  • 알려진 실패 코드를 HR이 이해할 수 있는 문구로 변환
  • 내부 실패 코드 원문은 UI에 노출하지 않음

2. 실패 시 Fail-closed UI

  • Renewal 실행 결과에서 안내 생성 실패를 즉시 경고
  • 안내 초안과 발송 링크가 생성되지 않았음을 명시
  • 결과 반영 후 문서 탭으로 이동해 HR의 다음 행동을 연결
  • Task의 business_data.renewal_execution을 읽어 새로고침 후에도 검토 상태 복원

3. 대상 언어 기반 수동 초안

  • 근로자의 preferred_language를 새 초안의 기본 언어로 사용
  • 비한국어 대상 또는 안내 검토 필요 상태에서는 한국어 문장을 자동 입력하지 않음
  • HR이 안내문을 직접 입력하기 전에는 저장 요청을 보내지 않음
  • 이미 저장된 정상 초안은 언어·문구·버전을 그대로 복원

동작 흐름

AI 안내 생성 실패
→ Server: guide_review_required=true, 초안/링크 미생성
→ Client: 실패 사유와 미생성 사실 표시
→ 문서 탭: 근로자 preferred_language 선택 + 빈 안내문
→ HR 직접 작성·검토
→ 요청 초안 저장

영향 범위

  • Client가 번역을 새로 수행하지는 않습니다.
  • Server가 성공적으로 저장한 안내 초안의 기존 흐름은 변경하지 않습니다.
  • 알 수 없는 신규 실패 코드는 안전한 공통 검토 문구로 표시합니다.
  • 자동 발송은 추가하지 않습니다.

검증

  • 관련 테스트: 35개 통과
  • 전체 테스트: 457개 통과
  • Production build: 통과
  • ESLint: 오류 0개, 기존 routes.tsx Fast Refresh 경고 13개
  • git diff --check: 통과

확인 체크리스트

  • Server snake_case 응답 필드와 동일한 이름 사용
  • 실패 코드 원문 미노출
  • 실패 상태에서 안내문 미입력 저장 차단
  • 근로자 선호 언어 기본 선택
  • 저장된 초안 회귀 테스트
  • Server 배포본과 실제 Renewal 실패 응답 smoke test

Closes #343

관련: fowoco/server#162, fowoco/server#179, fowoco/ai#44

Supersedes #344 — 브랜치 명명 규칙을 feat/로 맞추기 위해 대체합니다.

@hywznn hywznn self-assigned this Aug 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Client] 근로자 안내 생성 실패 시 HR 수동 검토 UI 연결

1 participant