---
title: "ADR-015: Telegram Bot 完整菜單系統恢復"
status: accepted
created: 2026-04-20
decision-date: 2026-04-20
authors:
  - Cascade AI Assistant
---

# ADR-015: Telegram Bot 完整菜單系統恢復

## 狀況

用戶回報 Telegram Bot 菜單功能缺失，原本的 6 項簡單功能無法滿足完整業務需求。經檢查發現 `telegram_bot_service.py` 使用了簡化版菜單，而 `openclaw_bot_routes.py` 包含完整的 7 大類別菜單系統。

## 決策

恢復並實現完整的 Telegram Bot 菜單系統，包含：

1. **主菜單擴展**：從 6 項功能擴展為 7 大類別
2. **三層架構**：建立主菜單 → 子菜單 → 特定功能的層次結構
3. **完整功能覆蓋**：包含所有業務場景的菜單選項
4. **向下相容**：保留原有功能並新增缺失功能

## 實作

### 主菜單結構（7大類別）

```
📊 業績查詢    🏆 商品廠商
🎯 目標管理    📈 智能分析  
📄 簡報報表    🌐 市場情報
🔍 競品日報
❓ 使用說明
```

### 子菜單系統（10個完整子系統）

1. **sales** - 業績查詢：今日/昨日/每週/每月/每季業績、趨勢分析、同期比較
2. **products** - 商品廠商：熱銷商品/廠商、商品健康、補貨預測、分類鑽取
3. **goals** - 目標管理：達成率查看、各週期目標設定
4. **analysis** - 智能分析：策略矩陣、業績趨勢、商品健康、促銷追蹤
5. **reports** - 簡報報表：各週期報告、策略分析、促銷效益、競品比較
6. **market** - 市場情報：電商新聞、天氣、熱搜、口碑、匯率、節慶、YouTube、AI學習、比價
7. **competitor** - 競品日報：今日/昨日簡報、各週期比較
8. **competitor_ppt** - 競品PPT長週期：半年/年比較（第三層）
9. **category** - 分類業績鑽取：15個完整商品分類
10. **trend** - 業績趨勢：各時間範圍分析

### 關鍵發現

#### 市場情報完整功能恢復
原本遺漏的重要功能：
- 📰 電商新聞
- 🌤 台北天氣
- 🔥 Google熱搜
- 💬 Dcard口碑
- 💱 台銀匯率
- 📅 電商節慶
- ▶️ YouTube爆紅商品
- 🧠 AI學習狀態
- 🔍 關鍵字比價
- 📷 圖片比價說明

#### 三層菜單架構
- 第一層：主菜單（7大類別 + 使用說明）
- 第二層：各類別子菜單
- 第三層：特定深入功能（如競品PPT長週期）

#### 15個完整分類
美妝保養、3C家電、服飾配件、居家生活、母嬰用品、生鮮食品、圖書文具、戶外運動、餐券票券、醫療保健、美體保健、寵物用品、箱包精品、車類百貨、情趣用品

## 結果

### 正面影響
- ✅ **功能完整性**：從6項擴展為涵蓋所有業務場景的完整菜單系統
- ✅ **用戶體驗**：清晰的層次結構，便於導航和功能發現
- ✅ **業務覆蓋**：支援業績、商品、目標、分析、報表、市場、競品等全方位需求
- ✅ **向下相容**：保留原有功能，無破壞性變更

### 風險緩解
- **複雜性管理**：透過清晰的層次結構降低學習成本
- **維護負擔**：統一的菜單架構便於後續維護和擴展

## 後續行動

1. **監控使用情況**：觀察新菜單系統的用戶使用模式和反饋
2. **持續優化**：根據實際使用情況調整菜單結構
3. **文件更新**：更新相關的用戶手冊和操作指南

## 相關文件

- [ADR-012: Agent Action Ladder](./ADR-012-agent-action-ladder.md)
- [Telegram Bot 服務實作](../../services/telegram_bot_service.py)
- [OpenClaw Bot 路由](../../routes/openclaw_bot_routes.md)
