電商儀表板文檔

主題

缺失資料庫物件分析報告 ​

分析時間：2025-08-17
目的：比對 API 服務使用的資料庫物件與 final_consolidated_migration.sql 的差異

分析結果總覽 ​

✅ 已存在的表 (31個) ​

  • users, roles, user_roles, permission_groups, customers
  • categories, products, inventories, inventory_logs, inventory_adjustments
  • orders, order_items, rfm_segment_mapping, rfm_scores
  • dim_date, holidays, campaigns, layered_attribution_config, attribution_rules
  • conversations, messages, tickets
  • notification_templates, notification_routing_rules, notification_distributions, notification_recipients, notifications
  • ai_system_config, ai_providers, ai_prompt_templates, ai_prompt_provider_configs, ai_usage_logs
  • alert_configs, alert_logs, events, funnel_events, user_sessions
  • permissions, role_permissions, system_settings, default_avatars

✅ 已修復的表 (1個) ​

  • payments - 被 OrderAnalyticsZeroExpansionService.ts 使用 ✅ 已新增

🔍 ✅ 已修復的視圖分析 ​

✅ 產品與庫存視圖 (2個) - 已完成 ​

  1. product_with_current_stock ✅ 已建立

    • 使用檔案：ProductApiService.ts
    • 用途：產品含庫存資訊查詢
    • 狀態：完成實現，包含庫存狀態判斷邏輯

  2. product_inventory_status ✅ 已建立

    • 使用檔案：ProductApiService.ts
    • 用途：產品庫存狀態檢查
    • 狀態：完成實現，包含警報等級判斷

✅ 客戶分析視圖 (3個) - 已完成 ​

  1. customer_details ✅ 已建立

    • 使用檔案：CustomerApiService.ts
    • 用途：客戶詳細資訊展示
    • 狀態：完成實現，整合 RFM 分析和訂單統計

  2. customer_rfm_lifecycle_metrics ✅ 已建立

    • 使用檔案：CustomerApiService.ts
    • 用途：客戶 RFM 生命週期分析
    • 狀態：完成實現，包含生命週期階段和建議行動

  3. customer_ltv_metrics ✅ 已建立

    • 使用檔案：CustomerApiService.ts
    • 用途：客戶終身價值分析
    • 狀態：完成實現，包含歷史價值和預估年度價值

✅ 活動分析視圖 (4個) - 已完成 ​

  1. revenue_attribution_analysis ✅ 已建立

    • 使用檔案：CampaignAnalyticsApiService.ts
    • 用途：營收歸因分析
    • 狀態：完成實現，支援多種歸因模型

  2. campaign_collaboration_analysis ✅ 已建立

    • 使用檔案：CampaignAnalyticsApiService.ts
    • 用途：活動協作分析
    • 狀態：完成實現，分析活動重疊效果

  3. campaign_overlap_calendar ✅ 已建立

    • 使用檔案：CampaignAnalyticsApiService.ts
    • 用途：活動重疊日曆
    • 狀態：完成實現，提供日曆視圖和競爭強度分析

  4. campaign_performance_enhanced ✅ 已建立

    • 使用檔案：CampaignAnalyticsApiService.ts
    • 用途：活動效果增強分析
    • 狀態：完成實現，包含前期/後期效果比較和效果模式分析

✅ 客服支援視圖 (7個) - 已完成 ​

  1. conversation_details ✅ 已建立

    • 使用檔案：ConversationApiService.ts
    • 用途：對話詳細資訊
    • 狀態：完成實現，整合客戶、代理和工單資訊

  2. conversation_summary_daily ✅ 已建立

    • 使用檔案：SupportAnalyticsApiService.ts, DashboardApiService.ts
    • 用途：客服每日統計
    • 狀態：完成實現，提供完整日統計指標

  3. conversation_week_hourly_heatmap ✅ 已建立

    • 使用檔案：SupportAnalyticsApiService.ts
    • 用途：客服週時段熱圖
    • 狀態：完成實現，按星期和小時統計對話活躍度

  4. agent_metrics ✅ 已建立

    • 使用檔案：SupportAnalyticsApiService.ts
    • 用途：客服人員指標
    • 狀態：完成實現，包含解決率、響應時間等關鍵指標

  5. agent_status_distribution ✅ 已建立

    • 使用檔案：SupportAnalyticsApiService.ts
    • 用途：客服狀態分布
    • 狀態：完成實現，提供可用性狀態和工作負載分析

  6. conversation_status_distribution ✅ 已建立

    • 使用檔案：SupportAnalyticsApiService.ts
    • 用途：對話狀態分布
    • 狀態：完成實現，按日期和狀態統計對話分佈

  7. agent_details ✅ 已建立

    • 使用檔案：AgentApiService.ts
    • 用途：客服人員詳細資訊
    • 狀態：完成實現，整合對話統計和效能指標

✅ 訂單分析視圖 (1個) - 已完成 ​

  1. order_basic_funnel_analysis ✅ 已建立
    • 使用檔案：DashboardApiService.ts
    • 用途：訂單基礎漏斗分析
    • 狀態：完成實現，提供轉換率和履行率分析

✅ 用戶管理視圖 (1個) - 已完成 ​

  1. user_details ✅ 已建立
    • 使用檔案：UserApiService.ts
    • 用途：用戶詳細資訊
    • 狀態：完成實現，整合角色資訊和訂單統計

✅ 已存在的視圖 (2個) ​

  • user_notifications_unified
  • user_active_notifications

✅ 已修復的 RPC 函數分析 ​

✅ 產品與庫存函數 (2個) - 已完成 ​

  1. get_product_overview ✅ 已實現

    • 使用檔案：ProductApiService.ts
    • 用途：取得產品概覽統計
    • 狀態：完成實現，提供完整產品統計和庫存價值計算

  2. get_inventory_overview ✅ 已實現

    • 使用檔案：ProductApiService.ts, DashboardApiService.ts
    • 用途：取得庫存概覽統計
    • 狀態：完成實現，包含庫存統計和價值分析

✅ 客戶分析函數 (2個) - 已完成 ​

  1. get_customer_overview ✅ 已實現

    • 使用檔案：DashboardApiService.ts
    • 用途：取得客戶概覽統計
    • 狀態：完成實現，整合 RFM 分群和客戶價值分析

  2. get_customer_analysis ✅ 已實現

    • 使用檔案：CustomerApiService.ts
    • 用途：取得客戶分析資料
    • 狀態：完成實現，支援分群分析和生命週期分析

✅ 訂單分析函數 (2個) - 已完成 ​

  1. get_order_basic_summary ✅ 已實現

    • 使用檔案：DashboardApiService.ts
    • 用途：取得訂單基本統計
    • 狀態：完成實現，提供綜合訂單統計和支付方式分析

  2. calculate_campaign_attributions ✅ 已實現

    • 使用檔案：CampaignAnalyticsApiService.ts
    • 用途：計算活動歸因
    • 狀態：完成實現，支援多種歸因模型（首次接觸、最後接觸、線性）

✅ 客服支援函數 (1個) - 已完成 ​

  1. assign_specific_conversation ✅ 已實現
    • 使用檔案：AgentApiService.ts
    • 用途：分配特定對話
    • 狀態：完成實現，包含權限驗證和狀態更新

✅ 通知系統函數 (4個) - 已完成 ​

  1. get_suggestion_stats ✅ 已實現

    • 使用檔案：NotificationApiService.ts
    • 用途：取得建議統計
    • 狀態：完成實現，提供建議接受率和類型統計

  2. notify_role ✅ 已實現

    • 使用檔案：GroupNotificationApiService.ts
    • 用途：角色群組通知
    • 狀態：完成實現，支援角色篩選和批量通知

  3. notify_broadcast ✅ 已實現

    • 使用檔案：GroupNotificationApiService.ts
    • 用途：廣播通知
    • 狀態：完成實現，支援全用戶廣播功能

  4. notify_custom_group ✅ 已實現

    • 使用檔案：GroupNotificationApiService.ts
    • 用途：自訂群組通知
    • 狀態：完成實現，支援用戶ID陣列的自訂群組通知

✅ AI 系統函數 (7個) - 已完成 ​

  1. get_best_provider_config ✅ 已實現

    • 使用檔案：ai/AIPromptTemplateService.ts
    • 用途：取得最佳供應商配置
    • 狀態：完成實現，基於綜合評分選擇最佳 Provider

  2. clone_prompt_template ✅ 已實現

    • 使用檔案：ai/AIPromptTemplateService.ts
    • 用途：複製提示範本
    • 狀態：完成實現，支援模板和配置的完整複製

  3. update_config_performance_score ✅ 已實現

    • 使用檔案：ai/AIPromptTemplateService.ts
    • 用途：更新配置效能分數
    • 狀態：完成實現，支援效能、成本和品質分數更新

  4. ai_system_health_check ✅ 已實現

    • 使用檔案：ai/AIPromptTemplateService.ts
    • 用途：AI 系統健康檢查
    • 狀態：完成實現，提供系統狀態和使用統計

  5. ai_system_statistics ✅ 已實現

    • 使用檔案：ai/AIPromptTemplateService.ts
    • 用途：AI 系統統計
    • 狀態：完成實現，按 Provider 和模板分析使用趨勢

  6. ai_system_readiness_check ✅ 已實現

    • 使用檔案：ai/AIPromptTemplateService.ts
    • 用途：AI 系統就緒檢查
    • 狀態：完成實現，評估系統就緒程度和提供改進建議

  7. test_prompt_template_processing ✅ 已實現

    • 使用檔案：ai/AIPromptTemplateService.ts
    • 用途：測試提示範本處理
    • 狀態：完成實現，提供模板測試和驗證功能

✅ 已存在的函數 (1個) ​

  • update_updated_at_column

🎉 修復完成狀態 ​

✅ 已完成修復（100% 完成） ​

表: 1個 ✅ 全部完成

  • payments 表已新增，支援完整的支付流程管理

視圖: 18個 ✅ 全部完成

  • 產品與庫存視圖 (2個)：產品庫存整合查詢
  • 客戶分析視圖 (3個)：RFM 分析、生命週期、終身價值
  • 活動分析視圖 (4個)：歸因分析、協作分析、重疊日曆、效果增強
  • 客服支援視圖 (7個)：對話詳情、日統計、熱圖、代理指標
  • 訂單分析視圖 (1個)：漏斗分析
  • 用戶管理視圖 (1個)：用戶詳細資訊

函數: 18個 ✅ 全部完成

  • 產品與庫存函數 (2個)：產品概覽、庫存概覽
  • 客戶分析函數 (2個)：客戶概覽、客戶分析
  • 訂單分析函數 (2個)：訂單摘要、活動歸因計算
  • 客服支援函數 (1個)：對話分配
  • 通知系統函數 (4個)：建議統計、角色/廣播/群組通知
  • AI 系統函數 (7個)：配置管理、健康檢查、統計分析、模板測試

技術實現亮點 ​

核心業務功能增強 ​

  1. 完整的支付系統支援 - 支援多種支付方式和狀態管理
  2. 智慧庫存管理 - 自動庫存狀態判斷和警報等級
  3. 深度客戶分析 - RFM 分群、生命週期分析、終身價值計算
  4. 多維度活動分析 - 歸因模型、重疊分析、效果趨勢

分析能力提升 ​

  1. 客服效能分析 - 多時段熱圖、代理績效指標、工作負載分析
  2. 訂單轉換分析 - 完整漏斗分析和轉換率計算
  3. 用戶行為洞察 - 綜合用戶畫像和角色整合

🤖 AI 系統完整化 ​

  1. 智慧 Provider 選擇 - 基於效能、成本、品質的綜合評分
  2. 系統健康監控 - 完整的健康檢查和統計分析
  3. 模板管理 - 複製、測試、效能追蹤功能

通知系統增強 ​

  1. 多種通知模式 - 角色群組、廣播、自訂群組
  2. 建議統計分析 - 建議接受率和效果追蹤
  3. 完整權限控制 - 安全的通知分發機制

系統相容性驗證 ​

✅ API 服務完整支援 ​

  • ProductApiService.ts: 產品和庫存視圖/函數完整支援
  • CustomerApiService.ts: 客戶分析功能完整實現
  • DashboardApiService.ts: 核心統計函數全部就位
  • CampaignAnalyticsApiService.ts: 活動分析功能完整
  • SupportAnalyticsApiService.ts: 客服分析能力完整
  • NotificationApiService.ts: 通知統計功能完整
  • AI 相關服務: AI 系統管理功能完整

✅ 前端整合準備就緒 ​

  • 所有視圖提供標準化資料格式
  • 所有函數返回 JSONB 格式，便於前端處理
  • 完整的錯誤處理和參數驗證
  • 支援分頁、篩選、排序的標準介面

最終狀態總結 ​

修復物件統計：

  • ✅ 表：1個 (100% 完成)
  • ✅ 視圖：18個 (100% 完成)
  • ✅ 函數：18個 (100% 完成)
  • ✅ 總計：37個資料庫物件全部完成

🎉 migration 檔案現已與專案 API 需求完全相容，可直接投入生產使用！