輸入起訖站以及出發日期與時間查詢適用高鐵車次與適用優惠
- 吳琦艾 Database schema design, data colleciton and process using postgreSQL
- 鄭亦辰 Back-end using Django
- 陳姵如 Front-end using ReactJS
- 下載 PostgreSQL 13 以及 pdAdmin (GUI介面)
- db 資料夾裡有四個 sql 檔案，名稱裡有 empty 的代表為空 table 無資料的備份檔，其他兩份是有資料的備份檔。
requests_tutorial.ipynb是生資料及抓資料的教學檔。de_init.ipynb示範如何把資料塞到 table 裡。
-
API endpoint: http://127.0.0.1:8000/api
-
三個接口
GET /stations
POST /timetable/search
POST /ticket/search
確定電腦有安裝 python3 以及完成上述資料匯入資料庫的指令後打開終端機執行以下指令：
# for mac
cd backend
python3 -m venv tutorial-env #建立虛擬環境 #-m: module-name
source tutorial-env/bin/activate #啟動虛擬環境 for mac# for windows
cd backend
python3 -m venv tutorial-env #建立虛擬環境 #-m: module-name
tutorial-env\Scripts\activate.bat #啟動虛擬環境 for windows成功的話，command prompt 前面應該會多出 (tutorial-env) 的字樣，代表已經進入這個虛擬環境。如果未來你想退出這個虛擬環境，可以輸入 deactivate。
接著下載所需套件，需要的套件與版本已定義在 requirements.txt，下載完輸入pip list檢查所有用 pip 下載的套件。
python -m pip install --upgrade pip #pip更新至最新版本
pip install -r requirements.txt
pip listPackage Version
------------------- -------
asgiref 3.4.1
dj-database-url 0.5.0
Django 3.2.6
django-cors-headers 3.8.0
djangorestframework 3.12.4
pip 21.3
psycopg2 2.9.1
python-decouple 3.4
pytz 2021.1
setuptools 47.1.0
sqlparse 0.4.1
安裝完套件後複製 .env.example 的內容到 .env。
.env裡存的是環境變數，裡面通常會放一些機密資訊（如SECRET_KEY、資料庫資訊等），這種檔案通常不會傳上版本控制系統（如 Github），但此為教學專案為了方便講解上傳，同學們實作專案時記得避免。
# for mac
cp .env.example .env# for windows
copy .env.example .env接著可以將 .env 當中的變數改成符合你電腦資料庫的值。
SECRET_KEY={aaaaaaaaa}
DEBUG=True
ALLOWED_HOSTS=.localhost,127.0.0.1
DATABASE_URL={postgres://USER:PASSWORD@HOST:PORT/NAME}最後，同步資料庫並啟動 backend server。
python manage.py migrate
python manage.py runserver用瀏覽器打開 http://127.0.0.1:8000/api/stations ，如果有順利拿到資源表示後端起成功。
如果你還沒有安裝 yarn，請參考官網 https://classic.yarnpkg.com/lang/en/docs/install/#mac-stable ，依照步驟安裝。
第一次開啟專案請先用以下指令安裝所有需要的 packages，之後再次開啟專案跳過這個指令即可。
cd frontend
yarncd frontend
yarn start一般情況會自動開啟瀏覽器，若沒有請手動開啟 http://127.0.0.1:3000/ ，看到以下畫面即代表成功開啟前端且前後端連接成功。
