開発者ガイド：メールフローのエンドツーエンドテスト（サインアップ、OTP、リセット、Webhook）
メールフローは製品にとって重要であり、壊れやすいものです。URLの一つの誤り、トークンの欠落、または配信問題がサインアップ失敗やアカウントロックアウトを引き起こす可能性があります。このガイドはエンドツーエンドテストのための再現可能なワークフローを提供します。
1) テストすべき項目（コアチェックリスト）
- テンプレートのレンダリング：デスクトップ＋モバイル；ボタンとテキストが読みやすいことを確認。
- リンクの正確性：本番環境にステージングリンクがないこと；http/httpsの混在がないこと。
- トークンロジック：期限切れが機能していること；必要に応じてトークンは一回限りの使用であること。
- 再送ポリシー：レート制限がスパムや悪用を防止；ユーザーへのメッセージが明確であること。
- ローカリゼーション：正しい言語、日付形式、必要に応じてRTLサポート。
2) シナリオごとに新しい受信箱を使用
共有テスト受信箱は混乱を招く残留物を作ります。テスト実行ごとに新しい使い捨て受信箱を使うことで結果をクリーンに保ちます。
メールボックスを作成：TempMailbox
3) メールだけでなくユーザージャーニーを検証
各フロー（サインアップ検証、OTP、リセット）について：
- 製品のUIまたはAPIからメールをトリガー。
- 配信時間を確認（中央値と遅延の測定）。
- 開封してCTAのリンク先を検証（クエリパラメータ、トークン、リダイレクト動作）。
- クリック後の結果を確認（検証フラグ設定、セッション作成、適切な成功ページ）。
4) 意図的にエッジケースをテスト
- 期限切れトークン（正常に失敗すべき）
- リンクのダブルクリック（状態を壊さないこと）
- 複数回の再送（クールダウンを強制）
- 誤ったメール入力後の修正（更新パス）
5) 可観測性：適切な指標を追跡
- 送信成功率
- バウンス率とプロバイダー拒否
- 検証完了率
- 検証までの時間分布
6) セキュリティの基本（省略しない）
- トークンはランダムでスコープ付き、時間制限付きであるべき。
- URLに機密ユーザー識別子を入れない。
- 適切な場合は使用後にトークンを無効化。
7) QAは倫理的かつ安全に
使い捨て受信箱を正当なテストとプライバシー衛生のために使用してください。悪用、不正、他サービスの規則回避には使用しないでください。
