Aile 生態系統說明檔案
一、Aile 生態概述
Aile 是一個基於微服務架構構建的雲端智慧商務服務平臺，部署於 GCP GKE 環境，面向個人商務人士與企業團隊，提供從「客戶溝通 → AI 客服 → 電子名片 → 積分支付 → 營銷增長」的完整商業閉環。
生態由三個層面共同構成：
- 底座（Aile）：多租戶客服 / 通訊底座，提供認證、訊息、租戶、服務號、群發、進線等核心能力。
- 平臺與應用層（AiPower / AiReach / Aiff / AileAI）：在底座之上以「租戶級整合應用」的標準模型擴充套件業務能力。
- 終端與入口（AiCard / FastBot / AileApp / AilePro / AileDesktop / Aiwow / WebChat）：面向使用者的產品矩陣與流量入口。
核心增長路徑
生態產品矩陣
| 產品 / 元件 | 定位 | 目標使用者 / 角色 |
|---|---|---|
| 🃏 AiCard | 病毒式傳播的電子名片，生態流量入口 | 商務人士、自由職業者 |
| 🤖 FastBot | AI 機器人訂閱式購買平臺 | 需要 AI 客服的個人或企業 |
| 📱 AileApp | 個人商務服務平臺（個人租戶） | 個人商務人士、小微企業主 |
| 💼 AilePro | 團隊商務協作平臺（團隊租戶） | 中小型企業團隊 |
| 🖥️ AileDesktop | 高效能桌面客戶端（Tauri + React） | 個人 / 團隊坐席 |
| 💬 WebChat SDK | 一行程式碼嵌入的網站智慧客 服 | 客戶網站嵌入 |
| 📲 Aiwow | 電子名片夾應用（客戶端） | 消費者、客戶 |
| 🔗 CRMGateway | 多渠道 + AI 服務統一整合閘道器 | 內部服務整合 |
| 💰 AiPool | 統一支付與點數管理系統 | 生態內支付 / 積分場景 |
| 🧠 AileAI | AI 編排域（Copilot / 多 Agent / RAG / MCP） | 生態內 AI 能力呼叫方 |
| 🧩 AiPower | Java 業務開發平臺（Unit + Flow），租戶級整合應用 | 應用開發 / 整合方 |
| 📣 AiReach | 生態首個 CRM 營銷應用（三件套） | 營銷運營團隊 |
| 🪄 Aiff (AIFF) | Aile 側前端整合框架（槽位 + endpoint 注入） | 外部 / 內部應用前端嵌入 |
二、生態分層全景架構
Aile 採用分層微服務架構，從認證到應用逐層解耦，並透過標準化整合邊界承載外部 / 內部應用。
架構分層說明
| 層級 | 職責 | 核心元件 |
|---|---|---|
| 🔐 統一認證層 | SSO 單點登入、JWT 簽發與驗證、第三方登入 | Authorization Server (AS) |
| ⚙️ 後端服務層 | 核心業務邏輯、積分交易、AI 能力、基礎功能 | NewAile Server、AiPool Server、AileAI、MCP |
| 🔀 BFF 聚合層 | 為不同前端提供定製化 GraphQL 介面 | AileBFF、AilePro BFF、Case BFF |
| 🌐 閘道器 / 整合層 | 多渠道訊息 / AI 路由；標準 OpenAPI 閘道器與 AIFF 註冊 | CRMGateway、aile-service-platform-integration |
| 🧩 應用與平臺層 | 以租戶級整合應用模型擴充套件業務能力 | AiPower、AiReach、Aiff |
| 📱 終端應用層 | 面向使用者的終端應用 | AileApp、AilePro、AileDesktop、WebChat |
| 📡 渠道層 | 社交媒體與第三方渠道接入 | Line、Facebook、Instagram、WeChat |
後端微服務叢集
| 叢集 | 職責 | 主要微服務 |
|---|---|---|
| NewAile Server | 核心業務 | admin / application / integration / user / card / event / invite + 閘道器 |
| AiPool Server | 積分與交易 | auth / activity / goods / job / tenant / notice / point / transaction + 閘道器 |
| MCP Server | 基礎功能 / AI 外部整合 | 人臉識別物聯模組、其他應用模組 |
三、核心技術棧
後端技術
| 領域 | 技術選 型 | 用途 |
|---|---|---|
| 認證框架 | Spring Boot 3.x + Spring Authorization Server | OAuth 2.0 / OIDC 標準認證 |
| API 層 | GraphQL（Apollo） | BFF 前後端通訊 |
| 實時通訊 | GraphQL Subscriptions / Socket.io | 訊息推送、狀態同步 |
| 主資料庫 | Cloud SQL for PostgreSQL | 持久化業務資料 |
| 快取 / 佇列 | Memorystore for Redis | 快取、OTP、Token 黑名單、優先順序佇列 |
| Token | JWT (RS256) | 統一認證 Token，30 天有效期 |
前端技術
| 領域 | 技術選型 | 用途 |
|---|---|---|
| UI 框架 | React 18 + TypeScript | 現代化前端開發 |
| 元件庫 | Radix UI | 無樣式可訪問元件 |
| 樣式方案 | TailwindCSS | 實用優先的 CSS |
| 狀態管理 | Apollo Client | GraphQL 狀態管理 |
| 構建工具 | Vite | 快速構建與熱更新 |
| 桌面框架 | Tauri (Rust) | 輕量級桌面應用（替代 Electron） |
基礎設施與運維
| 領域 | 技術選型 |
|---|---|
| 容器編排 | Google Kubernetes Engine (GKE) |
| 映象倉庫 | Google Artifact Registry |
| 金鑰管理 | Google Secret Manager |
| CI/CD | GitLab CI |
| 日誌 / 監控 | GCP Cloud Logging + Cloud Monitoring + OpenTelemetry |
| 可觀測性 | SLO/SLI 體系 + 分級告警 + Runbook |
四、Aile 生態核心特點
4.1 微服務架構，模組化發展
各服務獨立部署、獨立擴充套件，透過閘道器與 BFF 實現松耦合。新增服務或渠道只需接入閘道器層，無需改動已有服務。
4.2 統一認證，單點登入
獨立授權伺服器（AS）基於 OAuth 2.0 + OIDC 標準，為所有生態應用提供統一的 SSO 認證。支援手機號 + OTP 和四大平臺第三方登入（Line / Facebook / Google / Apple），並透過懶遷移策略實現舊系統使用者無感遷移。AS 是獨立服務，不等同於 aile-service-* 業務套件。
4.3 BFF 模式，多端適配
採用 GraphQL BFF（Backend for Frontend）模式，為移動端、桌面端、Web 端提供各自最佳化的介面聚合層，前後端完全解耦。
4.4 多渠道統一接入
透過 CRMGateway 統一管理 Line、Facebook、Instagram、WeChat、WebChat 等多渠道訊息，實現一個服務號管理所有渠道的統一體驗。
4.5 標準化應用整合模型
透過 platform-integration 閘道器、IntegrationApp 註冊、TenantIntegration 安裝握手、標準事件分發與 AIFF 前端嵌入，把 AiPower、AiReach 等應用以**「平臺對應用」**的可複用模型接入，而非一次性硬編碼對接。
4.6 AI 能力深度整合
- AI 輔助：坐席端 AI 建議，輔助客服人員回覆
- AI 諮詢：客戶端 AI 自動對話
- 分身 / 虛擬員工 / 助手：AI 驅動的智慧服務角色
- AileAI 編排域：Copilot 對話編排、多 Agent / skills、RAG 知識檢索、MCP 聯結器與流式輸出
- FastBot 提供機器人訂閱購買，可掛接到任意服務號
4.7 商務電子名片引流閉環
以商務電子名片作為流量入口，透過免費版→專業版的分級策略，結合推薦獎勵和 NFC 實體卡片，實現病毒式傳播，逐步引導使用者進入 Aile 生態。
4.8 統一支付與積分體系
AiPool 提供跨產品的統一支付平臺，支援點加金支付模式。Aile 點（個人積分）可充值為功能點（租戶功能額度），打通 Aiwow、Aile、AiPool 三端資料。
4.9 桌面端高效能方案
新版 AileDesktop 採用 Tauri + Rust 替代 Electron，應用體積從 150MB 降至 15MB 以下，記憶體佔用從 200-500MB 降至 80MB 以下，啟動速度 < 1 秒。
4.10 SLO 驅動的可觀測性
基於 OpenTelemetry 建設完整的監控體系，包括指標定義、告警規範、Runbook 故障手冊，確保系統高可用。
五、核心服務與 產品詳解
5.1 🔐 Authorization Server (AS) — 統一授權伺服器
核心職責：
- 身份認證：手機號 + OTP 驗證、第三方登入（Line / Facebook / Google / Apple）
- 賬號管理：管理使用者賬號及第三方賬號繫結關係
- Token 簽發與驗證：RS256 簽名的 JWT Token（30 天有效期）
- 懶遷移：使用者首次登入時自動從舊系統遷移，保持原有 accountId 不變
關鍵設計：資源伺服器透過 JWKS 公鑰本地驗證 Token，結合 Redis 快取實現高效能認證；OTP 防刷限制（單號每小時 ≤ 5 次，連續失敗 5 次鎖定 1 小時）。
5.2 ⚙️ NewAile Server — 核心業務服務
承載生態的核心業務能力：admin（管理）、application（應用）、integration（整合）、user（使用者）、card（名片）、event（事件）、invite（邀請）等微服務，並透過自身閘道 器對外提供能力。是服務號、租戶、聊天室、歸戶、群發、進線等業務的底座。
5.3 🔗 CRMGateway — 多渠道整合閘道器
雙重職責：
- 多渠道進線 Gateway：Line / Facebook / IG / WebChat → Aile / AileAI
- AI 服務 Gateway：內部 AI 諮詢請求 → AileAI
已完成：訊息格式多渠道整合、AI 訊息串接、AI 輔助 / 諮詢支援、穩定性最佳化與監控。
5.4 💬 WebChat SDK — 智慧客服嵌入元件
核心功能：極簡整合（loader.js < 5KB）、監控引擎（停留時長 / 滾動深度 / 使用者互動判定並主動彈出話術氣泡）、iframe 隔離的浮動視窗、進線原因追蹤、對外 API（AileWebChat('open'/'close'/'sendMessage'/'setReason'/'on')）。
架構特點：SDK 核心層與 WebChat React 應用透過 iframe + postMessage 隔離通訊；監控規則由管理臺配置、SDK 本地採集；規則級去重、優先順序衝突處理、開啟後自動暫停監控。
5.5 💰 AiPool — 統一支付與點數平臺
整合模式：Aile 產品呼叫 AiPool API 生成訂單 → 返回支付 URL → 使用者完成點加金支付 → AiPool 回撥通知支付狀態。
支援場景：FastBot 訂閱購買、AileApp / AilePro 套餐購買、單次功能購買、AiCard 名片購買。
微服務模組：auth / activity / goods / job / tenant / notice / point / transaction。
5.6 🧠 AileAI — AI 編排域
承接 Copilot 對話編排、多 Agent / skills、RAG 知識檢索（租戶隔離）、MCP 聯結器（Notion / Confluence / Drive / GitHub）與流式輸出。不直接拼 SQL、不越權，只能經應用 Tool API 取數、經 RAG / MCP 取知識。對接 AiPool、NewAile、MCP 等內部服務，以及 AiPower 等外部應用。
5.7 🧰 MCP Server — 基礎功能服務
讓 AI 整合外部應用的基礎功能服務層，包含人臉識別物聯模組 及其他可擴充套件應用模組。
5.8 🧩 AiPower — Java 業務開發平臺
定位：AiPower 被定義為 Aile 生態中的租戶級整合應用。提供單元（Unit）與流程（Flow）的快速建制、欄位建模、事件掛鉤、排程、AI 能力、賬號體系、多租戶隔離等能力。
整合邊界：
- Aile 平臺負責：應用安裝與授權、租戶上下文管理、標準 API 輸出、標準事件分發、Tenant Mapping。
- AiPower 負責：自身產品能力、個人 / 團隊模式的內部路由、自身執行時服務與回撥接收。
- 租戶進入方式：個人租戶進入公共模式（按 owner 隔離），團隊租戶按標準多租戶接入，兼顧成本、資料隔離與擴充套件性。
該整合模型可複用於不同的應用整合方，避免「單次特例對接」導致的平臺被單產品繫結與介面碎片化。
5.9 📣 AiReach — CRM 營銷應用（生態首個應用）
三件套架構：
- 業務後端：AiReach Backend Service（v1.5 起改為自建獨立服務，Java / Node 自選），承載業務主資料、
event_inbox冪等、tenant_integration金鑰、排程、多租戶隔離與 Tool API。 - BFF（Node.js）：前端聚合 + AS SSO + Aile 整合入站協議（install / webhook）+ AIFF 配置註冊 + SSE 中繼與薄 AI 閘道器。
- 前端（React）：一份獨立 React Web，同一部署同時滿足獨立訪問與 AileDesktop 多個 AIFF 槽位嵌入。
核心能力：服務號級營銷活動（campaign）、受眾解析、AiReach 自治營銷標籤體系（tag / tag_assignment / smart_tag_rule）、複用 Aile 服務號群發的推播鏈路、點選歸因、可選的「進線原因聯動」。
AI 能力（Phase 2）：AiReach Backend 作為資料與統計 / 工具域把能力工具化為 Tool API；AileAI 作為 AI 編排域承接 Copilot / 多 Agent / RAG，Aile 底座保持零侵入。
5.10 🪄 Aiff (AIFF) — 前端整合框架
機制：應用透過 /openapi/v1/aiff/** 註冊「嵌入位置（slot）+ endpoint URL」，AileDesktop 在對應槽位載入 endpoint 並注入上下文（token / serviceNumberId / contactId 等）。
配置維度：應用基本資 料、應用型別（Aiff 型別 / 通知型別）、載具（Desktop / Mobile）、入口位置（主框架側邊欄 / 聊天室 header 選單 / 訊息選單 / 客戶主頁替換）、應用範圍（按聊天室型別）、服務號範圍等。
整合演進：第一階段以租戶整合（手動金鑰 + 租戶整合 API）完成應用建立；未來發展為 NewAile 的「應用中心」，與雲端 AiPower 自動完成授權與開通。
5.11 📱 終端應用矩陣
| 應用 | 說明 | 當前狀態 |
|---|---|---|
| 📱 AileApp | 個人商務平臺：自動建商務號、多渠道進線、歸戶識別、AI 輔助 / 諮詢、任務系統。個人租戶 + 單一商務號。 | 內測版完成，正式釋出 2026 年 3 月 |
| 💼 AilePro | 團隊商務協作：多服務號 / 商務號、團隊內部聊天、客戶分配、廣播 / 批次等高階功能。團隊租戶。 | 開發啟動（Q2），套餐制定價 |
| 🖥️ AileDesktop | Tauri + React 高效能桌面端：啟動 < 1 秒、記憶體 < 80MB、體積 < 15MB。 | Phase 1 完成，Phase 2 BFF + Socket 聯調 |
| 🃏 AiCard | 電子名片流量入口：免費版（基礎樣式 / vCard / 有限分享 / 推薦有禮 NFC）→ 專業版（多渠道繫結 / WebChat 進線 / AI 接入 / 無限分享）。 | 臺北團隊開發中 |
| 🤖 FastBot | AI 機器人訂閱購買：自動在公共租戶建立服務號，機器人可掛接到 AileApp 商務號 / AilePro 服務號。 | 臺北團隊 UIUX 設計中 |
| 📲 Aiwow | 客戶端電子名片夾：收集 / 檢視名片、與商務號溝通、點數賬戶管理（UUPon / Aile 點）。 | 規劃 / 推廣階段 |
5.12 🤖 助手系統
包含分身、虛擬員工、助手等 AI 驅動的智慧服務角色，可繫結到服務號提供自動化客服能力，支援購買與配置管理。
5.13 📊 監控與可觀測性體系
體系構成：指標定義（SLI/SLO）、監控告警規範（P0-P2 分級）、Runbook 故障手冊、基於 OpenTelemetry 的實施計劃。
已建立 Runbook：P0（服務 5xx 錯誤率過高、資料庫連線失敗）；P1（CPU / 記憶體使用率過高、API 響應時間過慢）；P2（Pod 頻繁重啟）。
六、應用整合模型（平臺對應用）
AiPower / AiReach 等應用透過統一的四段流程接入 Aile，形成可複用、邊界穩定的生態整合模型：
四段整合流程：
- 註冊 IntegrationApp（一次性）：平臺管理員註冊
appId與installBaseUrl。 - 安裝握手 + AIFF 註冊：生成
tenantIntegrationId/ Secret，應用初始化租戶上下文與冪等表，並註冊 AIFF 槽位。 - 事件分發：Aile → 應用 webhook，攜帶
eventId，由應用event_inbox冪等去重。 - OpenAPI 出站：應用讀取
tenant_integrationSecret，HMAC 簽名直髮 Aile 閘道器。
七、點數與點獲取體系
點數模型：
- Aile 點：個人在 AiPool 中的積分（真實賬務：增減、支付、餘額）。
- 功能點：租戶在 Aile 中的功能額度，由 Aile 點充值而來。
點獲取三大場景：活動給點、管理員給點、使用者自購。統一由 TenantPointGrantService 處理，配合 Mongo TenantPointAudit 審計模型、冪等 eventId、AIPool S2S 呼叫、狀態機（Pending / Processing / Success / Failed），以及活動引擎 aipool-activity-service（Pub/Sub + Redis/Lua 預算）。
三端打通：透過 AiPool 打通 Aiwow、Aile、AiPool 三端的點數資料，支援企業主頁點數餘額展示、按企業查詢點數明細、激勵卡等應用場景。
八、服務號體系
服務號是 Aile 生態中對外溝通的核心載體：
| 型別 | 適用物件 | 數量限制 | 主要用途 |
|---|---|---|---|
| 個人商務號 | 個人租戶 | 一個租戶一個 | 個人對外商務溝通，自行管理 AI 秘書 |
| 企業官方服務號 | 企業租戶 | 一企業一個 | 企業對外官方渠道入口 |
| 企業對外服務號 | 企業租戶 | 自行管理 | 企業專屬服務渠道（客服、售後等） |
| 企業個人商務號 | 企業員工 | 一員工一個 | 員工以企業身份對外溝通 |
版本控制：個人商務號透過 flag 欄位區分免費版（flag=free）與專業版（flag=vip）；專業版支援多渠道繫結（Line / FB / IG / WeChat）、WebChat 進線、AI 接入等進階功能。
九、商業模式與增長路徑
以商務電子名片為流量入口，分四階段推進生態閉環：
| 階段 | 核心目標 | 關鍵動作 |
|---|---|---|
| ① 免費電子名片推廣 | 快速建立使用者基礎 | 手機號註冊自動建個人租戶、病毒式分享、推薦贈 NFC 卡片 |
| ② Line OA 升級引導 | 建立官方服務渠道 | 協助建立 Line OA、錄入金鑰為整合做準備 |
| ③ 專業版升級 + AileApp | 引導使用核心應用 | 名片接入 NewAile、AI 自動回覆、客戶端引導用 Aiwow / WebChat |
| ④ 全面生態整合 | 多渠道與高階 AI 管理 | 多渠道繫結、虛擬人 / 高階 AI、秘書協作、統一訊息中心 |
十、關鍵術語表
| 術語 | 說明 |
|---|---|
| Aile | 多租戶客服 / 通訊底座（auth / platform-integration / message / tenant / ...） |
| AS | Authorization Server，統一授權伺服器（獨立服務） |
| BFF | Backend for Frontend，前端專用的 GraphQL 聚合層 |
| CRMGateway | 多渠道訊息和 AI 服務閘道器 |
| AiPool | 統一支付 / 積分平臺 |
| AileAI | AI 編排域（Copilot / 多 Agent / RAG / MCP） |
| AiPower | Java 業務開發平臺（Unit + Flow），租戶級整合應用 |
| AiReach | 生態首個 CRM 營銷應用（業務後端 + Node BFF + React 三件套） |
| Aiff / AIFF | Aile Integrated Front-end Framework，前端整合框架 |
| MCP | 基礎功能服務（含人臉識別物聯等模組） |
| Aile 點 / 功能點 | 個人在 AiPool 的積分 / 租戶在 Aile 的功能額度（由 Aile 點充值） |
| 分身 / 虛擬員工 | AI 驅動的智慧助手角色 |
| 進線原因 | 訪客開啟 WebChat 時附帶的來源與意圖後設資料 |
| 歸戶 | 多渠道識別為同一客戶的統一身份管理 |
| IntegrationApp / TenantIntegration | 生態應用註冊實體 / 租戶安裝關係與金鑰 |