Salesforce開発でAIを使い倒す｜要件整理から実装まで全自動化した方法

# 概要
（機能の概要を1〜2行で）

# 目的・背景
（なぜこの機能が必要なのか）

# 課題
（現状の問題点）

# 要件
（実現したいこと、箇条書き）

# 対応方針
（どのように実現するか、技術的なアプローチ）

- 商談が成約になったらメール送信したい
- 対象は取引先責任者
- 金額が大きい案件だけ（1,000万円以上）
- 営業部長にも通知
- 送信履歴は残したい
- バルク処理も対応

# 概要
商談成約時に、関係者へ自動でメール通知を行う機能

# 目的・背景
- 商談成約の情報共有を迅速化
- 重要案件（高額）については、経営層にも即座に通知
- 営業担当者の通知漏れを防ぐ

# 課題
- 現状は営業担当者が手動でメール送信している
- 通知漏れが発生している
- 高額案件の情報が経営層に届くのが遅い

# 要件
1. 商談がステージ「Closed Won」になった際に自動メール送信
2. 送信対象：関連する取引先責任者 + 営業部長
3. 送信条件：商談金額が1,000万円以上
4. 送信履歴をカスタムオブジェクトに記録
5. バルク処理対応（一括更新時も動作）

# 対応方針
- トリガー（After Update）で商談のステージ変更を検知
- メール送信はトリガーハンドラー経由で別クラスに切り出し
- 送信履歴はカスタムオブジェクト Email_History__c に記録
- バルク対応：for文内でのSOQL/DML禁止、Map活用

# 要件（追記）
6. メール送信失敗時のエラーハンドリング
7. 送信先が存在しない場合のログ出力

# 対応方針（詳細）

## クラス構成
- **OpportunityTrigger**：トリガー本体
- **OpportunityTriggerHandler**：トリガーハンドラー
- **EmailNotificationService**：メール送信ロジック
- **EmailHistoryLogger**：送信履歴記録

## 処理フロー
1. 商談のステージが「Closed Won」に更新される
2. トリガーが発火（After Update）
3. OpportunityTriggerHandler が商談金額をチェック（1,000万円以上）
4. 関連する取引先責任者を取得（SOQL）
5. 営業部長のメールアドレスを取得
6. EmailNotificationService でメール送信
7. EmailHistoryLogger で送信履歴を記録

## カスタムオブジェクト設計
### Email_History__c
| 項目名 | 型 | 説明 |
|--------|-----|------|
| Opportunity__c | 参照 | 対象商談 |
| Contact__c | 参照 | 送信先取引先責任者 |
| Sent_Date__c | 日時 | 送信日時 |
| Template_Name__c | テキスト | 使用したテンプレート名 |
| Status__c | 選択リスト | 成功/失敗 |
| Error_Message__c | ロングテキスト | エラー内容 |

## 考慮事項
- ガバナ制限（1日のメール送信上限：5,000通）
- バルク処理対応（for文内でのSOQL/DML禁止）
- エラーハンドリング（メール送信失敗時のログ）
- テスト時のメール送信抑制（System.Test.isRunningTest()）

public class OpportunityTriggerHandler {
    
    public static void handleAfterUpdate(List<Opportunity> newOpps, Map<Id, Opportunity> oldMap) {
        // 成約 & 1,000万円以上の商談をフィルタリング
        // メール送信対象の取引先責任者を取得
        // 営業部長のメールアドレスを取得
        // メール送信処理を呼び出し
        // 送信履歴を記録
    }
    
    private static List<Opportunity> filterTargetOpps(List<Opportunity> newOpps, Map<Id, Opportunity> oldMap) {
        // 実装予定
        return null;
    }
}

private static List<Opportunity> filterTargetOpps(List<Opportunity> newOpps, Map<Id, Opportunity> oldMap) {
    List<Opportunity> targetOpps = new List<Opportunity>();
    
    for (Opportunity opp : newOpps) {
        Opportunity oldOpp = oldMap.get(opp.Id);
        
        // ステージが Closed Won に変更 & 金額が1,000万円以上
        if (opp.StageName == 'Closed Won' 
            && oldOpp.StageName != 'Closed Won'
            && opp.Amount >= 10000000) {
            targetOpps.add(opp);
        }
    }
    
    return targetOpps;
}

## 原因
for文の中でSOQLクエリを実行しているため、バルク処理時にガバナ制限に抵触しています。

## 修正方法
SOQLクエリをfor文の外に移動し、一度に全データを取得してMapで管理してください。

## 修正コード例
（修正後のコードを提示）