幫平台加上 AI 功能（下）：不花錢也能測試 AI，然後上線

AI 每次回答都不一樣，又要花額度，要怎麼寫自動測試？答案是用「假的 AI」。本週完成每日上限、用假客戶端測試所有情況，最後部署並設定金鑰。

本週結束時你會

• 全站每日 AI 呼叫上限
• 用假的 AI 客戶端測試：快取、上限、失敗、注入、輸出跳脫
• 部署到 Vercel，金鑰設定在環境變數
• 完成 Demo 與專案回顧

今天的時間安排

每日上限【自己做】

需求：資料表 ai_usage(day, calls) 記錄每天呼叫次數；每次真的呼叫 API 前加 1；達到上限（環境變數 AI_DAILY_LIMIT，預設 50）時不呼叫，顯示「今天的 AI 使用次數已達上限」。

用假的 AI 客戶端寫測試【跟著做】

ai.summarize 有一個 client 參數。測試時傳入一個「長得像 Gemini 客戶端」的假物件：它不連網、回傳固定內容，還會記錄收到的提示詞，讓我們檢查 API 被呼叫了幾次、提示詞長什麼樣子。

請在 tests/test_ai.py 寫 AI 摘要功能的測試，全部不可以真的呼叫 Gemini：
1. 寫一個 FakeClient 類別，模仿 google-genai 的 client.interactions.create(model, input)：記錄每次收到的 input，回傳有 output_text 的物件；也可以設定成丟出錯誤
2. 測試前把 app.config["AI_CLIENT"] 換成 FakeClient
3. 測試這些情況：產生並顯示摘要；評論沒變時第二次不呼叫；新增評論後會重新呼叫；評論少於 3 則不呼叫；達到每日上限；AI 丟出錯誤時店家頁仍正常；含「忽略以上指示」的評論只出現在 <reviews> 區塊內；AI 回傳 <script> 時頁面有跳脫且長度被截斷；沒有金鑰時丟出 AIUnavailable
執行 python -m pytest -q。原本吃貨站的測試也要一起通過。

class FakeClient:
    def __init__(self, reply="湯頭鮮甜最常被稱讚，缺點是要排隊。", error=None):
        self.prompts, self.reply, self.error = [], reply, error
        self.interactions = SimpleNamespace(create=self._create)

    def _create(self, model, input):
        self.prompts.append(input)          # 記錄提示詞，之後可以檢查
        if self.error:
            raise self.error                 # 模擬 AI 服務掛掉
        return SimpleNamespace(output_text=self.reply)

上線

1. 吃貨站要先完成第 8 週的做法：db.py 支援 Postgres、Vercel 連上 Neon，並在 Neon 建立 ai_summaries 與 ai_usage 兩張表。
2. Vercel → Settings → Environment Variables，新增 GEMINI_API_KEY（自己貼上金鑰）與 SECRET_KEY，可選擇性新增 AI_DAILY_LIMIT。
3. 重新部署，打開派森牛肉湯產生一次摘要。

本週檢核

• python -m pytest -q 全部通過，而且測試過程沒有真的呼叫 API
• 線上網站可以產生摘要；拿掉金鑰時網站不會當掉
• Demo：示範一次快取（第二次不呼叫）與一次失敗處理
• 專案回顧