# MOMO Pro System - 產品需求書 (PRD)

> 版本：2.0 | 最後更新：2026-01-29

---

## 📌 產品概述

### 產品名稱
**MOMO Pro System** (WOOO TECH 電商監控系統)

### 產品願景
打造一站式電商營運管理平台，整合商品監控、業績分析、廠商管理、AI 文案生成等功能，協助電商營運團隊提升工作效率。

### 目標用戶
| 角色 | 主要需求 |
|------|---------|
| **PM (產品經理)** | 監控商品價格、追蹤銷售業績 |
| **採購人員** | 管理廠商缺貨、發送補貨通知 |
| **行銷人員** | AI 文案生成、趨勢分析 |
| **管理者** | 數據報表、系統監控 |

---

## 🎯 功能模組

### 模組總覽

```mermaid
mindmap
  root((MOMO Pro))
    商品監控
      價格追蹤
      漲跌分析
      下架偵測
    業績分析
      每日業績
      月份總表
      成長分析
    廠商管理
      缺貨匯入
      郵件發送
      廠商清單
    AI 助手
      文案生成
      熱門推薦
      趨勢分析
    系統管理
      用戶管理
      權限控制
      系統設定
```

---

## 📊 模組一：商品價格監控

### 功能描述
自動爬取 MOMO 電商平台商品價格，即時追蹤價格變動，提供漲跌分析。

### 用戶故事

| ID | 角色 | 故事 | 驗收條件 |
|----|------|------|---------|
| US-1.1 | PM | 我想查看所有監控中的商品列表 | 顯示商品名稱、價格、分類、變動狀態 |
| US-1.2 | PM | 我想篩選今日漲價/降價的商品 | 支援漲價、降價、下架篩選 |
| US-1.3 | PM | 我想查看商品的歷史價格走勢 | 顯示折線圖，支援 7/30/90 天區間 |
| US-1.4 | PM | 我想搜尋特定商品 | 支援名稱、品號搜尋 |
| US-1.5 | PM | 我想匯出商品價格報表 | 支援 Excel 匯出 |

### 功能規格

| 功能 | 規格 |
|------|------|
| 爬蟲頻率 | 每小時（可設定） |
| 監控商品數 | ~6,000 筆 |
| 價格歷史保留 | 365 天 |
| 支援篩選 | 分類、價格區間、變動類型 |
| 支援排序 | 價格、變動幅度、更新時間 |

---

## 📈 模組二：業績分析

### 功能描述
整合 Google Drive 自動匯入每日業績資料，提供多維度業績分析報表。

### 用戶故事

| ID | 角色 | 故事 | 驗收條件 |
|----|------|------|---------|
| US-2.1 | 管理者 | 我想查看今日即時業績 | 顯示銷售額、訂單數、達成率 |
| US-2.2 | 管理者 | 我想比較昨日/上週業績 | 顯示同期比較、成長率 |
| US-2.3 | 管理者 | 我想分析各品牌業績 | 支援品牌維度分析 |
| US-2.4 | PM | 我想查看我負責的品牌業績 | 支援 PM 篩選 |
| US-2.5 | 管理者 | 我想匯出業績報表 | 支援 Excel 匯出 |

### 功能規格

| 功能 | 規格 |
|------|------|
| 資料來源 | Google Drive Excel 檔案 |
| 自動匯入 | 每 30 分鐘掃描 |
| 分析維度 | 日/週/月、品牌、PM、分類 |
| 指標 | 銷售額、毛利、轉換率、瀏覽數 |

---

## 📦 模組三：廠商缺貨管理

### 功能描述
匯入缺貨清單，自動比對廠商聯絡資訊，批次發送補貨通知郵件。

### 用戶故事

| ID | 角色 | 故事 | 驗收條件 |
|----|------|------|---------|
| US-3.1 | 採購 | 我想匯入缺貨 Excel 檔案 | 支援拖曳上傳，顯示匯入進度 |
| US-3.2 | 採購 | 我想預覽要發送的郵件內容 | 顯示郵件主旨、收件者、商品列表 |
| US-3.3 | 採購 | 我想批次發送通知郵件 | 一鍵發送，顯示發送狀態 |
| US-3.4 | 採購 | 我想管理廠商聯絡資訊 | 新增/編輯/刪除廠商郵件 |
| US-3.5 | 採購 | 我想查看郵件發送歷史 | 顯示發送時間、狀態、錯誤訊息 |

### 功能規格

| 功能 | 規格 |
|------|------|
| 匯入格式 | Excel (.xlsx) |
| 自動比對 | 依廠商代碼比對郵件 |
| 郵件格式 | HTML 格式，附件商品清單 |
| 發送記錄 | 完整稽核追蹤 |

---

## 🤖 模組四：AI 文案助手

### 功能描述
整合 Ollama 和 Google Gemini AI，自動生成商品銷售文案和熱門推薦。

### 用戶故事

| ID | 角色 | 故事 | 驗收條件 |
|----|------|------|---------|
| US-4.1 | 行銷 | 我想為商品生成促銷文案 | 支援選擇風格、關鍵字 |
| US-4.2 | 行銷 | 我想查看熱門趨勢商品推薦 | 顯示 mybest、@cosme 排行 |
| US-4.3 | 行銷 | 我想收藏好用的文案 | 支援收藏、評分功能 |
| US-4.4 | 行銷 | 我想查看 AI 使用統計 | 顯示 Token 用量、費用 |
| US-4.5 | 行銷 | 我想搜尋網路最新資訊 | 支援 Gemini 網路搜尋 |

### 功能規格

| 功能 | 規格 |
|------|------|
| AI 提供者 | Ollama (本地) / Gemini (雲端) |
| 文案風格 | 吸睛、專業、急迫、親民 |
| 趨勢來源 | mybest、@cosme、YouTube |
| 生成速度 | ~5-10 秒 |

---

## 👤 模組五：用戶與權限管理

### 功能描述
管理系統用戶帳號、角色權限、登入記錄。

### 用戶故事

| ID | 角色 | 故事 | 驗收條件 |
|----|------|------|---------|
| US-5.1 | 管理員 | 我想新增/編輯用戶帳號 | 設定帳號、密碼、角色 |
| US-5.2 | 管理員 | 我想設定用戶權限 | 細粒度權限控制 |
| US-5.3 | 管理員 | 我想查看登入記錄 | 顯示登入時間、IP、狀態 |
| US-5.4 | 用戶 | 我想修改自己的密碼 | 支援密碼強度檢查 |
| US-5.5 | 管理員 | 我想停用/啟用帳號 | 一鍵切換狀態 |

### 角色權限

| 角色 | 權限 |
|------|------|
| `admin` | 系統管理員，完整存取 |
| `manager` | 管理者，可管理用戶 |
| `user` | 一般用戶，唯讀存取 |

---

## ⚙️ 模組六：系統設定與監控

### 功能描述
系統配置管理、爬蟲排程控制、系統日誌查看。

### 用戶故事

| ID | 角色 | 故事 | 驗收條件 |
|----|------|------|---------|
| US-6.1 | 管理員 | 我想設定爬蟲執行時間 | 支援 Cron 表達式 |
| US-6.2 | 管理員 | 我想手動觸發爬蟲 | 一鍵執行 |
| US-6.3 | 管理員 | 我想查看系統日誌 | 支援篩選、搜尋 |
| US-6.4 | 管理員 | 我想設定通知參數 | Telegram、LINE、郵件設定 |
| US-6.5 | 管理員 | 我想監控系統狀態 | 顯示 CPU、記憶體、磁碟 |

---

## 🔔 模組七：通知系統

### 功能描述
整合 Telegram、LINE、郵件，發送業績通知、系統告警。

### 通知類型

| 類型 | 頻率 | 通道 |
|------|------|------|
| 每日業績報告 | 每日 9:00 | Telegram |
| 爬蟲執行通知 | 即時 | Telegram |
| 價格異動通知 | 即時 | Telegram |
| 系統異常告警 | 即時 | Telegram |
| 廠商郵件通知 | 手動 | Email |

---

## 📱 非功能性需求

### 效能需求

| 項目 | 要求 |
|------|------|
| 頁面載入 | < 3 秒 |
| API 回應 | < 500ms (一般) / < 5s (報表) |
| 並發用戶 | 支援 50+ 同時在線 |
| 資料處理 | 10,000 筆/分鐘 (匯入) |

### 可用性需求

| 項目 | 要求 |
|------|------|
| 服務可用性 | 99.5% SLA |
| 資料備份 | 每日自動備份 |
| 災難復原 | RTO < 4 小時 |

### 安全需求

| 項目 | 要求 |
|------|------|
| 認證 | Session + bcrypt |
| 傳輸加密 | HTTPS (TLS 1.3) |
| 權限控制 | RBAC 三級權限 |
| 稽核追蹤 | 登入記錄、操作日誌 |

### 相容性需求

| 項目 | 要求 |
|------|------|
| 瀏覽器 | Chrome 90+, Firefox 90+, Safari 15+, Edge 90+ |
| 螢幕解析度 | 支援 1280x720 以上 |
| 行動裝置 | 響應式設計 (RWD) |

---

## 📅 版本歷程

| 版本 | 日期 | 變更 |
|------|------|------|
| 1.0 | 2025-12 | 初版：商品監控、業績報表 |
| 1.5 | 2026-01 | 新增：廠商缺貨管理 |
| 2.0 | 2026-01 | 新增：AI 文案助手、趨勢爬蟲 |
