🧪 テスト仕様書 v2.0

Zoom Memo Automation システムテスト計画 - Transcript API統合版

⚡ v2.0新機能: Zoom Transcript API統合により処理時間90%削減・コスト80%削減を実現

1. v2.0テスト戦略

🚀 v2.0パフォーマンス目標

処理時間
30-60秒
(v1.0: 228.8秒)
処理コスト
$3/月
(v1.0: $15/月)
対応時間
60分+
(v1.0: 17分制限)
成功率
99.5%
(v1.0: 95%)

テスト段階計画

段階 期間 目的 成功基準 状態
Phase 1 Week 1 TranscriptService単体テスト VTT解析成功率100% 🚧実装中
Phase 2 Week 2 A/Bテスト・性能比較 処理時間90%削減達成 ⏳予定
Phase 3 Week 3+ 完全移行・監視強化 本番環境99.5%稼働率 ⏳予定

2. v2.0新規テストケース

🆕 PT002: Transcript API統合テスト

項目 内容 期待結果 状態
テスト環境 Vercel本番環境 - 準備完了
VTT取得 Transcript APIからVTTファイル取得 5秒以内完了 🆕新規
VTT解析 TranscriptServiceでVTT解析 話者・タイムスタンプ正確抽出 🆕新規
要約生成 Gemini APIで要約のみ生成 10-15秒以内完了 🆕新規
E2E処理 録画検知→VTT→要約→保存→通知 30-60秒以内完了 🆕新規

🆕 AB001: A/B比較テスト

比較項目 v1.0(音声処理) v2.0(Transcript) 改善率
処理時間 228.8秒 目標: 30-60秒 90%削減
Gemini API使用量 音声+要約 要約のみ 80%削減
タイムアウトリスク 17分で発生 完全解決 100%改善
対応可能会議時間 最大17分 60分以上 350%拡張

🆕 FB001: フォールバックテスト

シナリオ 条件 期待動作 状態
VTT取得失敗 Transcript APIエラー 音声処理に自動切替 🆕実装予定
VTT未生成録画 古い録画・設定無効 音声処理で対応 🆕実装予定
VTT破損 不正なVTTフォーマット エラー検知→音声処理 🆕実装予定

3. 既存テストケース(v1.0互換)

PT001: 本番スルーテスト(フォールバック用)

テスト項目 v1.0結果 v2.0での役割 状態
End-to-End音声処理 228.8秒成功 フォールバック処理として維持 ✅維持
Gemini文字起こし 97秒(制限あり) VTT失敗時のみ使用 ✅フォールバック
チャンク処理 実装済み 大容量音声のフォールバック ✅維持

TC203/204/205: 機能別テスト

テストID 内容 v2.0対応 状態
TC203 音声処理テスト フォールバック機能として維持 ✅互換
TC204 動画保存テスト 変更なし(継続使用) ✅継続
TC205 Slack投稿テスト 変更なし(継続使用) ✅継続

4. v2.0処理フロー検証

【v2.0 新処理フロー - 4ステップ】 1. [Zoom録画検知] → [録画メタデータ取得] ↓ 2. [Transcript API] → [VTTファイルダウンロード] ← 🆕NEW! ↓ [TranscriptService] → [VTT解析・話者抽出・タイムスタンプ処理] ↓ 3. [Gemini API] → [要約生成のみ(文字起こし不要)] ← 🚀高速化! ↓ 4. [並行処理] → [Google Drive保存] + [Slack通知] 【フォールバック処理】 VTT取得失敗 → 従来の音声処理フロー(v1.0)に自動切替 【パフォーマンス改善】 🚀 処理時間: 5-10分 → 30秒-1分(90%削減) 💰 処理コスト: $15/月 → $3/月(80%削減) ⏱️ タイムアウト: 17分制限 → 完全解決

検証ポイント

🔍 VTT処理検証

  • VTTフォーマット正確性
  • 話者識別精度
  • タイムスタンプ整合性
  • 日本語・英語混在対応

⚡ 性能検証

  • 処理時間測定
  • メモリ使用量監視
  • API呼び出し回数
  • 並行処理効率

🛡️ 信頼性検証

  • フォールバック動作
  • エラーハンドリング
  • リトライメカニズム
  • ログ記録完全性

📊 品質検証

  • 要約品質比較
  • 文字起こし精度
  • 話者分離正確性
  • 重要ポイント抽出

5. 負荷テスト計画

🏋️ 負荷テストシナリオ

シナリオ 録画時間 v1.0結果 v2.0目標
短時間会議 5分 2-3分処理 15-20秒
標準会議 30分 タイムアウトリスク 30-45秒
長時間会議 60分 処理不可 45-60秒
超長時間会議 120分 処理不可 60-90秒

🔄 同時処理テスト

同時録画数 v1.0対応 v2.0対応 改善効果
1録画 問題なし 高速処理 90%高速化
3録画 順次処理 並行処理可能 3倍スループット
5録画 タイムアウトリスク 安定処理 5倍スループット

6. エラーハンドリングテスト

❌ v2.0新規エラーコード

エラーコード 説明 対処法 テスト状態
ZM-401 Transcript API認証失敗 音声処理フォールバック 🆕追加
ZM-402 VTTファイル取得失敗 リトライ→音声処理 🆕追加
ZM-403 VTTフォーマット不正 パーサー切替→音声処理 🆕追加
TS-501 TranscriptService解析エラー 詳細ログ→音声処理 🆕追加
TS-502 話者識別失敗 デフォルト話者使用 🆕追加

7. 移行テスト計画

🔄 段階的移行スケジュール

v1.0使用率 v2.0使用率 テスト内容 判定基準
Week 1 100% 0%(開発) v2.0単体テスト 全テスト成功
Week 2 75% 25%(A/B) 小規模A/Bテスト 性能目標70%達成
Week 3 50% 50%(並行) 本格A/Bテスト 性能目標90%達成
Week 4 25% 75%(主力) v2.0主力運用 安定稼働率99%
Week 5+ 0%(FB) 100%(完全) v1.0はFBのみ 完全移行成功

8. 受入テスト基準

✅ v2.0リリース判定基準

カテゴリ 項目 基準値 必須/推奨
性能 平均処理時間 60秒以内 必須
処理成功率 99%以上 必須
コスト削減率 70%以上 必須
品質 要約精度 v1.0同等以上 必須
話者識別精度 95%以上 推奨
文字認識精度 98%以上 推奨
信頼性 フォールバック動作 100%動作 必須
エラーリカバリ 自動復旧 必須
ログ完全性 100%記録 必須

9. テスト自動化

🤖 自動テストスクリプト

スクリプト名 用途 実行頻度 状態
test-transcript-api.js Transcript API接続テスト 日次 🆕作成予定
test-vtt-parser.js VTT解析エンジンテスト CI/CD 🆕作成予定
test-ab-comparison.js v1.0/v2.0性能比較 週次 🆕作成予定
test-fallback.js フォールバック動作検証 日次 🆕作成予定
monitor-performance.js リアルタイム性能監視 常時 🆕作成予定

10. テスト結果サマリー(最新)

📊 v2.0テスト進捗状況

カテゴリ 完了 実施中 予定 進捗率
設計・仕様 5 0 0 100%
実装 2 3 5 20%
単体テスト 0 2 8 0%
統合テスト 0 0 10 0%
受入テスト 0 0 5 0%

🎯 マイルストーン

  • 完了: v2.0アーキテクチャ設計・仕様策定
  • 🚧 実施中: TranscriptService実装・VTTパーサー開発
  • 次期: A/Bテストフレームワーク構築
  • 📅 目標: 2週間でPhase 2完了・3週間で本番移行
最終更新: | テスト自動化: 準備中 | v2.0 Transcript統合版: 2025-09-26
🚀 v2.0目標: 処理時間90%削減・コスト80%削減・タイムアウト問題100%解決