Skip to content

fix: Renewal 문서 생성과 승인·OCR 후속 흐름 안정화 - #195

Merged
hywznn merged 4 commits into
mainfrom
fix/golden-flow-e2e-stability
Aug 16, 2026
Merged

fix: Renewal 문서 생성과 승인·OCR 후속 흐름 안정화#195
hywznn merged 4 commits into
mainfrom
fix/golden-flow-e2e-stability

Conversation

@hywznn

@hywznn hywznn commented Aug 16, 2026

Copy link
Copy Markdown
Member

한 줄 요약

Renewal이 생성한 문서를 현재 업무에 맞게 검증·저장하고, 승인·OCR 이후 다음 Workflow와 Case 상태가 안전하게 이어지도록 보강합니다.

Refs #10

왜 필요한가요?

  • AI가 반환한 생성 문서를 모두 같은 문서 유형으로 저장하면 HR 문서함에서 실제 용도를 구분할 수 없습니다.
  • 다른 Workflow의 템플릿이나 필수값이 빠진 문서를 그대로 저장하면 잘못된 초안을 정상 결과처럼 보여 줄 수 있습니다.
  • 같은 Case에서 HR이 이미 입력한 안전한 계약 Slot을 재사용하지 못하면 Workflow 재실행 때 같은 정보를 다시 요구합니다.
  • 근로자 제출 문서가 이전 Task에 연결된 경우 현재 Renewal 실행이 OCR 결과를 찾지 못할 수 있습니다.
  • 마지막 Task가 끝나도 Case가 완료되지 않거나 동시 승인 요청이 일관되지 않은 오류를 반환하는 상태 전이 문제가 있었습니다.

무엇이 바뀌나요?

생성 문서 계약과 출처

  • Task 유형별 canonical template과 필수 values를 검증합니다.
  • 생성 목적에 맞는 DocumentType으로 저장하고 AI_GENERATED 출처를 기록합니다.
  • 신원보증서 문서 유형과 Flyway V53을 추가합니다.
  • 잘못된 템플릿, 빈 필수값, 현재 Task와 무관한 문서는 저장 전에 거부합니다.

Workflow 상태 연결

  • 같은 Case에서 이미 확인된 비민감 계약 Slot을 다음 Renewal 실행에 재사용합니다.
  • 여권번호·외국인등록번호 같은 민감값은 일반 Slot 재사용 대상에서 제외합니다.
  • OCR 결과를 현재 Task에서 못 찾으면 같은 근로자의 유효한 결과를 안전하게 조회합니다.
  • 모든 Task가 완료되면 Case도 COMPLETED로 전환합니다.
  • 동시에 승인한 두 요청은 한 건만 성공하고 나머지는 409 Conflict를 반환하도록 정리합니다.

다른 PR과의 관계

검증

  • ./gradlew clean test 전체 성공
  • 모바일 보안 링크 접속 → 요청 파일 선택 → 업로드 → 제출 완료 브라우저 E2E 확인
  • 파일 업로드 API 201 Created와 로컬 저장 결과 확인
  • 개인정보 원문을 일반 Slot 재사용에서 제외하는 테스트
  • 생성 문서 계약·출처·상태 전이·동시 승인 테스트
  • feat: 문서 안전 보관과 업무 조회 제외 구현 #194 병합 후 최신 main 반영
  • 깨끗한 PostgreSQL에서 Flyway V52 → V53 순차 적용 검증
  • 실제 AI·OCR Provider를 활성화한 Staging 대표 시나리오 E2E

병합 전 확인

@hywznn hywznn self-assigned this Aug 16, 2026
@hywznn hywznn added area:server Spring Boot API·도메인·DB·tenant·Task Workflow 영역; Prompt·모델·Provider 구현 제외 area:ai-integration Server ↔ AI Runtime 내부 계약·Client·검증·trace 연동 영역; Prompt·모델·Provider 구현은 ai 저장소 소유 priority:P0 MVP 진행을 막는 최우선 핵심 작업 status:in-progress 담당자가 현재 구현 중인 작업 type:integration 외부 LLM·DB·스토리지 등 시스템 간 연동 작업 labels Aug 16, 2026
@hywznn
hywznn marked this pull request as ready for review August 16, 2026 14:44
@hywznn hywznn added status:in-review 구현을 마치고 리뷰 또는 병합을 기다리는 작업 and removed status:in-progress 담당자가 현재 구현 중인 작업 labels Aug 16, 2026
@hywznn
hywznn merged commit 63164e0 into main Aug 16, 2026
4 checks passed
@hywznn
hywznn deleted the fix/golden-flow-e2e-stability branch August 16, 2026 15:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:ai-integration Server ↔ AI Runtime 내부 계약·Client·검증·trace 연동 영역; Prompt·모델·Provider 구현은 ai 저장소 소유 area:server Spring Boot API·도메인·DB·tenant·Task Workflow 영역; Prompt·모델·Provider 구현 제외 priority:P0 MVP 진행을 막는 최우선 핵심 작업 status:in-review 구현을 마치고 리뷰 또는 병합을 기다리는 작업 type:integration 외부 LLM·DB·스토리지 등 시스템 간 연동 작업

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant