feat: 통합 문서함·파일 업로드·문서 준비도 구현

[chaeliki]

왜 필요한가요?

#13(통합 문서함·파일 업로드·문서 준비도)의 4개 API와 감사 로그 연동,
통합 테스트까지 완료했습니다.

Closes #13

완료된 범위

API 4개

• POST /files — 파일 업로드 (MIME/크기 검증, scan_status NOT_SCANNED 고정)
• GET /documents — 통합 문서함 조회 (근로자 표시 이름 포함)
• GET /tasks/{taskId}/document-readiness — 서류 준비도 (Task 체크리스트 snapshot 기준)
• PUT /tasks/{taskId}/document-request-draft — 문서 요청 초안 저장(생성/갱신)

패키지

• file: StoredFile 도메인, FileStorage port + LocalFileStorage/FakeFileStorage
• document: ChecklistItemDocumentMapper(itemCode↔DocumentType), DocumentRequestDraft,
  통합 조회·준비도·초안 Service 3종

worker 패키지 재수정 (이미 병합된 #5 코드)

• WorkerDocument에 file_id 실제 연결 (tenant 재검증 포함)
• WorkerRepository에 근로자 배치조회 추가, count 쿼리 정리(리팩토링)

감사 로그

• 파일 업로드, 서류-파일 연결, 초안 저장 시 AuditEvent 기록
• AuditAction/AuditTargetType에 새 값 추가 (FILE_UPLOADED, WORKER_DOCUMENT_FILE_LINKED,
  DOCUMENT_REQUEST_DRAFT_SAVED / FILE, WORKER_DOCUMENT, DOCUMENT_REQUEST_DRAFT)

존재-검증 감사

• 모든 Service의 외부 ID 참조를 재점검해 실제 버그 3건 발견·수정
  (FileService.upload()의 taskId/workerId, WorkerDocumentService.register()의 workerId,
  DocumentRequestDraftService.upsert()의 taskId — 전부 존재하지 않는 ID를 넘기면
  DB 제약 위반으로 500이 나던 것을 404로 명확히 처리하도록 수정)

통합 테스트

• FileSecurityIntegrationTest 3개 (업로드 성공+감사로그, MIME 거부, taskId 존재검증)
• DocumentSecurityIntegrationTest 6개 (준비도 missing→available, 준비도 타사업장 404,
  목록조회+근로자이름, 초안 생성/갱신/버전충돌, 초안 타사업장 404)

결정 사항

• scan_status는 검사 인프라가 없어 항상 NOT_SCANNED로 고정, 파일 연결은 허용
• 파일 크기(20MB)·허용 MIME은 상식적인 기본값 (FileService에 TODO)
• purpose, SubmissionStatus 4개 값 확정, WorkerDocument.taskId 필터는
  #60으로 분리
• file/document 패키지 분리는 docs/project-structure.md 기준
• ChecklistItemDocumentMapper는 직접 정의
  (현재 워크플로우 2개, item_code 6개 반영, 향후 갱신 필요)

item_code	DocumentType	근거
PASSPORT_COPY_VERIFY_CURRENT	PASSPORT_COPY	이름 직접 대응
ALIEN_REGISTRATION_CARD_VERIFY_CURRENT	ARC	약자 대응
EMPLOYMENT_CONTRACT_VERIFY_PERIOD	CONTRACT	근로계약 관련
EMPLOYMENT_CONTRACT_USE_CURRENT_STANDARD_FORM	CONTRACT	근로계약 관련
EMPLOYMENT_PERMIT_VERIFY_PERIOD	PERMIT	고용허가 관련
APPLICATION_FORM_SELECT_CURRENT	(매핑 없음)	서류 확인 아닌 액션, 준비도 계산 제외

발견된 버그 (수정 완료)

• LocalFileStorage: 저장 경로가 normalize() 안 돼서 실제 파일 저장 시 항상 실패
• DocumentRequestDraftJpaEntity: @Version 누락으로 버전이 증가 안 함

검증

• ./gradlew clean test — 전체 통과 (170개)

리뷰 포인트

• ChecklistItemDocumentMapper의 하드코딩 매핑 방식 (임시, 후속 갱신 필요)

[hywznn]

금일 오전 중으로 확인해보겠습니다