# 每月營收年度比較

基於 Flask + Gemini API 的後台資料分析工具，功能聚焦於「相同月份跨年度的營收與訂單數比較」，並結合 Gemini AI 進行自然語言趨勢分析。

---

### 🔧 系統架構與關鍵功能

- **登入驗證機制**
    
    
    - 使用者需輸入 `.env` 中設定的管理密碼方可進入分析頁面。
- **資料來源**
    
    
    - 所有資料儲存在 `orders.json`，格式如下：

```
{
  "year_month": "2023-08",
  "orders": 123,
  "revenue": 45000
}
```

- **圖表視覺化**
    
    
    - 主頁面以折線圖顯示每月營收與訂單數的長期走勢。
    - 可切換不同月份，對應顯示跨年份該月份的營收比較。
- **AI 分析**
    
    
    - 使用 Google Gemini API 對指定月份的歷年營收與訂單資料進行自動摘要、趨勢、亮點與異常分析。
    - 分析提示語由系統自動生成，包含：
        
        
        - 各年度該月份的營收與訂單統計
        - 總和營收與訂單數
        - 自然語言生成的洞察報告

---

### ✏️ 資料維護功能

- 編輯介面提供：
    
    
    - 🔼 新增或更新 `year_month` 資料
    - 🗑️ 刪除特定年月的紀錄
- 所有更新皆會即時同步至 `orders.json`

---

### 📁 安全性與擴充性

- 所有敏感設定（密碼、API Key）皆採用 `.env` 儲存，並透過 `python-dotenv` 載入。
- 模組具備良好擴充彈性，可未來接入其他 API（如 GA4、WooCommerce 等）整合更多維度的資料分析。