프로젝트 구조 - 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 등은 환경설정 파일