Aile 生態系統說明檔案

一、Aile 生態概述

Aile 是一個基於微服務架構構建的雲端智慧商務服務平臺，部署於 GCP GKE 環境，面向個人商務人士與企業團隊，提供從「客戶溝通 → AI 客服 → 電子名片 → 積分支付 → 營銷增長」的完整商業閉環。

生態由三個層面共同構成：

• • 底座（Aile）：多租戶客服 / 通訊底座，提供認證、訊息、租戶、服務號、群發、進線等核心能力。
• • 平臺與應用層（AiPower / AiReach / Aiff / AileAI）：在底座之上以「租戶級整合應用」的標準模型擴充套件業務能力。
• • 終端與入口（AiCard / FastBot / AileApp / AilePro / AileDesktop / Aiwow / WebChat）：面向使用者的產品矩陣與流量入口。

核心增長路徑

生態產品矩陣

二、生態分層全景架構

Aile 採用分層微服務架構，從認證到應用逐層解耦，並透過標準化整合邊界承載外部 / 內部應用。

架構分層說明

後端微服務叢集

三、核心技術棧

後端技術

前端技術

基礎設施與運維

四、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 — 多渠道整合閘道器

雙重職責：

1. 1. 多渠道進線 Gateway：Line / Facebook / IG / WebChat → Aile / AileAI
2. 2. 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 營銷應用（生態首個應用）

三件套架構：

1. 1. 業務後端：AiReach Backend Service（v1.5 起改為自建獨立服務，Java / Node 自選），承載業務主資料、event_inbox 冪等、tenant_integration 金鑰、排程、多租戶隔離與 Tool API。
2. 2. BFF（Node.js）：前端聚合 + AS SSO + Aile 整合入站協議（install / webhook）+ AIFF 配置註冊 + SSE 中繼與薄 AI 閘道器。
3. 3. 前端（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 📱 終端應用矩陣

5.12 🤖 助手系統

包含分身、虛擬員工、助手等 AI 驅動的智慧服務角色，可繫結到服務號提供自動化客服能力，支援購買與配置管理。

5.13 📊 監控與可觀測性體系

體系構成：指標定義（SLI/SLO）、監控告警規範（P0-P2 分級）、Runbook 故障手冊、基於 OpenTelemetry 的實施計劃。

已建立 Runbook：P0（服務 5xx 錯誤率過高、資料庫連線失敗）；P1（CPU / 記憶體使用率過高、API 響應時間過慢）；P2（Pod 頻繁重啟）。

六、應用整合模型（平臺對應用）

AiPower / AiReach 等應用透過統一的四段流程接入 Aile，形成可複用、邊界穩定的生態整合模型：

四段整合流程：

1. 1. 註冊 IntegrationApp（一次性）：平臺管理員註冊 appId 與 installBaseUrl。
2. 2. 安裝握手 + AIFF 註冊：生成 tenantIntegrationId / Secret，應用初始化租戶上下文與冪等表，並註冊 AIFF 槽位。
3. 3. 事件分發：Aile → 應用 webhook，攜帶 eventId，由應用 event_inbox 冪等去重。
4. 4. OpenAPI 出站：應用讀取 tenant_integration Secret，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 生態中對外溝通的核心載體：

版本控制：個人商務號透過 flag 欄位區分免費版（flag=free）與專業版（flag=vip）；專業版支援多渠道繫結（Line / FB / IG / WeChat）、WebChat 進線、AI 接入等進階功能。

九、商業模式與增長路徑

以商務電子名片為流量入口，分四階段推進生態閉環：

十、關鍵術語表