MVP 정의서 - DDAL-KKAK-DOT/DDALKKAK GitHub Wiki

🎤 발표 영상 및 자료

팀딸깍_MVP정의서_250428.pdf

https://youtu.be/O5bUvOflN2I?si=XY_lZ3pOjujRl4NW

💡 내용 요약

프로젝트 개요

- 프로젝트 제목: 포트폴리오 만들어줘~! 딸깍.
- 팀명: 딸깍.
- 팀 구성원 및 역할
    - 고민지: 팀장, 프론트엔드 리드, 팀 회의 진행 및 일정 조율 담당
    - 나상현: AI 리드, 기술 안건 준비 및 토론 진행 담당
    - 김예찬: 백엔드 리드, 회의록 작성 및 실행 관리 담당
    - 조하은: 풀스택, 의견 수렴 및 아이디어 제안 담당
    
    → 기술 문서화, 코드 리뷰 등 전원 참여 (그라운드룰에 따름)
    
- 프로젝트에 대한 간략한 설명 (핵심 목표 포함)
    - 기존 이력서 및 포트폴리오 작성의 번거로움을 해소하기 위해, 사용자가 링크만 첨부하면 자동으로 포트폴리오를 생성해주는 웹 서비스

기술 스택

- 프론트엔드/백엔드 사용 기술 및 라이브러리
    - 프론트엔드: Next.js, TailwindCss, Tanstack-Query 등
    - 백엔드: Fast API, Open AI API
- 데이터베이스 사용 여부 및 종류: 사용하지 않음 (단, 확장 가능성 있음)
- 배포 환경 및 협업 도구 (GitHub, Notion 등):
    - 협업도구: GitHub, Notion, Discord, Code with me
    - 배포 환경: AWS EC2
    - 프로젝트 관리: GitHub Project
    - 문서화: Notion, GitHub Wiki

MVP 목표

- 사용자(개발자)가 입력한 외부 링크를 기반으로 AI 분석을 통해 포트폴리오 자동 생성
- 시각화 UI 제공
- 생성된 포트폴리오 PDF 다운로드 기능 포함

→ 최소 기능에 집중하여 빠른 프로토타입 구현

MVP 핵심 기능 

- **외부 링크 크롤링 기능**
    - 사용자가 입력한 GitHub, 블로그 등 URL의 정보를 수집
- **AI 기반 포트폴리오 자동 생성**
    - 크롤링된 정보는 OpenAI를 활용해 포트폴리오 형태로 요약 및 정리
- **PDF 저장/다운로드 기능**
    - 사용자가 최종 포트폴리오를 PDF로 변환 및 저장할 수 있도록 지원

MVP에서 제외한 기능

- **로그인 기능을 통한 개인화 및 저장 기능** 
→ 포트폴리오 이력 및 개인 맞춤 프로모션 기능 제공
- **UI 커스터마이징 기능**
→ 피그마 디자인 기반의 다양한 템플릿 제공 및 자유로운 편집 기능
- **다양한 분야 확대**
    
    → 대응하여 포트폴리오 및 이력서 작성 기능
    
- **마크다운 기반 포트폴리오 편집**
    - 생성된 포트폴리오 내용을 마크다운으로 수정 가능, 실시간 UI 반영

완성 가능한 목표 (측정 가능) -

- 사용자로부터 입력받은 **외부 링크 10개 이상을 분석**하여, 정해진 템플릿에 맞춰 포트폴리오 자동 생성
- 생성된 포트폴리오가 실제 UI에 **정상적으로 시각화 및 편집 가능**
- **PDF 파일로 변환 및 다운로드 가능한 기능이 작동**하는 것을 확인

Time Line

Sprint 1. – 초기 기획 및 준비 단계

  • 프로젝트 기획 확정 및 역할 분담 재확인
    • MVP 정의서 최종 검토 및 확정
    • 팀원별 역할(프론트엔드, 백엔드, AI, 기획, 계정 관리, 문서화 등) 재확인 및 업무 분담
  • 기술 스택 및 개발 환경 설정
    • 프론트엔드: React, Vite, TailwindCss, React-Query 등 환경 셋업
    • 백엔드: FastAPI, OpenAI API 연동 테스트 환경 마련
  • 협업 도구 및 초기 리포지토리 구축
    • GitHub, Notion, Discord, Code with me 등 협업 도구 활용
    • GitHub 리포지토리 생성 및 초기 코드 베이스 구성
  • 기본 기획 및 와이어프레임 작업
    • 프로젝트의 주요 화면 및 기능 흐름에 대한 와이어프레임 초안 작성
    • 포트폴리오 자동 생성 및 외부 소스(깃허브 등) 크롤링 기능의 개략적인 구조 설계

Sprint 2. – 프론트엔드 및 백엔드 초기 개발 단계

  • 백엔드 초기 개발
    • FastAPI를 이용해 기본 API 틀 구축 및 OpenAI API 연동 테스트
    • 깃허브 및 외부 소스의 링크 크롤링 기본 로직 구현 시작
  • 프론트엔드 초기 개발
    • React 기반 프로젝트 생성 및 기본 페이지(홈, 포트폴리오 생성 페이지 등) 구성
    • UI 기본 틀 및 레이아웃 구상, 간단한 목업 기능 구현
  • 프로토타입 개발 및 팀 피드백
    • 각 기능(예, 자동 포트폴리오 생성 기능)별 초안 프로토타입 개발
    • 팀 내부에서 정기 미팅을 통해 초기 시연 및 피드백 수렴

Sprint 3. – 핵심 기능 개발 및 통합 단계

  • 핵심 기능 완성
    • 깃허브 및 외부 소스 링크 크롤링: 사용자 지정 링크에 대해 데이터를 추출하는 기능 완성 및 오류 수정
    • 자동 포트폴리오 생성: OpenAI API를 통한 자동 생성 알고리즘 구현 및 테스트
    • 마크다운 기반 포트폴리오 수정 기능: 사용자가 내용 수정 후 즉시 UI에 반영되는 기능 개발
  • 시스템 통합 및 API 연동
    • 프론트엔드와 백엔드 간 데이터 연동 점검
    • API와 UI 간 원활한 통신 및 데이터 처리 기능 확인
  • 내부 테스트 및 버그 수정
    • 팀원 전원이 참여하는 내부 테스트 진행
    • 발견된 문제점 및 버그 수정, 개선 사항 도출

Sprint 4. – 최종 마무리 및 발표 준비

  • 최종 기능 점검 및 디버깅
    • MVP에 포함된 모든 기능(링크 크롤링, 자동 포트폴리오 생성, UI 반영 등)의 최종 테스트
    • 버그 수정 및 보완 사항 반영
  • 문서화 및 자료 정리
    • GitHub Wiki, Notion 등에 프로젝트 기술 정리 및 문서화 완성
    • 발표 자료용 PPT (PDF 변환, 약 10장 내외) 초안 작성 및 내용 확정
  • 발표 영상 제작 준비
    • 5분 이내 발표 영상 촬영 계획 수립(데모 시나리오, 유튜브 등 링크 활용)
    • 내부 리허설 진행하여 발표 내용 및 시연 흐름 점검

Sprint 5. – 발표 및 최종 제출 주간

  • 발표 준비 및 최종 리허설
    • 팀원 전체가 참여하는 최종 발표 리허설 진행
    • 발표 자료 최종 검토 및 수정, 시연 순서 정리
  • 최종 발표 진행
    • 발표 자료(PPT PDF)와 발표 영상(YouTube 등 링크)을 활용한 공식 발표 진행
    • 질문 대응 및 피드백 수렴을 통한 발표 마무리
  • 최종 자료 제출
    • 이클래스의 MVP 게시판을 통해 모든 자료(발표자료, 영상 링크 등)를 제출