# 課程評分App Spec


## 時程：
* 4/20：期中報告
* 6/??：期末展示報告

## 使用 Data

* 課程檢索系統的爬蟲
* 線上教學資源

## 後端

## 功能
### 評分
給予星級，綜合評分
1. 給分甜度
2. 課程難易度
3. 私心推薦程度
4. 學得到東西？
5. 好選課程度

### 心得分享
1. 斷詞分析
2. 課程建議

### 筆記分享
1. 拍照功能（若有問題，就放棄）
2. 可上傳文件拍照
3. 課程詳細頁面可以看到別人的筆記分享

### 帳號管理
1. 考慮使用NID登入
2. 可以選擇完全匿名課程評分

### 我的最愛
1. 可把課程加入到我的最愛列表
2. 篩選、搜尋功能
3. 額外：可以建立多個列表

### 討論版
1. 可以發文
2. 可按讚、留言

### 搜尋
1. Filter （參照課程檢索系統）

## 為什麼想要做這個APP?
1. 讓課程資訊更透明化
2. 讓學生在修課之前能知道更詳細的內容，以免學生選到不想上的課程，影響權益
3. 老師可以獲得學生的心得回覆，可作為改良課程的參考
4. 有個專屬於課程的分享平台（在Dcard上什麼都有，很雜亂）

## 傳遞什麼樣的內容/服務
1. 學期中可以藉由平台分享上課資訊
2. 課程詳細內容與評價
3. 嚴格過濾評論(?)

## 鎖定的客群是誰
1. 想要更了解詳細課程內容的學生
2. 逢甲教授，欲暸解課程的心得回覆評價的老師
3. 欲共享學習資源的學生

## 他們有什麼需求
### 老師
1. 需要知道學生對於課程的評價以及建議
### 學生:
1. 選課前需要更詳細了解課程狀況，只有課程大綱可能不太夠
2. 可以在課程上面給予老師課程建議
3. 需要課程的筆記
4. 可能上課沒有聽到，需要有上過課的人幫忙
5. 關於課程的各種疑難雜症需要被解答

## 與其他類似APP的差異
1. Dcard : 課程評價不夠客觀，會有情緒性的字眼出現

## 將使用那些開放資料
1. FCU 課程檢索系統爬蟲
2. NID 登入 API

## Use Case Diagram、（大家分工）

UI工具: Adobe XD

### 分工列表
1. 施冠彰：帳號管理、討論版
2. 丁泓哲：評分、心得分享
3. 宗淳一朗：搜尋、我的最愛
4. 陳聖樺：筆記分享

**新分工列表**
###
1. 宗淳一朗：課程檢索、我的最愛課程頁面
2. 施冠彰：首頁、設定、帳號管理、討論版
3. 丁泓哲：課程專屬頁面、評分分享頁面
#### 課程專屬頁面：目前評分以及留言、課程資料、筆記分享連結、討論版連結
5. 陳聖樺：收藏筆記頁面

## 開發進度表
1. 資料爬蟲
2. 資料清洗、重構
3. 定義資料庫結構、後端 API
4. 開發前端App、後端服務
5. 測試與部署

## 開發模式
1. 使用 Tello、Jira 來管理 Task
2. 透過 Gitlab 進行 Code 版本控制，每個 Repo 都有兩個 Branch：master、dev。每次有新的Task就建立新的開發branch，並且在完成時提出MR，由其他組員來 Review 並合併到 dev。並且在固定一段時間，全組員合力將Dev MR到 Master，維持Master一直處於可以穩定運作的狀態。
3. 每當 Master 有新版本時，在後端伺服器安裝pm2，除了可以實時管理伺服器狀態與Log，也有自動部署功能，可以在master有新的版本時，自動pull、build並部署到伺服器上

## 開發工作分配

### 施冠彰
1. 後端伺服器架設
2. 後端API開發
3. App 開發


### 丁泓哲

1. 後端API開發
2. App


### 宗淳一朗


### 陳聖樺