[EPIC] FOWOCO Server Roadmap · Controlled AI Workflow MVP

[hywznn]

한 줄 목표

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

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

현재 완성된 기반

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

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

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를 기준으로 합니다.

마무리 작업

순서	작업	상태
1	#15 알림 이벤트 생성·Client 연결	PR #125 Draft
2	#128 Renewal 결과·안내 초안 연결	PR #131 Draft
3	AI 생성 문서 값 계약 후 HWPX/PDF 저장 연결	AI 후속 계약 대기
4	#34 RLS 운영 적용 확인	진행 중
5	#9 HTTPS Demo deployment	Infra #104 선행
6	#10 대표 Product E2E	#9 이후

대표 데모

“응웬반A가 3년 만료 예정이야. 재계약하고 체류연장 준비해줘”
→ AI Intent·필요 Slot 확인
→ Server DB 정보 보충
→ HR 추가 질문
→ Case 1개와 재계약·취업활동기간 연장·체류기간 연장 Task
→ HR 검토·승인
→ 필요한 근로자 안내·서류 요청
→ 외부 제출·증빙·완료·감사로그

MVP 완료 조건

• 사업장 격리·Role·동시성·멱등성을 테스트합니다.
• AI 응답을 Server가 재검증하고 가짜 성공 후보를 만들지 않습니다.
• Candidate 채택과 승인·발송을 분리합니다.
• Worker Link 만료·회전·응답·파일과 감사 이력을 남깁니다.
• 재시작·중복 요청·Outbox 실패 뒤에도 중복 업무를 막습니다.
• Renewal 안내·생성 문서를 기존 Document 흐름에 연결합니다.
• LM Studio 없이 HTTPS 환경에서 실제 Server↔AI 왕복을 확인합니다.
• 대표 Case를 처음부터 완료까지 반복 재현합니다.

이번 데모에서 하지 않는 것

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

문서

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