📋 機能設計書

P001: ZoomRecordingService（本番録画処理部品）

説明: Zoom API経由で実際の録画データを取得し、シーケンシャル処理で効率的に動画・音声を処理する部品

実装場所: 1.src/services/zoomRecordingService.js

状態: ✅ 実装完了

シーケンシャル処理フロー

主要メソッド

P001-DEV: SampleDataService（開発・テスト用）

説明: Google Drive「99.zoom_memo_recording/sample」フォルダからサンプル音声データを取得する部品（開発・テスト専用）

実装場所: 1.src/services/sampleDataService.js

状態: ✅ 実装完了（本番では非使用）

詳細仕様

P002: AudioSummaryService（音声要約部品）

説明: 音声ファイルをGeminiで8項目構造化要約を生成する部品

実装場所: 1.src/services/audioSummaryService.js

状態: ✅ 実装完了

8項目要約構造

P003: VideoStorageService（動画保存部品）

説明: 動画ファイルをGoogle Driveに保存し、組織内共有リンクを生成する部品

実装場所: 1.src/services/videoStorageService.js

状態: ✅ 実装完了

詳細仕様

P004: MeetingNotificationService（通知部品）

説明: 8項目構造化要約と動画共有リンクをSlackに投稿する部品

実装場所: 1.src/services/meetingNotificationService.js

状態: ✅ 実装完了

詳細仕様

C002: 録画ダウンロード機能

説明: 検知された録画ファイル（音声・動画）を一時フォルダにダウンロードする機能

実装場所: 1.src/services/zoomService.js

状態: ✅ 実装完了

詳細仕様

C003: AI文字起こし機能

説明: ダウンロードした音声ファイルをGoogle Gemini APIで高精度テキストに変換する機能

実装場所: 1.src/services/aiService.js

状態: ✅ 実装完了（動的モデル選択対応）

詳細仕様

C004: AI議事録生成機能

説明: 文字起こしテキストを解析し、構造化された議事録を自動生成する機能

実装場所: 1.src/services/aiService.js（analyzeComprehensively）

状態: ✅ 実装完了

詳細仕様

C005: Google Drive保存機能

説明: 録画ファイルをGoogle Driveの組織フォルダに自動保存し、共有リンクを生成する機能

実装場所: 1.src/services/googleDriveService.js

状態: 🔄 実装済み（認証設定待ち）

詳細仕様

C006: Slack統合機能

説明: 議事録要約とGoogle Drive録画リンクをSlackチャンネルに自動投稿する機能

実装場所: 1.src/services/slackService.js

状態: ✅ 実装完了（運用品質向上機能実装済み）

詳細仕様

B001: GoogleDriveService（基盤）

説明: Google Drive APIの基本操作を提供する共通部品

実装場所: 1.src/services/googleDriveService.js

使用部品: SampleDataService, VideoStorageService

状態: ✅ 実装完了

提供メソッド

B002: AIService（基盤）

説明: Google Gemini APIを使用した文字起こし・要約機能を提供する共通部品

実装場所: 1.src/services/aiService.js

使用部品: AudioSummaryService

状態: ✅ 実装完了（動的モデル選択対応）

提供メソッド

B003: SlackService（基盤）

説明: Slack Web APIを使用した投稿機能を提供する共通部品

実装場所: 1.src/services/slackService.js

使用部品: MeetingNotificationService

状態: ✅ 実装完了

提供メソッド

B004: ZoomService（基盤）

説明: Zoom Cloud Recording APIを使用した録画取得機能を提供する共通部品

実装場所: 1.src/services/zoomService.js

使用部品: ZoomRecordingService, 各種テストエンドポイント

状態: ✅ 実装完了（Vercel対応メソッド追加）

提供メソッド

従来メソッド

S001: エラーハンドリング・通知システム

説明: 処理中のエラーを自動検知し、Slackにエラー通知を送信する機能

実装場所: 1.src/utils/logger.js、1.src/services/slackService.js

状態: ✅ 実装完了

詳細仕様

S002: 録画別実行ログ出力システム

説明: 各録画ファイルの処理実行ログを個別ファイルで Google Drive に自動保存する機能

実装場所: 1.src/utils/executionLogger.js、PT001テストに統合済み

状態: ✅ 実装完了 - エラーコード体系と完全統合済み

{
  "executionId": "exec_20250807_143021_12345",
  "meetingInfo": {
    "id": "12345",
    "topic": "1on1 Meeting", 
    "startTime": "2025-08-07T14:30:21.000Z"
  },
  "steps": [
    {
      "step": "zoom_data_fetch",
      "status": "SUCCESS",
      "startTime": "2025-08-07T14:30:21.100Z",
      "endTime": "2025-08-07T14:30:25.200Z",
      "duration": 4100,
      "details": { "fileSize": "74.3MB" }
    },
    {
      "step": "gemini_transcription", 
      "status": "ERROR",
      "startTime": "2025-08-07T14:30:25.300Z",
      "endTime": "2025-08-07T14:32:10.100Z", 
      "duration": 104800,
      "errorCode": "AI001",
      "errorMessage": "Gemini API rate limit exceeded"
    }
  ],
  "summary": {
    "overallStatus": "ERROR",
    "totalDuration": 108900,
    "successSteps": 1,
    "errorSteps": 1
  }
}
                    

S003: 標準エラーコード体系

説明: システム全体で統一されたエラーコード体系を定義・実装

実装場所: 1.src/utils/errorCodes.js

状態: ✅ 実装完了（50種類の詳細エラーコード定義済み）

// エラーコード定義例
ZM001: {
  code: 'ZM001',
  message: 'Zoom API認証失敗',
  messageEn: 'Zoom API authentication failed',
  retryable: false,
  notifySlack: true,
  troubleshooting: 'ZOOM_API_KEY、ZOOM_API_SECRET、ZOOM_ACCOUNT_IDを確認してください'
}

// ErrorManager使用例
const error = ErrorManager.createError('ZM001', { userId: 'user123' });
const isRetryable = ErrorManager.isRetryable('ZM001'); // false
const shouldNotify = ErrorManager.shouldNotifySlack('ZM001'); // true
                    

S004: ヘルスチェック機能

説明: 全外部API（Zoom・Gemini・Slack・Google Drive）の接続状況をチェックする機能

実装場所: api/health-check.js

状態: ✅ 実装完了

詳細仕様

S005: Claude対話記録システム

説明: 開発過程のClaude Codeとの対話を記録し、設計書を自動更新するシステム

実装場所: 3.operations/ClaudeScriptLogging/

状態: ✅ 実装完了

詳細仕様

• ✅ API認証トークン管理: 環境変数による安全な管理
• ✅ 一時ファイル削除: 処理完了後の自動クリーンアップ
• 🔄 Google Drive組織内共有: ドメイン制限付きリンク生成
• 📋 録音データ暗号化: 計画中（現在はローカル一時保存のみ）

• ✅ ヘルスチェック: 全外部API接続状況の監視
• ✅ エラー通知: Slack自動通知システム
• ✅ ログ記録: Winston使用（app.log）
• 📋 リトライ機能: 要実装（現在は単発実行）
• 📋 稼働率監視: 要測定