WorkflowMCP

# Sprint Plan - WorkflowMCP API 완성 # 기존 API 확장 및 자기설명적 API 구현 ## 📋 프로젝트 개요 **총 기간**: 3주 (15 작업일) **총 작업량**: 35시간 **일일 작업량**: 2.3시간/일 (적정 수준) **Sprint 구성**: 3 Sprint × 1주씩 ## 🎯 Sprint 목표 ### Sprint 1: 현황 파악 및 핵심 기능 (5일, 17시간) **목표**: 기존 API 완전 분석 후 누락된 핵심 기능 구현 ### Sprint 2: 자기설명적 API 시스템 (5일, 14시간) **목표**: Discovery & Help API 구현으로 사용성 향상 ### Sprint 3: 통합 및 완성 (5일, 4시간) **목표**: 실시간 기능 추가 및 최종 통합 --- ## 🏃‍♂️ Sprint 1: 현황 파악 및 핵심 기능 (Week 1) **기간**: 1주차 (5 작업일) **작업량**: 17시간 (3.4시간/일) **핵심 목표**: 누락된 28개 MCP 도구를 API로 구현 ### Day 1 (3.5시간) - 현황 분석 #### Morning (2시간) - 기존 API 상세 분석 - [ ] **API 응답 형식 분석** (1시간) - 34개 기존 API 엔드포인트 응답 구조 분석 - Manager vs 직접 DB 접근 패턴 파악 - 에러 처리 방식 표준화 현황 확인 - [ ] **MCP vs API 완전 매핑** (1시간) - 58개 MCP 도구와 34개 API의 정확한 매핑표 작성 - 누락된 기능별 우선순위 결정 #### Afternoon (1.5시간) - Gap Analysis - [ ] **Document Relations 분석** (0.75시간) - `link_document`, `create_prd_document` 등 8개 도구 분석 - 기존 Documents API와 통합 방안 설계 - [ ] **Connection Management 분석** (0.75시간) - Task-Test 연결, Task 관계 등 6개 도구 분석 - 기존 connections API 확장 방안 설계 **산출물**: - `existing-api-analysis.md` - `mcp-api-mapping.md` - 구현 우선순위 매트릭스 ### Day 2 (3.5시간) - Document Relations API #### Morning (2시간) - Document Linking API - [ ] **Document Link API 구현** (2시간) - `POST /api/documents/[id]/link` - 문서 연결 - `GET /api/documents/[id]/links` - 연결 조회 - `DELETE /api/documents/[id]/link/[linkId]` - 연결 해제 #### Afternoon (1.5시간) - PRD Document API - [ ] **PRD Document API 구현** (1.5시간) - `POST /api/prds/[id]/documents` - PRD 문서 생성 - `GET /api/prds/[id]/documents` - PRD 문서 목록 **산출물**: - `dashboard/src/routes/api/documents/[id]/link/+server.js` - `dashboard/src/routes/api/prds/[id]/documents/+server.js` ### Day 3 (3.5시간) - Test Analysis & Connection API #### Morning (2시간) - Test Analysis API - [ ] **Test Summary & Coverage** (2시간) - `GET /api/test-summary` - 전체 테스트 요약 - `GET /api/test-coverage` - 테스트 커버리지 분석 - `GET /api/test-coverage/[projectId]` - 프로젝트별 커버리지 #### Afternoon (1.5시간) - Test Connection API - [ ] **Test-Task Connection** (1.5시간) - `GET /api/test-cases/[id]/connections` - 테스트 연결 조회 - `POST /api/test-cases/[id]/connections` - 테스트 연결 추가 **산출물**: - `dashboard/src/routes/api/test-summary/+server.js` - `dashboard/src/routes/api/test-coverage/+server.js` - `dashboard/src/routes/api/test-cases/[id]/connections/+server.js` ### Day 4 (3.5시간) - Enhanced Connection Management #### Morning (2시간) - Task Connection Enhancement - [ ] **Task Connection API 확장** (2시간) - 기존 `/api/tasks/[id]/connections` 확장 - `POST /api/tasks/[id]/connections/batch` - 대량 연결 추가 - `GET /api/connections/network` - 전체 네트워크 데이터 #### Afternoon (1.5시간) - Cross-Entity Connections - [ ] **범용 Connection API** (1.5시간) - `GET /api/entities/[type]/[id]/connections` - 범용 연결 조회 - `POST /api/entities/[type]/[id]/connections` - 범용 연결 생성 **산출물**: - Enhanced connections API - `dashboard/src/routes/api/connections/network/+server.js` - `dashboard/src/routes/api/entities/[type]/[id]/connections/+server.js` ### Day 5 (3시간) - Analytics & Status API #### Morning (1.5시간) - Project Analytics Enhancement - [ ] **Project Analytics 확장** (1.5시간) - `GET /api/projects/[id]/analytics` 기존 기능 확장 - `GET /api/projects/[id]/timeline` - 프로젝트 타임라인 - `GET /api/projects/[id]/metrics` - 상세 메트릭 #### Afternoon (1.5시간) - Environment Status & Sprint Review - [ ] **Environment Status** (1시간) - `GET /api/environments/[id]/status` - 환경 상태 상세 - `GET /api/environments/[id]/health` - 헬스체크 - [ ] **Sprint 1 Review** (0.5시간) - 구현 완료 API 테스트 - 다음 Sprint 준비 **산출물**: - Enhanced analytics & status APIs - Sprint 1 완료 보고서 ### Sprint 1 성과 측정 - [ ] 28개 누락 MCP 도구 중 20개 API 구현 완료 - [ ] 기존 34개 API와의 호환성 100% 유지 - [ ] 모든 신규 API 기본 테스트 통과 --- ## 🔍 Sprint 2: 자기설명적 API 시스템 (Week 2) **기간**: 2주차 (5 작업일) **작업량**: 14시간 (2.8시간/일) **핵심 목표**: Discovery & Help API로 세션 친화적 API 완성 ### Day 6 (3시간) - Express API 서버 기반 구조 #### Morning (2시간) - Express 서버 설정 - [ ] **Express API 서버 기본 구조** (2시간) - Express.js API 서버 설정 (`src/api-server.js`) - SvelteKit API와 통합을 위한 프록시 설정 - CORS, 보안 헤더 등 기본 미들웨어 구성 #### Afternoon (1시간) - Discovery API 기반 - [ ] **Discovery API 기반 구조** (1시간) - Discovery service 기본 구조 설계 - API 메타데이터 수집 시스템 **산출물**: - `src/api-server.js` - `src/middleware/proxy-middleware.js` - `src/services/DiscoveryService.js` ### Day 7 (3시간) - Discovery API 완성 #### Morning (2시간) - Core Discovery APIs - [ ] **Discovery API 구현** (2시간) - `GET /api` - 전체 API 디스커버리 루트 - `GET /api/endpoints` - 모든 엔드포인트 목록 - `GET /api/categories` - 카테고리별 API 그룹핑 #### Afternoon (1시간) - Schema API - [ ] **Schema API** (1시간) - `GET /api/schema` - API 스키마 정보 - Dynamic schema generation **산출물**: - `src/routes/discovery.js` - Complete discovery API system ### Day 8 (3시간) - Help System 기반 구조 #### Morning (2시간) - Help Database & Content - [ ] **Help 시스템 기반** (2시간) - Help 컨텐츠용 SQLite 테이블 생성 - 카테고리별 도움말 컨텐츠 작성 시작 - Help content management system #### Afternoon (1시간) - Dynamic Examples - [ ] **동적 예제 생성 시스템** (1시간) - 실행 가능한 예제 자동 생성 - 예제 코드 템플릿 시스템 **산출물**: - `src/database/help-schema.sql` - `src/services/HelpContentService.js` - 기본 도움말 컨텐츠 ### Day 9 (3시간) - Interactive Help API #### Morning (2시간) - Help API 구현 - [ ] **Help API 완성** (2시간) - `GET /api/help` - 도움말 시스템 루트 - `GET /api/help/[category]` - 카테고리별 도움말 - `GET /api/help/[category]/examples` - 실행 가능한 예제 #### Afternoon (1시간) - Help Search - [ ] **Help 검색 시스템** (1시간) - `GET /api/help/search` - 도움말 검색 - Full-text search for help content **산출물**: - `src/routes/help.js` - `src/services/HelpService.js` - Complete interactive help system ### Day 10 (2시간) - HATEOAS 링크 시스템 #### Morning (2시간) - HATEOAS Implementation - [ ] **HATEOAS 링크 시스템** (2시간) - Response enhancement middleware - 기존 SvelteKit API 응답에 HATEOAS 링크 자동 추가 - 리소스 간 관계 링크 생성 시스템 **산출물**: - `dashboard/src/lib/middleware/hateoas-middleware.js` - `src/utils/link-builder.js` - Enhanced API responses with navigation ### Sprint 2 성과 측정 - [ ] Discovery API로 전체 API 탐색 가능 - [ ] Help API로 카테고리별 도움말 제공 - [ ] HATEOAS 링크로 API 네비게이션 향상 - [ ] 새 세션에서 5분 내 API 학습 가능 --- ## 🚀 Sprint 3: 통합 및 완성 (Week 3) **기간**: 3주차 (5 작업일) **작업량**: 4시간 (0.8시간/일) + 통합 테스트 **핵심 목표**: 실시간 기능 추가 및 최종 완성 ### Day 11 (1시간) - API 표준화 #### Morning (1시간) - Response Standardization - [ ] **API 응답 표준화** (1시간) - 모든 API 응답 형식 통일 - 에러 응답 표준화 - 성공 응답 메타데이터 추가 **산출물**: - API 응답 표준 스키마 - 에러 처리 표준화 ### Day 12 (1시간) - SSE 실시간 기능 #### Morning (1시간) - Server-Sent Events - [ ] **SSE 기본 구조** (1시간) - SvelteKit에 SSE 엔드포인트 추가 - 데이터 변경 이벤트 브로드캐스팅 - PRD/Task/Test 상태 변경 알림 **산출물**: - `dashboard/src/routes/api/stream/+server.js` - Real-time notification system ### Day 13 (1시간) - 대시보드 API 콘솔 #### Morning (1시간) - API Console - [ ] **API 콘솔 페이지** (1시간) - 대시보드에 API 테스트 콘솔 페이지 추가 - 인터랙티브 API 탐색 도구 구현 **산출물**: - `dashboard/src/routes/api-console/+page.svelte` - Interactive API explorer ### Day 14 (1시간) - 문서화 및 모니터링 #### Morning (1시간) - Documentation & Monitoring - [ ] **OpenAPI 문서화** (0.5시간) - OpenAPI 3.0 스펙 자동 생성 - Swagger UI 통합 - [ ] **API 모니터링** (0.5시간) - API 사용량 통계 - 응답 시간 모니터링 **산출물**: - `docs/openapi.yaml` - Swagger UI integration - API monitoring tools ### Day 15 (통합 테스트 및 배포 준비) #### 전체 일정 - 통합 테스트 - [ ] **전체 시스템 테스트** - 58개 MCP 도구의 API 접근 검증 - 기존 대시보드 기능 회귀 테스트 - 새로운 API의 Claude Code 연동 테스트 - [ ] **성능 테스트** - API 응답 시간 < 500ms 검증 - 대시보드 성능 영향 < 5% 검증 - [ ] **사용성 테스트** - 새 세션에서 API 학습 시간 측정 - Discovery & Help API 효과성 검증 - [ ] **배포 준비** - 프로덕션 환경 설정 - 모니터링 시스템 활성화 **산출물**: - 전체 테스트 보고서 - 배포 가이드 - 사용자 매뉴얼 ### Sprint 3 성과 측정 - [ ] 모든 58개 MCP 도구 API 접근 가능 - [ ] 실시간 업데이트 기능 작동 - [ ] API 콘솔로 인터랙티브 탐색 가능 - [ ] 완전한 문서화 및 모니터링 시스템 --- ## 📊 Overall Progress Tracking ### 주차별 진행률 목표 - **Week 1 (Sprint 1)**: 60% 완료 (핵심 기능) - **Week 2 (Sprint 2)**: 90% 완료 (사용성 향상) - **Week 3 (Sprint 3)**: 100% 완료 (최종 완성) ### 일일 체크포인트 각 작업일 종료 시 확인사항: - [ ] 계획된 API 엔드포인트 구현 완료 - [ ] 기존 기능 영향도 확인 (회귀 테스트) - [ ] 다음 날 작업 준비 완료 - [ ] 이슈 발생 시 해결 방안 수립 ### Risk Management #### 🔴 High Risk - **기존 API 호환성**: 매일 회귀 테스트 필수 - **SvelteKit 종속성**: Express 서버와의 충돌 가능성 #### 🟡 Medium Risk - **Manager 클래스 수정**: 기존 코드 영향 최소화 - **데이터베이스 스키마**: 기존 데이터 손실 방지 #### 🟢 Low Risk - **Express 서버 추가**: 독립적 구현으로 안전 - **문서화**: 기능에 영향 없음 ### Sprint Adjustment Rules #### Sprint 1 조정 - 핵심 API 구현이 지연될 경우 Sprint 2 일정 단축 - Document Relations API 우선순위 최상 #### Sprint 2 조정 - Help API가 복잡할 경우 기본 Discovery만 구현 - HATEOAS는 선택적 구현 #### Sprint 3 조정 - 실시간 기능은 최후 우선순위 - 통합 테스트 시간 확보가 최우선 ## ✅ Definition of Done ### API 구현 완료 기준 - [ ] 해당 MCP 도구와 동일한 기능 제공 - [ ] 기본 에러 처리 구현 - [ ] 간단한 단위 테스트 통과 - [ ] 기존 API와 일관된 응답 형식 ### Sprint 완료 기준 - [ ] 모든 계획된 API 구현 완료 - [ ] 회귀 테스트 통과 (기존 기능 영향 없음) - [ ] 다음 Sprint 준비 완료 - [ ] 문서화 업데이트 ### 프로젝트 완료 기준 - [ ] 58개 MCP 도구 모두 API로 접근 가능 - [ ] 자기설명적 API 시스템 완성 - [ ] 100% 기존 호환성 유지 - [ ] Claude Code에서 활용 가능한 Discovery API - [ ] 완전한 문서화 및 테스트 ## 🎯 Success Metrics ### 정량적 지표 - **API Coverage**: 58/58 MCP 도구 (100%) - **Response Time**: < 500ms (95 percentile) - **Compatibility**: 100% 기존 기능 유지 - **Learning Time**: < 5분 (새 세션에서 API 학습) ### 정성적 지표 - **Usability**: Claude Code에서 자연스러운 API 탐색 - **Maintainability**: 기존 코드 구조와 일관성 - **Extensibility**: 향후 기능 추가 용이성 - **Documentation**: 완전하고 이해하기 쉬운 문서