分析指標綜合稽核文件 (已修正版)
重要修正說明
本文件已基於實際資料庫架構重新檢視和修正。先前版本包含了大量不存在的資料庫欄位和功能假設。
概述
本文件詳細列出電商管理平台中所有主要頁面的分析指標，基於實際存在的資料庫結構標記資料來源、計算公式和實作狀態。經過實際程式碼稽核，確認目前實作狀態為 Phase 1 (基礎資料展示階段)。
🔍 分析方法論
資料來源分類
- 🗄️ DB: 直接從資料庫查詢取得（已驗證存在）
- ⚙️ FE: 前端計算處理（基於已存在資料）
- 🔄 Hybrid: 混合模式（確認資料庫基礎數據存在）
- 📊 RPC: 使用資料庫函數（已驗證函數存在）
實作狀態標記（基於程式碼稽核）
- ✅ Verified: 已驗證實作並可運行
- 🚧 Partial: 部分資料存在，部分需前端處理
- ❌ Mock: 完全為前端模擬數據
- ⚠️ Missing: 依賴不存在的資料庫欄位
- 🔄 Planned: 規劃中但需資料庫擴展
🔍 實際資料庫架構驗證
✅ 確認存在的資料庫表格
核心業務表格:
orders- 主訂單表 (確認欄位: id, user_id, total_amount, status, created_at)order_items- 訂單明細表payments- 付款記錄表customers- 客戶資料表products- 產品目錄表inventory_logs- 庫存追蹤表conversations- 客服對話表messages- 聊天記錄表users- 用戶帳號表permissions- 權限系統表roles- 用戶角色表
確認存在的分析視圖:
conversation_summary_daily- 日對話統計conversation_week_hourly_heatmap- 客服時間分析agent_metrics- 客服人員績效agent_status_distribution- 客服狀態統計conversation_status_distribution- 對話狀態分析customer_ltv_metrics- 客戶終身價值product_inventory_status- 庫存狀態統計business_health_metrics- 業務健康度 KPIrevenue_by_campaign- 活動營收統計
確認存在的 RPC 函數:
get_order_basic_summary()- 訂單基礎統計get_customer_overview()- 客戶概覽get_inventory_overview()- 庫存概覽calculate_campaign_attributions()- 活動歸因分析mark_messages_as_read()- 訊息管理get_random_avatar_path()- UI 工具函數
❌ 不存在的欄位和表格
系統監控相關:
- ⚠️
uptime_seconds- 系統可用性時間 - ⚠️
response_time_ms- API 回應時間 - ⚠️
api_response_time_ms- API 效能監控
活動分析相關:
- ⚠️
cost- 活動成本欄位 - ⚠️
intensity_weight- 活動強度權重 - ⚠️
campaign_participations- 活動參與表 - ⚠️ 重疊分析相關表格
客服滿意度相關:
- ⚠️
satisfaction_score- 滿意度評分 - ⚠️
promoters_percentage- NPS 推薦者比例 - ⚠️
detractors_percentage- NPS 批評者比例
知識庫相關:
- ⚠️
kb_views- 知識庫瀏覽次數 - ⚠️
self_service_resolutions- 自助服務解決次數 - ⚠️
kb_helpfulness_score- 知識庫有效性評分
指標詳細分析（基於實際資料庫架構）
1. 營運總覽儀表板 (DashboardOverview.vue)
核心 KPI 指標
| 指標名稱 | 資料來源 | 處理方式 | 計算公式 | 實作狀態 | 相關模組 |
|---|---|---|---|---|---|
| 總營收 | 🗄️ DB | RPC + Fallback | SUM(orders.total_amount) WHERE status='completed' | ✅ | Orders, Payments |
| 訂單量 | 🗄️ DB | RPC + Fallback | COUNT(orders) WHERE date_range | ✅ | Orders |
| 活躍客戶 | 🗄️ DB | RPC + Fallback | COUNT(DISTINCT user_id) FROM orders WHERE recent | ✅ | Customers, Orders |
| 客戶滿意度 | ⚠️ Missing | Mock | ⚠️ satisfaction_score 欄位不存在 | ❌ | Support, Feedback (需實作) |
| 營收成長率 | 🔄 Hybrid | ⚙️ FE | (current_period - previous_period) / previous_period * 100 | 🚧 | Orders, Analytics |
| 目標達成率 | ⚙️ FE | ⚙️ FE | actual_revenue / target_revenue * 100 | 🚧 | Business Planning |
| 轉換率 | 🔄 Hybrid | ⚙️ FE | completed_orders / total_visits * 100 | 🚧 | Orders, Traffic |
| 客戶留存率 | 🔄 Hybrid | ⚙️ FE | returning_customers / total_customers * 100 | 🚧 | Customers |
即時監控指標
| 指標名稱 | 資料來源 | 處理方式 | 計算公式 | 實作狀態 | 相關模組 |
|---|---|---|---|---|---|
| 系統可用性 | ⚠️ Missing | Mock | ⚠️ uptime_seconds 欄位不存在 | ❌ | System Monitoring (需實作) |
| 平均載入時間 | ⚠️ Missing | Mock | ⚠️ response_time_ms 欄位不存在 | ❌ | Performance (需實作) |
| 線上用戶數 | 🗄️ DB | RPC | COUNT(DISTINCT user_id) FROM orders WHERE user_id IS NOT NULL | 🚧 | Users, Orders |
| 待處理訂單 | 🗄️ DB | RPC | COUNT(orders) WHERE status='pending' | ✅ | Orders |
| 營收效率 | ⚙️ FE | ⚙️ FE | (completion_rate + retention_rate) / 2 | ✅ | Orders, Customers |
2. 活動分析系統 (CampaignAnalyticsView.vue)
總覽分析指標
| 指標名稱 | 資料來源 | 處理方式 | 計算公式 | 實作狀態 | 相關模組 |
|---|---|---|---|---|---|
| 活動總營收 | 🔄 Planned | Mock | ⚠️ campaign revenue tracking 需實作 | ❌ | Campaigns, Orders (需實作) |
| 活動ROI | ⚠️ Missing | Mock | ⚠️ cost 欄位不存在，無法計算 ROI | ❌ | Campaigns, Finance (需實作) |
| 參與用戶數 | ⚠️ Missing | Mock | ⚠️ campaign_participations 表不存在 | ❌ | Campaigns, Users (需實作) |
| 轉換率 | ⚠️ Missing | Mock | ⚠️ conversions/impressions 數據不存在 | ❌ | Campaigns, Analytics (需實作) |
歸因分析指標
| 指標名稱 | 資料來源 | 處理方式 | 計算公式 | 實作狀態 | 相關模組 |
|---|---|---|---|---|---|
| 首次接觸歸因 | 📊 RPC | RPC | get_first_touch_attribution() | ✅ | Attribution, Campaigns |
| 最後接觸歸因 | 📊 RPC | RPC | get_last_touch_attribution() | ✅ | Attribution, Campaigns |
| 線性歸因 | 📊 RPC | RPC | distribute_credit_equally() | ✅ | Attribution, Campaigns |
| 時間衰減歸因 | 📊 RPC | RPC | apply_time_decay_weights() | ✅ | Attribution, Campaigns |
3. 客服支援分析 (SupportAnalyticsView.vue)
工單效能指標
| 指標名稱 | 資料來源 | 處理方式 | 計算公式 | 實作狀態 | 相關模組 |
|---|---|---|---|---|---|
| 平均回應時間 | 🗄️ DB | API | AVG(first_response_time_minutes) | ✅ | Support |
| 平均解決時間 | 🗄️ DB | API | AVG(resolution_time_hours) | ✅ | Support |
| 首次解決率 | 🗄️ DB | API | first_contact_resolutions / total_tickets * 100 | ✅ | Support |
| 工單積壓量 | 🗄️ DB | API | COUNT(*) WHERE status IN ('open', 'pending') | ✅ | Support |
滿意度分析
| 指標名稱 | 資料來源 | 處理方式 | 計算公式 | 實作狀態 | 相關模組 |
|---|---|---|---|---|---|
| 客服滿意度 | ⚠️ Missing | Mock | ⚠️ satisfaction_score 欄位不存在 | ❌ | Support, Feedback (需實作) |
| 滿意度趨勢 | ⚠️ Missing | Mock | ⚠️ 基於不存在的滿意度數據 | ❌ | Support, Analytics (需實作) |
| NPS 分數 | ⚠️ Missing | Mock | ⚠️ promoters/detractors 數據不存在 | ❌ | Support, Feedback (需實作) |
| 滿意度分佈 | ⚠️ Missing | Mock | ⚠️ satisfaction score 數據不存在 | ❌ | Support (需實作) |
知識庫效能
| 指標名稱 | 資料來源 | 處理方式 | 計算公式 | 實作狀態 | 相關模組 |
|---|---|---|---|---|---|
| 知識庫使用率 | ⚠️ Missing | Mock | ⚠️ kb_views 欄位不存在 | ❌ | Knowledge Base (需實作) |
| 自助解決率 | ⚠️ Missing | Mock | ⚠️ self_service_resolutions 欄位不存在 | ❌ | Knowledge Base, Support (需實作) |
| 熱門問題排行 | ⚠️ Missing | Mock | ⚠️ knowledge base tracking 不存在 | ❌ | Knowledge Base (需實作) |
| 知識庫滿意度 | ⚠️ Missing | Mock | ⚠️ kb_helpfulness_score 欄位不存在 | ❌ | Knowledge Base, Feedback (需實作) |
🔄 實際架構狀態分析
✅ 實際已完成 (Phase 1)
- 基礎 CRUD 操作: 核心業務表格的資料讀取和展示
- 簡單聚合查詢: 基本的 COUNT、SUM、AVG 統計
- 部分 RPC 函數:
get_order_basic_summary()等基礎分析函數 - 前端資料處理: 基於真實資料的前端計算和格式化
❌ 實際缺失 (誤判為已完成)
- 系統監控數據: uptime_seconds、response_time_ms 等欄位不存在
- 活動成本追蹤: cost、intensity_weight 等欄位不存在
- 客戶滿意度系統: satisfaction_score 等欄位不存在
- 知識庫分析: kb_views、self_service_resolutions 等功能不存在
- 複雜歸因分析: 大部分歸因邏輯需要額外資料庫表格支援
🔄 需要實際實作 (Phase 2)
- 資料庫表格擴展: 新增監控、成本、滿意度等必要欄位
- 分析視圖建立: 建立複雜分析所需的資料庫視圖
- RPC 函數開發: 實作進階分析邏輯的資料庫函數
- 資料收集機制: 建立系統效能、使用者行為等資料收集
🚨 緊急修正行動項目
立即改正 (1 週內)
- 更新前端組件: 移除所有依賴不存在欄位的显示邏輯
- 修正 API 服務: 更新 fallback 邏輯，回傳適當的缺失值處理
- 更新文件: 修正所有分析相關文件中的不實採統
- 測試驗證: 確保所有分析頁面可正常運行
短期規劃 (2-4 週)
- 資料庫架構擴展: 新增必要的監控和滿意度欄位
- 基礎分析功能: 實作真正的成長率計算和比較邏輯
- 資料收集機制: 建立系統效能和使用者行為追蹤
- 分析視圖建立: 建立更多預計算的分析視圖
中長期目標 (2-6 月)
- 完整活動分析系統: 包含成本追蹤和 ROI 計算
- 客服滿意度系統: 完整的滿意度調查和分析機制
- 知識庫分析: 自助服務效能的詳細追蹤
- 進階預測分析: 流失預測、需求預測等 ML 模型
文件版本: v2.0-CORRECTED | 最後更新: 2025-07-29 | 更新者: Database Schema Verification