feat: 승인·감사 워크플로우 구현

[hywznn]

왜 필요한가요?

Closes #11
Refs #5, #6, #23

AI가 만든 업무를 사람 승인 없이 전달하지 않고, 승인 시점의 내용과 이후 상태 변경을 사업장 범위 안에서 추적하기 위한 기반입니다.

Worker·Document 스키마는 병합된 PR #40의 canonical V3를 사용합니다. 이 PR은 Task·Approval이 소유하는 V4·V5만 추가합니다.

무엇이 바뀌나요?

• Task·Checklist·전이 이력 V4와 Approval·Submission·Evidence·Audit V5 migration
• DRAFT → READY_FOR_REVIEW → APPROVED → WAITING_EXTERNAL → COMPLETED 상태 guard
• 승인 요청·승인·반려·외부 제출·증빙·완료 API 6개
• 업무 활동 timeline과 ADMIN 감사 검색 API 2개
• AI 원본·HR 최종본·changed fields·source versions 승인 snapshot
• snapshot의 여권·외국인등록·전화·계좌·token·password·전체 Prompt 유입 차단
• JPA version과 승인 대상 content_revision + fingerprint 분리
• JWT ActorContext 기반 company scope, HR/ADMIN 쓰기, VIEWER timeline, ADMIN audit 권한
• 상태 변경·승인 record·감사 event의 동일 transaction 처리
• stale·중복 승인 요청은 pending approval 조회보다 Task version을 먼저 검사해 일관된 409 CONCURRENT_MODIFICATION 반환

#40 Worker 계약 반영

• 중복 V3__create_worker_core.sql 제거
• work_status, stay_expiry_date, nationality_code, RESIGNED 계약 반영
• (worker_id, company_id) tenant-aware FK 유지
• Worker·WorkerDocument 통합 테스트가 V4·V5 데이터와 함께 실행되도록 정리

대표 API

• POST /api/v1/tasks/{taskId}/approval-requests
• POST /api/v1/tasks/{taskId}/approve
• POST /api/v1/tasks/{taskId}/reject
• POST /api/v1/tasks/{taskId}/external-submissions
• POST /api/v1/tasks/{taskId}/evidence
• POST /api/v1/tasks/{taskId}/complete
• GET /api/v1/tasks/{taskId}/activities
• GET /api/v1/audit-events

검증

• ./gradlew clean test
• 승인 → 제출 → 증빙 → 완료 대표 HTTP 흐름
• 반려 후 DRAFT 복귀와 이전 승인 재사용 차단
• 민감정보 snapshot·감사 저장 실패 시 transaction rollback
• VIEWER 쓰기 차단, ADMIN 감사 검색, 타 사업장 404
• stale version·중복 승인 409와 동시 승인 단일 성공
• 동시 승인 테스트 로컬 반복 실행
• OpenAPI 8개 operation과 공통 오류 계약
• 최신 GitHub Actions Test and build 통과

ADR·저장소 경계

• ADR-0001: Server가 승인·상태·감사를 소유하고 AI Prompt/Provider는 포함하지 않습니다.
• ADR-0002: /api/v1, JWT company scope, 공통 오류, 404 tenant hiding, optimistic concurrency를 따릅니다.
• ADR-0003: Task 상태와 승인 snapshot을 분리하고 version·content_revision·fingerprint를 각각 사용합니다.
• AI 호출, Knowledge Workflow 원본, Worker Link token, Outbox publication은 각각 [AI Integration] AiRuntimeClient·계약 검증·장애 격리 구현 #8/[AI Run] 비동기 실행 상태·재시도·멱등성 구현 #24, knowledge, [Worker Link] 로그인 없는 근로자 보안 링크와 응답 구현 #7, [Reliability] 이벤트 유실 방지·재처리 기반 구현 #25 범위입니다.

리뷰에서 중점 확인할 부분

• PR feat: 근로자 기본정보·서류 메타데이터 API 구현 #40 canonical V3와 V4·V5 migration 경계
• 승인 snapshot에 필요한 값은 남기면서 개인정보·Secret을 차단하는 기준
• Task 전이와 승인 record, 감사 event가 같은 transaction에서 유지되는지
• 중복 승인 시 일관된 409와 단일 승인·감사 기록이 보장되는지
• ADMIN/HR/VIEWER와 company scope가 API·application 양쪽에 적용됐는지

[hywznn]

리뷰 전에 확인할 마지막 보완사항입니다.

• Client가 보내는 requirements_satisfied flag를 제거했습니다.
• Server가 현재 Task 상태와 DB의 필수 checklist 완료 여부를 직접 계산합니다.
• 미완료 필수 checklist가 있으면 승인 요청 전체를 422 TASK_REQUIREMENTS_MISSING으로 거부합니다.
• PostgreSQL migration fixture와 동시 승인 경쟁 test까지 포함해 Test and build가 통과했습니다.

따라서 화면 값을 조작해 READY_FOR_REVIEW로 우회하는 경로는 없습니다.

[chaeliki]

V3 관련해서 조율이 필요할 것 같습니다.
일단 저도 PR 드래프트 올려두고 자러가겠습니다..!! 수고많으셨어요!!