🛠️ 運用設計書 v2.0

1. 朝の定期確認（9:00）

1. Slackチャンネル確認
   • 夜間処理の完了通知を確認
   • エラー通知がないか確認
   • 処理時間が1分を超えていないか確認（v2.0基準）
2. Google Drive確認
   • 録画フォルダに新規ファイルが保存されているか
   • 文字起こし・要約ドキュメントが生成されているか
3. ヘルスチェック実行
   curl https://your-domain.vercel.app/api/health-check

2. Transcript API利用状況確認

パフォーマンス監視手順

1. リアルタイム監視

   # 処理ログ監視
   tail -f 3.operations/logs/app.log | grep "処理時間"
   
   # v2.0専用メトリクス
   grep "Transcript取得" app.log | tail -20
   grep "VTT解析" app.log | tail -20
                           

2. 処理パス分析

   処理パス	発生割合目標	確認方法
   Transcript高速パス	95%以上	TranscriptService利用ログ
   音声フォールバック	5%未満	AudioSummaryService利用ログ

3. ボトルネック特定
   • VTTダウンロード時間（目標: 5秒以内）
   • VTT解析時間（目標: 1秒以内）
   • 要約生成時間（目標: 10-30秒）

Transcript関連エラー（新規）

フォールバック動作確認

# フォールバック発生状況確認
grep "Fallback to audio processing" app.log | tail -10

# フォールバック理由分析
grep "Transcript not available" app.log | wc -l
grep "VTT parse error" app.log | wc -l

# フォールバック成功率
grep "Fallback successful" app.log | wc -l
                

1. Zoom側設定確認

1. 自動文字起こし設定
   • Zoom管理画面にログイン
   • 「設定」→「記録」→「クラウド記録」
   • 「音声の文字起こし」が有効になっているか確認
   • 言語設定が「日本語」になっているか確認
2. API権限確認
   • Zoom App Marketplaceで権限確認
   • recording:readスコープが有効か
   • Transcriptファイルアクセス権限があるか

2. システム側設定

環境変数（Vercel）

3. 移行設定管理

A/Bテスト設定

# 段階的移行の割合設定
export TRANSCRIPT_ROLLOUT_PERCENTAGE=10  # 初期10%
export TRANSCRIPT_ROLLOUT_PERCENTAGE=50  # 50%へ増加
export TRANSCRIPT_ROLLOUT_PERCENTAGE=100 # 完全移行

# 特定ユーザーのみv2.0有効化
export TRANSCRIPT_ENABLED_USERS="user1@example.com,user2@example.com"
                

コスト監視手順

1. 日次確認

   # API使用量確認
   curl -X GET "https://generativelanguage.googleapis.com/v1/usage" \
     -H "Authorization: Bearer YOUR_API_KEY"
   
   # Transcript使用率確認（コスト0）
   grep "Using Transcript API" app.log | wc -l
   grep "Fallback to Gemini" app.log | wc -l
                           

2. 月次レポート生成
   • Transcript API利用率: 目標95%以上
   • フォールバック発生回数と原因
   • Gemini API節約量の算出

Stage 1: 並行実装（Day 1-3）

1. 実装確認
   • transcriptService.jsの動作確認
   • VTT解析処理の検証
   • 要約専用メソッドのテスト
2. 切替設定

   # 開発環境でv2.0有効化
   export USE_TRANSCRIPT_API=true
   export TRANSCRIPT_ROLLOUT_PERCENTAGE=0  # 本番は0%
   
   # テスト実行
   npm run test:transcript
                           

Stage 2: A/Bテスト（Day 4-10）

Stage 3: 完全移行（Day 11-14）

1. 100%切替

   # 本番環境で完全移行
   export TRANSCRIPT_ROLLOUT_PERCENTAGE=100
   
   # 確認コマンド
   curl https://your-domain.vercel.app/api/health-check | jq '.transcript_enabled'
                           

2. 旧コード削除準備
   • AudioSummaryServiceをフォールバック専用に変更
   • 不要な音声処理コードをコメントアウト
   • 1週間後に完全削除予定
3. ドキュメント更新
   • 運用手順書の更新完了確認
   • エラーコード一覧の更新
   • パフォーマンス基準値の変更