invoice-packing

Invoice & Packing List 轉檔工具 - 產品需求文件 (PRD)

1. 產品概述

1.1 產品名稱

Invoice & Packing List 轉檔工具

1.2 產品描述

一個基於 Web 的檔案轉換工具，支援將 CSV/Excel 資料轉換為標準化的 Invoice（發票）和 Packing List（裝箱單）格式。工具提供直觀的用戶界面，支援多品項處理，並確保輸出文件符合商業標準。

1.3 目標用戶

貿易公司員工
物流管理人員
會計人員
需要批量生成發票和裝箱單的業務人員

2. 功能需求

2.1 核心功能

2.1.1 檔案上傳功能

支援格式：CSV、Excel (.xlsx, .xls)
上傳方式：點擊選擇、拖拽上傳
檔案預覽：顯示前5筆資料預覽
檔案資訊：顯示檔名、檔案大小

2.1.2 轉檔類型選擇

Invoice 轉檔：生成標準發票格式
Packing List 轉檔：生成標準裝箱單格式
動態界面：根據選擇的轉檔類型顯示相應的設定選項

2.1.3 多品項支援

動態擴展：支援任意數量的產品品項
自動編號：產品編號自動遞增（1, 2, 3…）
持續新增：商品區塊會根據品項數量持續往下新增
底部資訊固定：確保重要資訊不會被多品項推下去

2.2 Invoice 功能

2.2.1 基本資訊設定

發票日期：可自訂發票日期
有效期限：可設定發票有效期限
發票號碼：支援手動輸入或自動生成
自動生成編號：基於時間戳生成唯一發票編號

2.2.2 公司資訊設定

公司名稱：預設為 “Juan Yuan Limited”
公司地址：預設地址，可修改
公司電話：預設電話號碼

2.2.3 客戶資訊對應

地址對應：retailer_warehouse_address → E4
電話對應：retailer_contact_phone → E5
聯絡人對應：retailer_contact_name → E6

2.2.4 產品清單處理

多品項支援：支援任意數量的產品
欄位對應：
- SKU → Barcode 欄位 (B欄)
- 產品名稱 → 商品欄位 (C欄)
- 箱入數 → 固定值 250
編號自動遞增：No. 欄位自動遞增

2.2.5 底部資訊固定

付款條件：Payment Term: 100% Prepaid T/T
貿易條款：Trade Teams: EXW
金額標示：Amount: USD
付款詳情：包含銀行資訊和簽名欄位

2.3 Packing List 功能

2.3.1 基本資訊設定

Packing List 日期：可自訂日期
Packing List 編號：可自訂編號

2.3.2 客戶資訊對應

買方資訊：retailer_erp_customer_name → Buyer
地址資訊：retailer_warehouse_address → Address
聯絡資訊：retailer_contact_phone → Tel
聯絡人：retailer_contact_name → Contact

2.3.3 產品清單處理

多品項支援：支援任意數量的產品
欄位對應：
- SKU → Barcode (B欄)
- 產品名稱 → 不帶值 (空白)
- 有效日期 → Best Before Date (YYYY-MM-DD 格式)
- 測量 → Measurement (cm)
- 重量 → Net Weight (KG)
- 箱入數 → 固定值 250

2.3.4 Total 行功能

自動添加：在產品清單後自動添加 Total 行
樣式設定：粗體、置中對齊
位置固定：確保 Total 行在正確位置

2.4 用戶界面功能

2.4.1 響應式設計

桌面版：2欄布局（上傳區域 + 設定區域）
平板版：1欄布局，垂直排列
手機版：優化觸控操作，字體大小調整

2.4.2 互動功能

拖拽上傳：支援檔案拖拽到上傳區域
即時預覽：上傳後立即顯示資料預覽
欄位檢查：自動檢查必要欄位是否存在
狀態提示：成功/錯誤狀態的視覺回饋

2.4.3 對應關係說明

Invoice 對應關係：清楚標示各欄位的對應關係
Packing List 對應關係：詳細說明欄位映射
必要欄位清單：列出轉檔所需的必要欄位

3. 技術需求

3.1 前端技術

HTML5：語義化標記
CSS3：響應式設計、現代化樣式
JavaScript (ES6+)：現代化 JavaScript 語法
XLSX.js：Excel 檔案處理庫

3.2 後端技術

Python 3.7+：主要開發語言
Streamlit：Web 應用框架
Pandas：資料處理
OpenPyXL：Excel 檔案操作

3.3 檔案格式支援

輸入格式：CSV、Excel (.xlsx, .xls)
輸出格式：Excel (.xlsx)
編碼支援：UTF-8

3.4 瀏覽器相容性

Chrome：最新版本
Firefox：最新版本
Safari：最新版本
Edge：最新版本

4. 非功能性需求

4.1 效能需求

檔案大小限制：支援最大 10MB 的檔案
處理時間：1000筆資料處理時間 < 5秒
記憶體使用：合理控制記憶體使用量

4.2 可用性需求

學習成本：新用戶5分鐘內可完成基本操作
錯誤處理：清楚的錯誤訊息和解決建議
操作流程：簡化為3步驟（上傳→設定→下載）

4.3 可靠性需求

資料完整性：確保轉檔過程中資料不遺失
格式一致性：輸出格式符合商業標準
錯誤恢復：處理異常情況時不影響系統穩定性

5. 資料需求

5.1 必要欄位

5.1.1 Invoice 必要欄位

retailer_erp_customer_name：客戶名稱
retailer_warehouse_address：客戶地址
retailer_contact_phone：聯絡電話
retailer_contact_name：聯絡人
sku：產品編號
name：產品名稱

5.1.2 Packing List 必要欄位

retailer_erp_customer_name：客戶名稱
retailer_warehouse_address：客戶地址
retailer_contact_phone：聯絡電話
retailer_contact_name：聯絡人
sku：產品編號
name：產品名稱
effective_date：有效日期
measurement：測量單位
weight：重量

5.2 資料格式要求

日期格式：支援多種日期格式，自動轉換為 YYYY-MM-DD
數值格式：支援整數和小數
文字格式：支援中文、英文、數字

6. 使用者體驗需求

6.1 操作流程

上傳檔案：選擇或拖拽 CSV/Excel 檔案
選擇轉檔類型：Invoice 或 Packing List
設定參數：填寫必要的設定資訊
執行轉檔：點擊轉檔按鈕
下載結果：下載生成的 Excel 檔案

6.2 錯誤處理

檔案格式錯誤：提示支援的檔案格式
欄位缺失：列出缺失的必要欄位
資料格式錯誤：提供修正建議
轉檔失敗：顯示詳細錯誤訊息

6.3 成功回饋

轉檔成功：顯示成功訊息和下載連結
檔案資訊：顯示生成的檔案名稱和大小
使用提示：提供後續使用建議

7. 部署需求

7.1 系統需求

作業系統：Windows 10+, macOS 10.14+, Linux
Python 版本：3.7 或更高版本
記憶體：最少 4GB RAM
儲存空間：最少 100MB 可用空間

7.2 依賴套件

streamlit>=1.28.0
pandas>=1.5.0
openpyxl>=3.0.0

7.3 啟動方式

Streamlit 應用：streamlit run app.py
HTML 版本：直接開啟 exact_invoice_template.html

8. 維護需求

8.1 版本控制

使用 Git 進行版本控制
主要分支：main
功能分支：feature/*
修復分支：bugfix/*

8.2 測試需求

單元測試：核心功能測試
整合測試：端到端流程測試
使用者測試：實際使用場景測試

8.3 文件維護

技術文件：API 文件、架構文件
使用者文件：操作手冊、常見問題
更新日誌：版本更新記錄

9. 成功指標

9.1 功能指標

轉檔成功率：> 95%
多品項支援：支援 100+ 品項
處理速度：1000筆資料 < 5秒

9.2 使用者指標

學習時間：新用戶 < 5分鐘上手
操作效率：3步驟完成轉檔
錯誤率：< 5% 的操作錯誤

9.3 技術指標

系統穩定性：99% 正常運行時間
瀏覽器相容性：支援主流瀏覽器
響應速度：頁面載入 < 3秒

文件版本：1.0
最後更新：2024-09-23
負責人：開發團隊