01 MVP Roadmap

MVP 로드맵

목표는 “AI가 문장을 생성하는 데모”가 아니라, AI 후보가 권한·검토·승인·증빙·감사 규칙 안에서 실제 HR 업무로 이어지는 Controlled AI Workflow MVP입니다.

현재 기준

• M3: Controlled AI Workflow Backend MVP, 2026-08-14
• M4: 데모 안정화와 운영 편의 고도화
• 실제 진행 현황: Server Roadmap Project
• 전체 범위: Epic #2

API 개수는 Wiki에 고정하지 않습니다. 구현된 수량과 계약은 Swagger/OpenAPI를 기준으로 확인합니다.

현재 역할 분담

담당	Issue
@hywznn	#4 Auth·Company, #6 Task Workflow, #11 Approval·Audit, #8 AI Integration, #24 AiRun, #25 Outbox·Reliability
@chaeliki	#5 Worker·Document metadata, #13 Document·File, #7 Worker Link, #15 Dashboard, #16 Settings
공동	#9 Demo deployment, #10 Product E2E, 서로의 PR review

최신 담당자와 진행 상태는 Server Roadmap Project와 GitHub 협업 가이드를 기준으로 확인합니다. Raw workload는 대략적인 난이도 참고값이며 담당 비율이나 완료율이 아닙니다.

구현 순서

flowchart LR
  A["#23 계약 확정"] --> B["#4 Auth"]
  A --> C["#5 Worker"]
  A --> D["#6 Task Workflow"]
  A --> E["#8 AiRuntimeClient"]
  A --> R["#25 Durable Event"]
  R --> F["#24 AiRun"]
  A --> Q["#27 저장소 보호"]
  D --> G["#11 Approval/Audit"]
  C --> H["#13 Document/File"]
  G --> I["#7 Worker Link"]
  E --> J["후보 확정 통합"]
  F --> J
  J --> K["#9 Demo Deploy"]
  H --> K
  I --> K
  Q --> K
  K --> L["#10 Product E2E"]

Loading

GitHub의 실제 blocked by 관계는 hard blocker만 뜻합니다. Fake Port로 독립 개발이 가능하면 Ready 또는 In Progress로 둘 수 있습니다.

병렬 개발 원칙

• @hywznn은 auth, company, task, workflow, approval, audit, aiintegration, airun, reliability를 주로 소유합니다.
• @chaeliki는 worker, document, file, workerlink, dashboard, settings를 주로 소유합니다.
• Demo deployment와 Product E2E는 공동 작업이며 서로의 PR을 review합니다.
• 상대 모듈의 Entity·Repository를 직접 참조하지 않고 Port와 ID 기반 계약을 사용합니다.
• build.gradle, SecurityConfig, 공통 Error, Flyway 순서는 상대 담당자에게 알리고 PR에서 함께 검토합니다.
• 구현은 병렬로 하되 DB migration 번호와 공유 파일 병합 순서는 합의합니다.

M3 완료 기준

• 사업장별 로그인과 Role·tenant 격리가 동작합니다.
• 근로자·문서·업무카드의 핵심 CRUD와 상태 전이가 동작합니다.
• POST /api/v1/ai-runs가 202를 반환하고 실행 상태를 조회할 수 있습니다.
• Server는 AI Runtime만 호출하며 Provider SDK와 Prompt를 포함하지 않습니다.
• 복합 요청에서 여러 후보를 만들고 HR이 후보별로 확정·폐기할 수 있습니다.
• 승인 전 발송이 차단되고 Worker Link가 만료·회전·폐기됩니다.
• 완료 증빙과 AuditEvent가 남습니다.
• PostgreSQL 기반 재시작 복구와 중복 방지가 검증됩니다.
• 팀원이 접근 가능한 HTTPS 데모 환경에서 제품 E2E를 통과합니다.

M4로 미루는 것

• 대량 Import와 운영 편의
• 사업장 설정·알림 고도화
• Dashboard projection과 고급 관측성
• Blue/Green·Canary 자동화
• 다중 Provider·Agent Router 고도화

M4 설계를 미리 고려하되 M3의 안전한 사용자 흐름을 희생해 선구현하지 않습니다.