[Feature] 완료 처리 실제 API 연동 (외부제출/증빙/완료)

[BcKmini]

배경

fowoco/server 승인·감사 API(#11)에 완료 처리 흐름도 포함돼 있다. CaseDetailPage의 완료 처리 오버레이(#148)는 데모 데이터로 먼저 구현했다.

실제 서버 API

POST /api/v1/tasks/{taskId}/external-submissions  (외부기관 제출 기록 — 서버가 대신 제출하지 않음)
POST /api/v1/tasks/{taskId}/evidence               (완료 증빙 등록)
POST /api/v1/tasks/{taskId}/complete               (완료 처리)

주의할 점

• recordExternalSubmission는 "HR이 직접 수행한 제출 결과만 기록"한다 — 클라이언트의 "실제 제출은 담당자가 직접 수행했습니다" 체크박스와 정확히 대응된다.
• 각 요청의 정확한 body 필드는 컨트롤러 소스(ExternalSubmissionRequest/EvidenceRequest/CompleteTaskRequest 등, 파일명은 확인 필요)를 다시 확인해서 클라이언트 ExternalCompletionModal의 증빙 유형(접수번호/파일/화면 캡처) 선택지와 맞춰야 한다.
• #148에서 만든 InternalCompletionModal(내부업무, 증빙 불필요)에 대응하는 별도 API가 있는지 확인 필요 — 없다면 complete만으로 처리되는지 확인.

완료 조건

• 증빙 등록 API의 정확한 요청 필드를 확인한다
• ExternalCompletionModal의 "완료 처리" 버튼이 실제 evidence + complete 호출로 교체됨
• InternalCompletionModal의 "파일 없이 완료"가 실제 complete 호출로 교체됨 (증빙 없이 호출 가능한지 확인)
• 테스트 작성

[BcKmini]

정확한 요청 필드를 확인했습니다.

`POST .../evidence` (EvidenceRequest):

• `evidence_type`: enum `DOCUMENT, RECEIPT, OFFICIAL_RESULT, HR_CONFIRMATION` — 클라이언트 데모의 "접수번호/파일/화면 캡처" 3개 칩과 이름이 다릅니다. 매핑 제안: 접수번호→`RECEIPT`, 파일→`DOCUMENT`, 화면 캡처→`DOCUMENT`(별도 타입 없음). "실제 제출은 담당자가 직접 수행했습니다" 체크박스는 별도 boolean 필드가 아니라 `HR_CONFIRMATION` 타입의 증빙을 별도로 등록하는 것입니다 — 즉 완료 처리 흐름이 지금 데모보다 한 단계 더 필요할 수 있습니다(증빙 1개 + HR_CONFIRMATION 증빙 1개, 총 2번 호출).
• `file_reference`, `note`, `recorded_at` 필드 있음.

`POST .../external-submissions` (ExternalSubmissionRequest) — 데모에 아예 없던 필드 발견:

• `destination` (제출처, 예: 기관명) — 필수(`@NotBlank`)인데 지금 클라이언트 ExternalCompletionModal에는 이 입력 필드가 없습니다.
• `safe_reference` (안전한 접수 참조값, PII 제외) — 필수. 지금 데모의 "접수번호" 값이 이거에 대응하는 걸로 보이는데, 이름이 "안전한 참조값"이라 실제 접수번호 원문을 그대로 넣어도 되는지 아니면 마스킹된 값이어야 하는지 서버 쪽에 확인이 필요합니다.
• `submitted_at`

결론: #148에서 만든 ExternalCompletionModal은 필드 구성 자체를 다시 짜야 합니다 — 지금은 "증빙 유형 + 값 + 체크박스 + 메모"인데, 실제로는 "제출처 입력 → external-submissions 기록 → 증빙 등록(evidence) → HR 확인 증빙 등록(evidence, HR_CONFIRMATION) → complete" 순서가 될 가능성이 높습니다. 정확한 순서/상태 전이는 ApprovalService 구현을 더 봐야 확정할 수 있습니다.