1b4f3a7bbe
Some checks failed
CD Pipeline / deploy (push) Failing after 59s
- 建立 Gitea Actions CD pipeline (.gitea/workflows/cd.yaml) - 部署模式: rsync Python 檔案至 188 → docker restart (volume mount) - Dockerfile/requirements 變動時自動重建 Docker image - 部署通知: Telegram (開始/成功/失敗) - 健康檢查: https://mo.wooo.work/health (最多 5 次重試) - 同步最新 CLAUDE.md / ADR-008 / memory (2026-04-19) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
265 lines
7.6 KiB
Markdown
265 lines
7.6 KiB
Markdown
# 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 文案助手、趨勢爬蟲 |
|