🚀 프로젝트 이름

간단한 한 줄 소개 – 프로젝트의 핵심 가치 또는 기능

---

🗂 목차

• 소개
• 프로젝트 기간
• 기술 스택
• 기능
• 시연
• 폴더 구조
• 팀 소개
• Git 컨벤션
• 테스트 방법
• 프로젝트 문서
• 라이선스

---

📱 소개

프로젝트의 주요 목적과 사용자가 얻게 될 경험을 설명해주세요.

🔗 앱스토어/웹 링크

📆 프로젝트 기간

• 전체 기간: 2025.06.23 - 2025.08.01
• 개발 기간: 2025.07.04 - 2025.07.28

🛠 기술 스택

• iOS: Swift / SwiftUI / UIKit / Vision / MusicKit 등
• Backend: On-premise: MeiliSearch, BeautifulSoup / Severless : Lambda, ApiGateway, S3, DynamoDB
• 아키텍처: MVVM + Clean Architecture 등
• 기타 도구: Figma, Notion, GitHub Projects / JIRA / Confluence 등

🌟 주요 기능

• ✅ AVFoundation으로 페스티벌 라인업을 인식한다
• ✅ 인식된 포스터를 vision으로 텍스트를 추출한다.
• ✅ 추출된 텍스트를 가지고 페스티벌 라인업에 포함된 가수들을 모아 플레이리스트를 생성한다.
• ✅ MusicKit으로 30초 미리듣기 및 생성된 플레이리스트를 내보낼 수 있다.

필요시 이미지, GIF, 혹은 링크 삽입

🖼 화면 구성 및 시연

기능	설명	이미지
예시1	기능 요약
예시2	기능 요약

🧱 폴더 구조

📦CodePlay
┣ 📂Presentation
┃ ┣ 📂Factory
┃ ┣ 📂Scene
┃ ┃ ┣ 📂ExportPlaylist
┃ ┃ ┣ 📂LicenseCheck
┃ ┃ ┣ 📂MainPosterView
┃ ┃ ┗ 📂Root
┃ ┗ 📂Utils
┣ 📂Domain
┃ ┣ 📂Interfaces
┃ ┣ 📂Models
┃ ┣ 📂Services
┃ ┗ 📂Usecases
┣ 📂Data
┃ ┣ 📂Network
┃ ┗ 📂SceneB
┣ 📂Application
┣ ┗ 📂DIContainer
┗ 📂Resources

🧑‍💻 팀 소개

이름	역할	GitHub
Cherry	iOS Developer	@zz6cherry
Elian	PM, Back-End	@dangdang1ing15
Kwangro	iOS Developer	@hkwangro
Three	PM	@iamseulee
Yan	iOS Lead	@yanni13

🔗 팀 블로그 / 미디엄 링크

🔖 브랜치 전략

(예시)

• main: 배포 가능한 안정 버전
• dev: 통합 개발 브랜치
• feat/*: 기능 개발 브랜치
• fix/*: 버그 수정 브랜치
• setting/*: 프로젝트 설정 브랜치
• chore/*: Feat 이외에 코드 수정, 내부 파일 수정, 애매한 것들이나 잡일
• refactor/*: 리펙토링 및 전면 수정

🌀 커밋 메시지 컨벤션

(예시)
Gitmoji + Conventional Commits

예시

• ✨ feat: 로그인 화면 추가
• 🐛 fix: 홈 진입 시 크래시 수정
• ♻️ refactor: 데이터 모델 구조 정리

✅ 테스트 방법

1. 이 저장소를 클론합니다.

git clone https://github.com/yourteam/project.git

2. Xcode로 .xcodeproj 또는 .xcworkspace 열기
3. 시뮬레이터 환경 설정: iPhone 15 / iOS 17
4. Cmd + R로 실행 / Cmd + U로 테스트 실행

📎 프로젝트 문서

• 기획 히스토리
• 디자인 히스토리
• 기술 문서 (아키텍처 등)

📝 License

This project is licensed under the CHOOSE A LICENSE. and update this line