Skip to content

feat: Language Assistant 검토 초안 보존 - #181

Open
hywznn wants to merge 2 commits into
mainfrom
feat/180-language-guide-review-draft
Open

feat: Language Assistant 검토 초안 보존#181
hywznn wants to merge 2 commits into
mainfrom
feat/180-language-guide-review-draft

Conversation

@hywznn

@hywznn hywznn commented Aug 15, 2026

Copy link
Copy Markdown
Contributor

왜 필요한가요?

실제 Language Assistant는 한국어 안내문·쉬운 한국어·번역문을 생성해도 품질 검증 결과가 warning이면 HR 검토를 요청합니다. 기존 Server는 검토 플래그와 실패 코드만 저장하고 본문을 버려, HR이 검토할 내용을 볼 수 없었습니다.

Closes #180

무엇이 바뀌나요?

  • Runtime의 Language Assistant 결과에서 허용한 본문과 경고 코드만 선별합니다.
  • Renewal 실행 응답에 guide_review_draft를 반환합니다.
  • 기존 Task 실행정보에 같은 값을 저장해 새로고침 후에도 복구합니다.
  • 안내문 필드 타입과 generation_status·requires_human_review 정합성을 Server에서 다시 검증합니다.
  • 잘못된 Provider 응답은 조용히 버리지 않고 계약 오류로 차단합니다.
  • 공식 document_request_draft, Worker Link, SMS는 자동 생성하지 않습니다.
  • README와 AI Runtime 계약 문서를 갱신했습니다.
  • Flyway·DB 스키마 변경은 없습니다.

검증

  • ./gradlew test --tests "*RenewalRuntimeContractValidatorTest" --tests "*RenewalExecutionIntegrationTest" --no-daemon — 성공
  • ./gradlew clean test --no-daemon — 성공
  • GitHub Server CI·API 문서·DB 문서 — 성공
  • 실제 AI Runtime 왕복
    • 한국어·쉬운 한국어·번역문 생성 확인
    • guide_review_draft API 반환 확인
    • Task 재조회 후 동일 본문 복구 확인
    • worker_message_draft_id=null 확인
  • 실제 HWP 생성 왕복
    • HWP 5.x 파일 4종 생성
    • 생성 문서 본문을 다시 파싱해 이름·여권번호·외국인등록번호·임금·업무 값 반영 확인

리뷰 시 확인할 점

  • guide_review_draft는 AI 제안이며 공식 발송 초안이 아닙니다.
  • HR 수정·승인 전까지 기존 fail-closed 흐름을 유지합니다.
  • 외부 AI 응답의 본문 타입·상태·검토 플래그가 모순되면 INVALID_RESPONSE_CONTRACT로 차단합니다.

@hywznn
hywznn marked this pull request as ready for review August 15, 2026 03:32
@hywznn
hywznn requested review from chaeliki and krestar August 15, 2026 03:32
@hywznn hywznn added the status:in-review 구현을 마치고 리뷰 또는 병합을 기다리는 작업 label Aug 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

status:in-review 구현을 마치고 리뷰 또는 병합을 기다리는 작업

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[AI Integration][P0] Language Assistant 검토 초안을 보존·조회

1 participant