botrun-horse 2.29.2 → 2.30.0

package/botrun-c/api/scripts/migrate-plan-free-rpd-16to32.ts

@@ -0,0 +1,262 @@
+#!/usr/bin/env tsx
+/**
+ * Migrate Plan-Free RPD Limit Script (16 → 32)
+ * 遷移所有 plan-free 使用者的 RPD 計數器
+ *
+ * 用途：當 plan-free 的 RPD 限制從 16 改為 32 時，
+ *       清除所有 plan-free 使用者的 RPD 計數器，讓他們立即享有新的限制
+ *
+ * 執行方式：
+ *   tsx scripts/migrate-plan-free-rpd-16to32.ts [--dry-run]
+ *
+ * 選項：
+ *   --dry-run  只顯示會被清除的計數器，不實際執行刪除
+ */
+
+import { Firestore } from '@google-cloud/firestore';
+import { CounterKey } from '../src/rate-limit/domain/entities/UsageCounter.js';
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+
+// 初始化 Firestore with credentials
+let db: Firestore;
+
+function initializeFirestore(): Firestore {
+  // 嘗試多個可能的金鑰路徑
+  const possiblePaths = [
+    join(process.cwd(), '..', 'keys', 'firebase-admin-key.json'),
+    join(process.cwd(), '..', 'keys', 'compute-sa-key.json'),
+    join(process.cwd(), 'keys', 'firebase-admin-key.json'),
+    join(process.cwd(), 'keys', 'compute-sa-key.json'),
+  ];
+
+  for (const path of possiblePaths) {
+    if (existsSync(path)) {
+      const serviceAccount = JSON.parse(readFileSync(path, 'utf-8'));
+      console.log(`✅ 使用認證金鑰: ${path}`);
+      return new Firestore({
+        projectId: serviceAccount.project_id,
+        credentials: {
+          client_email: serviceAccount.client_email,
+          private_key: serviceAccount.private_key,
+        },
+      });
+    }
+  }
+
+  // 如果找不到金鑰檔案，使用預設認證（適用於 Cloud Run 環境）
+  console.log('⚠️  未找到本地金鑰，使用預設認證');
+  return new Firestore();
+}
+
+db = initializeFirestore();
+
+interface UserPlan {
+  userId: string;
+  plan: string;
+}
+
+/**
+ * 取得所有 plan-free 使用者
+ */
+async function getPlanFreeUsers(): Promise<UserPlan[]> {
+  const users: UserPlan[] = [];
+
+  try {
+    const usersSnapshot = await db.collection('users')
+      .where('plan', '==', 'Lite')
+      .get();
+
+    usersSnapshot.forEach(doc => {
+      const data = doc.data();
+      users.push({
+        userId: doc.id,
+        plan: data.plan,
+      });
+    });
+  } catch (error) {
+    console.error('❌ 無法讀取使用者資料:', error);
+    throw error;
+  }
+
+  return users;
+}
+
+/**
+ * 取得指定使用者的所有 RPD 計數器
+ */
+async function getUserRpdCounters(userId: string): Promise<string[]> {
+  const keys: string[] = [];
+
+  try {
+    const countersSnapshot = await db.collection('rate_limit_counters').get();
+
+    countersSnapshot.forEach(doc => {
+      const key = doc.id;
+      const parsed = CounterKey.parse(key);
+      // 只取得 RPD 類型的計數器
+      if (parsed && parsed.userId === userId && parsed.type === 'rpd') {
+        keys.push(key);
+      }
+    });
+  } catch (error) {
+    console.error('❌ 無法讀取計數器:', error);
+    throw error;
+  }
+
+  return keys;
+}
+
+/**
+ * 取得計數器的當前值
+ */
+async function getCounterValue(key: string): Promise<number> {
+  try {
+    const doc = await db.collection('rate_limit_counters').doc(key).get();
+    if (doc.exists) {
+      const data = doc.data();
+      return data?.count || 0;
+    }
+    return 0;
+  } catch (error) {
+    console.error(`❌ 無法讀取計數器 ${key}:`, error);
+    return 0;
+  }
+}
+
+/**
+ * 刪除指定的計數器
+ */
+async function deleteCounter(key: string): Promise<void> {
+  try {
+    await db.collection('rate_limit_counters').doc(key).delete();
+  } catch (error) {
+    console.error(`  ❌ 無法刪除 ${key}:`, error);
+    throw error;
+  }
+}
+
+/**
+ * 主程式
+ */
+async function main() {
+  const isDryRun = process.argv.includes('--dry-run');
+
+  console.log('🚀 Plan-Free RPD 限制遷移工具');
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  console.log('📝 說明: 從 RPD 16 → 32 的遷移');
+  console.log('');
+
+  if (isDryRun) {
+    console.log('⚠️  【DRY RUN 模式】只顯示資訊，不會實際刪除');
+    console.log('');
+  }
+
+  try {
+    // 1. 取得所有 plan-free 使用者
+    console.log('🔍 步驟 1: 搜尋所有 plan-free 使用者...');
+    const users = await getPlanFreeUsers();
+    console.log(`✅ 找到 ${users.length} 位 plan-free 使用者`);
+    console.log('');
+
+    if (users.length === 0) {
+      console.log('✅ 沒有需要遷移的使用者');
+      return;
+    }
+
+    // 2. 收集所有需要清除的 RPD 計數器
+    console.log('🔍 步驟 2: 收集 RPD 計數器...');
+    let totalCounters = 0;
+    const userCounters: Map<string, string[]> = new Map();
+
+    for (const user of users) {
+      const counters = await getUserRpdCounters(user.userId);
+      if (counters.length > 0) {
+        userCounters.set(user.userId, counters);
+        totalCounters += counters.length;
+      }
+    }
+
+    console.log(`✅ 找到 ${totalCounters} 個 RPD 計數器需要清除`);
+    console.log('');
+
+    if (totalCounters === 0) {
+      console.log('✅ 沒有需要清除的計數器');
+      return;
+    }
+
+    // 3. 顯示詳細資訊
+    console.log('📊 步驟 3: 計數器詳情');
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+
+    let blockedUsers = 0;
+    for (const [userId, counters] of userCounters) {
+      let hasBlockedCounter = false;
+
+      for (const key of counters) {
+        const count = await getCounterValue(key);
+        const isBlocked = count >= 16; // 舊限制是 16
+
+        if (isBlocked && !hasBlockedCounter) {
+          blockedUsers++;
+          hasBlockedCounter = true;
+        }
+
+        const status = isBlocked ? '🔴 已達舊限制' : '🟢 正常';
+        console.log(`  ${status} ${key.substring(0, 40)}... (count: ${count})`);
+      }
+    }
+
+    console.log('');
+    console.log(`⚠️  其中 ${blockedUsers} 位使用者已達到舊限制（需立即清除）`);
+    console.log('');
+
+    if (isDryRun) {
+      console.log('');
+      console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+      console.log('✅ DRY RUN 完成');
+      console.log('');
+      console.log('👉 若要實際執行，請移除 --dry-run 參數：');
+      console.log('   tsx scripts/migrate-plan-free-rpd-16to32.ts');
+      console.log('');
+      return;
+    }
+
+    // 4. 執行刪除
+    console.log('🗑️  步驟 4: 清除計數器...');
+    let deleted = 0;
+
+    for (const [userId, counters] of userCounters) {
+      for (const key of counters) {
+        await deleteCounter(key);
+        deleted++;
+
+        // 每 10 個顯示一次進度
+        if (deleted % 10 === 0) {
+          console.log(`  ⏳ 進度: ${deleted}/${totalCounters}`);
+        }
+      }
+    }
+
+    console.log('');
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.log('✅ 遷移完成！');
+    console.log('');
+    console.log('📊 統計資訊:');
+    console.log(`   • 影響使用者數: ${userCounters.size}`);
+    console.log(`   • 清除計數器數: ${deleted}`);
+    console.log(`   • 立即解除封鎖: ${blockedUsers} 位`);
+    console.log('');
+    console.log('🎉 所有 plan-free 使用者現在享有新的 RPD 限制（32 次/天）');
+    console.log('');
+
+  } catch (error) {
+    console.error('');
+    console.error('❌ 執行失敗:', error);
+    console.error('');
+    process.exit(1);
+  }
+}
+
+// 執行
+main();

package/botrun-c/api/scripts/migrate-plan-names-to-lite-max.ts

@@ -0,0 +1,269 @@
+#!/usr/bin/env tsx
+/**
+ * 訂閱方案名稱遷移腳本
+ *
+ * 目的：將所有訂閱方案名稱從舊格式遷移到新格式
+ * - plan-free  → Lite
+ * - plan-max-1 → Max-1
+ * - plan-max-2 → Max-2
+ *
+ * 執行前：
+ * 1. 確保已備份 Firestore 資料
+ * 2. 確認新版程式碼已部署
+ *
+ * 執行方式：
+ * cd api
+ * npx tsx scripts/migrate-plan-names-to-lite-max.ts
+ *
+ * Rollback:
+ * npx tsx scripts/rollback-plan-names-from-lite-max.ts
+ */
+
+import { Firestore } from '@google-cloud/firestore';
+
+const db = new Firestore();
+
+// 方案名稱對應表
+const PLAN_MAPPING = {
+  'plan-free': 'Lite',
+  'plan-max-1': 'Max-1',
+  'plan-max-2': 'Max-2',
+} as const;
+
+interface MigrationReport {
+  total: number;
+  updated: number;
+  skipped: number;
+  errors: number;
+  details: Array<{
+    userId: string;
+    oldPlan: string;
+    newPlan: string;
+    status: 'success' | 'skipped' | 'error';
+    error?: string;
+  }>;
+}
+
+/**
+ * 遷移單一使用者的訂閱方案名稱
+ */
+async function migrateUserPlan(
+  userId: string,
+  oldPlan: string,
+  dryRun: boolean
+): Promise<{ status: 'success' | 'skipped' | 'error'; newPlan?: string; error?: string }> {
+  // 檢查是否需要遷移
+  if (!PLAN_MAPPING[oldPlan as keyof typeof PLAN_MAPPING]) {
+    return { status: 'skipped', error: `未知的舊方案名稱: ${oldPlan}` };
+  }
+
+  const newPlan = PLAN_MAPPING[oldPlan as keyof typeof PLAN_MAPPING];
+
+  // Dry run 模式：只顯示會執行的操作，不實際修改
+  if (dryRun) {
+    console.log(`  [DRY RUN] ${userId}: ${oldPlan} → ${newPlan}`);
+    return { status: 'success', newPlan };
+  }
+
+  try {
+    // 實際更新
+    await db.collection('user_subscriptions').doc(userId).update({
+      plan: newPlan,
+      updatedAt: new Date(),
+    });
+
+    console.log(`  ✅ ${userId}: ${oldPlan} → ${newPlan}`);
+    return { status: 'success', newPlan };
+  } catch (error) {
+    const errorMsg = error instanceof Error ? error.message : '未知錯誤';
+    console.error(`  ❌ ${userId}: 更新失敗 - ${errorMsg}`);
+    return { status: 'error', error: errorMsg };
+  }
+}
+
+/**
+ * 執行遷移
+ */
+async function migrate(dryRun: boolean = false): Promise<MigrationReport> {
+  console.log('==================================================');
+  console.log('  訂閱方案名稱遷移工具');
+  console.log('==================================================\n');
+
+  if (dryRun) {
+    console.log('⚠️  DRY RUN 模式：只顯示會執行的操作，不實際修改資料\n');
+  } else {
+    console.log('🚀 正式遷移模式：即將修改 Firestore 資料\n');
+  }
+
+  const report: MigrationReport = {
+    total: 0,
+    updated: 0,
+    skipped: 0,
+    errors: 0,
+    details: [],
+  };
+
+  try {
+    // 取得所有訂閱記錄
+    const snapshot = await db.collection('user_subscriptions').get();
+
+    if (snapshot.empty) {
+      console.log('📭 沒有找到任何訂閱記錄\n');
+      return report;
+    }
+
+    console.log(`📊 找到 ${snapshot.size} 筆訂閱記錄\n`);
+    report.total = snapshot.size;
+
+    // 遷移每一筆記錄
+    for (const doc of snapshot.docs) {
+      const data = doc.data();
+      const userId = doc.id;
+      const oldPlan = data.plan;
+
+      const result = await migrateUserPlan(userId, oldPlan, dryRun);
+
+      report.details.push({
+        userId,
+        oldPlan,
+        newPlan: result.newPlan || oldPlan,
+        status: result.status,
+        error: result.error,
+      });
+
+      if (result.status === 'success') {
+        report.updated++;
+      } else if (result.status === 'skipped') {
+        report.skipped++;
+      } else {
+        report.errors++;
+      }
+    }
+  } catch (error) {
+    console.error('❌ 遷移過程發生錯誤:', error);
+    throw error;
+  }
+
+  return report;
+}
+
+/**
+ * 顯示遷移報告
+ */
+function displayReport(report: MigrationReport, dryRun: boolean) {
+  console.log('\n==================================================');
+  console.log('  遷移報告');
+  console.log('==================================================\n');
+
+  console.log(`總記錄數: ${report.total}`);
+  console.log(`✅ 成功: ${report.updated}`);
+  console.log(`⚠️  跳過: ${report.skipped}`);
+  console.log(`❌ 錯誤: ${report.errors}`);
+
+  // 顯示按方案分類的統計
+  const planStats = report.details.reduce((acc, item) => {
+    if (item.status === 'success') {
+      const key = `${item.oldPlan} → ${item.newPlan}`;
+      acc[key] = (acc[key] || 0) + 1;
+    }
+    return acc;
+  }, {} as Record<string, number>);
+
+  if (Object.keys(planStats).length > 0) {
+    console.log('\n方案遷移統計:');
+    Object.entries(planStats).forEach(([transition, count]) => {
+      console.log(`  ${transition}: ${count} 位使用者`);
+    });
+  }
+
+  // 顯示錯誤詳情
+  const errors = report.details.filter(d => d.status === 'error');
+  if (errors.length > 0) {
+    console.log('\n❌ 錯誤詳情:');
+    errors.forEach(e => {
+      console.log(`  ${e.userId}: ${e.error}`);
+    });
+  }
+
+  // 顯示跳過詳情
+  const skipped = report.details.filter(d => d.status === 'skipped');
+  if (skipped.length > 0) {
+    console.log('\n⚠️  跳過詳情:');
+    skipped.forEach(s => {
+      console.log(`  ${s.userId}: ${s.error}`);
+    });
+  }
+
+  if (dryRun) {
+    console.log('\n⚠️  這是 DRY RUN 結果，資料庫未被修改');
+    console.log('如要實際執行遷移，請移除 --dry-run 參數');
+  } else {
+    console.log('\n✅ 遷移完成！');
+  }
+
+  console.log('\n==================================================\n');
+}
+
+/**
+ * 驗證遷移結果
+ */
+async function verify(): Promise<void> {
+  console.log('🔍 驗證遷移結果...\n');
+
+  const snapshot = await db.collection('user_subscriptions').get();
+
+  const planCounts = snapshot.docs.reduce((acc, doc) => {
+    const plan = doc.data().plan;
+    acc[plan] = (acc[plan] || 0) + 1;
+    return acc;
+  }, {} as Record<string, number>);
+
+  console.log('目前方案分布:');
+  Object.entries(planCounts).forEach(([plan, count]) => {
+    console.log(`  ${plan}: ${count} 位使用者`);
+  });
+
+  // 檢查是否還有舊方案名稱
+  const oldPlans = Object.keys(planCounts).filter(p => p.startsWith('plan-'));
+  if (oldPlans.length > 0) {
+    console.log('\n⚠️  警告: 仍有使用者使用舊方案名稱:');
+    oldPlans.forEach(p => {
+      console.log(`  ${p}: ${planCounts[p]} 位使用者`);
+    });
+  } else {
+    console.log('\n✅ 驗證通過: 所有使用者已使用新方案名稱');
+  }
+
+  console.log('');
+}
+
+/**
+ * 主程式
+ */
+async function main() {
+  const args = process.argv.slice(2);
+  const dryRun = args.includes('--dry-run');
+  const verifyOnly = args.includes('--verify');
+
+  if (verifyOnly) {
+    await verify();
+    return;
+  }
+
+  // 執行遷移
+  const report = await migrate(dryRun);
+
+  // 顯示報告
+  displayReport(report, dryRun);
+
+  // 如果是正式執行且成功，自動驗證
+  if (!dryRun && report.errors === 0) {
+    await verify();
+  }
+}
+
+// 執行
+main().catch(error => {
+  console.error('❌ 執行失敗:', error);
+  process.exit(1);
+});