중간 데모 발표 - DDAL-KKAK-DOT/DDALKKAK GitHub Wiki

🎤 발표 영상 및 자료

팀딸깍_중간발표자료_250608.pdf

https://youtu.be/mjmxqWN14AA?si=0mA4ZBwuniWnovib

💡 중간 보고서

1. 프로젝트/MVP 개요

문제 인식 : 포트폴리오·이력서를 처음 작성하는 사람들에게 포트폴리오 작성이 막막함

→ 간편하게 초안을 제공하는 서비스가 필요함
MVP 목표
1. 외부 링크 크롤링(GitHub·블로그 등)
2. AI 기반 자동 포트폴리오 생성
3. PDF 변환·다운로드 제공
기술 스택 :
- 개발 :
  
  Frontend: Next.js, TailwindCSS, Tanstack-Query, React-Hook-Form Backend: FastAPI, Gemini
- 배포 :
  
  AWS EC2 & Vercel
- 협업 :
  
  GitHub / Notion / Discord

2. MVP 목표 대비 구현 진척도

기능	구현 상태	비고
외부 링크 크롤링	✅ 완료	BS4 + Selenium + Requests 병행
AI 포트폴리오 자동생성	✅ 완료	Gemini + 프롬프트 엔지니어링
PDF 변환·다운로드	✅ 완료	모듈 완성
FE/BE 배포 (Vercel/AWS)	✅ 완료	GitHub Actions CD, AWS EC2
FE-BE API 연동	✅ 완료	Portfolio Generation 연동 완료

3. 코드 품질 및 문서화 상태

항목	현황
API 문서화	FastAPI Swagger
테스트	기본 단위 테스트, 통합 테스트 작성 중
Style/Convention	Gitmoji, Prettier, Husky, Conventional Commits
라이선스	MIT License
README/위키	구조 초안 완료 – 세부 사용법·아키텍처에 대한 추가적인 설명이 필요함

4. 팀 협업 및 GitHub 활용도

브랜치 전략

: 모노레포 구조를 기반으로 하여, 프론트엔드와 백엔드 개발을 각각 독립된 브랜치에서 병렬적으로 진행할 수 있도록 브랜치 전략을 설계
- 현재 최종 코드 위치: [dev-fe](https://github.com/DDAL-KKAK-DOT/DDALKKAK/tree/dev-fe), [dev-be](https://github.com/DDAL-KKAK-DOT/DDALKKAK/tree/dev-be)
- 작업 플로우
  1. Issue 등록
  2. 브랜치 분기(Issue 번호 기반) 및 PR 생성
  3. 코드리뷰 및 Squash-Merge 방식 병합
코드리뷰 문화
- 모든 팀원의 승인(appove)을 받은 후에 병합 가능
Git Actions를 활용한 CI
- 프런트엔드 별도 레포로 복제 후 배포
- Pylint 문법 자동 확인

5. 주요 기술적 도전 과제 및 해결 방안

도전 과제	문제점	해결 전략
Vercel CD 비용	조직 계정 과금	개인 레포 + GitHub Actions → Vercel 무료 플랜
LLM 출력 안정화	JSON 구조 불안정	Few-shot + JSON schema 프롬프트
동적 페이지 크롤링	JS 렌더링 지연	Requests + 헤드리스 Selenium + BeautifulSoup4 하이브리드
API 연동 보안	CORS/토큰 관리	FastAPI Middleware + OAuth 2.0

6. 남은 작업(To-Do) 및 리스크

남은 일정	작업	리스크/완화
6/9-6/11	PDF 변환 API 연동	백엔드 측 SSL 인증 실패 → 로컬 배포
6/10-6/12	CI/CD & 테스트 자동화	환경 의존성 → 테스트 코드 강화
6/10-6/14	템플릿 적용	다중 템플릿 복잡도 ↑ → MVP는 1종
6/13-6/15	문서화 보강	별도 리스크 없음

향후 일정

7. 피드백 받고 싶은 항목

README 깊이 : 간략한 README와 상세한 README는 각각의 장단점을 가지고 있는데, 어느 정도 수준의 구현이 기준이 적절할지 궁금합니다
오픈소스 LLM/VLM으로의 전환 : 오픈소스 모델과 Proprietary 모델의 장단점을 두고 보았을 때, 과목의 취지상 오픈소스 모델을 활용하는 것이 바람직할지 궁금합니다.

8. 결론 및 다음 단계

핵심 기능 95 % 완성, 남은 과제는 “백엔드 SSL 적용 후 API 연동”과 “CI/CD 및 테스트 자동화”.

→ 또는, OpenSource 프로젝트이니만큼 배포 없이 공개해도 좋을지
코드 품질 기반 마련 → 테스트·문서화 보강 예정.
팀 협업 원활하지만 리뷰·테스트 병행을 강화해 리스크 최소화.

최종 발표(6/15)까지 완전한 API 워크플로우와 CI & 템플릿 5종을 배포 목표로 합니다.

📄 This project is licensed under the MIT License.
🙋 For questions or contributions, refer to CONTRIBUTING.md.

⚠️ GitHub.com Fallback ⚠️