---
tags: backend, meeting
---
# 2022/10/29 會議記錄
## 成員
- [name=yaya]
- [name=brian]
- [name=andy]
- [name=nick]
## 紀錄草稿
story: 登入、看到請假紀錄

閱讀資料 (去讀文件
1. 寫一個function 取代Database
2. 會議共筆
3. 跟前端討論(後端的)API格式
4. 建API document
5. 每個人(本機)都要有開發環境規格
6. 生成測試資料(假資料)
7. 建一個 repository
(8.)如有餘力可套用DB(有template模板可以用
(9.)登入資料寫入DB

測試資料：
1. 隨機資料
2. 登入的隨機資料、紀錄的隨機資料

API包含：
0. API本身的資料傳送格式 (API規格
1. 登入API
2. 紀錄取得API


## 結論
### 要做的事
- (1hr) 建立會議共筆
- 確定使用HackMD
- 每週只要有會議就要打（會議中的紀錄和結論）
- (2hr) 開API規格
- [x] **10/29(一)21:00內部討論API**
- [x] **10/31(一)16:00與前端共會**
- (3hr) 建立本機環境
- 有問題就拋出
- 每個人都要做
- (1hr) 建 repository
- [x] DayOff-Backend
- **10/31 當日**
- [x] 閱讀，統合群組資料

- [x] 閱讀，統合template資料
#### API
- (4hr) 判斷登入(模擬校務系統)
-
- (3hr) 判斷登入(給前端串接的)
- return error message, 成/敗
- call 判斷登入(模擬校務系統)
- (5hr) 產生隨機資料function(請假紀錄)
- (1hr) 讀請假紀錄(API、給前端串接的)
##### 未來有空做
- (3hr) 登入紀錄寫入DB

## API 規格

GET www.example.com/api/login

:::spoiler 判斷登入(模擬校務系統)

### 呼叫

   POST  /dev/v1/login/

#### Parameters
- username
- password
### 回傳

# school api

:::

:::spoiler 判斷登入(給前端串接的)
### 呼叫

POST    /v1/login/

#### Parameters
- username
- password
### 回傳
- Status code 200

{
    "code": 0, 
    "msg": "succeed", 
    "data": [
      { 
        "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJfaWQiOiI1ZDRlOGQ5YTA2MWMxYTJjMDIxY2JlMTgiLCJpYXQiOjE1NjU4NTczMjAsImV4cCI6MTU2NTk0MzcyMH0.GQVyQJLmwXd2jQZsjZ8n6cAWD0HQGjvlp2Mk8kAsGy8", 
        "userNmae": "金宣妘", 
        "studentId": "U10816014", 
        "errorMessage":""
      }
    ] 
}

- Status code 401

{
  "code": 2,
  "msg": "帳號或密碼錯誤，請重新輸入",
  "data": [
    {
        "token": "",
        "userNmae": "", 
        "studentId": "",
    }
  ]
}
{
  "code": 6,
  "msg": "帳號或密碼為空，請重新輸入",
  "data": [
    {
        "token": "",
        "userNmae": "", 
        "studentId": "",
    }
  ]
}

- Status code 403

{
  "code": 3,
  "msg": "Suspended account",
  "data": [
    {
        "token": "",
        "userNmae": "", 
        "studentId": "", 
    }
  ]
}

- Status code 504

{
  "code": 4,
  "msg": "Timeout",
  "data": [
    {
        "token": "",
        "userNmae": "", 
        "studentId": "", 
    }
  ]
}

- Status code 500

{
  "code": 5,
  "msg": "Other",
  "data": [
    {
        "token": "",
        "userNmae": "", 
        "studentId": "", 
    }
  ]
}

#### msg and error message
msg: SUCCESS、...
status code: 401
-帳號或密碼不得為空，請重新輸入
-帳號或密碼錯誤，請再試一次

:::

:::spoiler 產生隨機請假紀錄資料(模擬校務系統)

### 呼叫

GET /dev/v1/record/

#### Parameters
- token
### 回傳

#

#### state
pending 未審理
approved 已批准
rejected 已拒絕
:::

:::spoiler 讀請假紀錄(API、給前端串接的)

### 呼叫

GET /v1/record/

#### Parameters
- token
### 回傳

{
   "code":0,
   "msg":"Success",
   "data":{
      "totalPageNumber":3,
      "currentPageNumber":1,
      "recordData":[
         {
            "uuid":"3c4ea096-e04f-40f1-8911-6846f1084979",
            "name":"小明",
            "code":"1234",
            "date":"2022/10/18",
            "weekday":"四",
            "sessions":[
               5,
               6,
               7
            ],
            "teacher":"大衛",
            "leaveType":"病假",
            "status":"approved",
            "sendTime":"2022/10/17 12:30"
         }
      ]
   }
}

currentPageNumber - start with 1

:::