Skip to content

feat(demo-data): 합성 근로자 전체 문서 원본 적재 - #183

Draft
hywznn wants to merge 8 commits into
mainfrom
feat/182-demo-passport-fixture
Draft

feat(demo-data): 합성 근로자 전체 문서 원본 적재#183
hywznn wants to merge 8 commits into
mainfrom
feat/182-demo-passport-fixture

Conversation

@hywznn

@hywznn hywznn commented Aug 15, 2026

Copy link
Copy Markdown
Contributor

무엇을 변경했나요

  • Demo Company 28명에게 서로 다른 합성 신원과 유효 여권 파일을 구성했습니다.
  • 신규 문서 43건과 기존 LEGACY 비누락 문서 67건의 원본을 실제 파일 저장소에 멱등 적재합니다.
  • 대표 근로자 응웬반A에게 여권, 외국인등록증 앞·뒤·통합본, 고용허가서, 표준근로계약서, 취업활동기간 연장신청서, 통합신청서, 체류지 입증자료를 연결했습니다.
  • 외국인등록증은 카드형 정보 구조와 합성 인물 사진을 사용하고 공식 보안문양·관인은 복제하지 않습니다.
  • OCR 필드 위의 대각선 워터마크와 배경 문구를 제거하고, 필드 밖 상하단 표시·무효 식별번호·비공식 발급기관으로 합성 문서를 구분합니다.
  • 고용허가서와 표준근로계약서는 서버 근로자·회사·업무 메타데이터로 채웁니다.
  • 연장신청서와 통합신청서의 DRAFT는 빈 원본이 아니라 모든 가용 필드가 채워진 미서명 초안입니다.
  • OCR fixture의 외국인등록번호·체류자격·만료일·주소를 실제 Seed 근로자와 일치시켰습니다.
  • 한글 렌더링을 위해 OFL 라이선스의 Noto Sans KR 폰트를 번들링했습니다.
  • 기존 메타데이터는 유지하고 cleanup 시 이 기능이 추가한 파일 연결만 원복합니다.

왜 필요한가요

문서 메타데이터만 있고 원본 파일이 없거나, 파일 본문과 근로자 DB가 달라 Client 미리보기·다운로드·OCR 계보를 종단 간 검증할 수 없었습니다. 또한 초안 파일이 빈 양식이고 중앙 워터마크가 OCR 입력을 가려 실제 검토 시나리오를 재현하기 어려웠습니다. 이번 변경으로 영구 PostgreSQL과 로컬 영구 파일 볼륨에서 서로 일치하는 합성 데이터를 재현할 수 있습니다.

결과

  • 메타데이터: 126건 (DEMO_SEED 43 + LEGACY 83)
  • 원본 파일: 109개 (이미지 71, PDF 34, HWP 1, HWPX 3)
  • 누락 상태: 17건
  • 유효 여권 보유 근로자: 28명
  • 대표 근로자 연결 문서: 14건
  • 타 회사 상세·다운로드: 404
  • OCR 검토 fixture: REVIEW_REQUIRED, 원본 문서·파일 ID 연결

모든 문서는 실제 개인정보와 공식 보안문양을 사용하지 않습니다. OCR 필드 밖의 고정 DEMO / NOT VALID 표시와 비실재 번호를 유지합니다.

검증

  • ./gradlew test --no-daemon — 성공
  • SyntheticDocumentGeneratorTest — OCR 필드 내 붉은 오버레이 픽셀 0 확인
  • DEMO_DOCUMENT_DATA_COMMAND=import 실행 후 126/109건 확인
  • 동일 import 재실행 후 중복 0건
  • DEMO_DOCUMENT_DATA_COMMAND=verify 성공
  • Server 재시작 후 readiness UP
  • 외국인등록증·여권 저장 파일 SHA-256과 DB checksum 일치
  • Client 문서함 126건, 응웬반A 14건 표시 확인
  • Client 외국인등록증 이미지 미리보기 및 OCR 검토 UI 확인
  • Client 근로자 상세 화면의 연결 문서·상태·유효기간 표시 확인
  • 브라우저 경고·오류 0건
  • 타 회사 계정의 문서 상세·파일 다운로드 404
  • OCR latest 응답의 문서 ID·파일 ID·검토 상태 확인

Closes #182

@hywznn hywznn changed the title feat(demo-data): 합성 여권 인적사항면 품질 개선 feat(demo-data): 전체 근로자 합성 여권 사본 27건 추가 Aug 15, 2026
@hywznn hywznn added the status:in-progress 담당자가 현재 구현 중인 작업 label Aug 15, 2026
@hywznn hywznn changed the title feat(demo-data): 전체 근로자 합성 여권 사본 27건 추가 feat(demo-data): 합성 근로자 전체 문서 원본 적재 Aug 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

status:in-progress 담당자가 현재 구현 중인 작업

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat: 합성 근로자 전체 문서 메타데이터·파일 적재

1 participant