# [芙瑞納] API & 後台介面

:::info
:bulb: 設計REST API，此功能用Node.js製作
:::

:::success
[UI連結](https://drive.google.com/drive/folders/1uWathJo14b_YutyTQ6LULxUNRRUPaVkN)
:::

1. ## 🤹🏻‍♂️會員登入
> POST 會員編號、密碼
>
> Response: token

### 🔓啟用 & 啟用失敗 & 啟用成功
> POST 會員編號、身分證號碼、手機號碼、密碼

> Response: token、成功訊息 / 失敗訊息

mb_statue=2 的狀態不允許登入


### 🔓忘記密碼 & 忘記密碼-確認送出(認證碼)
> POST 會員編號、身分證號碼

> Response: 已發出驗證碼/發出失敗
>

2. ## 會員中心 (token)
##### 個人資料
> POST(token) 姓名、帳號、課程積分、徽章(一星講師、白金總裁)
#### 即將到來的課程 & 柱狀圖
> POST(token) 課程資訊(時間、title、主持人、講師)、柱狀圖(三月內、4-6月、7-12月 活躍人數)


### 課程點數
> POST(token)
> 會員編號、會員姓名、計算聘級、啟用日、累積點數、失效點數、兌換點數、有效點數
>、點數紀錄(課程日期、課程地點、課程名稱、類型、備註)(可能先取時間區間的前10筆，因為畫面呈現的關係，或是依照APP發出要幾筆？)


### 個人設定
> POST(token) 舊密碼、新密碼

> Response:成功修改

3. ## 活動課程
### 行事曆 & 行事曆展開
> GET?月份
>
> 活動Title、活動時間區間、主持人、講師(json檔)


### 課程活動-內容
> GET
>
> 活動Title、活動時間區間、主持人、講師、地點、課程說明(json檔)


4. ## 商品
### 商品訂貨-分類
> GET
>
> 分類列表


### 商品訂貨-列表
> GET?分類
>
> 各產品(縮圖、title、內容淨重)(一頁要傳多少)、產品總數、傳遞產品數量


### 商品訂貨-內容
> GET 產品title、售出數量、商品詳情(產品容量、產品成分、使用方法)、相關商品(title、內容淨重)


5. ## 購物結帳(token)
### 購買記錄-列表
> POST(token、時間區間)
>
> 購買記錄(訂單編號、訂購日期、寄送方式、訂貨地點、業績日期、商品總額)

### 購買記錄-內容
> POST(token、訂單編號)
>
> 各產品(title、金額數量、出貨日期、出貨單號、出貨狀態)、收件人、收件地址、備註、商品總金額、寄送方式、折價券、總付款金額


### 購物車
> POST(token)

> 各產品(Title、價格、數量)


### 購買記錄-結帳
> 10/30 加入分期付款選項

> 10/30 加入業績月份選擇


6. ## 組織表
### 組織圖-圖形(取得該會員上方的所有會員)
> POST(token)
>
> 樹狀資料(json格式、層級)、個人(會員編號、會員姓名、計算聘級)、各會員(會員編號、會員姓名、本月業績、整組業績、上月業績)
> maxg:個人最高聘級(近期最高聘級)、group_maxg: 組織最高聘級(近期最高聘級)、intro_num:推薦多少人、pg_yymm:入會年月

### 組織圖-圖形明細
> POST(token)

> 日期年月、當月聘級、保障聘級、保障期、當月實際聘級、個人業績、當月.....==這個細節還有什麼？==


### 組織圖-列表
> POST(token)

> 個人(會員編號、會員姓名、計算聘級)、各會員(會員編號、會員姓名、個人業績、計算聘級、最高聘級、入會日期、組織業績、實際聘級、整組最高聘級)

排列順序與客戶討論後不做不做

> 加入推薦多少人(推3 代表推薦3人)以及新入會的文字

> 日期年月、保障聘級、保障期、實際聘級、個人業績、合格數、整組業績
`grade_class 計算聘級(保障)
bgrade_class 當月聘級(實際)
per_m_now 當月個人業績
per_m_last 上個月個人業績
org_money 當月組織業績
intro_num 該月推薦人數(假設推薦 3人，寫"推3")
pg_yymm 入會年月 (入會日期改成年月即可，如果是當月入會，寫一個"新入會")
maxg 最高聘級
group_maxg 整組最高業績`


### 組織圖-列表明細

> 新增：當月直推人數、當月訂購人數、當月新增人數、整組人數、當月稅前獎金

> 對his_moneypv2 的mb_no做索引 、 對his_moneypv2 yymm & orgseq_no1做索引,對true_intro_no 做索引


7. ## 獎金表
### 獎金表

8. ## 推播

# 後台需求
:::info
:bulb: 會員管理 | 商品管理 | 訂單系統管理 | 推播系統管理
:::

==待作==
- ~~找Vue Template，會員~~、商品、訂單管理系統、推播系統
#### 後台：
- 商品管理：只有新增(刪除？)，在輸入商品名稱時與資料庫確認是否有這個商品、列出
- 訂單管理系統：只可以看訂單(撈database資料)
- 會員登入：只有管理員可以登入後台
- 推播系統
#### Vue Dashboard(已買)
- Vue Dashboard & e-commerce(Vue3, Composition)
[連結](https://themeforest.net/item/hexadash-svelte-multipurpose-admin-dashboard-template/42355059)

- Vue3, options api
[連結](https://themeforest.net/item/viho-bootstrap-5-admin-dashboard-template/33351203)
---

# APP
> 商品：應該會以woocommerce的app來做，我在依照需要的API來提供，應該會需要參考原始的API
## 📖: 首頁
### Banner+三個營養組合
> 多張圖、輪播時間、營養組合縮圖
### 推薦商品
> 產品縮圖
### All
### 熱門關鍵字

#### 訂單紀錄
#### 課程點數

## 🗾組織圖
### 圖形組織圖
> 樹狀資料、會員編號、會員姓名、本月業績、整組業績、上月業績
### 列表組織圖(非樹狀要怎麼顯示？)
> ==顯示方式為何，這樣才知道怎麼拿資料==
### 組織圖-明細
> 日期年月、當月聘級、保障聘級、保障期、當月實際聘級、個人業績、當月.....==這個細節還有什麼？==
### 獎金表總表
> 獎金期別、本期獎金、營業稅、應扣稅額、補充保費、實撥獎金
#### 獎金表
> 推薦獎金、發展獎金、重銷分紅、組織獎金、差額獎金、總監同階、總裁培育、推薦加碼、加碼獎金、合計PV、獎金調整、獎金、稅額、營業稅、補充保費、溢撥追回、實撥獎金
---
>推薦獎金：代數、會員編號、明細、小記、備註

==似乎還有發展獎金、組織獎金、差額獎金==

### 課程點數

### 課程活動-列表
>縣市：時間、課程名稱、主持人、講師
#### 課程活動-內容
> 課程說明
### 購買記錄
>時間區間的前面10筆(包含內容)、
>訂單編號、訂購日期、寄送方式、訂貨地點、業績日期、商品總額(金額/PV)
>所有產品、產品名稱、縮圖、金額/PV、數量、
>收件人、收件地址、備註、折價券、總付款金額
### 商品訂貨-分類
>分類名稱、縮圖、Banner圖
### 商品訂貨-列表
### 商品訂貨-產品內容
> 產品詳情(依照產品類型有所不同)

? ### 購物車
### 推播通知-內容
### 推播通知列表
>日期、通知訊息標題

### 列表
> GET
>
> 活動Title、活動時間區間、主持人、講師(json檔)(筆數？ 依照螢幕大小or固定數量？ 畫面滑動時要怎麼動態取得更多)