市場分析報告系統 v2.2.1

智能市場分析 • 即時黃金價格 • N8N 整合 • 自動化郵件發送 • 情感分析

🚀 系統特色

📊 即時黃金價格監控 - 使用 yfinance 獲取即時黃金期貨價格 (GC=F)
📈 互動式價格圖表 - Chart.js 驅動的專業級價格圖表，支援多種時間週期
🧠 智能情感分析 - N8N 工作流程整合的市場情感分析系統
📧 獨立郵件發送頁面 - 分離式郵件配置和發送界面
🔗 N8N Webhook 整合 - 完整的自動化工作流程支援
🌐 現代化 Web 界面 - 響應式設計，支援多設備訪問
🐳 Docker 容器化 - 一鍵部署，環境隔離
📊 技術指標分析 - RSI14、移動平均線、趨勢箭頭、乖離率分析、黃金交叉檢測
🔄 生命週期管理 - 應用啟動/關閉事件處理
📝 增強日誌系統 - 詳細的錯誤追蹤和系統監控
🔍 健康檢查 - 完整的系統健康監控
📱 響應式設計 - 支援桌面和移動設備
🔄 自動刷新 - 每分鐘自動更新數據
🎨 動畫效果 - 背景動畫和互動效果

📁 系統架構

n8n_web_demo/
├── 🖥️  API 服務 (Port 8089)
│   ├── FastAPI 後端 (main.py)
│   ├── 市場數據處理
│   ├── 黃金價格 API (yfinance)
│   ├── N8N Webhook 整合
│   └── 郵件發送系統
├── 🌐 前端界面
│   ├── index.html (主頁面)
│   ├── mail.html (郵件頁面)
│   └── static/ (靜態資源)
│       ├── style.css
│       ├── mail-style.css
│       ├── script.js
│       └── mail-script.js
├── 📊 數據處理
│   ├── 黃金價格統計
│   ├── 技術指標計算
│   ├── 移動平均線 (MA5, MA20, MA50, MA125)
│   ├── 轉折點分析
│   └── 情感分析處理
├── 📋 配置與部署
│   ├── requirements.txt
│   ├── Dockerfile
│   ├── docker-compose.yml
│   └── 環境配置
└── 📁 系統目錄
    ├── logs/ (日誌檔案)
    ├── data/ (數據檔案)
    ├── cache/ (快取檔案)
    └── backups/ (備份檔案)

🛠️ 快速開始

方法一：本地開發模式（推薦）

# 1. 克隆或下載項目檔案
git clone <repository-url>
cd n8n_web_demo

# 2. 建立虛擬環境
python -m venv .venv
source .venv/bin/activate  # Linux/macOS
# 或
.venv\Scripts\activate     # Windows

# 3. 安裝依賴
pip install -r requirements.txt

# 4. 啟動服務
python main.py

方法二：Docker 部署

# 1. 建立環境變數檔案
cp .env.example .env

# 2. 編輯 .env 檔案設定您的配置
# 設定 N8N Webhook URL 和其他必要參數

# 3. 啟動服務
docker-compose up --build -d

# 4. 查看服務狀態
docker-compose ps

方法三：直接執行

# 1. 確保已安裝 Python 3.8+
python --version

# 2. 安裝依賴
pip install fastapi uvicorn yfinance pandas numpy requests pydantic[email]

# 3. 啟動服務
python main.py

🌐 服務訪問

服務	本地訪問	說明
主網站	http://localhost:8089	市場數據 + 黃金價格顯示
郵件頁面	http://localhost:8089/mail	獨立的郵件發送頁面
API 服務	http://localhost:8089	RESTful API 接口
API 文檔	http://localhost:8089/api/docs	Swagger API 文檔
健康檢查	http://localhost:8089/health	服務健康狀態
ngrok 隧道	http://localhost:4041	外部訪問隧道

📊 主要功能

1. 即時黃金價格監控

數據來源: Yahoo Finance (GC=F 黃金期貨)
更新頻率: 每分鐘自動刷新
支援時間週期: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y
支援時間間隔: 1m, 5m, 15m, 30m, 1h, 1d
前端預設: 固定為 1y 期間，1d 間隔
顯示內容:
- 當前價格 (USD/oz)
- 價格變化和變化百分比
- 24小時高低點
- 平均價格和波動率
- 市場狀態（開市/休市）
- 最後更新時間
- 互動式價格圖表 (Chart.js)
- 技術指標 (RSI14, MA線, 趨勢箭頭)
- 黃金交叉檢測
- 乖離率分析 (MA5/MA20 偏離程度)
- 轉折點顏色顯示 (綠/紅/橙)
- 可切換的移動平均線顯示
- 響應式圖表設計

2. 智能市場情感分析

數據來源: N8N 工作流程
分析內容:
- 情感分析分數 (0-100 分制)
- 情緒分類統計 (正面/中性/負面)
- 市場情感標籤 (恐懼/貪婪等)
- 市場情感摘要
- HTML 格式郵件報告
- 即時情緒指數顯示
- 情緒等級分類 (極度恐慌到極度貪婪)
- 資料來源說明 (NewsAPI, FinBERT, GPT-4o MINI)
- 情緒統計分析 (positive/neutral/negative 計數)

3. 技術指標分析

核心指標

移動平均線: MA5, MA20, MA50, MA125
RSI 指標: RSI14 (相對強弱指數)
波動率分析: 5日波動率
價格趨勢: 價格與移動平均線的關係
交叉信號: 黃金交叉檢測
轉折點分析: 基於前三個月最高價與最低價的平均值
市場狀態判斷: 基於時間的市場開放狀態
可切換顯示: 支援 MA5, MA20, MA125, 轉折點的開關控制
即時更新: 技術指標隨價格數據即時更新

增強功能 (v2.2.1)

趨勢箭頭顯示:
- MA5、MA20、MA50 數值後面顯示趨勢箭頭 (↑、↓、=)
- RSI14 數值後面顯示趨勢箭頭
- 箭頭顏色：綠色(↑)、紅色(↓)、灰色(=)
MA5 與 MA20 相對關係:
- 一般情況：顯示 MA5 > MA20 或 MA5 < MA20（白燈）
- 黃金交叉：昨日 MA5 ≤ MA20，今日 MA5 > MA20，今日收盤價 > MA20（綠燈）
乖離率分析:
- 計算當日價格相對於 MA5、MA20 的乖離率（%）
- 與前一天比較顯示趨勢箭頭
- 過熱警告：乖離率超過 ±10% 時顯示警告
- 180日平均乖離率比較
轉折點顏色顯示:
- 當日價格 > 轉折點：綠色
- 當日價格 < 轉折點：紅色
- 當日價格 = 轉折點：橙色
RSI14 改進:
- 從 RSI 升級為 RSI14
- 增強計算穩定性，處理邊界情況
- 改進空值處理和除零錯誤

4. 郵件發送系統

獨立頁面: /mail 路由
功能特色:
- 收件人設定
- 自訂郵件主旨
- 個人化訊息
- 多種郵件選項
- 即時預覽功能
- N8N webhook 整合
- 情感分析表情符號
- 郵件優先級設定
- 市場數據預覽
- 表單驗證
- 自動刷新市場數據

🔧 API 接口

核心 API

# 獲取當前市場數據
GET /api/current-data

# 獲取黃金價格
GET /api/gold-price?period=1y&interval=1d

# 接收 N8N 數據
POST /api/n8n-data

# 發送郵件到 N8N
POST /api/send-mail-to-n8n

# 測試 N8N 連接
GET /api/test-n8n-connection

# 調試存儲數據
GET /api/debug-stored-data

# 系統健康檢查
GET /health

數據格式範例

黃金價格 API 回應

{
  "status": "success",
  "data": {
    "symbol": "GC=F",
    "name": "Gold Futures",
    "current_price": 2023.45,
    "change": 12.30,
    "change_percent": 0.61,
    "high_24h": 2030.20,
    "low_24h": 2015.80,
    "avg_price": 2025.30,
    "volatility": 15.45,
    "currency": "USD",
    "unit": "per ounce",
    "last_updated": "2025-01-22T08:30:00Z",
    "market_status": "open",
    "chart_data": [...],
    "ma_lines": {
      "ma_5": [...],
      "ma_20": [...]
    },
    "ma_125_line": [...],
    "pivot_points": [...],
    "cross_signal": {
      "golden_cross": false,
      "status": "normal",
      "message": "⚪ 正常：MA20與MA5無交叉信號"
    },
    "technical_indicators": {
      "ma_5": 2025.30,
      "ma_5_trend": "↑",
      "ma_20": 2020.50,
      "ma_20_trend": "↓",
      "ma_50": 2015.30,
      "ma_50_trend": "=",
      "ma_relation": "MA5 > MA20",
      "cross_status": "normal",
      "cross_message": "⚪ 正常",
      "rsi14": 65.2,
      "rsi14_trend": "↑",
      "ma5_deviation": 2.5,
      "ma5_deviation_trend": "↑",
      "ma5_overheated": false,
      "ma20_deviation": 1.2,
      "ma20_deviation_trend": "↓",
      "ma20_overheated": false,
      "avg_ma5_deviation": 1.8,
      "avg_ma20_deviation": 0.9
    }
  }
}

N8N 數據格式

{
  "positive": 10,
  "neutral": 8,
  "negative": 10,
  "summary": "今日市場....",
  "score": 47,
  "label": "恐懼",
  "emailReportHtml": html格式
}

郵件發送請求

{
  "recipient_email": "[email protected]",
  "sender_name": "市場分析系統",
  "subject": "市場分析報告",
  "priority": "normal",
  "mail_type": "daily",
  "emailReportHtml": html格式,
  "include_charts": true,
  "include_recommendations": true,
  "include_risk_warning": false
}

📋 環境配置

必需環境變數

# 基本配置
ENVIRONMENT=production
DEBUG=false
LOG_LEVEL=INFO

# 服務端口
SERVER_HOST=0.0.0.0
SERVER_PORT=8089

# Webhook 配置
WEBHOOK_URL=https://your-n8n-instance.com/webhook/your-webhook-id
WEBHOOK_TIMEOUT=30

# N8N Webhook URL
N8N_WEBHOOK_URL=https://your-n8n-instance.com/webhook/Webhook - Preview

可選環境變數

# 日誌配置
LOG_LEVEL=INFO
LOG_FILE=logs/market_analysis.log

# 數據配置
DATA_DIR=data
CACHE_DIR=cache

🐳 Docker 部署

使用 Docker Compose

# 1. 建立環境變數檔案
cp .env.example .env

# 2. 編輯 .env 檔案
# 設定 N8N Webhook URL 和其他必要參數

# 3. 啟動服務
docker-compose up --build -d

# 4. 查看服務狀態
docker-compose ps

# 5. 查看日誌
docker-compose logs -f

使用 Dockerfile

# 1. 建立映像
docker build -t market-analysis-system .

# 2. 執行容器
docker run -d \
  --name market-analysis \
  -p 8089:8089 \
  -e WEBHOOK_URL=your_webhook_url \
  market-analysis-system

Docker Compose 服務

系統包含以下 Docker 服務：

market-analysis: 主要應用服務
ngrok: 隧道服務 (端口 4041)
redis: 快取服務 (可選)
prometheus: 監控服務 (可選)
grafana: 儀表板服務 (可選)

📊 監控與日誌

查看服務狀態

# 健康檢查
curl http://localhost:8089/health

# 查看日誌
tail -f logs/market_analysis.log

# Docker 日誌
docker-compose logs -f

系統統計

系統提供詳細的統計信息：

總報告數量
今日報告數量
API 調用次數
黃金價格調用次數
錯誤計數
系統運行時間
最後數據接收時間

📈 技術指標詳細說明

趨勢箭頭系統

系統為所有關鍵技術指標添加了趨勢箭頭顯示：

↑ (綠色): 指標上升，看漲信號
↓ (紅色): 指標下降，看跌信號
= (灰色): 指標持平，中性信號

移動平均線分析

MA5: 5日移動平均線，短期趨勢指標
MA20: 20日移動平均線，中期趨勢指標
MA50: 50日移動平均線，長期趨勢指標
MA125: 125日移動平均線，超長期趨勢指標

交叉信號檢測

黃金交叉: MA5 從下方穿越 MA20，且收盤價高於 MA20
信號顯示: 使用顏色編碼（綠/白）和表情符號

乖離率分析

計算方式: (當前價格 - 移動平均線) / 移動平均線 × 100%
過熱警告: 乖離率超過 ±10% 時顯示警告
歷史比較: 與 180 日平均乖離率比較

RSI14 指標

計算週期: 14 日相對強弱指數
超買區間: RSI > 70，市場可能過熱
超賣區間: RSI < 30，市場可能過冷
正常區間: 30 ≤ RSI ≤ 70
趨勢顯示: 與前一日比較顯示趨勢箭頭

轉折點分析

計算方式: 前三個月最高價與最低價的平均值
顏色編碼:
- 綠色：當日價格 > 轉折點
- 紅色：當日價格 < 轉折點
- 橙色：當日價格 = 轉折點

🔧 開發指南

本地開發環境

# 1. 建立虛擬環境
python -m venv .venv
source .venv/bin/activate  # Linux/macOS
# 或
.venv\Scripts\activate     # Windows

# 2. 安裝依賴
pip install -r requirements.txt

# 3. 設定環境變數
export DEBUG=true
export LOG_LEVEL=DEBUG

# 4. 啟動開發服務器
python main.py

檔案結構

n8n_web_demo/
├── main.py              # API 服務主程式
├── requirements.txt     # Python 依賴
├── Dockerfile           # Docker 配置
├── docker-compose.yml   # Compose 配置
├── docker-entrypoint.sh # Docker 入口腳本
├── setup-docker.sh      # Docker 設置腳本
├── frontend/           # 前端檔案
│   ├── index.html      # 主頁面
│   ├── mail.html       # 郵件頁面
│   └── static/         # 靜態資源
│       ├── style.css   # 樣式檔案
│       ├── mail-style.css
│       ├── script.js   # 腳本檔案
│       └── mail-script.js
├── data/               # 數據檔案
├── logs/               # 日誌檔案
├── backups/            # 備份檔案
├── cache/              # 快取檔案
└── test/               # 測試檔案

依賴套件

# 核心 Web 框架
fastapi>=0.104.0
uvicorn[standard]>=0.24.0

# 資料驗證和序列化
pydantic[email]>=2.5.0
email-validator>=2.0.0

# HTTP 客戶端
requests>=2.31.0
httpx>=0.24.0

# 金融數據
yfinance>=0.2.20

# 資料處理
pandas>=2.0.0
numpy>=1.24.0

# 相容性修正
typing-extensions>=4.5.0

🛠️ 故障排除

常見問題

1. 服務無法啟動

# 檢查端口是否被占用
netstat -tlnp | grep :8089

# 檢查 Python 版本
python --version

# 檢查依賴安裝
pip list | grep fastapi

2. 黃金價格無法獲取

# 檢查網路連接
curl -s "https://finance.yahoo.com" > /dev/null && echo "網路正常"

# 測試 yfinance
python -c "import yfinance as yf; print(yf.Ticker('GC=F').info['regularMarketPrice'])"

3. N8N 連接失敗

# 測試 webhook 連接
curl -X GET http://localhost:8089/api/test-n8n-connection

# 檢查 webhook URL 設定
echo $WEBHOOK_URL

4. 郵件發送失敗

# 檢查 N8N webhook URL
curl -X POST $N8N_WEBHOOK_URL -H "Content-Type: application/json" -d '{"test": "data"}'

# 查看郵件發送日誌
grep "send-mail" logs/market_analysis.log

效能優化

1. 記憶體使用優化

# 限制容器記憶體使用
docker run --memory="512m" market-analysis-system

2. 快取配置

# 啟用數據快取
mkdir -p cache

3. 日誌輪轉

# 設定日誌輪轉
logrotate /etc/logrotate.d/market-analysis

📞 技術支援

日誌位置

應用日誌: ./logs/market_analysis.log
Docker 日誌: docker-compose logs
系統日誌: /var/log/syslog

健康檢查

# API 健康檢查
curl http://localhost:8089/health

# 完整服務檢查
curl http://localhost:8089/api/current-data

備份與恢復

# 建立備份
tar -czf backup-$(date +%Y%m%d).tar.gz data/ logs/

# 恢復備份
tar -xzf backup-YYYYMMDD.tar.gz

🔄 版本更新

更新到最新版本

# 1. 停止服務
docker-compose down

# 2. 拉取最新代碼
git pull origin main

# 3. 重建並啟動
docker-compose up --build -d

版本歷史

v2.2.1: 技術指標全面升級，新增趨勢箭頭、乖離率分析、交叉信號增強
v2.2.0: 修正 RSI 和 MA50 顯示問題，增強技術指標計算穩定性
v2.1.4: 修正市場數據顯示問題，增強錯誤處理和日誌
v2.1.2: 增強錯誤處理和日誌，修正市場數據顯示問題
v2.1.0: 增強黃金價格 API，新增技術指標
v2.0.0: 分離式架構 + 黃金價格 + N8N 整合
v1.3.0: 郵件發送頁面 + N8N 整合增強
v1.2.0: 基本市場分析功能
v1.0.0: 初始版本

🤝 貢獻指南

歡迎提交 Issue 和 Pull Request 來改善本項目。

開發流程

Fork 本項目
建立功能分支 (git checkout -b feature/AmazingFeature)
提交變更 (git commit -m 'Add some AmazingFeature')
推送到分支 (git push origin feature/AmazingFeature)
開啟 Pull Request

代碼規範

使用 Python 3.8+ 語法
遵循 PEP 8 代碼風格
添加適當的註釋和文檔
確保所有測試通過

📄 授權條款

本項目採用 MIT 授權條款。詳見 LICENSE 檔案。

🙏 致謝

FastAPI - 現代化的 Python Web 框架
yfinance - Yahoo Finance 數據庫
Chart.js - 互動式圖表庫
N8N - 工作流程自動化平台

市場分析報告系統 v2.2.1 - 智能分析 • 精準決策 🚀

讓數據驅動決策，讓智能引領未來

Name		Name	Last commit message	Last commit date
Latest commit History 44 Commits
.idea		.idea
__pycache__		__pycache__
frontend		frontend
logs		logs
test		test
setup-docker.sh		setup-docker.sh
Dockerfile		Dockerfile
Dockerfile.simple		Dockerfile.simple
README.md		README.md
System Architecture Document.md		System Architecture Document.md
daemon.json		daemon.json
docker-compose.yml		docker-compose.yml
docker-entrypoint.sh		docker-entrypoint.sh
main.py		main.py
requirements.txt		requirements.txt

Sanwanh/n8n-fastapi-demo

Folders and files

Latest commit

History

Repository files navigation

市場分析報告系統 v2.2.1

🚀 系統特色

📁 系統架構

🛠️ 快速開始

方法一：本地開發模式（推薦）

方法二：Docker 部署

方法三：直接執行

🌐 服務訪問

📊 主要功能

1. 即時黃金價格監控

2. 智能市場情感分析

3. 技術指標分析

核心指標

增強功能 (v2.2.1)

4. 郵件發送系統

🔧 API 接口

核心 API

數據格式範例

黃金價格 API 回應

N8N 數據格式

郵件發送請求

📋 環境配置

必需環境變數

可選環境變數

🐳 Docker 部署

使用 Docker Compose

使用 Dockerfile

Docker Compose 服務

📊 監控與日誌

查看服務狀態

系統統計

📈 技術指標詳細說明

趨勢箭頭系統

移動平均線分析

交叉信號檢測

乖離率分析

RSI14 指標

轉折點分析

🔧 開發指南

本地開發環境

檔案結構

依賴套件

🛠️ 故障排除

常見問題

1. 服務無法啟動

2. 黃金價格無法獲取

3. N8N 連接失敗

4. 郵件發送失敗

效能優化

1. 記憶體使用優化

2. 快取配置

3. 日誌輪轉

📞 技術支援

日誌位置

健康檢查

備份與恢復

🔄 版本更新

更新到最新版本

版本歷史

🤝 貢獻指南

開發流程

代碼規範

📄 授權條款

🙏 致謝

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages