botrun-horse 2.30.0 → 2.34.0

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

@@ -1,262 +0,0 @@
-#!/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

@@ -1,269 +0,0 @@
-#!/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);
-});