[EPIC] FOWOCO Server Roadmap · Controlled AI Workflow MVP

[hywznn]

한 줄 목표

FOWOCO Server가 HR 요청을 복구 가능한 AI Run → 검증된 후보 → 사람 승인 → 근로자 보안 링크 → 증빙·완료·감사로 연결하는 Controlled AI Workflow를 제공합니다.

Server는 AI 모델이 아니라 업무 운영과 통제의 최종 책임자입니다. AI는 후보를 제안할 뿐 Task 상태, 승인, 발송과 완료를 직접 바꾸지 못합니다.

현재 구현된 기반

• Auth·Company·JWT·Refresh Token·Password Reset·Profile
• Worker·Document·File·Import·OCR
• Task·Workflow·Case·Checklist·담당자 변경
• Approval·Evidence·External Submission·Audit
• Worker Link·SMS 전달 상태·근로자 응답·파일 제출
• PLAN → Slot 보충 → ANALYZE·Candidate Decision·AiRun·SSE
• Dashboard·Settings·Notification 조회·읽음
• PostgreSQL 16·Flyway·RLS·Transactional Outbox
• Swagger/OpenAPI·DB 문서 자동 배포
• Knowledge CASE-EXPIRY-RENEWAL-001 기반 Golden Case

실제 구현 계약은 Swagger와 main 테스트를 기준으로 확인합니다.

Golden Case 검증 완료

“응웬반A가 3년 만료 예정이야. 재계약하고 체류연장 준비해줘”
→ AI PLAN·필요 Slot 확인
→ Server DB Context와 HR 답변 보충
→ Candidate 채택
→ 재계약·신분서류 보완·취업활동기간 연장·체류기간 연장 Task
→ Worker Link 파일 제출
→ OCR 검토와 Renewal 자동 재개
→ HWP 초안 생성
→ HR 승인·외부 제출 증빙·완료

로컬 실제 Server·AI Runtime 왕복에서 최종 Case COMPLETED, 4/4, 진행률 100%를 확인했습니다. 구현은 #197 / PR #207에서 완료했습니다.

현재 우선순위 (2026-08-19)

우선순위	작업	현재 상태
P0	#9 PostgreSQL·AI Runtime 기반 HTTPS 데모 배포	인프라 기반 완료, AI #69 설정·실제 Provider 왕복 확인 필요
P0	#10 배포 환경 대표 E2E·Runbook 확정	#9와 AI #69에 의해 Blocked
P1	#177 Prometheus scrape 인증	PR #178 CI 성공, 최신 main 반영 후 병합 대기
P1	#186 HWP/HWPX 미리보기 품질	PDF·이미지 미리보기 완료, HWP/HWPX 변환 품질은 AI 후속 작업
P2	#161 음차 Alias 후보 선택·HR 확인	데모 안전장치 완료, 일반 Alias 선택은 Backlog
P2	#196 Tenant 문서 수집·Template Registry	데모 이후 Backlog
P2	#208 Worker Import 1,000행 성능 개선	기능 변경 없는 성능 Backlog

지금 가장 먼저 끝낼 흐름

AI #69 해결
→ #9 배포 설정·실제 Provider Smoke
→ #10 Golden E2E·2분 Runbook
→ #177/#178 Prometheus 인증

Backend Team

담당	주 기여 영역
@hywznn	Auth·Task·Approval/Audit·AI Integration·AiRun·Case·Outbox·OCR·통합
@chaeliki	Worker·Document/File·Worker Link·Dashboard·Notification
@krestar	PostgreSQL·RLS·Settings·Demo Seed·DB 운영 안전성
공동	API 계약·Migration 조율·PR Review·배포·Product E2E

실제 담당자는 Issue Assignee를 기준으로 합니다.

MVP 완료 조건

• 사업장 격리·Role·동시성·멱등성 검증
• AI 응답 Server 재검증과 가짜 성공 차단
• Candidate 채택과 승인·발송 분리
• Worker Link 만료·회전·응답·파일·감사 이력
• 재시작·중복 요청·Outbox 실패 뒤 중복 업무 차단
• Renewal 안내·OCR·생성 문서를 기존 Task·Document 흐름에 연결
• 로컬 Golden Case 처음부터 완료까지 실제 왕복
• HTTPS 배포 환경에서 실제 Renewal·OCR·문서 생성 왕복
• 처음 참여한 팀원이 Runbook만 보고 2분 대표 시나리오 재현

이번 데모에서 하지 않는 것

• 외부기관 자동 로그인·자동 제출
• AI의 자동 승인·자동 발송·법률/노무 최종 판단
• 실제 개인정보를 넣은 Demo Seed
• 마이크로서비스 분리·Blue/Green Agent Router 운영
• 여섯 Workflow 공통 Runtime 일반화

문서

• README
• Server Wiki
• Server Roadmap
• Swagger
• Database 문서