[Case][P0] Case·Workflow Snapshot·업무함 Projection 구현

[hywznn]

한 줄 목표

업무함에서 여러 Task를 하나의 Case로 묶어 보고, Case를 만들 당시의 Workflow 순서와 조건을 Snapshot으로 고정합니다.

쉽게 말하면: 근로자 한 명의 “3년 만료 연장 준비”라는 큰 업무 폴더 안에 재계약·취업활동기간 연장·체류기간 연장 Task를 넣는 기능입니다.

왜 필요한가요?

현재 Task에는 case_id가 있지만 Case 자체의 테이블·상태·조회 API가 없습니다. 그래서 화면은 같은 Case의 Task 목록은 찾을 수 있어도, 전체 진행률·현재 할 일·처음 확정된 Workflow를 신뢰성 있게 보여 줄 수 없습니다.

API 범위

• GET /api/v1/cases — 업무함 Case 목록
• GET /api/v1/cases/{caseId}/projection — 선택한 Case의 전체 진행 상황

MVP에서는 별도 POST /cases를 만들지 않습니다. #24의 candidate 채택 시 Server가 Case와 Task를 한 Transaction에서 생성하거나 기존 Case에 연결합니다.

구현 범위

• Case 모델과 Flyway migration
• company_id, worker_id, 제목, 상태, 우선순위, 생성자·생성시각 관리
• Case 생성 시 Workflow Catalog의 version·단계 순서·필수조건을 Snapshot으로 저장
• Case 목록에 근로자 표시명, 진행률, 현재 Task, D-day, 우선순위 반환
• Projection에 Task·Checklist·Document 준비도·Approval·Worker 응답·Evidence 요약 반환
• Task 변경 뒤 Case 진행률을 DB 중복 상태로 따로 관리하지 않고 안전하게 계산하거나 일관되게 갱신
• 다른 사업장의 Case·Task가 섞이지 않도록 tenant 검사
• 목록 N+1 조회와 페이지네이션 점검

대표 예시

Case: 응웬반A 3년 만료 연장
├─ Task 1: 재계약
├─ Task 2: 취업활동기간 연장
└─ Task 3: 체류기간 연장

Workflow Catalog가 나중에 바뀌어도 이미 시작한 Case는 생성 당시 Snapshot을 사용합니다.

완료 조건

• 같은 candidate 결정을 재전송해도 Case·Task가 중복 생성되지 않습니다.
• GET /api/v1/cases에서 업무함에 필요한 최소 요약을 조회할 수 있습니다.
• Projection의 진행률과 실제 Task·Checklist 상태가 일치합니다.
• 다른 사업장의 Case는 ID를 알아도 404로 처리됩니다.
• Workflow Catalog 변경 뒤에도 기존 Case의 Snapshot이 변하지 않습니다.
• OpenAPI와 PostgreSQL tenant 통합 테스트가 있습니다.

이번 이슈에서 하지 않는 것

• Client 화면 구현
• AI가 Case를 자동 승인하거나 외부기관에 제출하는 기능
• 범용 BPMN 엔진
• Dashboard·알림 집계

관계

• Parent: [EPIC] FOWOCO Server Roadmap · Controlled AI Workflow MVP #2
• 기존 Case 필터 기반: [Task] 업무함 Case 조회를 위한 caseId 필터 추가 #71
• 생성 진입점: [AI Run] 비동기 실행 상태·재시도·멱등성 구현 #24 candidate decision
• Worker 날짜 기반: [Worker][P0] E-9 업무용 4개 날짜·비자정보 확장 #84
• Task Workflow·유형 확장: [Task Workflow] 업무카드·체크리스트·상태 전이 구현 #6, [Task][P0] 업무 유형·대상 범위 확장 #85
• 대표 검증: [E2E] 제품 대표 복합 요청 시나리오·데모 런북 완성 #10