docs: 補入 docs/external+guides+memory 目錄至版控

包含:
- docs/external/aiops_saas.md
- docs/guides/deployment_sop.md / devops_handbook.md / google_drive_setup.md
- docs/memory/credentials_passbook.md / history_logs.md

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
ogt
2026-04-19 16:31:50 +08:00
parent fb0dad2289
commit 19342a0044
6 changed files with 233 additions and 0 deletions

View File

@@ -0,0 +1,37 @@
# 🚀 EwoooC 部署標準作業程序 (SOP)
> **版本日期**: 2026-04-18 (依 ADR-008 修訂)
> **目標主機**: `ollama@192.168.0.188` (經 `192.168.0.110` 跳板)
## 🛠️ 開發同步流程
由於正式環境使用 Docker Compose + Volume Mount部署邏輯如下
### 1. 本地開發與測試
在 Mac 本地完成功能開發,並確認 `./app.py` 執行無誤。
### 2. 同步程式碼 (SCP)
使用 110 作為跳板機,將本地檔案推送至 188 正式目錄:
```bash
# 同步單一檔案
scp -o ProxyJump=wooo@192.168.0.110 app.py ollama@192.168.0.188:/home/ollama/momo-pro/
# 同步目錄
scp -o ProxyJump=wooo@192.168.0.110 -r services/ ollama@192.168.0.188:/home/ollama/momo-pro/
```
### 3. 重啟容器
檔案進入掛載目錄後,重啟容器以加載變更:
```bash
ssh -J wooo@192.168.0.110 ollama@192.168.0.188 "docker restart momo-pro-system"
```
## 🏗️ 重大變更 (Rebuild)
若修改了 `Dockerfile` 或新增了 `requirements.txt` 套件:
```bash
ssh -J wooo@192.168.0.110 ollama@192.168.0.188 "cd /home/ollama/momo-pro && docker compose build momo-app && docker compose up -d momo-app"
```
## 🔍 維運指令
- **查看日誌**: `docker logs -f momo-pro-system --tail 100`
- **進入資料庫**: `docker exec -it momo-db psql -U momo -d momo_analytics`
- **檢查磁碟**: `df -h`

View File

@@ -0,0 +1,56 @@
# EwoooC 運維與自動化手冊 (DevOps Handbook)
## 🌐 伺服器連線
| 環境 | 主機 | 指令 |
|---|-|---|
| **正式 (EwoooC)** | 192.168.0.188 | `ssh -J wooo@192.168.0.110 ollama@192.168.0.188` |
| **周邊 (UAT)** | 192.168.0.110 | `ssh wooo@192.168.0.110` |
| **安全 (Kali)** | 192.168.0.112 | `ssh kali@192.168.0.112` |
---
## 🐋 Docker & Docker Compose 指令 (188 主機)
執行路徑:`/home/ollama/momo-pro`
### 常用操作
- **查看狀態**: `docker ps | grep momo`
- **查看日誌**: `docker logs -f momo-pro-system --tail 100`
- **重啟主應用**: `docker restart momo-pro-system`
- **全面啟動**: `docker compose up -d`
- **進入資料庫**: `docker exec -it momo-db psql -U momo`
### 影像管理
- **重建影像**: `docker compose build --no-cache momo-pro-system`
- **清理過期資源**: `docker system prune -f`
---
## 🌐 Nginx 反向代理 (110 主機)
配置路徑:`/etc/nginx/sites-enabled/momo`
- **重新載入**: `sudo systemctl reload nginx`
- **語法檢查**: `sudo nginx -t`
---
## 🤖 n8n 工作流程管理 (188 主機)
- **進入容器**: `docker exec -it n8n /bin/sh`
- **手動執行 Workflow**: `docker exec n8n n8n execute --id=<workflow_id>`
- **列出 Workflow**: `docker exec n8n n8n list:workflow`
---
## ❄️ K8s 相關指令 (已撤除,備份存檔)
- **查看 Pod**: `kubectl get pods -n momo`
- **重啟 Deployment**: `kubectl rollout restart deployment/momo-app -n momo`
- **查看日誌**: `kubectl logs -f deployment/momo-app -n momo`
---
## 🏥 健康檢查與自動修復
**監控腳本**: `/home/wooo/scripts/domain-health-monitor.sh` (於 110 執行)
**頻率**: 每 5 分鐘
- `https://mo.wooo.work/health` -> 200
- `https://momo.wooo.work/health` -> 200
- `https://monitor.wooo.work/` -> 200
- `https://registry.wooo.work/v2/` -> 401

View File

@@ -0,0 +1,32 @@
# Google Drive API 設定指南
## 📋 功能說明
系統自動化流程:
1. **每 30 分鐘**檢查 Google Drive `當日業績匯入` 資料夾。
2. **自動下載** `即時業績_當日.xlsx`
3. **自動匯入** 至資料庫 `daily_sales_snapshot`
4. **歸檔** 原始檔案。
---
## 🔑 認證資訊庫
| 項目 | 值 |
|-----|-----|
| Google Cloud 專案名 | `wooo-481204` |
| Client ID | `132823079326-h9cvj5eahigm8hp9q0b7t5rk77bhu3gp...` |
| 認證帳號 | `owen.tsai@gmail.com` |
---
## 🛠️ 首次認證步驟
`config/google_token.pickle` 遺失或過期,執行以下指令:
```bash
python3 -c "from services.google_drive_service import drive_service; drive_service.authenticate()"
```
執行後會彈出瀏覽器要求授權。
---
## 📁 資料夾結構要求
Google Drive 根目錄必須存在:
`我的雲端硬碟/業績報表/當日業績/`