全站功能導覽與端點地圖
此頁面整合儲能雲端平台之所有操作頁面、RESTful API 規格、物聯網遙測傳輸協定與即時案場捷徑,方便運維工程師與開發人員快速存取。
平台核心維運頁面
User Interface Layer即時監控儀表板
展示各案場即時高頻功率流動(太陽能發電、電池充放電、電網買賣電、負載)、電池 SoC 比例、即時趨勢曲線圖,並支援 Tesla Fleet API 遠端指令快速下控。
歷史資料分析中心
TimescaleDB 原生降採樣 (time_bucket) 時序分析,支援 1h/24h/7d/30d/自訂區間,呈現發電、耗電、SoC 長期趨勢、KPI 極值統計與 CSV 數據匯出。
案場與訊號管理中心
全站案場總覽、即時在線/離線 KPI 統計、站點新增與參數編輯。內建即時遙測訊號檢查器 (Inspector),可檢視最新遙測 Payload、時間延遲與 Tesla Fleet 審計日誌。
系統超級後台 (Django Admin)
管理員數據庫直營介面。可管理資料表結構、使用者權限、案場中繼資料(Site 模型)、Tesla 下控紀錄(CommandLog 模型)與系統群組安全驗證。
核心 RESTful API 服務地圖
API Gateway & EndpointsTCP 10002
| 方法 | 端點路徑 | 模組名稱 | 功能說明 | 操作 |
|---|---|---|---|---|
| GET | /api/v1/health/ | 系統健康度 | 檢查 TimescaleDB 資料庫與 Redis 連線即時狀態 | 測試 |
| GET | /api/v1/sites/overview/ | 案場總覽 | 彙總全案場即時連線狀態、SoC %、最新遙測與功率總合 | 測試 |
| GET | /api/v1/sites/ | 案場清單 | 查詢所有註冊之儲能案場基本資料 (支援 POST 建立新案場) | 測試 |
| GET | /api/v1/telemetry/{site_id}/latest/ | 最新遙測快取 | 由 Redis 快取直接返回最新遙測封包 (延遲 < 1ms) | 測試(test) |
| GET | /api/v1/telemetry/{site_id}/history/ | 時序降採樣歷史 | 運用 TimescaleDB time_bucket 進行快速時序區間聚合 |
測試(5m) |
| GET | /api/v1/telemetry/{site_id}/recent_raw/ | 近期原始數據 | 獲取最新 50 筆無降採樣之原始高頻資料,供前端即時動態繪圖 | 測試(raw) |
| POST | /api/v1/fleet/{site_id}/backup_reserve/ | Tesla 遠端下控 | 設定 Powerwall 備份電量保留比率 (backup_reserve_percent: 0-100) | API Only |
| GET | /api/v1/sitemap/ | 站點地圖規格 | 輸出本平台之動態結構化站點與端點定義 (JSON 格式) | 測試 |
物聯網通訊拓撲與連接埠配置
Communication TopologyDaphne ASGI Web 服務
承載前端儀表板、RESTful API 與即時推播 WebSocket (`/ws/telemetry/{site_id}/`)。
MQTT Broker (TLS 加密)
現場 Android 網關與邊緣模擬器透過 One-Way TLS 加密連線發送高頻電力遙測 (`site/+/telemetry`)。
TimescaleDB (PostgreSQL 16)
時序 Hypertable (`telemetry_records`) 儲存歷史遙測,支援百萬級數據毫秒降採樣聚合。
Redis 7 & Channels Layer
快取案場最新遙測狀態 (`site:{id}:latest`),並作為 Django Channels 訊息廣播中繼層。