botrun-horse 2.29.2 → 2.30.0

package/botrun-c/api/scripts/dump-subscriptions.ts

@@ -0,0 +1,395 @@
+#!/usr/bin/env tsx
+/**
+ * Subscription Status Dump Script
+ * 顯示所有使用者的訂閱狀態（試用期、剩餘天數等）
+ */
+
+import { Firestore } from '@google-cloud/firestore';
+import { Subscription, SubscriptionStatus } from '../src/subscription/domain/entities/Subscription.js';
+import type { PlanType } from '../src/rate-limit/domain/entities/Plan.js';
+
+const db = new Firestore();
+
+interface SubscriptionReport {
+  userId: string;
+  email?: string;
+  plan: PlanType;
+  status: SubscriptionStatus;
+  statusDisplay: string;
+  trialStartDate?: Date;
+  trialEndDate?: Date;
+  daysRemaining: number;
+  daysUsed: number;
+  isExpired: boolean;
+  warningLevel: 'safe' | 'warning' | 'critical' | 'expired';
+  createdAt?: Date;
+}
+
+/**
+ * 取得使用者 Email（從 users collection）
+ */
+async function getUserEmail(userId: string): Promise<string | undefined> {
+  try {
+    const usersSnapshot = await db.collection('users').get();
+    for (const doc of usersSnapshot.docs) {
+      const data = doc.data();
+      // users collection 的 document ID 可能是 email，也可能是 uid
+      if (doc.id === userId || data.uid === userId) {
+        return data.email || doc.id;
+      }
+    }
+  } catch (error) {
+    // 忽略錯誤
+  }
+  return undefined;
+}
+
+/**
+ * 取得所有訂閱
+ */
+async function getAllSubscriptions(): Promise<SubscriptionReport[]> {
+  const reports: SubscriptionReport[] = [];
+
+  try {
+    const snapshot = await db.collection('user_subscriptions').get();
+
+    if (snapshot.empty) {
+      console.log('📭 目前沒有任何使用者訂閱記錄');
+      return reports;
+    }
+
+    console.log(`找到 ${snapshot.size} 筆訂閱記錄\n`);
+
+    const now = new Date();
+
+    for (const doc of snapshot.docs) {
+      const data = doc.data();
+
+      // 重建 Subscription 實體
+      const subscription = Subscription.fromData({
+        userId: data.userId,
+        plan: data.plan as PlanType,
+        status: data.status as SubscriptionStatus,
+        trialStartDate: data.trialStartDate?.toDate(),
+        trialEndDate: data.trialEndDate?.toDate(),
+        subscriptionStartDate: data.subscriptionStartDate?.toDate(),
+        subscriptionEndDate: data.subscriptionEndDate?.toDate(),
+        createdAt: data.createdAt?.toDate(),
+        updatedAt: data.updatedAt?.toDate(),
+      });
+
+      // 取得使用者 Email
+      const email = await getUserEmail(subscription.userId);
+
+      // 計算剩餘天數
+      const daysRemaining = subscription.getRemainingDays(now);
+      const isExpired = subscription.isExpired(now);
+
+      // 計算已使用天數
+      let daysUsed = 0;
+      if (subscription.trialStartDate) {
+        const usedMs = now.getTime() - subscription.trialStartDate.getTime();
+        daysUsed = Math.floor(usedMs / (1000 * 60 * 60 * 24));
+      }
+
+      // 警告等級
+      let warningLevel: 'safe' | 'warning' | 'critical' | 'expired' = 'safe';
+      if (isExpired) {
+        warningLevel = 'expired';
+      } else if (subscription.status === SubscriptionStatus.TRIAL) {
+        if (daysRemaining <= 1) {
+          warningLevel = 'critical';
+        } else if (daysRemaining <= 3) {
+          warningLevel = 'warning';
+        }
+      }
+
+      // 狀態顯示
+      let statusDisplay = '';
+      switch (subscription.status) {
+        case SubscriptionStatus.TRIAL:
+          statusDisplay = `試用中 (${daysRemaining} 天)`;
+          break;
+        case SubscriptionStatus.ACTIVE:
+          statusDisplay = '啟用';
+          break;
+        case SubscriptionStatus.EXPIRED:
+          statusDisplay = '已過期';
+          break;
+        case SubscriptionStatus.CANCELLED:
+          statusDisplay = '已取消';
+          break;
+      }
+
+      reports.push({
+        userId: subscription.userId,
+        email,
+        plan: subscription.plan,
+        status: subscription.status,
+        statusDisplay,
+        trialStartDate: subscription.trialStartDate,
+        trialEndDate: subscription.trialEndDate,
+        daysRemaining,
+        daysUsed,
+        isExpired,
+        warningLevel,
+        createdAt: subscription.createdAt,
+      });
+    }
+  } catch (error) {
+    console.error('❌ 無法讀取訂閱記錄:', error);
+    throw error;
+  }
+
+  return reports;
+}
+
+/**
+ * 格式化日期（台北時間 +08:00）
+ * 格式：2025-11-15 14:34:24 +08:00
+ */
+function formatDate(date?: Date): string {
+  if (!date) return 'N/A';
+
+  // 轉換為台北時間 (UTC+8)
+  const taipeiTime = new Date(date.getTime() + (8 * 60 * 60 * 1000));
+
+  // 格式化為 YYYY-MM-DD HH:mm:ss +08:00
+  const year = taipeiTime.getUTCFullYear();
+  const month = String(taipeiTime.getUTCMonth() + 1).padStart(2, '0');
+  const day = String(taipeiTime.getUTCDate()).padStart(2, '0');
+  const hours = String(taipeiTime.getUTCHours()).padStart(2, '0');
+  const minutes = String(taipeiTime.getUTCMinutes()).padStart(2, '0');
+  const seconds = String(taipeiTime.getUTCSeconds()).padStart(2, '0');
+
+  return `${year}-${month}-${day} ${hours}:${minutes}:${seconds} +08:00`;
+}
+
+/**
+ * 格式化狀態列（帶顏色）
+ */
+function formatStatusBar(daysUsed: number, totalDays: number): string {
+  const barLength = 14;
+  const filled = Math.min(Math.floor((daysUsed / totalDays) * barLength), barLength);
+  const empty = barLength - filled;
+
+  // 顏色選擇
+  const percentage = (daysUsed / totalDays) * 100;
+  let color = '\x1b[32m'; // 綠色 (0-50%)
+  if (percentage >= 85) {
+    color = '\x1b[31m'; // 紅色 (85-100%)
+  } else if (percentage >= 70) {
+    color = '\x1b[33m'; // 黃色 (70-85%)
+  }
+
+  const bar = color + '█'.repeat(filled) + '\x1b[0m' + '░'.repeat(empty);
+  return `${bar} ${Math.round(percentage)}%`;
+}
+
+/**
+ * 顯示單一訂閱狀態
+ */
+function displaySubscription(report: SubscriptionReport) {
+  console.log(`\n${'='.repeat(70)}`);
+
+  // 狀態標記
+  let statusIcon = '';
+  switch (report.warningLevel) {
+    case 'safe':
+      statusIcon = '✅';
+      break;
+    case 'warning':
+      statusIcon = '⚠️ ';
+      break;
+    case 'critical':
+      statusIcon = '🔴';
+      break;
+    case 'expired':
+      statusIcon = '⛔';
+      break;
+  }
+
+  console.log(`${statusIcon} 使用者: ${report.email || report.userId}`);
+  console.log(`   User ID: ${report.userId}`);
+  console.log(`${'-'.repeat(70)}`);
+
+  // 方案與狀態
+  console.log(`\n📋 方案: ${report.plan}`);
+  console.log(`📊 狀態: ${report.statusDisplay}`);
+
+  // 試用期資訊
+  if (report.status === SubscriptionStatus.TRIAL && report.trialStartDate && report.trialEndDate) {
+    console.log(`\n🗓️  試用期資訊:`);
+    console.log(`   開始日期: ${formatDate(report.trialStartDate)}`);
+    console.log(`   結束日期: ${formatDate(report.trialEndDate)}`);
+    console.log(`   已使用: ${report.daysUsed} 天 / 14 天`);
+    console.log(`   剩餘: ${report.daysRemaining} 天`);
+    console.log(`   進度: ${formatStatusBar(report.daysUsed, 14)}`);
+  }
+
+  // 建立日期
+  if (report.createdAt) {
+    console.log(`\n📅 建立時間: ${formatDate(report.createdAt)}`);
+  }
+
+  // 警告訊息
+  if (report.warningLevel === 'critical') {
+    console.log(`\n⚠️  警告: 試用期即將到期！`);
+  } else if (report.warningLevel === 'expired') {
+    console.log(`\n⛔ 試用期已過期`);
+  }
+}
+
+/**
+ * 顯示統計摘要
+ */
+function displaySummary(reports: SubscriptionReport[]) {
+  console.log(`\n${'='.repeat(70)}`);
+  console.log(`📊 統計摘要`);
+  console.log(`${'-'.repeat(70)}`);
+
+  const total = reports.length;
+
+  // 按狀態分類
+  const byStatus = reports.reduce((acc, r) => {
+    acc[r.status] = (acc[r.status] || 0) + 1;
+    return acc;
+  }, {} as Record<SubscriptionStatus, number>);
+
+  // 按方案分類
+  const byPlan = reports.reduce((acc, r) => {
+    acc[r.plan] = (acc[r.plan] || 0) + 1;
+    return acc;
+  }, {} as Record<string, number>);
+
+  // 按警告等級分類
+  const byWarning = reports.reduce((acc, r) => {
+    acc[r.warningLevel] = (acc[r.warningLevel] || 0) + 1;
+    return acc;
+  }, {} as Record<string, number>);
+
+  console.log(`\n總使用者數: ${total}`);
+
+  console.log(`\n訂閱狀態分布:`);
+  Object.entries(byStatus).forEach(([status, count]) => {
+    const percentage = Math.round((count / total) * 100);
+    console.log(`  ${status}: ${count} 位使用者 (${percentage}%)`);
+  });
+
+  console.log(`\n方案分布:`);
+  Object.entries(byPlan).forEach(([plan, count]) => {
+    const percentage = Math.round((count / total) * 100);
+    console.log(`  ${plan}: ${count} 位使用者 (${percentage}%)`);
+  });
+
+  console.log(`\n警告等級:`);
+  console.log(`  ✅ 安全: ${byWarning.safe || 0} 位`);
+  console.log(`  ⚠️  警告 (≤3天): ${byWarning.warning || 0} 位`);
+  console.log(`  🔴 緊急 (≤1天): ${byWarning.critical || 0} 位`);
+  console.log(`  ⛔ 已過期: ${byWarning.expired || 0} 位`);
+}
+
+/**
+ * 產生 CSV 內容
+ */
+function generateCSV(reports: SubscriptionReport[]): string {
+  // CSV 標題列
+  const headers = [
+    'User ID',
+    'Email',
+    'Plan',
+    'Status',
+    'Warning Level',
+    'Trial Start',
+    'Trial End',
+    'Days Used',
+    'Days Remaining',
+    'Is Expired',
+    'Created At'
+  ].join(',');
+
+  // CSV 資料列
+  const rows = reports.map(r => {
+    return [
+      r.userId,
+      r.email || '',
+      r.plan,
+      r.status,
+      r.warningLevel,
+      formatDate(r.trialStartDate),
+      formatDate(r.trialEndDate),
+      r.daysUsed,
+      r.daysRemaining,
+      r.isExpired ? 'Yes' : 'No',
+      formatDate(r.createdAt)
+    ].join(',');
+  });
+
+  return [headers, ...rows].join('\n');
+}
+
+/**
+ * 儲存 CSV 並開啟
+ */
+async function saveAndOpenCSV(reports: SubscriptionReport[]) {
+  const fs = await import('fs/promises');
+  const { execSync } = await import('child_process');
+
+  const csvContent = generateCSV(reports);
+  const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, -5);
+  const csvPath = `/tmp/subscription-report-${timestamp}.csv`;
+
+  await fs.writeFile(csvPath, csvContent, 'utf-8');
+
+  console.log(`\n✅ CSV 報表已儲存: ${csvPath}`);
+  console.log(`📊 正在開啟試算表...\n`);
+
+  try {
+    execSync(`open "${csvPath}"`, { stdio: 'inherit' });
+  } catch (error) {
+    console.error('⚠️  無法自動開啟檔案，請手動開啟:', csvPath);
+  }
+}
+
+/**
+ * 主程式
+ */
+async function main() {
+  console.log('==================================================');
+  console.log('  訂閱狀態檢查工具');
+  console.log('==================================================\n');
+
+  try {
+    // 取得所有訂閱
+    const reports = await getAllSubscriptions();
+
+    if (reports.length === 0) {
+      console.log('\n📭 目前沒有任何訂閱記錄\n');
+      return;
+    }
+
+    // 排序：過期 > 緊急 > 警告 > 安全
+    const warningOrder = { expired: 0, critical: 1, warning: 2, safe: 3 };
+    reports.sort((a, b) => warningOrder[a.warningLevel] - warningOrder[b.warningLevel]);
+
+    // 顯示每個訂閱狀態
+    for (const report of reports) {
+      displaySubscription(report);
+    }
+
+    // 顯示統計摘要
+    displaySummary(reports);
+
+    console.log(`\n${'='.repeat(70)}\n`);
+
+    // 產生 CSV 並開啟
+    await saveAndOpenCSV(reports);
+
+  } catch (error) {
+    console.error('❌ 執行失敗:', error);
+    process.exit(1);
+  }
+}
+
+// 執行
+main();

package/botrun-c/api/scripts/list-all-users.ts

@@ -0,0 +1,65 @@
+#!/usr/bin/env tsx
+/**
+ * 列出所有 Firebase Auth 使用者
+ */
+
+import admin from 'firebase-admin';
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+
+// 初始化 Firebase Admin
+if (!admin.apps.length) {
+  try {
+    // 嘗試多個可能的金鑰路徑
+    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'),
+    ];
+
+    let initialized = false;
+    for (const path of possiblePaths) {
+      if (existsSync(path)) {
+        const serviceAccount = JSON.parse(readFileSync(path, 'utf-8'));
+        admin.initializeApp({ credential: admin.credential.cert(serviceAccount) });
+        initialized = true;
+        break;
+      }
+    }
+
+    if (!initialized) {
+      admin.initializeApp(); // Use Application Default Credentials
+    }
+  } catch (error) {
+    console.error('⚠️  Firebase Admin 初始化失敗:', error);
+    throw error;
+  }
+}
+
+async function listAllUsers() {
+  console.log('==================================================');
+  console.log('  Firebase Auth 使用者列表');
+  console.log('==================================================\n');
+
+  try {
+    const listUsersResult = await admin.auth().listUsers(1000);
+
+    console.log(`找到 ${listUsersResult.users.length} 位使用者:\n`);
+
+    listUsersResult.users.forEach((userRecord, index) => {
+      console.log(`${index + 1}. ${userRecord.email || '(無 email)'}`);
+      console.log(`   UID: ${userRecord.uid}`);
+      console.log(`   建立時間: ${userRecord.metadata.creationTime}`);
+      console.log(`   最後登入: ${userRecord.metadata.lastSignInTime || '從未登入'}`);
+      console.log('');
+    });
+
+    console.log('==================================================\n');
+  } catch (error) {
+    console.error('❌ 列出使用者失敗:', error);
+    process.exit(1);
+  }
+}
+
+listAllUsers();