// Firestore Collection 結構（對應現有 4 個 Tables） { // 對應 users table "users": { "[userId]": { username, display_name, role, status, email, avatar_key, last_login, login_count } }, // 對應 student_progress table "student_progress": { "[userId]": { streak, last_study_date, total_words_learned, total_score, level, badges: [...] } }, // 對應 activity_log table（Sub-collection 設計） "users": { "[userId]/activity_logs/[logId]": { activity_type, module_name, score, duration_seconds, timestamp } }, // 對應 teacher_messages table "teacher_messages": { "[msgId]": { teacher_id, student_id, message_type, content, is_read, created_at } }, // 對應 weekly_tasks + class_groups tables "weekly_tasks": { ... }, "class_groups": { ... } } 複製

// server.js - Cloud Run 後端（安全保管 Gemini API Key） const express = require('express'); const { GoogleGenerativeAI } = require('@google/generative-ai'); const admin = require('firebase-admin'); const rateLimit = require('express-rate-limit'); const app = express(); app.use(express.json()); // ✅ CORS 設定（只允許自己的網域） app.use((req, res, next) => { res.header('Access-Control-Allow-Origin', process.env.ALLOWED_ORIGIN || 'https://english.yourschool.tw'); res.header('Access-Control-Allow-Headers', 'Content-Type, Authorization'); next(); }); // ✅ 速率限制：每個 IP 每分鐘最多 20 次 AI 請求 const aiLimiter = rateLimit({ windowMs: 60 * 1000, max: 20, message: { error: '請求過於頻繁，請稍候再試' } }); // ✅ Gemini AI 端點（API Key 存在環境變數，前端看不到） app.post('/api/ai/chat', aiLimiter, async (req, res) => { const { prompt, context } = req.body; const genAI = new GoogleGenerativeAI(process.env.GEMINI_KEY); const model = genAI.getGenerativeModel({ model: 'gemini-2.0-flash' }); const result = await model.generateContent(prompt); res.json({ text: result.response.text() }); }); // ✅ 前端改成呼叫後端 // 舊版：fetch('https://generativelanguage.googleapis.com/v1beta/...') // 新版：fetch('/api/ai/chat', { method:'POST', body:JSON.stringify({prompt}) }) app.listen(process.env.PORT || 8080); 複製

# 1. 建立 Dockerfile FROM node:20-alpine WORKDIR /app COPY package*.json ./ RUN npm ci --only=production COPY . . EXPOSE 8080 CMD ["node", "server.js"] # 2. 建置 & 推送到 Artifact Registry gcloud builds submit --tag asia-east1-docker.pkg.dev/[PROJECT]/wayne/api # 3. 部署到 Cloud Run（設定自動擴容） gcloud run deploy wayne-api \ --image asia-east1-docker.pkg.dev/[PROJECT]/wayne/api \ --region asia-east1 \ --min-instances 0 \ # 無流量時縮至 0（省費） --max-instances 100 \ # 最大 100 個實例 --concurrency 80 \ # 每實例最多 80 並發 --memory 512Mi \ --set-env-vars GEMINI_KEY=your-key-here \ --allow-unauthenticated 複製

// ✅ 可立即加入 student.html / teacher.html 的快取工具 const Cache = { set(key, data, ttlMinutes = 60) { sessionStorage.setItem(key, JSON.stringify({ data, exp: Date.now() + ttlMinutes * 60000 })); }, get(key) { const item = sessionStorage.getItem(key); if (!item) return null; const { data, exp } = JSON.parse(item); if (Date.now() > exp) { sessionStorage.removeItem(key); return null; } return data; }, del(key) { sessionStorage.removeItem(key); } }; // 使用範例：快取學習進度 60 分鐘 async function getProgress(userId) { const cached = Cache.get(`progress_${userId}`); if (cached) { console.log('⚡ 從快取取得進度'); return cached; } const data = await fetchFromFirestore(userId); Cache.set(`progress_${userId}`, data, 60); return data; } // 使用範例：快取班級訊息 5 分鐘 async function getMessages(classId) { const cached = Cache.get(`msgs_${classId}`); if (cached) return cached; const msgs = await loadMessagesFromDB(classId); Cache.set(`msgs_${classId}`, msgs, 5); return msgs; } 複製

# 在 GCP Console 設定費用警報（CLI 方式） gcloud billing budgets create \ --billing-account=BILLING_ACCOUNT_ID \ --display-name="Wayne English AI Budget" \ --budget-amount=50USD \ # 月費上限 $50 USD --threshold-rule=percent=80 \ # 80% 時發 Email 警告 --threshold-rule=percent=100 # 100% 時再次警告 # 若需要自動停止服務（超支時） # 可透過 Pub/Sub + Cloud Function 自動停用 API Key 複製

# 方法 1：直接在 GCP Console > Monitoring > Alerting 設定（推薦 UI 操作） # 方法 2：用 gcloud CLI ## 告警 1：API 回應時間 > 500ms gcloud alpha monitoring policies create \ --notification-channels=EMAIL_CHANNEL_ID \ --condition-filter='metric.type="run.googleapis.com/request_latencies" resource.type="cloud_run_revision" metric.labels.response_code_class="2xx"' \ --condition-threshold-value=500 \ --condition-threshold-comparator=GT \ --display-name="API 回應超過 500ms" ## 告警 2：錯誤率 > 5% gcloud alpha monitoring policies create \ --condition-filter='metric.type="run.googleapis.com/request_count" metric.labels.response_code_class="5xx"' \ --display-name="伺服器錯誤率過高" ## 告警 3：Cloud Run 實例數超過 50（預期用量異常） gcloud alpha monitoring policies create \ --condition-filter='metric.type="run.googleapis.com/container/instance_count"' \ --condition-threshold-value=50 \ --display-name="異常高並發警告" 複製

// migrate.js - 從 Genspark Tables API 匯出到 Firestore const admin = require('firebase-admin'); const fetch = require('node-fetch'); admin.initializeApp({ credential: admin.credential.applicationDefault() }); const db = admin.firestore(); const TABLES = [ 'users', 'student_progress', 'activity_log', 'teacher_messages', 'weekly_tasks', 'class_groups' ]; async function migrateTable(tableName) { console.log(`⏳ 移轉 ${tableName}...`); let page = 1, total = 0; while (true) { const res = await fetch( `https://your-genspark-project/tables/${tableName}?page=${page}&limit=100` ); const { data, total: count } = await res.json(); if (!data.length) break; const batch = db.batch(); data.forEach(row => { const ref = db.collection(tableName).doc(row.id); batch.set(ref, { ...row, migrated_at: Date.now() }); }); await batch.commit(); total += data.length; console.log(` ✅ 已移轉 ${total}/${count} 筆`); page++; if (data.length < 100) break; } console.log(`✅ ${tableName} 移轉完成，共 ${total} 筆`); } (async () => { for (const table of TABLES) { await migrateTable(table); } console.log('🎉 所有資料移轉完成！'); })(); 複製

# 方法 1：k6（免費，推薦） brew install k6 # 建立測試腳本 stress-test.js import http from 'k6/http'; export const options = { vus: 500, // 500 虛擬用戶 duration: '60s', // 持續 60 秒 }; export default function () { http.get('https://english.yourschool.tw/'); http.post('https://api.yourschool.tw/api/progress', ...); } # 執行測試 k6 run stress-test.js # 方法 2：Apache Bench（快速測試） ab -n 10000 -c 500 https://english.yourschool.tw/ # -n = 總請求數 -c = 並發數 複製