# PMSPEC_SAMPLE

:::warning
因專案內容涉及公司機密資訊，僅節錄部分內容作為產品規格文件撰寫方式參考。
:::

[TOC]

## 版本
- 版本v0.1
- 更新時間：2026/05/17 11:00
- 更新說明：買斷入庫總表初版

## 1. 總表

### 頁面示意圖


### 左側選單
- 採購作業管理
- 買斷商品管理
- 請購資料管理
- 進倉資料管理
- 買斷入庫總表 ==(此次新增)==

### 功能權限

:::info
:mega: ==\[Demo 簡化\]== 以下為工程開發規格，供參考，Demo 無需實作。
:::

- 採購作業管理-買斷入庫總表
- 查詢：
- 顯示左側選單。
- 可查詢所有資料。
- 若無權限時，進入功能頁面，跳轉總覽，顯示：您沒有權限!
- 維護編輯：
- 需要「查詢」項目開啟，才可開啟此權限項目。
- 可新增、編輯所有資料。

### 分頁
- 預設每100筆分頁。

### 排序
- 預設排序
- 1. 入庫倉別：先"統昶鶯歌倉"→"大智通三峽倉"→"統一數網辦公室"。
- 2. 預計入庫日期：倉別相同時，依「預計入庫日期」舊到新排序。
- 3. 供應商：日期相同時，依「供應商編號」小到大排列。
- 4. 進貨單號：供應商相同時，依「進貨單號」小到大排列。
- 5. 進倉單商品序號(#)：相同進倉單號，商品依照項目序號小到大排序(#1→#2)。
- 排序選項
- 依預設排序
- 依新增時間 (舊到新)
- 依新增時間 (新到舊)

### 資料來源
- 使用「進倉資料管理建立的資料」且「通知倉庫=已執行」
- 使用「2.1. 新增倉儲用進倉單」建立的資料。

### 查詢
:::info
:bulb: 已篩選條件列、清除全部、分頁切換，沿用系統公版樣式，Demo依照既有元件實作即可，無特殊規格。
:::
> **補充說明**
> 設定多個查詢條件時，條件關係為 `and`
> 查詢無結果，顯示：暫無資料
> 查詢有結果，顯示：共N筆
>
- 單號查詢：
- 關鍵模糊字查詢「進倉單號」、「ORD進貨單號」欄位。
- placeholder="請輸入進倉/ORD單號"
- 商品查詢：
- 關鍵模糊字查詢「商品編號」、「商品名稱」欄位。
- placeholder="請輸入商品編號/商品名稱"
- 供應商：
- 關鍵模糊字查詢「供應商名稱」、「供應商編號」欄位。
- ==\[Demo 簡化\]== 僅需要查詢供應商名稱
- placeholder="請輸入/選擇供應商"
- 日期區間：
- 日期選項：
- 預計入庫日期：選擇時查詢「預計入庫日期」欄位。
- 新增時間：選擇時查詢「進貨單新增時間」欄位。
- placeholder="YYYY/MM/DD"
- 倉庫註記：
- 關鍵模糊字查詢「倉庫註記」欄位
- placeholder="請輸入關鍵字"
- 內部備註：
- 關鍵模糊字查詢「內部備註」欄位
- placeholder="請輸入關鍵字"
- 入庫倉別：
- `<select>`，選項：顯示「維護入庫庫別」且「使用狀態=on」的倉庫名稱
- 例如：大智通三峽倉,統昶鶯歌倉,統一數網辦公室
- placeholder="請輸入/選擇供應商"
- 請款狀態：
- `<select>`，選項：待請款,已請款, 暫停
- ORD進貨單號：
- `<select>`，選項：未填寫,已填寫

### 列表欄位

> **下方說明文字**
> - 新增入庫數：限填【正數】增加實際庫存量、【負數】扣除實際庫存量、【Y數字】增加預購量、【Y-數字】扣除預購量。
> - 輸入「ORD進貨單號」代表該筆入庫作業完成。
>
| 欄位名稱 | 欄位說明 |
|---------|---------|
| 入庫倉別 | 與進倉單資料同步 |
| 倉庫註記 | 提供「欄位直接編修行為」，詳見該章節說明。placeholder="倉庫註記" |
| 預計入庫日期 | 與進倉單資料同步 |
| 供應商名稱 | 與進倉單資料同步 |
| 進倉單號 | 與進倉單資料同步；點擊連結，另開分頁開啟「進倉資料管理-進倉資料維護」 |
| 商品名稱 | 與進倉單資料同步；第一列：商品名稱；第二列：商品編號 |
| 預計入庫數量 | 與進倉單資料同步 |
| 實際入庫數量 | 顯示實際入庫數量，連結點擊開啟「1.1. Modal-商品入庫紀錄」 |
| 新增入庫數 | 提供「欄位直接編修行為」，詳見該章節說明。placeholder="入庫數" |
| 內部備註 | 提供「欄位直接編修行為」，詳見該章節說明。placeholder="內部備註" |
| ORD進貨單號 | placeholder="ORD單號" |
| ORD總金額 | placeholder="ORD金額" |
| 單品未稅成本 | 與進倉單資料同步 |
| 總未稅成本 | 與進倉單資料同步 |
| 請款狀態 | 提供「欄位直接編修行為」，詳見該章節說明。選項：待請款、已請款、暫停；新增資料預設為「待請款」 |
| 進貨單新增時間 | 抓取進倉單資料同步 |

---

### 欄位直接編修行為

**作用欄位**
| 欄位名稱 | 顯示模式 | 編輯模式（點擊欄位） | Tab |
|---------|---------|---------|--------|
| 倉庫註記 | 無值：欄位空白<br>有值：顯示填寫值，文字連結，顏色 `#E94829` | `<input>` | 總表、倉儲用-進倉單 |
| 新增入庫數 | 顯示"新增"，文字連結，既有表格文字顏色 | `<input>` <br>詳見：新增入庫數-設定說明| 總表、倉儲用-進倉單 |
| 內部備註 | 無值：欄位空白<br>有值：顯示填寫值，文字連結，顏色 `#E94829` | `<input>` | 總表、倉儲用-進倉單、進倉單異動紀錄、商品條碼異動紀錄 |
| ORD進貨單號 | 無值：欄位空白<br>有值：顯示填寫值，文字連結，既有表格文字顏色 | `<input>` | 總表、倉儲用-進倉單 |
| ORD總金額 | 無值：欄位空白<br>有值：顯示填寫值，文字連結，既有表格文字顏色 | `<input>` | 總表、倉儲用-進倉單 |
| 請款狀態 | 顯示選項值，文字連結，既有表格文字顏色 | `<select>`<br>選項：待請款、已請款、暫停 | 總表 |
| 建檔類別 | 顯示選項值，文字連結，既有表格文字顏色 | `<select>`<br>選項：「維護建檔類別」且「使用狀態=on」的建檔類別名稱 | 倉儲用-進倉單 |
| 處理狀態 | 待處理：<br>文字連結，顏色 `#E94829`<br>MM/DD已處理：<br>文字連結，顏色 `#529B2E`<br>（MM/DD = 該筆異動被處理的日期） | `<select>`<br>選項：待處理、已處理 | 進倉單異動紀錄、商品建檔紀錄、商品條碼異動紀錄 |

**欄位互動行為（類 Google Sheet inline edit）**
- `<input>` 離開輸入框（blur）→ 自動儲存，回到顯示模式
- `<select>` 選擇選項後（change）→ 自動儲存，回到顯示模式

**API**
- 儲存時呼叫：`PATCH /api/xxx/{id}`，帶入欄位值
- 儲存成功 → 更新畫面
- 儲存失敗 → Alert 提示，恢復原本的值

**新增入庫數-設定說明**

| 填寫說明 | 填寫範例 | 資料異動 |
|---------|---------:|---------|
| 正數 | 9 | 增加實際庫存量 |
| 負數 | -9 | 扣除實際庫存量 |
| Y正數 | Y9 | 增加預購量 |
| Y負數 | Y-9 | 扣除預購量 |