台灣大學轉系/雙主修/輔系資訊整合論壇

訪客可查閱雙轉輔門檻及歷年統計人數，登入者可於不同系所專區新增/回覆貼文以及分享雙轉輔成功資訊，包含修習課程、GPA、選填志願序，供大家參考。

Contributors & Tasks

林毓翔 Front-end using ReactJS
齊安浩 Front-end using ReactJS
黃子雍 Back-end using Django
廖偉霖 Back-end using Django

Database

下載 PostgreSQL 13 以及 pdAdmin (GUI介面)
./db/db.sql，包含所有table中的資料。
./db/webscraping 中 .ipynb 及 .py 檔為爬資料的程式檔，其中使用Seleinium及BeautifulSoup，其他則為爬到、整理過的資料檔，以.csv及.xls為主。
匯入資料
- 請先打開PosergreSQL Admin，在Databases創建名為DB_project的Database
- 接著請在創建好的DB_project 點擊右邊選擇restore。Format 請選擇Custom of tar，Filename請選擇我們資料夾中./db/db.sql，完成後請點選下方Restore。
- 匯入完成後，DB_project下的Schemas應該會有DB_projects和public，其中DB_projects 包含15張table，public包含10張table(僅有一張authuser會使用到)

API

討論文件：https://hackmd.io/ZJVemhdrQvygQuQjZEO_UA?view
API endpoint: http://127.0.0.1:8000/

Backend

確定電腦有安裝 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

接著下載所需套件，需要的套件與版本已定義在 requirements.txt，下載完輸入pip list檢查所有用 pip 下載的套件。

python -m pip install --upgrade pip #pip更新至最新版本
pip install -r requirements.txt
pip list

Package             Version
------------------- -------
dj-database-url     0.5.0
Django              3.2.6
django-cors-headers 3.8.0
djangorestframework 3.12.4
psycopg2-binary     2.9.1
python-decouple     3.4

安裝完套件後複製 .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/DB_project}

最後，同步資料庫並啟動 backend server。

python manage.py migrate
python manage.py runserver

用瀏覽器打開 http://127.0.0.1:8000/api/list ，如果有順利拿到資源表示後端起成功。

Frontend

Step 0. 安裝 yarn

如果你還沒有安裝 yarn，請參考官網 https://classic.yarnpkg.com/lang/en/docs/install/#mac-stable ，依照步驟安裝。

Step 1. 安裝 packages

第一次開啟專案請先用以下指令安裝所有需要的 packages，之後再次開啟專案跳過這個指令即可。

cd frontend
yarn (install)

Step 2. 開啟前端

cd frontend
yarn start

Step 3. 開啟瀏覽器

一般情況會自動開啟瀏覽器，若沒有請手動開啟 http://127.0.0.1:3000/ ，看到以下畫面即代表成功開啟前端且前後端連接成功。

jeffery12697/NTU-TMD_for_public