CleanLink 潔客
Professional Cleaning Service Platform
專業清潔服務媒合平台
📱 LINE LIFF 🟣 Odoo 17 📲 React Native 🤖 AI 估價 💳 ECPay 金流
清潔產業三大痛點
傳統清潔服務的核心挑戰
💸
定價爭議
非標準化環境難以精確估價，清潔師與客戶對清潔範圍認知不一，付款後追加費用引發糾紛，退款流程繁瑣耗時。
✓ AI 照片估價
📋
人工派單
電話接單效率低，手動媒合無法兼顧距離、技能、時間等多維度，服務資訊靠口頭傳遞，無法追蹤進度。
✓ 智慧媒合引擎
🏦
金流結算
現金付款無法追蹤，佣金計算依賴人工，撥款流程不透明，清潔師收入不穩定，平台盈利難以量化。
✓ 自動分潤撥款
🚀
CleanLink 一站式解決方案
LINE LIFF 前端預約 × Odoo 後台管理 × ECPay 金流 × GPT-4o AI 估價，打造台灣清潔市場完整數位化閉環
平台運作全景圖
👤 客戶
1
選擇服務
↓
2
填寫地址
↓
3
選擇時段
↓
4
加購服務
↓
5
確認預約 →
↓
6
線上付款 →
12
客戶評價 →
🟣 平台 Odoo
5
建立工單
狀態：已確認
↓
7
← 付款確認
↓
8
智慧媒合 →
推播通知
11
← 服務完成
↓
12
收評價 ←
↓
13
佣金撥款 →
🧹 清潔師
8
← 接收通知
↓
9
接受工單 →
↓
10
GPS 打卡
到達 / 開始
↓
11
服務完成 →
13
收到撥款
💳 金流 ECPay
6
← 收款
信用卡/ATM
↓
7
回呼確認 →
13
← 撥款指令
→ 清潔師帳戶
平台架構
三端協同，REST API 互通
📱 客戶 LIFF
React + Vite PWALINE LIFF 環境，透過 LINE access token 認證，支援 iOS / Android
主要功能服務選擇 / 地址管理 / 日期時段 / 加購服務 / 確認付款 / 預約記錄 / 個人中心
通訊REST API → cl_customer_api (~22 端點)，X-Line-Access-Token header 認證
🟣 Odoo 17 後台
10 個自定義模組cl_base / cl_service / cl_booking / cl_matching / cl_payment / cl_line / cl_review / cl_estimation / cl_customer_api / cl_cleaner_api
PostgreSQL 16資料持久層，完整的預約、清潔師、金流、評價資料模型
整合外部服務LINE Webhook / ECPay 金流 / GPT-4o Vision AI 估價
📲 清潔師 APP
React Native (Expo SDK 52+)iOS + Android 雙平台，清潔師專屬行動應用
主要功能工單接單 / GPS 打卡 / 行程管理 / 收入查看 / 推播通知
通訊REST API → cl_cleaner_api (~14 端點)，JWT Bearer token 認證
REST API / JSON
LINE Webhook
ECPay Callback
客戶登入 / 註冊
LINE 帳號一鍵綁定，安全便捷
LIFF 登入
LIFF 註冊
🔐
LINE 帳號綁定 LIFF access token 自動取得 LINE UID，免帳號密碼直接登入，降低註冊門檻
📱
手機號碼驗證 新用戶首次登入需填入手機號碼建立帳號，與 LINE 身份雙重綁定
🛡️
安全機制 密碼 bcrypt 加密、Token 自動刷新、Session 過期保護、防暴力破解
🔄
自動登入 已綁定用戶開啟 LIFF 自動驗證 token，無需重複登入操作
Step 1：選擇清潔服務
6 種服務類型，涵蓋家庭各種清潔需求
服務選擇
服務類型 起始價格 預估時數 說明
🏠 居家定期清潔$1,2003-4h每週/隔週定期服務
✨ 深度清潔$2,5005-8h全屋徹底清潔
🚚 搬遷清潔$3,0004-6h入住前/搬出後清潔
🏢 辦公室清潔$1,8003-5h商辦環境清潔
🪟 窗戶清潔$8002-3h玻璃/紗窗專業清潔
🛁 廚衛深度清潔$1,5003-4h廚房+衛浴專項清潔
✓ 即時報價 ✓ 服務說明 ✓ 圖片展示
Step 2：服務地址管理
多地址儲存，房型資訊完整記錄
地址管理
📍
多地址儲存 家、辦公室、父母家等多個地址一鍵切換，無需重複輸入
🏢
樓層 / 坪數 / 電梯 詳細記錄樓層高度、實際坪數、電梯有無，影響報價計算
🏠
房型分類 套房、2房、3房、4房以上、辦公室等多種房型分類，精確定義清潔範圍
📸
現場照片上傳 可上傳現場環境照片，觸發 AI 估價功能，取得更精確的報價
Step 3：選擇日期時段
彈性時段選擇，依服務時數自動計算
日期時段
📅
日曆選擇介面 月曆視圖快速選擇日期，灰色日期表示已滿或不可預約，綠色高亮可選日
⏰
時段格網 每30分鐘一格，08:00–20:00 可選，顯示各時段清潔師可用數量
🕐
服務時數滑桿 依房型預估最少時數，客戶可調整 +1~+4 小時，加時費用即時顯示
🔔
前日提醒 預約確認後 LINE 推播服務提醒，服務前 24 小時再次通知
Step 4：加購項目
彈性加值，滿足個人化清潔需求
加值服務
🧺 洗烘衣服務（含烘乾）+$300
🛏️ 整理床鋪 / 更換床單+$200
🍳 廚房爐台深度清潔+$500
🚿 浴室全面消毒+$400
🪟 陽台清潔+$350
🐾 寵物毛髮特殊清潔+$250
🧴 環保清潔用品升級+$150
Step 5：確認預約與付款
透明費用明細，ECPay 安全付款
確認付款
🏠 居家定期清潔（3小時）$1,200
➕ 加購：廚房深度清潔$500
➕ 加購：更換床單$200
🎁 新客優惠 -10%-$190
💳 應付總額$1,710
💳 信用卡 🏧 ATM 轉帳 📱 LINE Pay
🔒
ECPay 綠界金流 PCI-DSS 合規，SSL 加密，付款後自動 Webhook 確認，工單狀態即時更新
預約紀錄管理
全程狀態追蹤，一覽所有預約
預約紀錄
全部
進行中
已完成
已取消
📌
即時狀態追蹤 草稿 → 已確認 → 已付款 → 已派單 → 進行中 → 已完成，每步驟 LINE 推播通知
📋
預約詳情 點擊查看服務地址、清潔師資訊、費用明細、支付憑證
⭐
服務完成後評價 5 星評分 + 文字評語，可上傳清潔前後對比照片
🔄
一鍵再次預約 歷史訂單快速複製，相同地址、服務、時段預設帶入
個人中心 + VIP 會員
分級會員制度，提升客戶忠誠度
個人中心
等級條件折扣專屬優惠
🥉 一般會員0 次起無生日優惠券
🥈 銀牌會員滿 5 次95 折優先派單
🥇 金牌會員滿 15 次9 折指定清潔師
💎 鑽石會員滿 30 次85 折24hr 客服
👤
個人資料管理 手機號碼、LINE 綁定、通知偏好、常用地址、付款方式、收據寄送設定
🎁
點數 / 優惠券 每次消費累積點數，可兌換折扣券，推薦好友再享回饋
管理後台：清潔師管理
完整的清潔師生命週期管理
Odoo — cl_base / Cleaners
清潔師列表
👥 清潔師總數管理 ⭐ 等級分級（初級/中級/高級/頂級） ✅ 審核狀態管理 📍 服務區域設定 🔧 技能標籤篩選 💰 個人佣金率
清潔師詳細資料
技能、區域、佣金完整設定
Odoo — cl_base / Cleaner Form
清潔師表單
🎓 技能標籤多選 🗺️ 服務區域（縣市/行政區） 💳 銀行帳戶資訊 📅 可用時段設定 📊 歷史接單統計 ⭐ 平均評分顯示
客戶管理 × 服務目錄
客戶資料庫 + 6 種服務類型設定
Odoo — cl_base / Customers
客戶列表
Odoo — cl_service / Service Types
服務類型
動態定價規則引擎
多維度定價，自動計算服務費用
Odoo — cl_service / Pricing Rules
定價規則
📐 按坪數定價 🏢 按樓層係數 🕐 時段加價（假日/夜間） ➕ 加購項目單獨計價 🎟️ 優惠券疊加計算 💎 VIP 等級折扣
預約工單看板
Kanban 可視化管理，7 個狀態欄位
Odoo — cl_booking / Bookings Kanban
預約看板
草稿
已估價
已確認
已付款
已派單
進行中
已完成
工單詳情
完整狀態機，工單全生命週期管理
Odoo — cl_booking / Booking Form
預約表單
📋 服務詳情完整記錄 👤 客戶 + 清潔師關聯 💳 付款狀態追蹤 📍 GPS 打卡時間 📸 清潔前後照片 📝 內部備注欄位
智慧媒合 × 金流管理
多維度媒合引擎 + ECPay 交易記錄
Odoo — cl_matching / Smart Matching
智慧媒合
Odoo — cl_payment / Transactions
金流管理
評價系統 × AI 估價 × 佣金管理
三大核心功能模組
cl_review — 評價系統
評價系統
⭐ 5 星評價系統
cl_estimation — AI 估價
AI 估價
🤖 GPT-4o AI 照片估價
cl_payment — 佣金管理
佣金管理
💰 自動佣金計算撥款
技術架構
現代化技術棧，可擴展架構設計
🐍 後端 Backend
Odoo 17 Python 3.10+ PostgreSQL 16 REST API Werkzeug ORM ir.cron
10 個自定義模組，完整業務邏輯封裝，PostgreSQL 全文搜尋，自動化定時任務
⚛️ 前端 Frontend
React 18 Vite TypeScript LINE LIFF SDK Expo SDK 52 React Native Zustand
LIFF PWA + Expo 雙前端，共用 TypeScript 型別，pnpm workspace monorepo 管理
🔌 整合 Integrations
ECPay 綠界 LINE Messaging API LINE Login LIFF Webhook HMAC-SHA256
ECPay CheckMacValue 驗簽，LINE Signature 驗證，Webhook 冪等性保障，自動重試
🤖 AI 人工智慧
GPT-4o Vision OpenAI API Prompt Engineering JSON Schema Structured Output
照片上傳 → Base64 編碼 → GPT-4o 分析 → 結構化報價輸出，準確率達 85%+
REST API 端點 (36+)
完整 RESTful 設計，支援前後端分離架構
📱 Customer API (22 端點) X-Line-Access-Token
POST/api/v1/auth/login
POST/api/v1/auth/register
GET/api/v1/services
GET/api/v1/services/{id}/addons
GET/api/v1/addresses
POST/api/v1/addresses
GET/api/v1/time-slots
POST/api/v1/bookings
GET/api/v1/bookings
GET/api/v1/bookings/{id}
POST/api/v1/bookings/{id}/payment
POST/api/v1/bookings/{id}/review
🧹 Cleaner API (14 端點) JWT Bearer
POST/api/v1/cleaner/login
GET/api/v1/cleaner/profile
PUT/api/v1/cleaner/availability
GET/api/v1/cleaner/jobs
GET/api/v1/cleaner/jobs/{id}
POST/api/v1/cleaner/jobs/{id}/accept
POST/api/v1/cleaner/jobs/{id}/checkin
POST/api/v1/cleaner/jobs/{id}/complete
GET/api/v1/cleaner/earnings
GET/api/v1/cleaner/schedule
POST/api/v1/line/webhook
POST/api/v1/ecpay/callback
實施路線圖
三階段漸進式開發，24 週完整上線
✅ 已完成
Phase 1 — MVP
Week 1–8
  • LINE LIFF 完整預約流程
  • ECPay 線上付款串接
  • Odoo 後台工單管理
  • LINE 訊息通知系統
  • 清潔師基本 APP
  • 手動派單功能
  • 客戶評價系統
🚧 開發中
Phase 2 — Growth
Week 9–16
  • GPT-4o AI 照片估價
  • 智慧媒合引擎升級
  • 清潔師 APP 完整功能
  • VIP 會員制度
  • 動態定價規則引擎
  • 自動佣金撥款
  • 數據分析看板
📋 規劃中
Phase 3 — Scale
Week 17–24
  • 訂閱制月租方案
  • 企業 B2B 服務
  • 多城市擴張
  • 清潔師培訓平台
  • 供應鏈管理（耗材）
  • Franchise 加盟管理
  • Open API 生態系
CleanLink 潔客
讓專業清潔，觸手可及
10
Odoo 模組
36+
REST API
22
UI 截圖
6
服務類型
LINE LIFF · Odoo 17 · React Native · GPT-4o · ECPay