Skip to content
QuespotPublic

About

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

Β 

History

220 Commits

Folders and files

Repository files navigation

πŸ—ΊοΈ Quespot

μ „κ΅­ 방방곑곑, λ―Έμ…˜μœΌλ‘œ λ– λ‚˜λŠ” κ΄€κ΄‘ μ„œλΉ„μŠ€

Quespot은 κ΄€κ΄‘μ§€λ₯Ό νƒμƒ‰ν•˜κ³ , 지역별 λ―Έμ…˜μ„ μˆ˜ν–‰ν•˜λ©°, μ—¬ν–‰μ˜ κ²½ν—˜μ„ 기둝할 수 μžˆλŠ” λ―Έμ…˜ν˜• κ΄€κ΄‘ μ„œλΉ„μŠ€μž…λ‹ˆλ‹€.

μ‚¬μš©μžλŠ” ν˜„μž¬ μœ„μΉ˜ λ˜λŠ” μ„ νƒν•œ 지역을 기반으둜 관광지와 μΆ”μ²œ μ½”μŠ€λ₯Ό ν™•μΈν•˜κ³ , 사진 μΈμ¦Β·ν‚€μ›Œλ“œ μž…λ ₯·감상 기둝 λ“±μ˜ λ―Έμ…˜μ„ μˆ˜ν–‰ν•  수 μžˆμŠ΅λ‹ˆλ‹€.

λ―Έμ…˜μ„ μ™„λ£Œν•˜λ©΄ ν¬μΈνŠΈμ™€ λ°°μ§€, μ§€μ—­ μŠ€νƒ¬ν”„λ₯Ό νšλ“ν•˜κ³  μ—¬ν–‰ 기둝을 μ•„μΉ΄μ΄λΈŒμ— 남길 수 μžˆμŠ΅λ‹ˆλ‹€.

πŸ”— μ„œλΉ„μŠ€ λ°”λ‘œκ°€κΈ°


✨ μ£Όμš” κΈ°λŠ₯

1. μ§€μ—­ 기반 κ΄€κ΄‘μ§€ 탐색

  • ν˜„μž¬ μœ„μΉ˜ 및 μ„ νƒν•œ 지역을 기반으둜 κ΄€κ΄‘μ§€ 탐색
  • κ΄€κ΄‘μ§€ μœ„μΉ˜ 및 상세 정보 확인
  • λ‚œμ΄λ„μ™€ ν…Œλ§ˆλ₯Ό κ³ λ €ν•œ λ―Έμ…˜ μ½”μŠ€ 탐색
  • Google Maps 기반 지도 μΈν„°νŽ˜μ΄μŠ€

2. λ―Έμ…˜ν˜• κ΄€κ΄‘ μ½”μŠ€

λ‹¨μˆœνžˆ κ΄€κ΄‘μ§€λ₯Ό λ°©λ¬Έν•˜λŠ” κ²ƒμ—μ„œ λ‚˜μ•„κ°€, κ΄€κ΄‘μ§€λ₯Ό 직접 κ΄€μ°°ν•˜κ³  κ²½ν—˜ν•  수 μžˆλ„λ‘ λ―Έμ…˜μ„ μ œκ³΅ν•©λ‹ˆλ‹€.

λ―Έμ…˜ μœ ν˜• μ„€λͺ…
πŸ“Έ 사진 인증 μ£Όμ–΄μ§„ μž₯μ†Œλ‚˜ ꡬ도λ₯Ό μ°Έκ³ ν•˜μ—¬ 사진 촬영
πŸ”Ž ν‚€μ›Œλ“œ κ΄€μ°° κ΄€κ΄‘μ§€μ—μ„œ νŠΉμ • μš”μ†Œλ₯Ό λ°œκ²¬ν•˜κ³  기둝
✍️ 감상 기둝 λ°©λ¬Έ μž₯μ†Œμ— λŒ€ν•œ 생각과 κ²½ν—˜ μž‘μ„±
  • κ΄€κ΄‘ μ½”μŠ€λ³„ λ―Έμ…˜ 확인
  • λ―Έμ…˜ 상세 정보 및 μˆ˜ν–‰ ν™”λ©΄ 제곡
  • GPS 및 이미지 기반 인증 κΈ°λŠ₯
  • 인증 결과에 λ”°λ₯Έ ν™”λ©΄ μ „ν™˜

3. 보상 및 μŠ€νƒ¬ν”„

  • λ―Έμ…˜ μˆ˜ν–‰μ— λ”°λ₯Έ 포인트 νšλ“
  • λ―Έμ…˜ μ™„λ£Œ 보상 확인
  • 지역별 μŠ€νƒ¬ν”„ 및 λ°°μ§€ μˆ˜μ§‘
  • κ΄€κ΄‘ ν™œλ™μ— λŒ€ν•œ μ„±μ·¨ κ²½ν—˜ 제곡

4. μ—¬ν–‰ μ•„μΉ΄μ΄λΈŒ

  • μˆ˜ν–‰ν•œ λ―Έμ…˜ 및 μ—¬ν–‰ 기둝 확인
  • 관광지별 ν™œλ™ 이λ ₯ 관리
  • μ—¬ν–‰ 기둝과 보상 λ‚΄μ—­ 확인
  • μ—¬ν–‰ κ²½ν—˜μ„ κ³΅μœ ν•  수 μžˆλŠ” μΉ΄λ“œ κΈ°λŠ₯

5. μ•Œλ¦Ό

  • λ―Έμ…˜ κ΄€λ ¨ μ•Œλ¦Ό
  • 보상 νšλ“ μ•Œλ¦Ό
  • μΆ”μ²œ κ΄€κ΄‘μ§€ 및 μ„œλΉ„μŠ€ μ•Œλ¦Ό

πŸ›  Tech Stack

Category Technologies
Language TypeScript
Framework React 19
Build Tool Vite
Styling Tailwind CSS v4
Routing React Router DOM
Server State TanStack Query v5
HTTP Client Axios
Maps Google Maps, @vis.gl/react-google-maps
External Service Firebase
PWA vite-plugin-pwa
SVG SVGR
UI Icons Lucide React
Package Manager pnpm
Deployment Vercel

πŸ— Frontend Architecture

Quespot은 κ΄€κ΄‘μ§€ 탐색뢀터 λ―Έμ…˜ μˆ˜ν–‰, 인증, 보상 및 μ•„μΉ΄μ΄λΈŒκΉŒμ§€ μ—°κ²°λ˜λŠ” μ‚¬μš©μž 흐름을 μ€‘μ‹¬μœΌλ‘œ κ΅¬μ„±λœ React 기반 μ›Ή μ• ν”Œλ¦¬μΌ€μ΄μ…˜μž…λ‹ˆλ‹€.

곡톡 λ ˆμ΄μ•„μ›ƒκ³Ό λΌμš°νŒ…μ„ λΆ„λ¦¬ν•˜κ³ , μ„œλ²„ 데이터와 UI μƒνƒœμ˜ 역할을 κ΅¬λΆ„ν•˜μ—¬ μ—¬λŸ¬ κΈ°λŠ₯을 관리할 수 μžˆλ„λ‘ κ΅¬μ„±ν–ˆμŠ΅λ‹ˆλ‹€.

1. λΌμš°νŒ… 및 곡톡 λ ˆμ΄μ•„μ›ƒ

React Router의 createBrowserRouterλ₯Ό ν™œμš©ν•˜μ—¬ μ• ν”Œλ¦¬μΌ€μ΄μ…˜ λΌμš°νŒ…μ„ κ΅¬μ„±ν–ˆμŠ΅λ‹ˆλ‹€.

μ£Όμš” ꡬ성

  • MobileLayout: λͺ¨λ°”일 μ›Ή ν™˜κ²½μ˜ 곡톡 λ ˆμ΄μ•„μ›ƒ
  • BottomNavigationLayout: ν•˜λ‹¨ λ‚΄λΉ„κ²Œμ΄μ…˜μ„ μ‚¬μš©ν•˜λŠ” νŽ˜μ΄μ§€μ˜ 곡톡 λ ˆμ΄μ•„μ›ƒ
  • ProtectedRoute: 인증이 ν•„μš”ν•œ νŽ˜μ΄μ§€μ— λŒ€ν•œ μ ‘κ·Ό μ œμ–΄
  • PATH: νŽ˜μ΄μ§€ 경둜λ₯Ό λ³„λ„λ‘œ κ΄€λ¦¬ν•˜κΈ° μœ„ν•œ μƒμˆ˜

곡톡 UIλ₯Ό λ ˆμ΄μ•„μ›ƒ λ‹¨μœ„λ‘œ λΆ„λ¦¬ν•˜μ—¬ νŽ˜μ΄μ§€λ§ˆλ‹€ λ™μΌν•œ λ‚΄λΉ„κ²Œμ΄μ…˜κ³Ό ν™”λ©΄ ꡬ쑰λ₯Ό λ°˜λ³΅ν•΄μ„œ μž‘μ„±ν•˜μ§€ μ•Šλ„λ‘ κ΅¬μ„±ν–ˆμŠ΅λ‹ˆλ‹€.

λ˜ν•œ 인증이 ν•„μš”ν•œ ν™”λ©΄μ˜ μ ‘κ·Ό 쑰건을 λΌμš°νŒ… κ³„μΈ΅μ—μ„œ 관리할 수 μžˆλ„λ‘ λΆ„λ¦¬ν–ˆμŠ΅λ‹ˆλ‹€.

2. μ„œλ²„ μƒνƒœ 관리

TanStack Query v5λ₯Ό ν™œμš©ν•œ μ„œλ²„ μƒνƒœ 관리 ν™˜κ²½μ„ κ΅¬μ„±ν–ˆμŠ΅λ‹ˆλ‹€.

μ£Όμš” ꡬ성

  • μ• ν”Œλ¦¬μΌ€μ΄μ…˜ μ΅œμƒμœ„μ— QueryClientProvider 적용
  • QueryClientλ₯Ό ν†΅ν•œ μ„œλ²„ μƒνƒœ 관리 기반 ꡬ성
  • Axiosλ₯Ό ν™œμš©ν•œ HTTP 톡신
  • API 데이터 μ²˜λ¦¬μ™€ UI λ Œλ”λ§ 관심사 뢄리

이λ₯Ό 톡해 κ΄€κ΄‘μ§€, λ―Έμ…˜, μ‚¬μš©μž 정보 λ“± μ„œλ²„μ™€ μ—°λ™λ˜λŠ” 데이터λ₯Ό λ‹€λ£° 수 μžˆλŠ” κΈ°λ°˜μ„ λ§ˆλ ¨ν–ˆμŠ΅λ‹ˆλ‹€.

3. PWA ν™˜κ²½ ꡬ성

vite-plugin-pwaλ₯Ό ν™œμš©ν•˜μ—¬ λͺ¨λ°”일 ν™˜κ²½μ—μ„œ μ•±κ³Ό μœ μ‚¬ν•œ μ‚¬μš©μž κ²½ν—˜μ„ μ œκ³΅ν•˜κΈ° μœ„ν•œ PWA 섀정을 κ΅¬μ„±ν–ˆμŠ΅λ‹ˆλ‹€.

적용 μ„€μ •

  • Web App Manifest 등둝
  • standalone λ””μŠ€ν”Œλ ˆμ΄ λͺ¨λ“œ
  • autoUpdate 등둝 방식 μ„€μ •

PWA 섀정을 톡해 λͺ¨λ°”일 κΈ°κΈ°μ—μ„œ ν™ˆ 화면에 μΆ”κ°€ν•˜μ—¬ μ‚¬μš©ν•  수 μžˆλŠ” μ›Ήμ•± ν™˜κ²½μ„ μ§€μ›ν•˜λ„λ‘ κ΅¬μ„±ν–ˆμŠ΅λ‹ˆλ‹€.

4. κ°œλ°œν™˜κ²½ ꡬ성

Vite와 TypeScriptλ₯Ό 기반으둜 ν”„λ‘œμ νŠΈλ₯Ό κ΅¬μ„±ν–ˆμŠ΅λ‹ˆλ‹€.

  • TypeScript의 μ—„κ²©ν•œ νƒ€μž… 검사 μ„€μ •
  • @/ aliasλ₯Ό ν†΅ν•œ μ ˆλŒ€ 경둜 기반 λͺ¨λ“ˆ μ°Έμ‘°
  • Tailwind CSS v4 기반 μŠ€νƒ€μΌλ§
  • SVGR을 ν™œμš©ν•œ SVG μ»΄ν¬λ„ŒνŠΈ μ‚¬μš©
  • pnpm을 ν™œμš©ν•œ νŒ¨ν‚€μ§€ 관리

πŸ”„ User Flow

κ΄€κ΄‘μ§€ 탐색뢀터 μ—¬ν–‰ κΈ°λ‘κΉŒμ§€

μ§€μ—­ 선택 / ν˜„μž¬ μœ„μΉ˜
          ↓
    κ΄€κ΄‘μ§€ 및 μ½”μŠ€ 탐색
          ↓
       λ―Έμ…˜ 상세
          ↓
       λ―Έμ…˜ μˆ˜ν–‰
          ↓
   사진 / ν‚€μ›Œλ“œ / 감상 인증
          ↓
       인증 결과
          ↓
       보상 νšλ“
          ↓
      μ—¬ν–‰ μ•„μΉ΄μ΄λΈŒ

1. 탐색 및 μ½”μŠ€ 선택

μ‚¬μš©μžκ°€ 관심 μžˆλŠ” 지역을 μ„ νƒν•˜κ³ , 관광지와 μΆ”μ²œ λ―Έμ…˜ μ½”μŠ€λ₯Ό ν™•μΈν•©λ‹ˆλ‹€.

2. λ―Έμ…˜ μˆ˜ν–‰

μ„ νƒν•œ κ΄€κ΄‘ μ½”μŠ€μ— ν¬ν•¨λœ λ―Έμ…˜μ„ μˆ˜ν–‰ν•©λ‹ˆλ‹€.

λ―Έμ…˜μ˜ μ’…λ₯˜μ— 따라 사진 촬영, ν‚€μ›Œλ“œ μž…λ ₯, 감상 μž‘μ„± λ“±μ˜ μΈν„°νŽ˜μ΄μŠ€λ₯Ό μ œκ³΅ν•©λ‹ˆλ‹€.

3. 인증 및 κ²°κ³Ό 확인

μ‚¬μš©μžκ°€ μ œμΆœν•œ 인증 정보에 따라 인증 과정을 μ§„ν–‰ν•˜κ³  κ²°κ³Όλ₯Ό ν™•μΈν•©λ‹ˆλ‹€.

인증 μ§„ν–‰ μƒνƒœμ— 따라 λ‘œλ”© 및 κ²°κ³Ό 화면을 μ œκ³΅ν•©λ‹ˆλ‹€.

4. 보상 및 μ•„μΉ΄μ΄λΈŒ

λ―Έμ…˜ μˆ˜ν–‰ 결과에 λ”°λ₯Έ 보상을 ν™•μΈν•˜κ³ , μ‚¬μš©μžμ˜ μ—¬ν–‰ ν™œλ™μ„ μ•„μΉ΄μ΄λΈŒμ— κΈ°λ‘ν•©λ‹ˆλ‹€.


πŸ“‚ Project Structure

μ£Όμš” 디렉터리와 νŒŒμΌμ„ μ€‘μ‹¬μœΌλ‘œ μ •λ¦¬ν•œ ν”„λ‘œμ νŠΈ κ΅¬μ‘°μž…λ‹ˆλ‹€.

Quespot-FE/
β”œβ”€β”€ public/                  # 정적 λ¦¬μ†ŒμŠ€ 및 PWA μ•„μ΄μ½˜
β”œβ”€β”€ scripts/                 # ν”„λ‘œμ νŠΈ 슀크립트
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ assets/              # 이미지 및 SVG 에셋
β”‚   β”œβ”€β”€ components/          # 곡톡 및 κΈ°λŠ₯별 μ»΄ν¬λ„ŒνŠΈ
β”‚   β”œβ”€β”€ layouts/             # 곡톡 λ ˆμ΄μ•„μ›ƒ
β”‚   β”‚   β”œβ”€β”€ MobileLayout
β”‚   β”‚   └── BottomNavigationLayout
β”‚   β”œβ”€β”€ pages/               # κΈ°λŠ₯별 νŽ˜μ΄μ§€
β”‚   β”‚   β”œβ”€β”€ Auth/            # 둜그인, νšŒμ›κ°€μž…, μ˜¨λ³΄λ”©
β”‚   β”‚   β”œβ”€β”€ mission/         # λ―Έμ…˜ 탐색, 상세, μ½”μŠ€
β”‚   β”‚   β”‚   └── verify/      # λ―Έμ…˜ 인증 및 κ²°κ³Ό
β”‚   β”‚   β”œβ”€β”€ map/             # 지도 및 μž₯μ†Œ 검색
β”‚   β”‚   β”œβ”€β”€ My/              # λ§ˆμ΄νŽ˜μ΄μ§€ 및 μ•„μΉ΄μ΄λΈŒ
β”‚   β”‚   β”œβ”€β”€ HomePage
β”‚   β”‚   β”œβ”€β”€ RewardPage
β”‚   β”‚   └── NotificationPage
β”‚   β”œβ”€β”€ routes/              # λΌμš°νŒ… 및 μ ‘κ·Ό μ œμ–΄
β”‚   β”‚   β”œβ”€β”€ router.tsx
β”‚   β”‚   β”œβ”€β”€ paths.ts
β”‚   β”‚   └── ProtectedRoute
β”‚   β”œβ”€β”€ styles/              # μŠ€νƒ€μΌ κ΄€λ ¨ 파일
β”‚   β”œβ”€β”€ App.tsx              # μ•± μ»΄ν¬λ„ŒνŠΈ
β”‚   └── main.tsx             # μ•± μ§„μž…μ  및 Provider
β”œβ”€β”€ index.html
β”œβ”€β”€ package.json
β”œβ”€β”€ tsconfig.json
β”œβ”€β”€ vercel.json
└── vite.config.ts

βš™οΈ Development Environment

Vite Configuration

ν”„λ‘œμ νŠΈμ˜ λΉŒλ“œ ν™˜κ²½μ€ Viteλ₯Ό 기반으둜 κ΅¬μ„±λ˜μ–΄ μžˆμŠ΅λ‹ˆλ‹€.

적용 ν”ŒλŸ¬κ·ΈμΈ

  • @vitejs/plugin-react: React κ°œλ°œν™˜κ²½
  • @tailwindcss/vite: Tailwind CSS 톡합
  • vite-plugin-svgr: SVG μ»΄ν¬λ„ŒνŠΈ μ‚¬μš©
  • vite-plugin-pwa: PWA μ„€μ • 및 Manifest 생성

TypeScript

TypeScriptλ₯Ό ν™œμš©ν•΄ μ»΄ν¬λ„ŒνŠΈμ™€ 데이터 ꡬ쑰의 νƒ€μž… μ•ˆμ •μ„±μ„ ν™•λ³΄ν•˜κ³ , λΉŒλ“œ κ³Όμ •μ—μ„œ νƒ€μž… 검사λ₯Ό μˆ˜ν–‰ν•˜λ„λ‘ μ„€μ •ν–ˆμŠ΅λ‹ˆλ‹€.

Build & Deployment

  • Vite 기반 개발 μ„œλ²„ μ‹€ν–‰
  • tsc && vite buildλ₯Ό ν†΅ν•œ νƒ€μž… 검사 및 ν”„λ‘œλ•μ…˜ λΉŒλ“œ
  • Vercel을 ν†΅ν•œ μ›Ή μ„œλΉ„μŠ€ 배포
  • SPA λΌμš°νŒ…μ„ μœ„ν•œ 배포 ν™˜κ²½ μ„€μ •

πŸ‘©β€πŸ’» Frontend Team

Name GitHub
κΉ€μž¬λ²” @kinjaebeom
κ°•λ―Όμ„œ @shooukie
μ΅œνš¨λΉ„ @Hyobee02

πŸ”— Links


Quespot은 μ‚¬μš©μžκ°€ κ΄€κ΄‘μ§€λ₯Ό 직접 νƒμƒ‰ν•˜κ³ , λ―Έμ…˜μ„ μˆ˜ν–‰ν•˜λ©°, μ—¬ν–‰ κ²½ν—˜μ„ κΈ°λ‘ν•˜λŠ” 과정을 ν•˜λ‚˜μ˜ μ„œλΉ„μŠ€λ‘œ μ—°κ²°ν•œ ν”„λ‘œμ νŠΈμž…λ‹ˆλ‹€.

About

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages