프로젝트 구조 - DDAL-KKAK-DOT/DDALKKAK GitHub Wiki
백엔드
📦 backend
┣ service.py # FastAPI 엔트리포인트
┣ 📂data_model # Pydantic 모델 정의
┃ ┣ __init__.py
┃ ┣ career.py
┃ ┣ club.py
┃ ┣ education.py
┃ ┣ inputProfile.py
┃ ┣ outputProfile.py
┃ ┗ project.py
┣ gemini_client.py # Gemini API 클라이언트
┣ utils.py # 공통 유틸리티 함수
┣ utils_convert.py # PDF 변환 관련 유틸리티 함수
┣ utils_fetch.py # 데이터 가져오기 유틸리티 함수
┣ cors.py # CORS 설정
┣ 📂sample_data # 샘플 데이터
┃ ┗ output_data.py
┣ 📂test # 테스트 코드
┃ ┣ conftst.py
┃ ┣ test_api.py
┃ ┣ test_gemini.py
┃ ┗ test_utils_fetch.py
┗ __init__.py
프론트엔드
📦 frontend
┣ 📂.husky # CI용 Git hook 스크립트
┣ 📂public # 정적 파일
┣ 📂src # 실제 소스 코드 폴더
┃ ┣ 📂apis → API 호출 모듈
┃ ┣ 📂app → Next.js App Router
┃ ┃ ┣ 📂main → 메인 페이지
┃ ┃ ┣ 📂resume → 이력서 생성 flow
┃ ┃ ┃ ┣ 📂edit → 이력서 편집 UI
┃ ┃ ┃ ┗ 📂start → 이력서 시작 단계
┃ ┃ ┣ 📂templates → 템플릿 선택 관련 페이지
┃ ┃ ┣ layout.tsx → 공통 레이아웃 정의
┃ ┃ ┣ page.tsx → `/` 루트 경로 페이지
┃ ┃ ┗ providers.tsx → 전역 Provider 등록
┃ ┣ 📂components → 재사용 가능한 UI 컴포넌트
┃ ┃ ┣ Button / Field / Footer / Header / Icon 등
┃ ┃ ┗ layout → 레이아웃 관련 구조적 컴포넌트
┃ ┣ 📂fonts → 웹폰트 로딩 설정
┃ ┣ 📂hooks → 커스텀 훅
┃ ┃ ┗ queries → react-query 기반 훅
┃ ┣ 📂styles → 전역 스타일 정의 (Tailwind 포함)
┃ ┣ 📂types → TypeScript 인터페이스/타입 정의
┃ ┗ 📂utils → 공통 유틸 함수
┣ .gitignore / .prettierrc / tsconfig.json 등은 환경설정 파일