feat(workflow): Knowledge 기반 재계약 Golden Case 실행

[hywznn]

왜 필요한가요?

Candidate 채택 뒤의 재계약 업무가 Server 하드코딩 순서에 의존해, Knowledge가 정의한 E-9 재계약·취업활동기간 연장·체류기간 연장 절차와 화면의 업무 진행이 어긋났습니다. 또한 로컬 H2 데모를 30분 이상 진행하면 H2의 알려진 CHECK 제약 오류로 승인 API가 중단될 수 있었습니다.

Refs #197
Depends on fowoco/knowledge#60
Depends on #202
Runtime dependency: fowoco/ai#60
Document field mapping: fowoco/ai#62
Document preview compatibility: fowoco/ai#54

무엇이 바뀌나요?

• Knowledge CASE-EXPIRY-RENEWAL-001을 읽어 재계약 → 조건부 신분서류 보완 → 취업활동기간 연장 → 체류기간 연장 순서로 Task를 생성합니다.
• 여권·ARC 상태에 따라 신분서류 보완 Task를 조건부 생성합니다.
• Task 제목·설명·체크리스트·완료 증빙을 Catalog에서 가져옵니다.
• 여러 선행 Task가 모두 완료되어야 다음 Task가 현재 업무로 열립니다.
• 기관 직접 제출과 처리결과 기록을 승인 후 항목으로 분리했습니다. 승인 전에는 서류와 신청정보만 필수 확인합니다.
• local profile의 Hikari 물리 연결을 JVM 수명 동안 유지해 H2 2.4.240의 장시간 CHECK 제약 오류를 피합니다. 운영 기준 DB는 PostgreSQL 16으로 유지합니다.
• HR 요청부터 근로자 모바일 제출·OCR 검토·HWP 생성·연장 결과 기록까지 직접 수행하는 Runbook을 갱신했습니다.
• ./scripts/export-golden-demo-files로 실제 개인정보 없이 합성 여권·ARC 파일을 만들 수 있습니다.

DB 영향

• Flyway Migration 없음
• 기존 workflow_case.workflow_snapshot_json, Task business data, Outbox, StoredFile을 재사용합니다.
• 다른 팀 Migration 버전과 충돌하지 않습니다.

실제 수동 E2E 결과

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

• 발화문 분석 → EXPIRY_RENEWAL / WF-STY-001
• Golden Case와 Catalog 순서의 Task 4개 생성
• 여권·ARC 요청 → 공개 링크 조회 → 합성 파일 제출 → HR 공식 문서 채택
• OCR 검토 완료 → Outbox 자동 재개 → HWP 원본 생성·다운로드
• 재계약 승인·증빙·완료
• 취업활동기간 연장 승인·외부 접수 기록·완료
• 체류기간 연장 승인·외부 접수 및 결과 기록·완료
• 최종 Case COMPLETED, 4/4, 진행률 100%, currentTask=null

검증

• ./gradlew test --no-daemon — BUILD SUCCESSFUL
• WorkflowCatalogProjectionTest — BUILD SUCCESSFUL
• ARC 누락 시 Task 순서 1,2,3,4
• 신분서류 보완 불필요 시 Task 순서 1,3,4
• 두 선행 업무가 모두 완료된 뒤 다음 Task 개방
• 승인 전 필수 확인과 승인 후 제출·결과 기록의 순서 고정
• 실제 AI PLAN → 답변 → ANALYZE → Candidate 채택 왕복
• 합성 여권·ARC 제출부터 최종 Case 완료까지 수동 E2E
• git diff --check

병합 전 확인

• Server PR Renewal 확장 응답 계약 수용 #202 병합
• AI PR [Worker] WorkerDocument-Task 연결 (누락 범위 추가) #60 병합 및 동일 계약이 AI main에 반영
• Knowledge PR [Worker] WorkerDocument-Task 연결 (누락 범위 추가) #60 병합
• AI PR [Document] Agent 요청 canonical field allowlist Resolver 구현 #62 표준근로계약서 필드 매핑 반영
• AI PR [Reliability] REVIEW_REQUIRED 수동 재처리 API와 감사로그 구현 #54 HWP·HWPX PDF 변환 호환성 반영
• Client PR #360 사용자 검수 후 병합
• 최신 Server main 반영 후 GitHub CI 재확인 — Server CI 및 문서 빌드 성공

외부기관 자동 제출, 자동 승인, 자동 SMS 발송은 포함하지 않습니다. HWP·HWPX PDF 변환 호환성은 AI #54에서 반영했습니다.