[Workflow][P0] E-9 재계약 Golden Case 실행

[hywznn]

한 줄 목표

E-9 3년 만료 대표 시나리오를 Knowledge 기준의 하나의 Case로 실행하고, 사용자가 아래 전 과정을 직접 수행할 수 있게 합니다.

발화문 분석 → 재계약 → 서류 보완 → 취업활동기간 연장 → 체류기간 연장 → 완료

기준 계약

• Knowledge CASE-EXPIRY-RENEWAL-001
• Workflow WF-STY-001
• Golden 근로자: 응웬반A
• Knowledge PR feat: E-9 재계약 Golden Case 실행 계약 추가 knowledge#60
• AI Runtime PR 근로자 안내 실패를 HR 검토로 안전하게 전환 ai#60
• HWP 필드 매핑 PR fix(document): 재계약 조건을 표준근로계약서에 매핑 ai#62
• Server 구현 PR feat(workflow): Knowledge 기반 재계약 Golden Case 실행 #207

완료된 범위

• Knowledge Case Template·Task 순서·선행관계 반영
• 재계약 → 조건부 신분서류 보완 → 취업활동기간 연장 → 체류기간 연장 Task 생성
• 여권·ARC 상태에 따른 서류 보완 Task 조건부 생성
• 여러 선행 Task 완료 후 다음 Task 개방
• 승인 전 검토와 승인 후 기관 직접 제출·결과 기록 분리
• 근로자 링크 제출·WorkerDocument 채택·OCR 검토 후 기존 Renewal 자동 재개
• 기존 Outbox·Task·WorkflowCase·StoredFile 재사용
• 합성 여권·ARC Demo Data 생성 도구와 수동 E2E Runbook 제공
• 동일 이벤트 재처리 시 기존 OCR Run·문서 재사용
• 완료 증빙·승인·외부 제출 없이 연장 Task 완료 차단

실제 검증 결과

2026-08-18 로컬 Server·AI Runtime 왕복에서 다음을 확인했습니다.

• PLAN → 답변 → ANALYZE → Candidate 채택
• Catalog 기준 Task 4건 생성
• 합성 여권·ARC 제출 및 HR 공식 문서 채택
• OCR 검토 후 Outbox가 Renewal 자동 재개
• HWP 원본 생성·다운로드
• 재계약과 두 연장 업무 승인·증빙·완료
• 최종 Case COMPLETED, 4/4, 진행률 100%, currentTask=null

병합 확인

• Server Renewal 확장 응답 계약 수용 #202 병합
• Server fix(ai-run): 근로자 이름 단일 접두어 조회 보완 #206 병합
• Knowledge feat: E-9 재계약 Golden Case 실행 계약 추가 knowledge#60 병합
• AI 근로자 안내 실패를 HR 검토로 안전하게 전환 ai#60 병합
• AI fix(document): 재계약 조건을 표준근로계약서에 매핑 ai#62 병합
• Client #360 병합
• Server feat(workflow): Knowledge 기반 재계약 Golden Case 실행 #207 병합 및 CI 성공

제외 범위

• 외부기관 자동 로그인·자동 제출
• 자동 승인·자동 SMS 발송
• 실제 개인정보 Demo Data
• 여섯 Workflow 공통 Runtime 일반화
• HWP/HWPX → PDF 브라우저 미리보기 품질 보완

배포 환경의 실제 Provider E2E는 #9와 #10에서 계속 추적합니다.

[hywznn]

1차 구현은 Knowledge의 CASE-EXPIRY-RENEWAL-001을 기존 workflow_case·task·Snapshot으로 materialize하는 Golden Flow입니다. 새 Flyway 없이 조건부 신분서류 Task, Task별 체크리스트, 다중 선행관계, 전체 Case 제목을 적용하고 E2E로 검증합니다. 여섯 Workflow 공통 상태 엔진은 이 결과 이후 후속 범위로 유지합니다.

[hywznn]

구현 Draft PR을 올렸습니다: #207

현재 반영 범위:

• Knowledge CASE-EXPIRY-RENEWAL-001 기반 Task 순서·체크리스트
• ARC 누락 시 조건부 신분서류 보완 Task 생성
• 재계약과 서류 보완이 모두 끝난 뒤 취업활동기간 연장 개방
• 취업활동기간 연장 완료 후 체류기간 연장 개방
• 수동 Golden Flow 가이드 docs/golden-renewal-manual-e2e.md
• Flyway 변경 없음

로컬 전체 ./gradlew test는 BUILD SUCCESSFUL입니다. Knowledge PR fowoco/knowledge#60 병합 후 최신 main 기준 CI를 재확인합니다.

[hywznn]

PR #207이 main에 병합됐고, Knowledge·AI·Client 선행 PR과 로컬 Golden E2E까지 확인했습니다. 배포 환경의 실제 Renewal·OCR·문서 생성 왕복은 #9와 #10에서 계속 추적하므로 이 구현 이슈는 완료 처리합니다.