Skip to content

PerFumeOnMe/frontend

Repository files navigation

🌸 퍼퓸온미 (PerFumeOnMe)

나만의 향기를 찾아주는 맞춤형 향기 경험 플랫폼

사용자의 감각과 취향에 기반하여 향수를 찾고, 추천받고, 기록하며, 자기만의 향을 탐색할 수 있도록 돕는 개인화된 향기 큐레이션 서비스입니다.

💡 Project Overview

퍼퓸온미는 단순한 제품 추천을 넘어, 사용자의 감정과 상황, 개성까지 반영하여 진짜 '나만의 향'을 발견할 수 있는 여정을 제공합니다. 기술(GPT 기반 검색, 설문형 MBTI 진단 등)과 감성(향 기록, 키워드 추천 등)을 결합해, 사용자가 향기를 통해 자신을 발견하고 표현할 수 있는 플랫폼입니다.

👥 Contributors

칠성/김진성 웰시/최지은 미르/오동이 위즈/이슬기
김진성 최지은 오동이 이슬기
@smileman62 @chlwldms @OhDongI @wiz0208

📌 서비스 목표

  1. 선택의 어려움 해결: 수천 가지의 향수가 존재하지만, 대부분의 사용자들은 어떤 향이 자신에게 어울릴지 몰라서 선택에 어려움을 겪기에 퍼퓨온미는 사용자가 자신에게 맞는 향을 쉽게 찾을 수 있도록 돕습니다.

  2. 다양한 탐색 경로 제공: 사용자들은 향에 대한 취향을 언어로 설명하기 어렵기 때문에 검색이나 추천이 제한적입니다. 퍼퓨온미는 GPT, 키워드, 설문을 통한 다양한 경로로 향수를 찾을 수 있도록 합니다.

  3. 개인 맞춤형 추천: 기존 플랫폼은 일반적인 추천만 제공하지만, 사용자는 점점 더 자신에게 맞는 향수 경험을 원하고 있기에 퍼퓨온미는 성격, 취향, 기분 등 다양한 요소를 반영한 개인 맞춤형 추천을 제공합니다.

✨ 주요 기능

🔍 향기 찾기

상상하는 향을 GPT에게 자유롭게 묘사하면 유사한 향수를 찾아주는 AI 기반 향기 검색과 브랜드, 노트, 계절 등의 필터를 활용한 향수 검색 기능

💝 향기 추천

사용자의 외적(스타일, 이미지)·내적(성격, 취향) 키워드와 원하는 노트 조합(탑, 미들, 베이스)을 선택하면 감정적으로 공감할 수 있는 향수를 추천

📅 향기 기록

날짜별로 뿌린 향수와 그날의 기분이나 사건을 캘린더에 기록하여 향수를 '기억과 감정의 매개체'로 만들어주는 기능

🧠 향기 MBTI

향기 성향 설문을 통해 개인의 향기 MBTI를 제공하고, 이에 맞는 향 계열 및 향수를 추천하여 자신의 향기 취향을 자각할 수 있도록 돕는 기능

🛠️ Tech Stack

  • React 19: 최신 React 버전으로 강력한 성능과 사용자 경험 제공
  • TypeScript: 타입 안정성으로 개발 생산성과 코드 품질 향상
  • Vite: 빠른 개발 서버와 최적화된 빌드 제공
  • Tailwind CSS 4: 유틸리티 클래스 기반 스타일링으로 일관된 디자인
  • Framer Motion: 부드러운 애니메이션과 인터랙션 구현
  • React Router DOM: SPA 라우팅 관리
  • Axios: HTTP 클라이언트로 API 통신
  • React Hot Toast: 사용자 친화적인 알림 시스템
  • React Calendar: 향기 기록 캘린더 기능
  • React Icons: 다양한 아이콘 컴포넌트

⚙️ Getting Started

Prerequisites

다음 도구들이 설치되어 있는지 확인해주세요:

  • Node.js (v18 이상)
  • pnpm

Installation

  1. 저장소 클론
git clone https://github.com/PerFumeOnMe/Front-end.git
cd Front-end
  1. 의존성 설치
pnpm install
  1. 개발 서버 실행
pnpm run dev
  1. 브라우저에서 http://localhost:5173 접속

Available Scripts

pnpm run dev      # 개발 서버 실행
pnpm run build    # 프로덕션 빌드
pnpm run preview  # 빌드 결과 미리보기
pnpm run lint     # 코드 린팅
pnpm run svgr     # SVG 파일을 React 컴포넌트로 변환

🎯 해결하는 문제들

문제점 퍼퓨온미의 해결책
"향수를 말로 설명하기 어려워요" GPT 기반 향기 찾기로 감정, 장면, 이미지로도 검색 가능
"향수가 너무 많아 고르기 어려워요" 직관적인 키워드 추천 + 필터 조합 제공
"매번 비슷한 향만 쓰게 돼요" 성격/스타일 기반 향기 MBTI와 다채로운 추천 노출
"향수를 써도 기억에 안 남아요" 향기 캘린더에 감정·상황 기록 기능 제공
"향을 배우고 싶어요" 노트 설명, 향조 구조 시각화로 학습 가이드 제공

🌟 기대 효과

시장 반응

퍼퓸온미는 향수를 처음 접하는 사용자에게 진입장벽을 낮추고, 감성적으로 다가갈 수 있도록 돕는 직관적인 플랫폼입니다. 사용자들은 더 이상 "어떤 향이 좋은지 몰라서 아무거나 샀다가 후회하는 경험"을 반복하지 않게 됩니다.

사회적 기여

향수 문화의 접근성을 높이고, 지역 향수 공방과 연계하여 오프라인 체험의 기회를 넓히며, 향수 제작자 및 창작자들과의 상생 네트워크를 기대할 수 있습니다.

🏆 비전

향수를 소비재가 아닌 자기 표현의 수단으로 인식하게 만드는 것이 퍼퓨온미의 비전입니다. 궁극적으로는 향수 문화를 대중화하고, 오프라인 향기 체험까지 이어지는 라이프스타일 플랫폼으로 확장하는 것이 목표입니다.

📞 Contact

프로젝트에 대한 문의나 제안사항이 있으시면 언제든 연락해주세요!


퍼퓸온미와 함께 당신만의 특별한 향기를 찾아보세요! 🌸✨

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages