TourMaster

本專案以React及Django設計前後端，並且串接了ChatGPT API及Bing Search/Google Search API，打造了一個旅遊景點的推薦網站。平台透過自動生成詳細景點介紹及高品質圖片，讓使用者輕鬆獲取全球景點資訊。同時，具備「喜愛地點儲存」功能，幫助使用者有效管理查詢結果，提升行程規劃的便利性與體驗價值。

主要功能

• 用戶的帳號註冊、變更密碼、設置頭貼等
• 輸入地點，系統會生成多個推薦的周邊旅遊景點，並包含照片及介紹
• 喜愛景點功能，用戶可儲存有興趣的旅遊景點

運行 (適用於windows)

前端

安裝套件

npm install

啟動

npm run dev

後端

安裝套件

pip install -r requirements.txt

啟動

python manage.py runserver

port預設為8000，若有更動需至frontend/.env.development修改URL路徑

後端資料庫

程式碼中已包含了測試資料庫，可直接進行存取

Superuser

- Account: admin
- Password: admin

初始化資料庫

移除舊資料庫及用戶頭貼

del db.sqlite3
rmdir /s /q media\avatars

重新建立資料庫

python manage.py migrate

設定Superuser

python manage.py createsuperuser

伺服器部署 (適用於linux)

本專案支援在docker進行部署，並以Nginx進行反向代理
前端預設port:8080
後端預設port:8000

docker compose up --build

也可自行設定連接埠

BACKEND_PORT={backend port} FRONTEND_PORT={frontend port} docker compose up --build

API KEY相關設定

由於後端串接了ChatGPT API及Bing Search/Google Search API，因此需自行至backend/config.py設置API KEY，也可在此處設定系統要使用Bing還是Google進行圖片搜尋

(Bing的圖片品質較佳但需付費，Google則每天皆有免費額度)

註冊/登入/登出說明

• 當登入時，系統會生成：一個 access token（30分鐘有效）、一個 refresh token（1天有效）
  • 30分鐘內使用同一個 access token
  • 1天內同個帳號不用重新登入，使用同一個 refresh token（沒登出的情況下一直處於登入狀態）
  • 1天後要重新登入取得新的 access, refresh token
• 在沒有登入的情況下沒辦法切換到 home page，會自動導向 login page