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

두 명의 M3 업무량

사용자가 말한 65 + 40은 합이 105이므로 퍼센트 필드가 아니라 Project의 Raw workload로 기록했습니다. 정규화하면 약 61.9% : 38.1%입니다. M4는 이 105점에서 제외합니다.

담당	GitHub	맡은 영역	Raw workload
개발자 A	@hywznn	Architecture, Auth, Task Workflow, Approval/Audit, AiRun, Durable Event, 배포 기반, 저장소 보호	65
개발자 B	@chaeliki	Worker, Document/File, Worker Link, AI Runtime Client, 제품 E2E	40
합계			105

개발자 A · 65점

Issue	작업	점수
#23	저장소 경계·API·상태·Port·Event ADR	5
#4	인증·사업장 격리	13
#6	Task Workflow·Checklist	10
#11	승인·증빙·감사	13
#24	AiRun 상태·재시도·멱등성	13
#25	Durable Event·재시작 복구	5
#9	PostgreSQL·AI Runtime 기반 데모 배포	3
#27	저장소 보호·최소 권한·보안 자동화	3

개발자 B · 40점

Issue	작업	점수
#5	Worker·문서 메타데이터	10
#13	FileStorage·통합 문서함·준비도	9
#7	Worker Link·응답·제출	11
#8	Fake/Remote AiRuntimeClient·계약 검증·장애 격리	5
#10	제품 E2E·장애 시나리오·데모 런북	5

파트너 GitHub 계정이 @chaeliki가 아니라면 Assignee와 표를 같은 작업에서 함께 교체합니다.

구현 순서

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로 둘 수 있습니다.

병렬 개발 원칙

• 개발자 A는 auth, task, workflow, approval, audit, airun, reliability를 주로 소유합니다.
• 개발자 B는 worker, document, file, workerlink, aiintegration, E2E를 주로 소유합니다.
• 상대 모듈의 Entity·Repository를 직접 참조하지 않고 Port와 ID 기반 계약을 사용합니다.
• build.gradle, SecurityConfig, 공통 Error, Flyway 순서는 개발자 A가 통합합니다.
• 구현은 병렬로 하되 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의 안전한 사용자 흐름을 희생해 선구현하지 않습니다.