通知（Notifications）

目的

bizhiwayはアプリ内通知（service-notification）とメール（service-mail）の2チャネルで通知を提供します。購買フロー・サプライヤー管理の重要なマイルストーンで自動的に通知が送信されます。

2チャネルの通知

flowchart LR
    EVENT["システム内のイベント\n（承認・納品・契約期限...）"]

    EVENT --> INAPP["📱 アプリ内通知\nservice-notification\nポータル上でリアルタイム表示"]
    EVENT --> EMAIL["📧 メール通知\nservice-mail\n登録メールアドレスへ送信"]

アプリ内通知（service-notification）

ポータルのベルアイコンで未読数を表示し、クリックで詳細へ遷移します。

主なアプリ内通知

イベント	通知先
新規承認依頼	承認者（KS01）
承認完了 / 差戻し	依頼者（K001）
Buyerから新規PO	サプライヤー（S001）
サプライヤーがPOを受諾	購買担当者（K002）
検収完了	購買担当者（K002）
支払通知	サプライヤー（S001）
Mall商品の承認 / 却下	MallSupplier

通知ステータス

stateDiagram-v2
    [*] --> UNREAD : 通知が生成された
    UNREAD --> READ : ユーザーが通知を確認
    READ --> [*]

メール通知（service-mail）

アプリ内通知と並行して、または代替として送信されます。ポータルを頻繁に確認しないサプライヤーにとって特に重要です。

メールテンプレートの種類

種別	説明	管理者
共通テンプレート（Common）	システム全体のデフォルトテンプレート	Provider
個別テンプレート（Private）	会社グループごとのカスタムテンプレート	Buyer Admin

Buyer AdminはPrivateテンプレートを作成することでCommonテンプレートを上書きできます。

テンプレートの構成

要素	説明
メール分類（EmailClassification）	どのイベントに使うテンプレートか
件名（Subject）	動的変数を含む（例: `{{order_number}}`）
本文（Body）	HTML or テキスト — 変数置換あり
送信先（Recipients）	ロール指定または特定アドレス

主なメール一覧

メール	送信タイミング	送信先
承認依頼	案件申請時	承認者
承認完了	承認されたとき	依頼者
差戻し	差戻されたとき	依頼者
PO送付	PO確定時	サプライヤー
支払リマインダー	期日N日前	サプライヤー / Buyer
契約期限アラート	終了30日前・7日前	購買担当者
サプライヤー登録招待	招待作成時	新規サプライヤー
反社確認結果	チェック完了時	Provider Admin

ActiveMQ — メッセージキュー

メールとアプリ内通知はApache ActiveMQを通じて非同期送信されます。

flowchart LR
    EVENT["イベント発生\n（承認完了等）"] --> MQ["ActiveMQ\nメッセージキュー"]
    MQ --> NOTIF["service-notification\nDB書き込み\nアプリ内表示"]
    MQ --> MAIL["service-mail\nSMTP経由でメール送信"]

非同期処理により、メール障害が業務フローをブロックしません。

ビジネスルール

メールとアプリ内通知は独立： 設定によりどちらか一方のみ、または両方を送信できます。
個別テンプレートが共通テンプレートを上書き： Buyer Adminが個別テンプレートを作成した場合、そのイベントでは共通テンプレートは使用されません。
FAX対応： FAX・メールでの取引 フラグがONのサプライヤーにはFAXでPDF形式のPOを送付（J2外部処理）。
メール送信履歴： J2はメール送信のステータス（成功/失敗）のみを記録し、メールの内容コピーは保持しません。

画面・URL

画面	URL (Staging)
共通メールテンプレート	`/eProcurement/Settings/Mail/TemplateManagementCommon`
個別メールテンプレート	`/eProcurement/Settings/Mail/TemplateManagementPrivate`
テンプレート作成・編集	`/eProcurement/Settings/Mail/TemplateManagementDetail`
アプリ内通知	全ポータルのヘッダーにあるベルアイコン