我政需要你：孤獨解決媒合平台(I Need U)

• Figma Frontend Design

Introduction

在剛開學進入新的環境時，你是否會感到不安或是沒有人陪伴？
為了解決政大學生的孤單情況，我們建立了這個孤單解決媒合平台。
在這個平台上，無論是想揪團吃飯或是找人一起買一送一，又或者只是想找人聊聊天，都可以滿足你的需求～
我們有提供以下幾種服務：

1. 論壇活動發起
2. 提供醫療文章
3. 醫療診所地圖
4. 會員註冊／登入
5. Line Bot

Here we just provide the code of backend. If you want to try frontend, you can meet this github website.

Init Backend

User Stories

• Google Sheet：I need U Backend

Clone & Set Up

1. docker-compose.yml

services:
  backend:
    ...
    volumes:
      - [這邊要放自己的local路徑]/I_need_you_backend/my-app:/data
    ...

2. database.env

ACCOUNT=自己設一個帳號
PASSWORD=自己設一個密碼
ADDRESS=Docker上的IP位址:3306
DATABASE=ineedu

不知道Docker的IP位址可以用下面的語法來查詢：

1. MAC : docker inspect [Container ID] | grep IPAddress
2. Windows : docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' [Container ID]

• DB Container ID：打開Docker Dashboard後，在DB的Name下面有一串可以copy的數字+字串

Start Up

Step.1 - start up DB

docker compose up db -d

DB啟動後，開啟MySQL workbench連線： Host Name: 127.0.0.1 Port: 3307 進去後就可以看到一開始init的DB了。

Step.2 - start up Backend

• 先把main.py裡的這段程式碼取消註解(用來自動建DB的，db_model內有寫各個table的schema)

• 接下來在cmd執行這行指令就可以了～

docker compose up backend

• 只要有看到下面這樣就算start up成功！

i_need_you_backend-backend-1  | INFO:     Application startup complete.

然後就可以在搜尋引擎輸入127.0.0.1:5102/docs#/就可以看到FastAPI的Swagger UI介面了。

• 成功後要記得把上面的程式碼再註解起來唷！不然DB會一直drop create，原本丟進去的資料會不見！

Backend Structure

Routers

• 這層是依照網頁主題分類去區分py檔案，這次專案一共分成member、post、weather、medical這四個主題。
• 最接近前端的，在routers裡寫的都可以在Swagger UI上看到。

Services

Business.py

• 主要在做處理DB撈出來後的資料，例如：計算某個會員的累積消費金額。
• 同時也需要寫一些validation，例如：member name是string，但前端傳來int，這時就需要回傳error。

crud.py

• 從DB撈資料出來
• 用python的SQLAlchemy來寫

schema.py

• 定義從前端要傳過來哪些資料，以及定義這些資料的型態。(與google sheet的input欄位相同)

Utils

• 這層是DB的一些設定，平常不太會動到。

可再進一步開發的項目

• Line Bot做完整一些
• 串金流
• 將平台目標再規劃的更明確