ClientPulse 📊

專為 PM 設計嘅客戶跟進 Dashboard - 唔再漏 follow-up！

✨ 功能

📊 Dashboard

• 一眼睇晒所有客戶狀態
• 今日跟進清單
• 逾期提醒（紅色警示）
• 快速統計數據

👥 客戶管理

• 新增/編輯/刪除客戶
• 狀態追蹤 (Active / Pending / On Hold / Closed)
• 優先級設定 (High / Normal / Low)
• 自訂標籤分類
• 多個聯絡人管理

📝 跟進記錄

• 記錄每次溝通（電話/Email/會議/備註）
• 設定下次跟進日期
• 標記完成狀態
• 時間軸顯示歷史

🔍 搜尋過濾

• 快速搜尋客戶名/公司
• 按狀態過濾
• 按優先級排序

🚀 快速開始

前置要求

• Docker & Docker Compose

一鍵啟動

# Clone repo
git clone https://github.com/Area2-HK-Limited/clientpulse.git
cd clientpulse

# 複製環境變數
cp .env.example .env

# 啟動服務
docker-compose up -d

# 打開瀏覽器
open http://localhost:3000

服務端口

服務	端口	用途
Frontend	3000	Nuxt Web UI
PostgREST	3001	REST API
PostgreSQL	5433	Database
Adminer	8080	DB Admin

🛠️ 技術架構

┌─────────────────────────────────────────┐
│             Nuxt 3 Frontend             │
│           + Nuxt UI Pro                 │
└─────────────────┬───────────────────────┘
                  │ REST API
                  ▼
┌─────────────────────────────────────────┐
│              PostgREST                   │
│         Auto-generated REST API          │
└─────────────────┬───────────────────────┘
                  │ SQL
                  ▼
┌─────────────────────────────────────────┐
│             PostgreSQL 15                │
│     + Views + Functions + Triggers       │
└─────────────────────────────────────────┘

Layer	Technology
Frontend	Nuxt 3 + Nuxt UI + Tailwind CSS
API	PostgREST (Auto REST from PostgreSQL)
Database	PostgreSQL 15
Deploy	Docker Compose

📁 項目結構

clientpulse/
├── docker-compose.yml      # 服務編排
├── .env.example            # 環境變數範本
├── README.md
├── docs/
│   └── DEVELOPMENT_PLAN.md
├── frontend/
│   ├── nuxt.config.ts
│   ├── Dockerfile
│   ├── app.vue
│   ├── pages/
│   │   ├── index.vue           # Dashboard
│   │   └── clients/
│   │       └── [id].vue        # 客戶詳情
│   ├── composables/
│   │   └── useApi.ts           # API wrapper
│   └── assets/
│       └── css/main.css
└── backend/
    └── sql/
        └── init.sql            # Database schema

📊 數據庫設計

Tables

• clients - 客戶資料
• contacts - 聯絡人（多對一）
• followups - 跟進記錄
• attachments - 附件

Views

• dashboard_stats - Dashboard 統計
• today_followups - 今日跟進
• overdue_followups - 逾期跟進
• client_summary - 客戶摘要

🎨 截圖

Dashboard

客戶詳情

🔮 未來計劃

Phase 2 - AI 增強

• 🤖 AI 生成跟進建議
• 📧 Email 整合（自動創建跟進）
• 📊 客戶情緒分析
• 📈 銷售預測

Phase 3 - 團隊協作

• 👥 多用戶支援
• 🔐 權限管理
• 📱 Mobile App
• 🔔 Push Notification

🤝 貢獻

歡迎 PR 同 Issue！

📄 License

MIT

---

Made with ❤️ by M01 for Eric @ Area2