[E2E] 제품 대표 복합 요청 시나리오·데모 런북 완성

[hywznn]

한 줄 목표

Knowledge 0.3.0의 E-9 3년 만료 연장 Golden Case를 기준으로, 실제 배포 환경에서 AI 분석부터 Case·Task·승인·문서·Worker Link·응답 회수·완료까지 한 번에 재현합니다.

고정 계약

• Client는 빠른 선택 태그를 붙이지 않고 사용자가 작성한 발화문 원문만 전송합니다.
• AI가 대표 Intent EXPIRY_RENEWAL과 Workflow WF-STY-001을 반환합니다.
• PLAN 결정을 ANALYZE에서 재사용합니다.
• Knowledge/Workflow Catalog version은 0.3.0입니다.
• WF-STY-001 필수 Slot은 worker_id, due_at입니다.
• Candidate 채택은 Case·Task 생성이며 승인·발송이 아닙니다.

대표 입력

응웬반A가 3년 만료 예정이야. 재계약하고 체류연장 준비해줘

로컬 Golden E2E 완료

• 원문 PLAN → 추가 질문 → ANALYZE → Candidate 채택
• Knowledge CASE-EXPIRY-RENEWAL-001 기준 Case 1건·Task 4건 생성
• 재계약 → 조건부 신분서류 보완 → 취업활동기간 연장 → 체류기간 연장 순서
• HR Slot 답변과 Server DB Context 보충
• Worker Link 접속·파일 제출·HR 공식 문서 채택
• OCR 검토 → Outbox → Renewal 자동 재개
• Language Assistant 검토 초안과 HWP 원본 생성·다운로드
• 승인·외부 제출 증빙·완료
• 최종 Case COMPLETED, 4/4, 진행률 100%
• Golden Flow 구현 PR feat(workflow): Knowledge 기반 재계약 Golden Case 실행 #207 병합
• Client Golden Flow 연결 PR #360 병합

배포 E2E에서 확인된 범위

• 배포본 데모 로그인 → Dashboard 진입
• 원문 발화 → PLAN → 추가 질문 → ANALYZE → Candidate 표시
• Candidate 채택 → 실제 Case·Task 생성
• 저장된 PDF 문서 2페이지 미리보기
• Renewal 응답의 guideFailureCode=null
• workerRequestMessage와 번역 안내문 생성
• 실제 OCR → State 병합 → Renewal 재개 → 생성 문서 검토
• 같은 요청·Candidate·Worker 제출 재전송 시 중복 0건
• 승인 전 자동 발송 차단과 version 충돌 확인
• Server 재시작 뒤 미완료 Run·Event 복구
• 처음 참여한 팀원이 Runbook만 보고 2분 대표 시나리오 재현

현재 차단 원인 (2026-08-19)

Server 기능과 로컬 Golden E2E는 완료됐습니다. 배포 환경에서는 Renewal 호출이 AI #69의 LANGUAGE_ASSISTANT_NOT_CONFIGURED로 중단됩니다.

즉 현재 막힌 지점은 “Server가 AI를 호출하지 못함”이 아니라, 배포 AI의 Language Assistant가 실제 안내 초안을 만들 수 있는 설정으로 기동되지 않음입니다.

• 배포 설정 추적: [Deploy] PostgreSQL·AI Runtime 기반 데모 배포 구성 #9
• AI 원인 추적: [Bug] renewal-run 응답 중 "guide_failure_code": "LANGUAGE_ASSISTANT_NOT_CONFIGURED" ai#69

남은 순서

1. AI feat: 데모 사업장 및 근로자 시드 데이터 확장 #69 해결과 AI Pod 재기동
2. #9에서 Server↔AI endpoint·공유 인증·Pod 네트워크 확인
3. 배포 Task에서 Renewal → Language Assistant → 문서 생성 왕복
4. Worker Link → 파일 제출 → OCR → State 병합 → Renewal 자동 재개
5. 중복 요청·승인 전 발송 차단·재시작 복구 검증
6. 2분 데모 Runbook 최종 고정 후 완료 처리

완료 조건

• 대표 발화 1회로 Case·Task 생성부터 완료까지 이어집니다.
• 안내문·OCR·생성 문서가 실제 Provider 결과이며 Stub 성공으로 대체되지 않습니다.
• 재전송·재시작에도 중복 Case·Task·문서가 생기지 않습니다.
• 승인 전에는 안내 발송과 외부 제출이 실행되지 않습니다.
• 실행 로그와 Runbook만으로 실패 단계를 재현·설명할 수 있습니다.

배포 선행: #9 · 외부 차단: fowoco/ai#69 · 상위: #2 · 로컬 Golden 구현: #197 / PR #207