Perfuinder Back-End Server Project

AI 맞춤형 향수 추천 iOS 서비스

📋 Project Info

🔄 Fork Information

• Original Repository: Perfuinder/Server
• Forked by: 이정원
• Fork Purpose: 개인 포트폴리오 및 기능 개선
• Fork Date: 2025.09.02

🛠️ Tech Stack

• Backend: Java 17, Spring Boot 3.2.4
• Build Tool: Gradle 8.0
• Database: MySQL 8.0
• Documentation: Swagger/OpenAPI 3.0

🌟 My Contributions & Improvements

✨ 개발한 기능

• ⭐ 사용자 맞춤형 향수 추천 Gemini 통신 - 맞춤형 향수 추천 Gemini의 프롬포트와의 통신 프로세스 개발
• 🍂 현재 개벌 별 향수 추천 - 계절에 맞는 향수 추천 기능 개발
• 🔥 전체 API 개발 및 DB 관리 - 향수 추천 Gemini 통신 및 전체 API 개발과 향수 데이터 관리

🔧 개선한 부분

• 사용자의 설문에 맞지 않는 향수 추천 결과 개선을 위한 Gemini 프롬포트 고도화 및 DB 업데이트

🚀 Quick Start

# 1. 저장소 클론
git clone https://github.com/leegaarden/cardify.git
cd cardify

# 2. MySQL 데이터베이스 설정
mysql -u root -p
CREATE DATABASE your_database_name CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

# 3. 환경설정 파일 복사 및 수정
cp src/main/resources/application.yml.example src/main/resources/application.yml
# application.yml에서 데이터베이스 정보 수정

# 4. 빌드 및 실행
./gradlew clean build
./gradlew bootRun

✅ 실행 확인

• 서버: http://localhost:8080
• API 문서: http://localhost:8080/swagger-ui/index.html

🔀 Git Flow Strategy

우리 팀은 Git Flow 브랜치 전략을 사용하여 체계적으로 개발했습니다.

브랜치 구조

main (배포용)
├── develop (개발 메인)
│   ├── feature/login (사용자 인증)
│   ├── feature/discord (결제 실패 알림)
│   └── feature/kakaopay (카카오 정기 결제)
├── release/v1.0.0 (릴리즈 준비)
├── release/v1.1.0
└── hotfix/token-renewal (토큰 갱신 문제 긴급 해)

브랜치별 역할

• main: 배포 가능한 안정적인 코드
• develop: 다음 릴리즈를 위한 개발 브랜치
• feature/*: 새로운 기능 개발
• hotfix/*: 배포 후 긴급 버그 수정

워크플로우

1. develop에서 feature/기능명 브랜치 생성
2. 기능 개발 완료 후 develop으로 Pull Request
3. 코드 리뷰 후 develop에 merge
4. 테스트 완료 후 main과 develop에 merge

📚 API Documentation

🔑 Authentication

POST /api/v1/auth/token
GET  /api/v1/auth/refresh
GET  /api/v1/auth/check-refresh-token

👤 User

PUT    /api/v1/users/notification          # 사용자 알림 설정 변경
PUT    /api//v1/users/name                 # 사용자 이름 변경
POST   /api/v1/users/logout                # 사용자 로그아웃
GET    /api/v1/users/mypage                # 사용자 마이페이지 조회
GET    /api/v1/users/check                 # 사용자 출석체크

💸 PaymentMethod

PUT /api/v1/payment-methods/{id}/default   # 기본 결제 수단 변경

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👤 Author

이정원

• GitHub: @leegaarden
• Email: [email protected]
• LinkedIn: Jeong Won Lee
• Blog: velog

🙏 Acknowledgments

• 원본 프로젝트: organization/original-repo
• 팀원들: @석민솔

---

⭐ 이 프로젝트가 도움이 되었다면 Star를 눌러주세요!

This README was crafted with ❤️ for my portfolio