通知のしくみ/ Notifications
何が誰に届き、届かないときにどう気づくか
通知は、業務の出来事を関係者へ知らせるしくみであると同時に、異常を管理者へ伝える経路でもあります。松葉が送る通知は全 47 種類で、メールの届き方は受信者が自分で選びます。この章では、通知の 3 つの系統と設定の効き方、操作からメールボックスまでの受け渡し、そして「画面は正常なのにメールだけ出ない」状態をどこで見張るかを説明します。あわせて、管理者が文面を編集できる範囲と、その画面がどの段階で入るかを示します。
通知の 3 系統Three Families
松葉が送る通知は全 47 種類です。系統によって送られ方が違い、管理者が手を入れられる範囲も違います。まずこの 3 つの区別を押さえると、この先の章が読みやすくなります。
| 系統 | 種類数 | 代表例 | 届く相手 | 本文の編集 |
|---|---|---|---|---|
| 業務通知 |
全 24 種 稼働中 19 実装予定 · Step 4a 3 実装予定 · Step 4b 2 | アップロードと差し替え/コメント/メンバー追加とロール変更/招待/共有リンクの発行/ファイルリクエストの依頼・催促・受領/参加申請と承認/デイリーサマリ。保持期限の予告と削除当日の知らせは 実装予定 · Step 4a | Box の関係者 | 編集できる 画面は 実装予定 · Step 4b |
| 認証・本人宛 |
全 11 種 稼働中 11 | ログインと二要素認証の設定に使う確認コード/共有リンクの受取人とファイル提出者の確認コード/パスワードの再設定・追加・変更の完了/メールアドレスの確認と変更完了/メール配信の再開確認 | 本人のみ | 編集できない 文面はアプリに固定 |
| 管理者宛 |
全 12 種 稼働中 8 実装予定 · Step 4b 4 | ウイルス検出/種類と中身が一致しないファイルの隔離/隔離の取り出しと恒久削除/共有リンクの総当たり検知/Drive 同期の異常/月次の検出訓練の結果/Workspace 要対応の週次リマインダ。アラートの汎用通知と重大操作の通知は 実装予定 · Step 4b | システム管理者全員 (一部は関係者にも同報) | 編集できる 画面は 実装予定 · Step 4b |
系統ごとに送り方を分けている理由
確認コードやパスワード再設定のメールは、遅れれば利用者がその場でログインできません。そこで認証・本人宛の 11 種だけは途中の順番待ちを通さず、アプリから配送業者へ直接渡します。管理者が文面を編集できないのも同じ理由で、認証の文面が事故で壊れるとログイン自体が止まるためです。業務通知と管理者宛の通知は、順番待ちを挟んで確実に送ることを優先します。
届き方は受信者が選べるDelivery Modes
メールの届き方は、利用者が自分の設定画面で決めます 稼働中。管理者が一括で切り替える機能は持っていません。届きすぎて読まれなくなる状態を避けるため、受信者側に選択肢を置く設計です。
| モード | 動作 |
|---|---|
| 即時(既定) | 出来事が起きるたびにメールを送ります。 |
| デイリーサマリ | 1 日分をためて、指定した時刻に 1 通へまとめて送ります。時刻は 30 分単位で選べます。まとめた 1 通は通知センターにも受領行として残ります。 |
| 停止 | メールを送りません。アプリ内の通知センターとバッジには従来どおり出ます。 |
この 3 つは全体の既定として選び、さらに Box ごとに上書きできます。「普段はデイリーサマリだが、この案件の Box だけは即時で受け取る」といった使い分けができ、指定しなかった Box は全体の設定を引き継ぎます。
止められない通知
業務上の危険や期限に直結する知らせは、受信者の設定にかかわらず即時で届きます。招待/参加申請とその承認・却下/共有リンクの発行案内/ウイルス検出などのセキュリティ/Drive 同期の異常/隔離の取り出しと恒久削除/保持期限に関する知らせ/重大操作の通知がこれにあたります。これらはデイリーサマリにまとめず、Box ごとに停止していても送ります。
メール本文の末尾には配信停止のリンクが付き、メールソフトの「登録解除」からも止められます。停止の範囲は、Box に紐づく知らせならその Box、紐づかない知らせなら業務通知のメール全体です。ただし上記の止められない通知は停止後も届き続け、アプリ内の通知センターにも残ります。設定画面からいつでも再開できます。
配送の裏側Behind the Scenes
通知でいちばん困る故障は「画面の操作は成功しているのに、メールだけが出ていない」形で現れます。利用者からは気づけず、管理者にも自動では見えません。松葉は、この状態を作らないための多段の受け渡しと、詰まりを見つけるための点検を持っています。
色の役割 — Teal:稼働中の処理 / 金茶:台帳・時間もの / 赤:配信の停止 / 破線:外部サービスと見張り。「画面は正常なのにメールだけ出ない」を見張る場所は 3 つです。①送信予定に行が溜まっていないか(5 分ごとの点検)②配送そのものが失敗していないか(同じ点検と管理コンソールの通知状況)③届いたかどうか(到達確認とバウンスの警告)。いずれも異常はアラート台帳へ起票され、管理者に知らせが飛びます。
操作と知らせが食い違わないしくみ
送信予定への書き込みは、操作そのものの保存と同じひとまとまりの処理で行います。アップロードが成功したのに通知が作られなかった、あるいは操作が失敗したのに通知だけ飛んだ、という食い違いが起きません。そのうえで、実際の送信は 1 分ごとの払い出しに任せます。メールの配送は外部サービスへの通信を伴うため、そこで詰まっても利用者の操作は待たされません。
届かないときのしくみWhen Mail Bounces
退職・組織変更・入力間違いなどで、宛先が受け取れなくなることがあります。放置すると配送業者から見た評判が落ち、他の宛先にも届きにくくなるため、松葉は届かないアドレスを自動で切り離し、本人の手で戻せるようにしています 稼働中。
| 段階 | 起きること | 誰が何をするか |
|---|---|---|
| ① 到達確認 | 配送業者から「届いた/届かなかった」の結果を受け取り、宛先ごとに記録します。 | 自動(管理コンソールの通知状況で件数を確認できます) |
| ② 配信の停止 | 30 日以内に 3 回届かなかったアドレスは、メール配信をいったん止めます。同時に、その方が関わる Box のオーナーへ「この方にメールが届いていない」と知らせます。 | 自動 |
| ③ 本人による再開 | 本人は設定画面から確認メールを送り、届いたメールのリンク先で操作すると配信が再開されます(リンクの有効期限は 24 時間)。リンクを開くだけでは戻らず、明示の操作が要ります。 | 本人(管理者の手続きは不要) |
| ④ 個別の再送 | 特定の通知が失敗している場合は、管理コンソールの通知状況から手動で送り直せます。 | システム管理者 稼働中 |
管理者が編集できるものTemplates & Free Messages
通知の文面は「共通の外殻」と「本文」の二層でできています。外殻(ヘッダ・フッタ・配色・配信停止リンク)はアプリ側が用意し、本文だけを管理者が編集できる設計です。文面をデータベースに置く準備は済んでおり、編集する画面が 実装予定 · Step 4b です。
| 対象 | できること | 状態 |
|---|---|---|
| テンプレートの編集 | 業務通知と管理者宛の本文(件名・本文)を書き換えます。ダミーデータでの表示確認、系統での絞り込みと検索を備えます。全社共通の文面に加え、Box ごとの差し替えにも対応します。 | 実装予定 · Step 4b |
| 差し込みの語句 | 本文には Box 名・ファイル名・操作した方の名前などを差し込めます。差し込める語句はテンプレートごとに決めた一覧に限られ、一覧にない語句を書いても空欄になります。誤って内部の値が本文へ出ることを防ぐためです。 | 実装予定 · Step 4b |
| 認証・本人宛の 11 種 | 編集できません。ログインや再設定が止まる事故を避けるため、文面はアプリに固定してあります。 | 稼働中(編集不可のまま) |
| ゼロベース通知 | テンプレートを使わず、件名・本文・宛先をその場で書いて送ります。Box の画面から、システム管理者と Box のオーナーが使えます。共有リンクを管理者が強制的に失効させたときの連絡も、この経路で理由を添えて送ります。送信は履歴に残ります。 | 稼働中 |
テンプレートの編集画面ができるまでの間も、定型外の連絡はゼロベース通知で送れます。文面の恒久的な変更が必要になった場合は、開発側での差し替えになります。
配信状況の確認Monitoring Delivery
配信の状態を見る経路は 2 つあります。日常はアプリの中だけで完結し、配送業者側の詳細を見たいときにだけ外の画面を使います。
| 経路 | 見えるもの | 使う人 | 状態 |
|---|---|---|---|
| 管理コンソールの通知状況 | 送信件数と成功率、失敗した通知の一覧と手動での再送、メール配信を止めている方の人数(上段の計器)。個別の再開は、その通知の詳細を開いて行います。詳しくは管理コンソールの章を参照してください。 | システム管理者 | 稼働中 |
| Resend Dashboard | 配送業者側の記録(1 通ごとの配送ログ、受信側から返された理由、到達率の推移)。松葉が持つ鍵は送信専用で、アプリから配送ログを取りに行かない設計のため、細かい配送理由はこちらで見ます。 | エンジニア(必要なときのみ) | 稼働中 |
日常の判断は管理コンソール側で完結します。Resend Dashboard を開くのは、特定の宛先だけ届かない原因を追うときなど、受信側が返した理由まで確かめたい場合に限られます。持ち場の切り分けは自動メンテナンスと長期運用の「持ち場の線引き」を参照してください。