メール機能（Email）

通知メールの送信（SendGrid）と、受信メールの記録・閲覧（webhook → DB → システム管理画面）。

送信: SendGrid + Eta 受信: webhook → 記録閲覧: システム管理画面

概要

メールには送信と受信の2系統がある。送信は通知メール（例：問合せ通知）を SendGrid で送る。受信は外部から届いたメールを webhook 経由で受け取り Email テーブルに記録し、システム管理画面で閲覧する。

送信（Outbound）

送信基盤：SendGrid（@sendgrid/mail）。本文は Eta テンプレートでレンダリング。
送信者名は「スマピタ」（ブランド名）。
現在のテンプレートは landing-page-inquiry（問合せ通知）のみ。
実装：apps/www/lib/mailer/send.ts（テンプレは templates/*.eta）。
※ 送信メールは Email テーブルには記録されない（記録対象は受信メールのみ）。

受信（Inbound）

外部メール配信サービスからの webhook（notificationType: "Received" ＋ base64 本文）を受信。
PostalMime でメールをパースし、差出人・宛先・件名・本文を Email テーブルに記録。
システム管理者がシステム管理画面の /emails で一覧・確認（宛先での絞り込みあり）。
実装：apps/system-manager/app/webhook/email/route.ts（+ message-schema.ts）。

関連データモデル

Email

prisma/schema/email.prisma（@namespace システム）

fromAddress / fromName 差出人
toAddress / toName 宛先
subject / body 件名・本文
→ 受信メールの記録（送信メールは含まない）

関連する画面・実装

受信メール一覧：apps/system-manager/app/emails/ ＋ actions/emails/{list-email,list-to-address}.ts
受信 webhook：apps/system-manager/app/webhook/email/route.ts
送信：apps/www/lib/mailer/send.ts（SendGrid + Eta）

開発セッション履歴

本ドキュメントは既存実装をもとに遡及作成。今後の改修は sessions/ 配下に追記する。