1. 사전 준비

1. Git 리포지터리 클론

   git clone <https://github.com/Lee-Hyeongkyeong/OSSW_githubushim.git>
   

2. 필수 소프트웨어

   • Python 3.9 이상
   • Node.js 16 이상 & npm
   • (선택) 가상환경 관리 도구: venv 또는 virtualenv

3. .env 템플릿 확인

   주요 변수

   GOOGLE_CLIENT_ID=383618059631-45iv6up01gkr9ib49a4shr92flk393bg.apps.googleusercontent.com
   GOOGLE_CLIENT_SECRET=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
   TOUR_API_KEY=your_korean_tour_api_key
   FLASK_ENV=development
   SECRET_KEY=your_flask_secret_key
   

2. 백엔드(Flask) 실행 환경 설정

1. 가상환경 생성 및 활성화

   python3 -m venv venv
   source venv/bin/activate
   
   

2. 의존성 설치

   pip install --upgrade pip
   pip install -r requirements.txt
   
   

3. 데이터 준비

   • OS_data.py 실행 (backend/survey 폴더) tour 4.0 API에서 원본 데이터(tour_contents.json) 생성

     python backend/survey/OS_data.py
     
     

   • OS_tag.py 실행 (backend/survey 폴더) tour_contents.json → 태그 부여된 tagged_contents.json 생성

     python backend/survey/OS_tag.py
     
     

3. 백엔드 서버 실행

1. WSGI 서버 실행

   python wsgi.py
   

   • 기본 포트: https://127.0.0.1:5000

2. 동작 확인

   • 브라우저에서 https://127.0.0.1:5000 접속
   • 구글 로그인 화면으로 리디렉션 되는지 확인

4. 프론트엔드(React) 실행

1. 의존성 설치

   cd frontend
   npm install
   

2. 개발서버 실행

   npm start
   

   • 기본 포트: http://localhost:3000

3. 동작 확인

   • http://localhost:3000 접속
   • 설문 페이지, 추천 결과 페이지 등이 정상적으로 뜨는지 테스트