Skip to content

Commit c3cf74d

Browse files
jj1kimclaude
andcommitted
docs: 프로젝트 README 작성
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
0 parents  commit c3cf74d

1 file changed

Lines changed: 48 additions & 0 deletions

File tree

README.md

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
# TravelMapper
2+
3+
즉흥적인 여행자를 위한 유연한 여행 스케줄러
4+
5+
## 프로젝트 소개
6+
7+
여행 계획을 세울 때, 빡빡한 일정표는 부담스럽고 무계획은 불안합니다.
8+
TravelMapper는 가고 싶은 장소들을 위시리스트에 미리 저장해두고, 여행 당일 상황에 맞춰 유연하게 일정을 확정할 수 있는 서비스입니다.
9+
10+
## 핵심 기능
11+
12+
- **스케줄 관리**: 여행 일정 생성 및 비밀번호 기반 접근
13+
- **위시리스트**: 교통/숙박/식사/카페/관광지 5개 카테고리 관리
14+
- **타임라인**: 24시간 30분 단위 그리드 기반 일정 배치
15+
- **일정 확정**: 위시리스트 항목을 드래그하여 타임라인에 확정
16+
- **"뭐 하지?" 추천**: 빈 시간대에 가능한 장소 자동 필터링
17+
- **경로 탐색**: 확정 일정 간 Google Maps 길찾기
18+
- **비용 관리**: 인당 비용 자동 계산 및 카테고리별 요약
19+
- **공유**: 토큰 기반 읽기전용 링크 생성
20+
- **다크 모드**: 시스템 설정 감지 + 수동 토글
21+
22+
## 기술 스택
23+
24+
| 영역 | 기술 |
25+
|------|------|
26+
| Frontend | Next.js (App Router), React, TypeScript, Tailwind CSS |
27+
| Backend | Next.js API Routes |
28+
| Database | Supabase PostgreSQL (배포) / SQLite (로컬 개발) |
29+
| Maps | Google Maps Platform (Places, Directions, Routes API) |
30+
| 배포 | Vercel |
31+
32+
## 개발 관리
33+
34+
- **브랜치 전략**: `main``dev``feature-*`
35+
- **Task 관리**: [GitHub Issues](../../issues)
36+
- **기획/문서**: [GitHub Wiki](../../wiki)
37+
- **PR 전략**: feature 브랜치에서 dev로 PR
38+
39+
## 로컬 실행
40+
41+
```bash
42+
npm install
43+
cp .env.local.example .env.local
44+
# .env.local에 Google Maps API Key 설정
45+
npm run dev
46+
```
47+
48+
Supabase 환경변수 없이 실행하면 자동으로 SQLite(로컬 DB)를 사용합니다.

0 commit comments

Comments
 (0)