러닝 코스 생성기

GPT API와 카카오맵 API를 활용한 맞춤형 러닝 코스 생성기입니다.

🚀 배포된 사이트

Railway 배포: 러닝 코스 생성기 (권장) Vercel 배포: 러닝 코스 생성기

📋 기능

• 현재 위치 기반 러닝 코스 생성
• 거리, 난이도, 선호 환경 설정
• GPT API를 활용한 맞춤형 코스 추천
• 카카오맵 API를 통한 경로 시각화
• 시간대별 러닝 팁 제공

🛠️ 기술 스택

• Frontend: HTML, CSS, JavaScript, Bootstrap
• Backend: Node.js, Express.js
• API: OpenAI GPT API, 카카오맵 API
• 배포: Vercel

🔧 설치 및 실행

로컬 개발

1. 저장소 클론

git clone <repository-url>
cd running-course-generator

2. 의존성 설치

npm install

3. 환경 변수 설정

cp env.example .env
# .env 파일에 API 키 입력

4. 개발 서버 실행

npm run dev

배포

이 프로젝트는 Railway를 통해 자동 배포됩니다 (권장).

Railway 배포 방법

1. Railway 계정 생성

   • Railway.app에 접속
   • GitHub 계정으로 로그인

2. 프로젝트 연결

   • New Project → Deploy from GitHub repo 선택
   • 2025UNithon-main 저장소 선택

3. 환경변수 설정

   • Railway 대시보드에서 Variables 탭 선택
   • 다음 환경변수 추가:
     • OPENAI_API_KEY: OpenAI API 키
     • KAKAO_REST_API_KEY: 카카오맵 REST API 키
     • NODE_ENV: production

4. 자동 배포

   • GitHub에 푸시하면 자동으로 배포됨
   • 배포 완료 후 제공되는 도메인으로 접속

Vercel 배포 (대안)

이 프로젝트는 Vercel을 통해도 배포할 수 있습니다.

🔑 API 키 설정

로컬 개발 환경

1. 프로젝트 루트에 .env 파일 생성
2. 다음 내용을 입력하고 실제 API 키로 교체:

# OpenAI API 설정
OPENAI_API_KEY=your_openai_api_key_here

# 카카오맵 API 설정
KAKAO_REST_API_KEY=your_kakao_rest_api_key_here

# 서버 포트 설정 (선택사항)
PORT=3000

# 환경 설정
NODE_ENV=development

Vercel 배포 환경

1. Vercel 대시보드에서 프로젝트 선택
2. Settings → Environment Variables 메뉴로 이동
3. 다음 환경변수 추가:

OpenAI API 키

• Name: OPENAI_API_KEY
• Value: 발급받은 OpenAI API 키
• Environment: Production, Preview, Development 모두 선택

카카오맵 API 키

• Name: KAKAO_REST_API_KEY
• Value: 발급받은 카카오 REST API 키
• Environment: Production, Preview, Development 모두 선택

API 키 발급 방법

OpenAI API 키

1. OpenAI Platform에서 계정 생성/로그인
2. API Keys 메뉴에서 "Create new secret key" 클릭
3. API 키 복사하여 환경변수에 설정

카카오맵 API 키

1. 카카오 개발자에서 계정 생성/로그인
2. 애플리케이션 생성 후 "플랫폼" → "Web" 등록
3. "앱 키" → "REST API 키" 복사하여 환경변수에 설정

📱 사용법

1. 현재 위치 입력 또는 GPS 위치 사용
2. 러닝 거리, 난이도, 선호 환경 설정
3. 러닝 시간대 선택
4. 추가 요청사항 입력 (선택사항)
5. "코스 생성하기" 버튼 클릭
6. 생성된 코스 확인 및 지도에서 경로 확인

🌟 주요 특징

• 맞춤형 추천: 사용자 설정에 따른 개인화된 코스 생성
• 실시간 지도: 카카오맵을 통한 직관적인 경로 시각화
• AI 기반: GPT API를 활용한 지능형 코스 추천
• 반응형 디자인: 모바일과 데스크톱에서 최적화된 사용자 경험

�� 라이선스

MIT License