## 異動範圍

倉儲作業->**誠衣**驗貨作業、廠退->`进货厂退作业 - 扣款`

## 需求目標

1. 調整驗貨單拋轉權限
2. 新增採購回評機制
3. 預扣瑕疵明細庫存
4. 自動開立廠退單

## 需求規劃

1. 將驗貨單拋轉權限更改為

| 狀態 | 下拋權限擁有者 |
| ------ | ------ |
| 完成驗貨 | 採購 |
| 採購已確認 | 物流 |
| 驗貨單歸檔 | - |

2. 移除驗貨單可直接轉至`驗貨單歸檔`的規則（限驗貨類型＝`其他抽驗`）

圖一：拋轉流程

- 紅字部分為此次異動範圍


3. 驗貨單至`完成驗貨`時，需設定一機制將瑕疵明細扣除庫存

4. 採購自`完成驗貨`至`採購已確認`時，新增採購回評Dialog

- Dialog出現條件：限欲下拋驗貨單，瑕疵總件數>0


5. 呈上，回評存檔後，開立扣款廠退單（限：需執行扣款廠退的明細）
- 回評內容非扣款廠退的明細，釋放庫存

- 廠退單開立規則，可見：工作表-[廠退單明細資訊](https://docs.google.com/spreadsheets/d/1yR1_TO7W41nK47jPSPvmlkeTogW_Ziyhw7vxbLDTfQM/edit?usp=sharing)

6. 在`採購已確認`、`驗貨單歸檔`狀態，在驗貨單明細顯示採購回評紀錄（格式可參考下圖）
- 僅供檢視


詳細UI可視[明細（2022/12/06更新）](https://drive.google.com/file/d/1RqL9vzhGMg2blEiNhwFNeSIkitCNwutF/view?usp=sharing)

## 調整原因

1. 預扣瑕疵明細中的庫存：在採購回評瑕疵處理方式前，需要先將件數預扣，以避免系統將不可賣的瑕疵件數納入可賣庫存，造成超賣

2. 自動開立廠退單：採購需根據現場驗到的瑕疵明細，決定是否需開立廠退單。

目前機制：採購填寫mail回評哪些瑕疵明細需開立廠退單（下圖）


## 其他相關資訊

[驗貨ERP UI](https://drive.google.com/file/d/1RqL9vzhGMg2blEiNhwFNeSIkitCNwutF/view?usp=sharing)

[诚衣_NO.376_377验货_厂退同步化_.xlsx](/uploads/877e6b3f216c52d495ff7ca2e3affc4f/诚衣_NO.376_377验货_厂退同步化_.xlsx)


-----

## 需求測試

### 測試情境 1

誠衣驗貨功能APP點選完成驗貨、ERP誠衣驗貨功能從驗貨進行中拋轉至完成驗貨

使用者權限：

- 验货管理者 roles/wh_inflow.inspections.manager

平台：ERP、APP

路徑：倉儲作業/誠衣驗貨作業、APP驗貨

### 測試案例

1. 完成驗貨，驗證官網庫存扣庫
- [x] 新增`进货抽验` 驗貨單，採購單號：62011012209
- [x] APP 開始驗貨，SkuId:620110110，新增瑕疵 5 件，重整上架 1 件
- [x] APP 完成驗貨，驗證原先官網庫存 10 件，完成驗貨後剩 6 件
- [x] 驗證狀態轉到`完成驗貨`
> SkuID:620110110
> 官網庫存數量:10 -> 6 (公式：10-(5-1) = 6)
> 淘寶庫存數量:10
> 瑕疵數量:5
> 重整上架數量:1
> 可至倉儲作業->倉儲->庫存查詢 確認數值是否正確扣除
2. 完成驗貨，驗證官網庫存不足，續扣淘寶庫存
- [x] 接續使用上一筆驗貨單，ERP點選加驗，新增一筆驗貨批次，[顏色][尺碼]8件
- [x] APP 開始驗貨，SkuId:620110110，新增瑕疵 8 件，重整上架 1 件
- [x] APP 完成驗貨，驗證原先官網庫存 6 件、淘寶庫存 10 件，完成驗貨後官網庫存剩 0 件、淘寶庫存剩 9 件
- [x] 狀態轉到`完成驗貨`
> SkuID:620110110
> 官網庫存數量:6 -> 0 (公式：6-(8-1) = -1 多出來的續扣至淘寶)
> 淘寶庫存數量:10 -> 9 (公式：10-1 = 9)
> 瑕疵數量:7
> 重整上架數量:1
> 可至倉儲作業->倉儲->庫存查詢 確認數值是否正確扣除
3. 完成驗貨，驗證官網、淘寶庫存皆不足，不執行扣庫
- [x] 接續使用上一筆驗貨單，ERP點選加驗，新增一筆驗貨批次，[顏色][尺碼]10件
- [x] APP 開始驗貨，SkuId:620110110，新增瑕疵 10 件，重整上架 0 件
- [x] APP 完成驗貨，驗證原先官網庫存 0 件、淘寶庫存 9 件，總庫存不足，不執行扣庫
- [x] 驗證狀態轉到`完成驗貨`
> SkuID:620110110
> 官網庫存數量:0
> 淘寶庫存數量:9 不扣(9 < 10)
> 瑕疵數量:10
> 重整上架數量:0
> 可至倉儲作業->倉儲->庫存查詢 確認數值是否正確扣除
4. 完成驗貨，驗證官網、淘寶庫存皆不足，不執行扣庫
- [ ] 新增`其他抽验` 驗貨單，款號：62011，[顏色][尺碼]30件
- [ ] APP 開始驗貨，SkuId:620110110，新增瑕疵 30 件，重整上架 0 件
- [ ] APP 完成驗貨，驗證原先官網庫存 10 件、淘寶庫存 9 件，總庫存不足，不執行扣庫
- [ ] 驗證狀態轉到`完成驗貨`
> SkuID:620110110
> 官網庫存數量:10 不扣(10+9 < 30)
> 淘寶庫存數量:9 不扣(10+9 < 30)
> 瑕疵數量:30
> 重整上架數量:0
> 可至倉儲作業->倉儲->庫存查詢 確認數值是否正確扣除

## 測試情境2

誠衣驗貨狀態(驗貨主管)拋轉權限測試

> 因原本的驗貨主管權限，將採購主管拆出來，需再次測試確保功能正常

使用者權限：

- 验货管理者 roles/wh_inflow.inspections.manager

平台：ERP

路徑：倉儲作業/誠衣驗貨作業

### 測試案例

1. 拋轉`驗貨進行中` 轉 `完成驗貨`
- [x] 勾選任意一筆或多筆驗貨單，出現 `完成驗貨` 按鈕
- [x] 點擊 `完成驗貨` 按鈕，驗證可正常拋轉
2. 拋轉 `完成驗貨` 轉 `採購已確認`
- [ ] 勾選任意一筆`最新驗貨批次有填處理結果`的驗貨單，不能出現`驗貨已確認` 按鈕
- [x] 驗證無權限拋轉
3. 拋轉 `採購已確認` 轉 `驗貨單歸檔`
- [x] 勾選任意一筆或多筆驗貨單，出現 `驗貨單歸檔` 按鈕
- [x] 點擊`驗貨單歸檔` 按鈕，驗證可成功拋轉

## 測試情境3

誠衣驗貨狀態(採購)拋轉權限測試

使用者權限：

- 驗貨採購主管人員 roles/wh_inflow.inspections.purchaser.manager
- 採購人員 roles/plans.purchaser

平台：ERP

路徑：倉儲作業/誠衣驗貨作業

### 測試案例

1. 拋轉`驗貨進行中` 轉 `完成驗貨`
- [ ] 勾選任意一筆或多筆驗貨單，不可出現 `完成驗貨` 按鈕
- [x] 驗證無權限拋轉
2. 拋轉 `完成驗貨` 轉 `採購已確認`
- [ ] 勾選任意一筆或多筆驗貨單，出現 `採購已確認` 按鈕，且不能出現`驗貨已確認` 按鈕
- [x] 點擊 `採購已確認` 按鈕，驗證可正常拋轉（有未填回評的瑕疵，須填完回評後驗證狀態拋轉，回評測試請參考測試情境5)
3. 拋轉 `採購已確認` 轉 `驗貨單歸檔`
- [ ] 勾選任意一筆或多筆驗貨單，不可出現 `驗貨單歸檔` 按鈕
- [x] 驗證無權限拋轉

### 測試情境 4

誠衣驗貨作業，測試 `重新驗貨(是否被移除)`、`不驗貨歸檔(是否被移除)`、`回拋回驗貨進行中(是否被移除)`、`加驗`、`刪除` 功能

原本流程圖

更改後流程圖


> `刪除` 功能沒有異動，但因其他功能的調整，需再次測試確保功能正常

- 使用者： 物流人員、採購人員
- 使用者權限：
- roles/wh_inflow.inspections.manager
- roles/wh_inflow.inspections.purchaser.manager
- roles/plans.purchaser
- 平台：ERP
- 路徑：倉儲作業/誠衣驗貨管理

#### 測試案例

1. 移除 `重新驗貨` 功能
- [x] 在 `採購已確認` 狀態，勾選 `最新驗貨批次驗貨數量為0` 的驗貨單，不可出現 `重新驗貨` 按鈕
- [x] 在 `驗貨單歸檔` 狀態，勾選 `只有一個驗貨批次且驗貨數量為0` 的驗貨單，不可出現 `重新驗貨` 按鈕

2. 移除 `不驗貨歸檔` 功能
- [x] 在 `新驗貨單` 狀態底下，勾選類別為 `進貨抽驗`，`驗貨批次 > 1 且 最新驗貨批次有填處裡結果`的驗貨單，不可出現 `不驗貨歸檔` 按鈕
- [x] 在 `新驗貨單` 狀態底下，勾選類別為 `其他抽驗`，`驗貨批次 > 1 且 最新驗貨批次有填處裡結果`的驗貨單，不可出現 `不驗貨歸檔` 按鈕
- [ ] 接續上兩點條件，還需驗證其 `驗貨明細`，左下角也不可出現 `不驗貨歸檔` 按鈕

3. 移除 `回拋回驗貨進行中` 功能
- [x] 在 `完成驗貨` 狀態，勾選任一筆或多筆驗貨單，不可出現 `驗貨進行中` 按鈕
4. 驗證 `加驗` 功能
- [ ] 驗證以下動作採購人員可以執行，物流人員不能執行
- [x] 在 `完成驗貨`、`採購已確認` 狀態，任一勾選多張驗貨單，不可出現 `加驗` 按鈕
- [x] 在 `完成驗貨`、`採購已確認` 狀態，任一勾選一張驗貨單，需要出現 `加驗` 按鈕
- [x] 接續上點，點擊 `加驗` 按鈕，跳出 `加驗視窗` 編輯完後存檔，驗貨單狀態需轉回 `新驗貨單` 且新增一筆驗貨批次
> **完成驗貨** 狀態底下的**加驗功能**沒有異動，但因其他功能的調整，需再次測試確保功能正常。

> **採購已確認** 狀態底下的**加驗功能**，移除了 **驗貨數量>0** 才能加驗的條件，變成任一筆驗貨單都可加驗。

5. 驗證 `刪除` 功能
- [x] 在 `新驗貨單` 狀態，勾選 `抽驗次數為1、已驗貨數量為0 且 沒有取貨紀錄(完全還沒開始驗)`的驗貨單，出現 `刪除` 按鈕
- [x] 點擊 `刪除` 按鈕，此驗貨單從列表消失
- [x] 在 `新驗貨單` 狀態，找到 `驗貨單批次>1`的驗貨單，進入 `驗貨明細`，左下出現 `刪除驗貨` 按鈕
- [x] 狀態轉回完成驗貨
- [x] 點擊 `刪除驗貨` 按鈕，驗證刪除此`驗貨批次`


## 測試情境5

`完成驗貨` 轉 `採購已確認`

使用者： 採購人員

權限：
* roles/wh_inflow.inspections.purchaser.manager
* roles/plans.purchaser

平台：erp

路徑：倉儲作業/誠衣驗貨管理

### 測試案例

1. 採購將`完成驗貨` 轉 `採購已確認`，驗證需填寫`採購回評`情境
- [ ] 在被勾選要轉狀態的驗貨單，驗貨單底下的**任一驗貨批次，有瑕疵且未填回評**，需要跳出回評視窗
> 是否要填回評規則，參考：驗貨單>驗貨明細
> 案例一【有瑕疵且未填回評，要填回評】：
> 1. 瑕疵明細:
> * 瑕疵件數：布料其他/顏色：01-顏色02-S，共10件
> * 重整上架:0件
> * (有瑕疵，公式: (10-0)>0)
> 3. 採購回評: 01-顏色02-S，口款廠退:0/允收:0/到付寄回工廠:0(未填回評: 10-(0+0+0)>0)
> 

> 案例二【有瑕疵且有填回評，不需填回評】：
> 1. 瑕疵明細:
> * 瑕疵件數：布料其他/顏色：01-顏色02-S，共10件
> * 重整上架:0件
> * (有瑕疵，公式: (10-0)>0)
> 2. 採購回評: 01-顏色02-S，口款廠退:5/允收:3/到付寄回工廠:2(有填回評: 10-(5+3+2)=0)
> 

> 案例三【沒有瑕疵且未填回評，不需填回評】：
> 1. 瑕疵明細:
> * 瑕疵件數：布料其他/顏色：01-顏色02-S，共10件
> * 重整上架:10件
> * (沒有瑕疵，公式: (10-10)=0)
> 2. 採購回評: 01-顏色02-S，口款廠退:0/允收:0/到付寄回工廠:0(未填回評: 10-(0+0+0)>0)
> 
- [ ] 勾選一筆或多筆**不需要回評的驗貨單**，出現`採購已確認` 按鈕
- [ ] 點擊`採購已確認`按鈕，驗證狀態拋轉到`採購已確認`
- [x] 勾選10筆以上，**需要回評的驗貨單**，驗證`採購已確認` 按鈕消失，無法拋轉
> 採購回評要填寫的內容較多，所以有限制一次最多勾選10筆 **需要回評的驗貨單**，
> 另外**不需填回評的驗貨單**，數量是沒有上限的。
- [x] 勾選一筆或多筆**需要回評的驗貨單**，點擊`採購已確認` 按鈕，需彈出回評視窗

2. 編輯採購回評視窗


- [x] ① 驗證標題顯示: `{款號} {商品名稱}`(ex.`54007 男衬衫-男`)
- [x] ② 驗證 tab 標題：`驗貨{批次號} /n {驗貨日期}`(ex.`验货5 /n 2022-12-05`)，註：/n 表示換行
- [ ] 驗證 ① ② ⑩ 內容，對照每張驗貨單的 `驗貨明細`，只顯示沒有填寫 `採購回評`的`驗貨批次` 下的所有 `瑕疵明細`。
> ① 驗貨單的顯示規則：此驗貨單底下的任一驗貨批次，有瑕疵且未填回評(可參考測試案例1)
> ② 驗貨批次的顯示規則：此驗貨批次，滿足有瑕疵且未填回評(可參考測試案例1)
> ⑩ 瑕疵明細顯示規則：
> * 標題顯示： `{瑕疵原因}Ｘ{瑕疵數量-已上架數量} {顏色}-{尺寸}`
> * 若此`瑕疵數量`扣除`已重整上架數量`等於零，回評將不顯示此瑕疵。
>
> 

- [x] ③ 點擊＋，新增一行執行動作，驗證新增後其他原有資料不變
- [x] ④ 點擊垃圾桶，刪除此行執行動作，驗證刪除後其他原有資料不變
- [x] ⑤ `執行動作` 欄位，驗證下拉選單有 `扣款廠退`、`允收`、`到付寄回工廠` 選項
- [x] ⑤ `執行動作` 欄位，為空時，需顯示紅框
- [x] ⑥ `件數` 欄位，驗證只能填入數字，填入數字以外的會被清空
- [x] ⑥ `件數` 欄位，驗證數字不能為0或空，為0或空顯示紅框
- [x] ⑥ 同一瑕疵區塊`件數` 欄位加總數量，要跟瑕疵件數一樣，不一樣顯示紅框
- [ ] ① 點擊`<` 、`>` 切換驗貨單或 ② 切換驗貨批次 tab，驗證手動填入的資料不變
- [ ] ① 點擊`<` 、`>` 切換驗貨單或 ② 切換驗貨批次 tab，驗證根據不同的`驗貨單`、`驗貨批次` 瑕疵內容改變
- [ ] ⑦ `採購回評留言`，每個驗貨批次底下都要有`採購回評留言`區塊
- [ ] ⑦ `採購回評留言`，驗證繁體檢查
- [ ] ⑧ 點擊`存檔`，檢查所有瑕疵都有對應的執行動作
- [ ] 若有驗貨單沒有填寫完成，跳出提醒訊息`以下验货单，回评未填写完成：{款號} {商品名稱}/n {款號} {商品名稱}...`(ex.`以下验货单，回评未填写完成：5022 Pima棉`)
- [ ] 若有驗貨單沒有填寫完成，在關閉提醒訊息後，切換第一筆沒有完成的`驗貨單的驗貨批次`
- [ ] 若成功存檔，狀態轉到 `採購已確認`(接續開立廠退單，請看測試情境6)
- [ ] ⑨ 點擊`關閉`，關閉視窗，且不做任何事

## 測試情境6

`完成驗貨` 轉 `採購已確認`釋放庫存並產出廠退單

使用者權限：

- 驗貨採購主管人員 roles/wh_inflow.inspections.purchaser.manager
- 採購人員 roles/plans.purchaser

平台：ERP

路徑：倉儲作業/誠衣驗貨管理

### 測試案例

1. 完成驗貨，驗證官網庫存扣庫
- [x] 新增`进货抽验` 驗貨單，採購單號：62011012209
- [x] APP 開始驗貨，SkuId:620110110，新增瑕疵 5 件，重整上架 1 件
- [x] APP 完成驗貨，驗證原先官網庫存 10 件，完成驗貨後剩 6 件
- [x] 驗證狀態轉到`完成驗貨`
> SkuID:620110110
> 官網庫存數量:10 -> 6 (公式：10-(5-1) = 6)
> 淘寶庫存數量:10
> 瑕疵數量:5
> 重整上架數量:1
> 可至倉儲作業->倉儲->庫存查詢 確認數值是否正確扣除
2. 完成驗貨，驗證官網庫存不足，續扣淘寶庫存
- [x] 接續使用上一筆驗貨單，ERP點選加驗，新增一筆驗貨批次，[顏色][尺碼]8件
- [x] APP 開始驗貨，SkuId:620110110，新增瑕疵 8 件，重整上架 1 件
- [x] APP 完成驗貨，驗證原先官網庫存 6 件、淘寶庫存 10 件，完成驗貨後官網庫存剩 0 件、淘寶庫存剩 9 件
- [x] 狀態轉到`完成驗貨`
> SkuID:620110110
> 官網庫存數量:6 -> 0 (公式：6-(8-1) = -1 多出來的續扣至淘寶)
> 淘寶庫存數量:10 -> 9 (公式：10-1 = 9)
> 瑕疵數量:7
> 重整上架數量:1
> 可至倉儲作業->倉儲->庫存查詢 確認數值是否正確扣除
3. 完成驗貨，驗證官網、淘寶庫存皆不足，不執行扣庫
- [x] 接續使用上一筆驗貨單，ERP點選加驗，新增一筆驗貨批次，[顏色][尺碼]10件
- [x] APP 開始驗貨，SkuId:620110110，新增瑕疵 10 件，重整上架 0 件
- [x] APP 完成驗貨，驗證原先官網庫存 0 件、淘寶庫存 9 件，總庫存不足，不執行扣庫
- [x] 驗證狀態轉到`完成驗貨`
> SkuID:620110110
> 官網庫存數量:0
> 淘寶庫存數量:9 不扣(9 < 10)
> 瑕疵數量:10
> 重整上架數量:0
> 可至倉儲作業->倉儲->庫存查詢 確認數值是否正確扣除
4. 完成驗貨，驗證官網、淘寶庫存皆不足，不執行扣庫
- [ ] 新增`其他抽验` 驗貨單，款號：62011，[顏色][尺碼]30件
- [ ] APP 開始驗貨，SkuId:620110110，新增瑕疵 30 件，重整上架 0 件
- [ ] APP 完成驗貨，驗證原先官網庫存 10 件、淘寶庫存 9 件，總庫存不足，不執行扣庫
- [ ] 驗證狀態轉到`完成驗貨`
> SkuID:620110110
> 官網庫存數量:10 不扣(10+9 < 30)
> 淘寶庫存數量:9 不扣(10+9 < 30)
> 瑕疵數量:30
> 重整上架數量:0
> 可至倉儲作業->倉儲->庫存查詢 確認數值是否正確扣除

## 測試情境9

回評明細顯示

使用者權限：
- 驗貨主管 roles/wh_inflow.inspections.manager
- 驗貨採購主管人員 roles/wh_inflow.inspections.purchaser.manager
- 採購人員 roles/plans.purchaser

平台：ERP

路徑：倉儲作業/誠衣驗貨管理

### 測試案例

### 瑕疵回報

## 測試情境10

米格驗貨狀態轉換測試

> 米格驗貨狀態轉換沒有異動，但因實作跟誠衣驗貨寫在一起，需再次測試確保功能正常

使用者權限：
- 驗貨主管 roles/wh_inflow.inspections.manager
- 採購人員 roles/plans.purchaser

平台：ERP

路徑：倉儲作業/米格驗貨管理

### 測試案例

1. 米格狀態轉換圖
- [ ] 依照上圖驗證，所有狀態轉換功能正常

## 測試情境11

驗貨列表顯示

使用者權限：
- 驗貨主管 roles/wh_inflow.inspections.manager
- 驗貨採購主管人員 roles/wh_inflow.inspections.purchaser.manager
- 採購人員 roles/plans.purchaser

平台：ERP

路徑：倉儲作業/米格驗貨管理

### 測試案例

1. 擁有驗貨主管或驗貨採購主管人員
- [ ] 可看到所有驗貨單與驗貨批次
2. 只擁有採購人員權限
- [x] 只可看到自己的款號的驗貨單

### 瑕疵回報