01 MVP Roadmap

M3 백엔드 MVP 로드맵

목표

2026년 8월 14일까지 다음 대표 흐름을 실제 배포 환경에서 끝까지 동작시킵니다.

HR 로그인 → 근로자 등록 → 자연어 분석 → 업무카드 후보 → HR 승인 → 근로자 보안 링크 → 응답 → 완료 → 감사 로그

• 에픽 #2
• M3 마일스톤
• M4 마일스톤
• 통합 Project · 팀원 전용
• 42개 API 카탈로그

현재와 목표

구분	현재	M3 목표
서버	Spring Boot 골격과 /health 1개	42개 API 계약 중 M3/P0 핵심 흐름
DB	local H2, dev PostgreSQL 설정	PostgreSQL + Flyway migration
AI	미연동	교체 가능한 AI Adapter + 외부 LLM
보안	Spring Security 미활성	JWT, 역할, 사업장 격리, 토큰 해시
테스트	Context 기동 테스트 1개	상태 전이·보안·E2E 통합 테스트
배포	없음	HTTPS 데모 주소 + 외부 LLM

구현 순서

flowchart LR
  F["#3 개발 기반"] --> A["#4 인증·권한"]
  A --> W["#5 근로자·서류"]
  A --> U["#11 승인·감사"]
  W --> T["#6 업무카드·Workflow"]
  T --> AI["#8 AI Adapter"]
  W --> DOC["#13 파일·문서 준비도"]
  W --> IMP["#14 파일 가져오기"]
  U --> L["#7 Worker Link"]
  T --> L
  AI --> D["#9 데모 배포"]
  DOC --> D
  IMP --> D
  L --> D
  D --> E["#10 E2E·런북"]
  E --> UX["#15·#16 M4 사용성"]

Loading

1단계: 바로 시작

• #3 Spring Boot 개발·검증 기반

README, Gradle 권한, Flyway, OpenAPI, 공통 오류, CI를 먼저 정리합니다.

2단계: 업무 데이터의 안전한 기반

• #4 JWT 인증·사업장 권한·멀티테넌시
• #5 근로자·서류 상태 관리
• #11 HR 승인·발송 통제·감사 로그

모든 데이터에 사업장 범위를 강제하고 HR 업무의 책임자를 기록합니다.

3단계: FOWOCO 핵심 Workflow

• #6 업무카드와 상태 전이
• #8 AI Adapter와 검증·버전 로그
• #11 승인·반려·증빙·감사 로그
• #13 파일·문서 준비도
• #7 로그인 없는 근로자 보안 링크
• #14 근로자 파일 가져오기

AI 결과를 업무카드 후보로만 만들고, HR 승인 후 제한된 링크로 전달합니다.

4단계: 배포와 증명

• #9 PostgreSQL·외부 LLM 데모 배포
• #10 대표 복합 요청 E2E·데모 런북

LM Studio 없이도 접근 가능한 배포 주소에서 대표 흐름을 검증합니다.

M4: 데모 안정화와 운영 편의

• #15 오늘 업무 대시보드
• #16 사업장 설정

M3 핵심 흐름을 막지 않는 P1 사용성 기능입니다. 발표 일정이 확정되면 M4 due date를 지정합니다.

이슈 상태 읽는 법

상태	의미	해야 할 일
준비됨	바로 시작 가능	담당자와 브랜치를 정하고 구현
백로그	할 일로 확정됨	선행 조건과 담당 일정 확인
차단됨	지금 시작하면 재작업 위험	이슈의 선행 작업을 먼저 완료
진행 중	누군가 구현 중	중복 작업하지 말고 PR 확인
리뷰 대기	구현 완료, 검토 필요	완료 조건과 테스트를 리뷰
완료	배포·문서 포함 완료	후속 회귀 테스트 유지

M3 완료 조건

• 복합 요청이 체류연장과 여권 사본 요청 후보 2개로 분해됨
• 누락정보는 NEEDS_INFO, 충분한 정보는 READY_FOR_REVIEW
• HR 승인 전 Worker Link 발급 불가
• 링크 만료·폐기·재발급 동작
• AI JSON 오류와 Timeout이 안전한 검토 상태로 처리됨
• 생성부터 완료까지 감사 로그 조회 가능
• AI 호출 버전과 지연시간·파싱 오류 기록
• GitHub Actions 테스트·빌드 통과
• PostgreSQL·외부 LLM·HTTPS 데모 주소에서 E2E 통과
• 처음 참여한 팀원이 이 Wiki로 로컬 실행과 데모 재현

MVP 범위 밖

• 외부기관 자동 제출
• AI의 법률·노무 최종 판단
• 자체 학습 모델의 필수 서비스 탑재
• Kubernetes와 Blue/Green 실제 트래픽 전환
• 대용량 원본 파일·OCR 전체 구현