Resend ドメイン認証Outbound email setup
松葉のメール送信（招待 / OTP / 共有リンク / 削除予告など 10 種類のテンプレート）は Resend（メール配信 SaaS）に集約しました。送信ドメインは社内の他プロジェクトでも使っている mail.example.com を再利用しています。共用ドメインだと「松葉から届いた」と分かりにくいため、件名・送信者表示名・本文ロゴの 3 点で ブランドを明示する設計にしました。
送信元の設計From address design
DNS（SPF / DKIM / DMARC）はドメイン側で既に Verified 済のため、本手順では設定不要。代わりに「受信者から見て松葉のメールだとわかる」工夫を 3 層で重ねています。
| 項目 | 値 | 役割 |
|---|---|---|
| 送信元アドレス | noreply@mail.example.com | 返信不要を明示 |
| 送信者表示名 | 松葉 / Matsuba | From ヘッダで「松葉 / Matsuba <noreply@…>」と表示 |
| 件名プレフィクス | [松葉] | 全テンプレート共通で先頭付与 |
| 本文先頭アイコン | logo-mark-with-name.svg | react-email の <Img> で埋め込み |
| API キー | Resend matsuba-server | Matsuba 専用キー（漏洩時の影響を局所化、年次ローテも独立） |
| Webhook | https://portal.example.com/api/webhooks/resend | 配信状態（delivered / bounced / complained）の受信口 |
受信箱でどう見えるかIn recipient's inbox
共用ドメインの宿命として「@mail.example.com 由来のメール」が複数のサービスから届きます。利用者が混乱しないよう、3 つの目印でブランドを明示します。
From:松葉 / Matsuba <noreply@mail.example.com>
To:tanaka.hanako@example.com
Subject:[松葉] Box「2026 年度 新商品企画」への招待
田中 花子 様
林がお客様を Box「2026 年度 新商品企画」に招待しました。下記リンクからご参加ください（リンクの有効期限は 30 日間です）。
3 つの目印: (1) 送信者表示名「松葉 / Matsuba」、 (2) 件名プレフィクス「[松葉]」、 (3) 本文先頭の松葉ロゴ。Outlook の一覧表示でも、Gmail のスレッド表示でも、最初に「松葉」の文字またはロゴが目に入る配置になっています。
送信から配信状態の追跡までSend & track
バウンス率（送信失敗率）が一定の比率を超えた場合は Cloud Monitoring 経由でメール通知が飛びます（Step 10）。共用ドメインのレピュテーション（評判）が他プロジェクトの影響で落ちないよう、配信状態は email_logs テーブルにも追記し、Resend 側ダッシュボードと突き合わせ可能にしています。
後続手順で Secret Manager に登録するものOutputs to secrets
| 取得した値 | Secret Manager 名 | 誰が使う |
|---|---|---|
API キー re_xxx… | matsuba-resend-api-key | matsuba-api / matsuba-batch（送信） |
Webhook Signing Secret whsec_xxx… | matsuba-resend-webhook-secret | matsuba-api（Webhook 偽造防止検証） |