🚀 EasyLink 支付平台 - SaaS 架構

從單一商戶系統升級為 SaaS 多租戶平台

🔗快速鏈接

🎛️ 代理商門戶 (Agent Portal)

🔗 Agent Portal 主頁

代理商控制台，查看旗下商戶業績

upay-saas.jkdcoding.com

🔐 Agent 登入

代理商登入頁面

upay-agent.jkdcoding.com

📝 商戶入網申請

提交新商戶申請（5步驟表單）

upay-newapp.jkdcoding.com/new-application.html

🐔 King Chicken 商戶系統

💳 KC 支付頁面

客戶付款入口

king-chicken.jkdcoding.com

🔐 KC 管理後台登入

商戶管理員登入

king-chicken.jkdcoding.com/login.html

📊 KC 交易記錄

查看所有交易、篩選、導出

king-chicken.jkdcoding.com/admin.html

📈 KC 管理者報告

WhatsApp 自動日報設置

king-chicken.jkdcoding.com/boss-report.html

🚚 KC 收款渠道管理

渠道列表、二維碼發送、業績統計

king-chicken.jkdcoding.com/drivers.html

🔌 API 與模板

⚡ Worker API 健康檢查

API 狀態檢查端點

easylink-api-v2.jimsbond007.workers.dev/health

🧪 _dummy 商戶模板

標準化商戶模板示例

easylink-client-dummy.pages.dev

💡核心概念：平台架構

三級架構體系

EasyLink 採用 平台層 → 代理商層 → 商戶層 的三級架構，支持無限擴展。

代理商 Agent

Agent Portal

提交商戶申請
查看旗下業績

⬇️ 提交商戶資料

平台層 Platform

EasyLink SaaS

審核商戶資料
統一管理所有商戶

⬇️ 開通獨立商戶系統

商戶 A

King-Chicken 🐔

商戶 B

餐廳甲 🍜

商戶 C

零售店乙 🏪
⬇️ 共享統一平台能力

統一支付網關

Worker API

一個 Worker 服務所有商戶
銀聯通聯、支付寶、微信支付

✨近期優化更新 (2026年3月)

📅 2026-03-26 - 交易記錄與同步功能

  • ✅ EasyLink 訂單同步 - 新增批量同步功能，可從 EasyLink 查詢訂單最新狀態
  • ✅ Admin 頁面優化 - 訂單號欄位收窄、備註可點擊編輯、移除渠道統計卡片
  • ✅ 備註功能 - 交易記錄支持點擊編輯備註，失焦自動保存

📅 2026-03-26 - 渠道管理重構

  • ✅ 司機 → 渠道 - 「司機管理」改名為「收款渠道管理」
  • ✅ 統計卡片更新 - 渠道數量、今日總收款、今日總訂單
  • ✅ 表格欄位調整 - 渠道方/聯絡電話/訂單數量/收款總額/二維碼/備註
  • ✅ WhatsApp 發送二維碼 - 點擊按鈕直接發送渠道專屬二維碼
  • ✅ 日期篩選 - 支持選擇開始/結束日期篩選渠道業績

📅 2026-03-26 - 管理者報告增強

  • ✅ 收件人管理 - WhatsApp 報告收件人支持刪除功能
  • ✅ CloudWAPI 配置 - Sender 號碼更新為 85268810677
  • ✅ 中文消息修復 - 解決 UTF-8 編碼問題

📅 2026-03-26 - 支付體驗優化

  • ✅ 支付成功頁面 - 新增 payment-success.html，修復 404 問題
  • ✅ FRONTEND_URL 修復 - 更新為正確的商戶客戶端域名

📅 2026-03-25 - 數據庫修復

  • ✅ driverCode 字段 - 添加缺失的交易記錄字段
  • ✅ 交易記錄可見 - 修復 Admin 頁面無法顯示交易的問題

📁文件系統結構

Cloudflare 項目目錄

# Cloudflare 項目根目錄 C:\Users\Owner\Cloudflare\ │ ├── Easylink/ # SaaS 平台核心 │ ├── agent-portal/ # 代理商門戶 │ │ ├── index.html # 代理商控制台 │ │ ├── new-application.html # 商戶入網申請 │ │ └── login.html # 代理商登入 │ │ │ ├── super-admin/ # 平台超管後台 │ │ └── index.html # 管理所有代理商和商戶 │ │ ├── templates/ # 商戶模板 │ │ └── merchant-template/ # 基於 KC 的配置模板 │ │ ├── index.html # 支付頁面 │ │ ├── admin.html # 管理後台（含三TAB） │ │ ├── drivers.html # 渠道管理（原司機管理） │ │ └── config.js # 商戶配置文件 │ │ │ └── saas-platform-overview.html # 本說明文檔 │ ├── king-chicken-v2/ # King Chicken（首個商戶） │ ├── apps/ │ │ └── worker/ # 【共享】所有商戶共用 │ │ └── src/index.js # 統一 API Worker │ │ │ └── clients/ # 商戶客戶端實例 │ └── kingchicken/ # KC 專屬客戶端 │ ├── index.html # 支付頁面 │ ├── login.html # 登入頁 │ ├── admin.html # 交易記錄 │ ├── boss-report.html # 管理者報告 │ └── drivers.html # 渠道管理（原司機管理） │ ├── Upay/ # 對外品牌（Trade Name） │ └── # 推廣 EasyLink 服務時使用 │ └── .archive/ # 已歸檔舊項目 └── # kingchicken_OLD 等已棄用項目

📌 關鍵理解

  • clients\kingchicken = 商戶客戶端實例（Merchant Client Instance）
  • King Chicken 既是客戶又是標桿案例，用於開發新功能
  • 所有新商戶複製 templates\merchant-template 並修改配置
  • 所有商戶共享同一個 Worker API，數據在數據庫層隔離

🤝代理商（Agent）體系

代理商權限

  • ✓ 查看自己旗下所有商戶的業績和交易數據
  • ✓ 提交新商戶入網申請（上傳銀聯商務所需文件）
  • ✓ 查看自己的佣金收入和結算記錄
  • ✗ 不能查看其他代理商的商戶數據
  • ✗ 不能修改系統配置或費率

商戶入網流程

1️⃣

Agent 收集
商戶資料

→
2️⃣

在 Portal
提交申請

→
3️⃣

EasyLink
審核資料

→
4️⃣

審核通過
開通商戶

→
5️⃣

商戶開始使用
Agent 獲得佣金

⚠️King Chicken 業務邏輯說明

渠道管理（原司機管理）

King Chicken 是配送型業務，使用「渠道」概念管理各配送節點的收款。
每個渠道有獨立的二維碼，客戶掃描後自動關聯該渠道，便於月底結算。

其他商戶類型可根據業務調整此頁面：

📊平台能力指標

支持商戶數

∞

無限擴展

新商戶開通

1分鐘

複製模板+配置

代理商數

∞

獨立數據隔離

數據隔離

100%

商戶間完全隔離

📅升級實施計劃

1

Phase 1: KC 功能完善（已完成）

完成渠道管理、管理者報告、三TAB導航等功能。歸檔舊項目文件。

2

Phase 2: Agent Portal（已完成）

開發代理商門戶，支持商戶入網申請提交。基於銀聯商務要求設計表單。

3

Phase 3: EasyLink 同步（已完成）

實現從 EasyLink 批量同步訂單狀態，確保數據一致性。

4

Phase 4: _dummy 模板（進行中）

基於 KC 創建標準化商戶模板，提取可配置變量，編寫開通文檔。

5

Phase 5: 一鍵開通腳本

開發自動化腳本，實現：輸入商戶信息 → 自動生成客戶端 → 部署 → 開通。

6

Phase 6: 全面推廣

通過代理商網絡拓展商戶，目標 100+ 商戶接入平台。

🎯項目總結

架構設計優勢

  • 三級架構：平台 → 代理商 → 商戶，支持無限擴展
  • 數據隔離：代理商只能看到自己的商戶，商戶數據完全隔離
  • 模板復用：KC 作為標桿，新商戶 1:1 複製配置
  • 統一維護：一個 Worker 服務所有商戶，更新同步生效
  • 代理商賦能：Agent Portal 讓代理商自主提交申請，降低平台運營成本
  • 訂單同步：支持從 EasyLink 批量同步訂單狀態，確保數據一致性