Aile 點獲取體系 — 完整使用者故事（統整修訂版 v2.0）

版本：v2.0（統整修訂版）

日期：2026-06-07

分組：Backend / Admin / AileApp / 活動引擎

配套設計規格：Aile 點獲取體系 — 完整設計規格（統整修訂版 v2.0）

[!NOTE]
本文件定位為開發參考用的臨時設計稿，協助團隊在正式規格文件發布前對齊需求拆解；待正式規格建立後，可由正式文件取代並移除此參考稿。

0. 說明

階段總覽：Phase 1 給點底座 + 管理員給點 + 個人租戶購買 + 基礎審計；Phase 2 AileApp 購買/明細與 Admin 報表增強；Phase 3 活動給點。

Backend

BE-01 統一給點基礎服務

使用者故事

作為 Aile 後端團隊，我想要提供統一的給點服務，封裝 AIPool 累點、冪等、狀態流轉與審計，以便管理員給點、使用者自購到賬、活動給點都能複用同一套可靠底座。

驗收標準

1. 給點服務支援管理員給點、購買到賬、活動給點等來源場景。
2. 每次給點生成或接收全域性唯一 eventId，同一 eventId 不重複給點。
3. 給點前寫入審計底稿（目標租戶、openId、點數、場景、來源業務 ID、狀態、備註）。
4. AIPool 成功返回後，審計狀態更新為 Success，記錄 outTraceId。
5. AIPool 業務拒絕時審計更新為 Failed 並保留失敗原因。
6. （修訂 C2）通訊超時/異常時保留 Processing，交由補單 Job 或手動重試，不靜默標為失敗。
7. 已成功的重複請求直接返回既有結果，不再呼叫 AIPool。

備註

• Phase：1
• 依賴：AIPool 累點介面契約、個人租戶與 openId 對映。
• （修訂 C1）新建 TenantPointGrantService，不堆入審計服務；審計讀寫複用 TenantPointAuditService。
• 不包含：審批流、活動規則引擎、前端頁面。

BE-02 Aile 官方管理員給點服務

使用者故事

作為 Aile 官方管理員，我想要透過後臺對個人租戶直接授予 Aile 點，以便處理客訴補償、服務關懷、使用者挽留和運營激勵等場景。

驗收標準

1. 提供官方管理員給點介面，僅允許具備 Aile 官方管理員許可權的操作者使用。
2. 給點目標僅限個人租戶，團隊租戶不可作為 Phase 1 給點目標。
3. （修訂 C8）審計 tenantId 必須寫入目標個人租戶 ID（非 SYSTEM_GLOBAL_TENANT），以 operatorId 記錄管理員身份。
4. 支援給點原因：客訴補償、服務關懷、使用者挽留、系統故障補償、運營激勵、其他；“其他”必須提供備註。
5. 給點結果可透過 eventId 或審計記錄查詢。
6. 給點失敗時返回明確失敗原因，便於 Admin 展示和運營排查。

備註

• Phase：1
• 依賴：BE-01、Admin 許可權模型、租戶列表查詢能力。
• 不包含：額度上限、分級審批、AilePro 聊天介面給點。

BE-03 Aile 點內嵌購買代理與到賬同步

使用者故事

作為個人租戶使用者，我想要在 Aile 內完成 Aile 點購買並自動到賬，以便減少跳轉 AIPool 的摩擦，在配額不足時及時恢復使用。

驗收標準

1. 後端可提供 Aile 點購買套餐或支付引數給 Admin/App 前端。
2. 使用者發起購買時，後端能建立或代理 AIPool 支付流程。
3. 支付成功後同步到賬結果並寫入點數審計（auditScene=UserPurchase）。
4. 購買到賬以訂單 ID 或支付流水作為冪等依據，不重複入賬。
5. 支付失敗、取消或超時狀態可被查詢並展示。
6. Aile 側餘額展示以 AIPool 或可信同步結果為準。

備註

• Phase：1 Admin；Phase：2 AileApp。
• 依賴：AIPool 支付/套餐/回撥契約。
• 不包含：Aile 自建支付通道。
• 待確認：套餐來源、支付方式、到賬觸發方式（見設計規格第 13 節）。

BE-04 點數收支審計與報表介面

使用者故事

作為運營和客服團隊，我想要查詢所有 Aile 點收入、支出、失敗和處理中記錄，以便追蹤使用者點數變化、排查異常並統計運營效果。

驗收標準

1. 支援按租戶、時間範圍、場景、狀態、操作人、來源業務 ID 查詢審計記錄。
2. 審計列表同時展示收入和支出，正數表示獲點，負數表示扣點。
3. 支援基礎統計：本日/本月給點總額、給點次數、按場景或原因分佈。
4. 每條記錄展示 AIPool 響應碼、outTraceId、失敗原因等排障欄位。
5. 查詢介面不影響現有扣點審計與配額統計口徑。

備註

• Phase：1 基礎；Phase：2 報表增強。
• 依賴：BE-01、現有 TenantPointAudit 資料完整性。

BE-05 活動給點規則與事件執行服務

使用者故事

作為運營團隊，我想要透過活動規則向符合條件的使用者自動發放 Aile 點，以便用註冊獎勵、邀請獎勵、節日活動等方式提升活躍和轉化。

驗收標準

1. 系統能接收使用者行為事件，並根據活動規則判斷是否符合給點條件。
2. 活動支援基礎配置：時間範圍、觸發條件、單次給點數量、參與上限、總預算。
3. 發點前必須完成預算原子扣減，避免併發超發。
4. 符合條件後釋出給點事件，透過統一給點服務執行。
5. 活動參與記錄可查詢，包含成功、失敗、重複、預算不足等狀態。
6. 活動預算耗盡時自動進入 EXHAUSTED 狀態並停止繼續發點。

備註

• Phase：3
• 依賴：BE-01、活動服務歸屬確認（見設計規格 Q7）、Pub/Sub/Redis 可用性。
• （修訂 C3）活動狀態列舉統一為 DRAFT/ACTIVE/PAUSED/EXHAUSTED/ENDED/ARCHIVED。
• 不包含：複雜 Blockly 規則編輯器首期完整實現，可先支援固定規則模板。

BE-06 失敗補單與手動重試（新增）

使用者故事

作為運維/後端團隊，我想要對處於 Failed 或長期 Processing 的給點記錄進行補單重試，以便在 AIPool 超時/異常後安全恢復給點，且不重複發放。

驗收標準

1. 補單/重試始終攜帶原 eventId，依賴冪等保證不重複給點。
2. 已 Success 的記錄補單時直接返回原成功結果。
3. 補單 Job 可自動掃描長期 Processing 記錄並重推；人工可手動觸發重試。
4. 重試走過同一狀態機（Failed→Processing→Success/Failed）。

備註

• Phase：1（手動重試基礎）；Phase：3（活動補發控制檯）。
• 依賴：BE-01。
• 說明：對應設計規格衝突 C2的狀態保留策略。

Admin

AD-01 官方管理員租戶列表給點

使用者故事

作為 Aile 官方管理員，我想要在租戶列表中篩選個人租戶併發起給點，以便快速完成補償、關懷或運營激勵。

驗收標準

1. 租戶列表支援搜尋、租戶型別篩選和狀態篩選。
2. 僅個人租戶顯示“給點”操作入口。
3. 給點彈窗展示目標租戶資訊，支援輸入點數、選擇原因、填寫備註。
4. 提交前展示二次確認，避免誤發。
5. 提交後展示成功、失敗或處理中狀態。
6. 重複點選提交不會造成重複給點。

備註

• Phase：1
• 依賴：BE-02、租戶列表介面、Admin 許可權識別。

AD-02 點數審計查詢與運營統計

使用者故事

作為 Aile 運營人員，我想要在後臺檢視點數給出、扣除、購買和失敗記錄，以便做日常排查、對賬和運營分析。

驗收標準

1. 支援按租戶、時間、場景、狀態、操作人、原因篩選記錄。
2. 明細列表展示點數變化、來源場景、狀態、原因、AIPool trace、時間。
3. 收入和支出有清晰區分。
4. 頁面展示本日/本月給點總額、給點次數和原因分佈。
5. 失敗記錄可看到失敗原因，並能複製 eventId 供 backend 排查。

備註

• Phase：1 基礎；Phase：2 報表增強。
• 依賴：BE-04。

AD-03 個人租戶內嵌購買元件

使用者故事

作為個人租戶管理員，我想要在 Admin 我的配額頁面直接購買 Aile 點，以便在點數不足時快速補充餘額，繼續使用付費配額能力。

驗收標準

1. 我的配額頁面展示 Aile 點餘額和“立即購買”入口。
2. 購買彈窗展示可購買檔位、價格、贈送資訊和支付方式。
3. 使用者選擇檔位後可進入 AIPool 支付流程。
4. 支付成功後頁面重新整理餘額，並展示購買成功狀態。
5. 支付失敗、取消或超時時有明確提示。
6. 購買記錄出現在點數收支明細中。

備註

• Phase：1
• 依賴：BE-03、AIPool 支付流程。

AD-04 活動管理與參與審計

使用者故事

作為運營人員，我想要在 Admin 後臺配置和監控點數活動，以便管理活動預算、規則、參與情況和發點異常。

驗收標準

1. 支援建立、編輯、啟用、暫停、結束活動。
2. 活動配置至少包含時間範圍、觸發條件、獎勵點數、總預算、參與上限。
3. 活動列表展示狀態、預算剩餘、參與人數、發放點數。
4. 參與審計可檢視每個使用者的獎勵狀態和失敗原因。
5. （修訂 C3）預算耗盡時狀態清晰展示為 EXHAUSTED 並停止繼續發點；狀態取值使用統一列舉。
6. 支援對失敗記錄進行人工排查，是否補發由許可權與流程控制。

備註

• Phase：3
• 依賴：BE-05。
• 不包含：首期不強制實現複雜視覺化規則編排器。

AD-05 活動預算追加與一鍵補發（新增）

使用者故事

作為運營人員，我想要對進行中或已用罄的活動追加預算，並對發放失敗的記錄一鍵補發，以便靈活調整活動節奏並修復異常。

驗收標準

1. 可對 ACTIVE/EXHAUSTED 活動追加預算，追加成功後差額同步 INCRBY 至 Redis 可用預算。
2. 追加預算為執行緒安全操作，不會造成預算超發。
3. 對 Failed 參與記錄可一鍵 Re-run，底層攜帶原 eventId。
4. 由於 Unique Index + code 雙重冪等，重複點選或原交易實際已成功時絕不重複發點。

備註

• Phase：3
• 依賴：BE-05、BE-06。

AileApp 前端

APP-01 Aile 點購買入口與超額引導

使用者故事

作為 AileApp 使用者，我想要在點數不足或觸發超額時看到購買入口，以便快速補充 Aile 點並繼續完成當前操作。

驗收標準

1. 點數管理或配額相關頁面展示 Aile 點餘額和購買入口。
2. 當使用者觸發點數不足或超額提示時，能進入購買引導。
3. 購買入口能展示可購買檔位，並接入後端支付流程。
4. 支付成功後餘額重新整理。
5. 支付失敗、取消或超時時有明確提示。

備註

• Phase：2
• 依賴：BE-03。

APP-02 點數收支明細

使用者故事

作為 AileApp 使用者，我想要檢視自己的 Aile 點收入和支出明細，以便理解點數來源、消費原因和當前餘額變化。

驗收標準

1. 明細頁按時間倒序展示點數收入與支出。
2. 每條記錄展示場景、點數變化、狀態、時間和簡短說明。
3. 收入和支出視覺區分清晰。
4. 支援檢視購買充值、管理員給點、活動獎勵、超額扣點等型別。
5. 失敗或處理中記錄不誤導使用者為已到賬或已扣除。

備註

• Phase：2
• 依賴：BE-04。

APP-03 活動中心與獎勵狀態

使用者故事

作為 AileApp 使用者，我想要檢視當前可參與的點數活動和獎勵領取狀態，以便透過完成活動獲得 Aile 點。

驗收標準

1. 活動中心展示進行中的活動列表。
2. 活動詳情展示規則、獎勵點數、時間範圍和參與條件。
3. 使用者能看到自己的參與狀態：未參與、已達成、發放中、已到賬、失敗。
4. 獎勵到賬後有明確通知或狀態變化。
5. 活動結束或預算用盡時，不再引導使用者參與。

備註

• Phase：3
• 依賴：BE-05、AD-04。

活動引擎（專項，Phase 3）

ENG-01 高併發預算原子扣減與防刷（新增）

使用者故事

作為活動引擎，我想要在高併發下原子化執行預算校驗與扣減，以便徹底杜絕點數超發。

驗收標準

1. 使用 Redis Lua 指令碼序列化執行“檢查餘額 + 扣減”原子操作。
2. 預算充足返回成功併發布給點事件；不足返回失敗。
3. 預算不足時釋出告警並非同步更新活動狀態為 EXHAUSTED。
4. 同一使用者受頻次限制（如 LIFETIME、每日）約束，不可繞過。

備註

• Phase：3
• 依賴：BE-05、Redis/MemoryStore。

推進建議

1. Phase 1 優先同時推進 BE-01、BE-02、BE-03、BE-04 基礎版、BE-06手動重試基礎，以及 AD-01、AD-02 基礎版、AD-03。
2. Phase 2 推進 AileApp 購買與明細體驗（APP-01、APP-02），並增強 Admin 報表。
3. Phase 3 再推進活動給點（BE-05、ENG-01、AD-04、AD-05、APP-03），避免活動規則複雜度阻塞首期商業閉環。