feat: initial public release (MAESTRO)

2026-06-03 05:08:00 +00:00
commit f5c7666f6b
823 changed files with 184150 additions and 0 deletions
@@ -0,0 +1,69 @@
+---
+id: notifications
+title: 通知を受け取る
+category: basic
+order: 70
+keywords: [通知, ブラウザ通知, Web Push, プッシュ通知, Service Worker, VAPID]
+---
+
+# 通知を受け取る
+
+タスクの開始・完了・失敗・回答待ちをブラウザ通知で受け取れます。通知は **自分が owner のタスクのみ** が対象です。設定は TopBar → 設定 → 通知 で行います。
+
+通知の仕組みは 2 種類あります。
+
+## V1: ブラウザ通知（前面表示）
+
+V1 は OS / ブラウザの Notification API を使う通知です。**タブが開いていてフォーカスがあるときのみ** 発火します（タブを閉じている・別アプリを見ているときは届きません）。
+
+### 有効化の手順
+
+1. 設定 → 通知 を開く
+2. 「ブラウザ通知を有効化」を押し、ブラウザの許可ダイアログで許可する
+3. 許可後に表示される「通知を受け取る (マスター ON/OFF)」で受信のオン・オフを切り替えられる
+4. 「テスト通知 (ページ内)」で動作確認できる
+
+許可をブラウザ側で拒否した場合は、アドレスバー左の設定アイコンから「通知」を許可に変更してください。状態は画面上に「有効化済み」「一時停止中」「ブラウザで拒否」「未許可」として表示されます。
+
+## V2: モバイル / バックグラウンド通知（Web Push）
+
+V2 は Service Worker と Web Push を使う通知です。**タブやブラウザを閉じていても** サーバーから直接プッシュが届きます。管理者が V2 を有効化している環境でのみ利用できます。
+
+### 購読の手順
+
+1. 設定 → 通知 を開く（V1 のマスター ON が前提）
+2. 「📱 モバイル / バックグラウンド通知 (V2)」セクションで「このデバイスで購読」を押す
+3. 購読中になると「✅ このデバイスで購読中」と表示され、購読デバイス一覧に端末が追加される
+4. 「テスト通知 (サーバー経由)」で動作確認できる
+
+デバイスごとに購読します。複数の端末・ブラウザから購読でき、一覧から個別に「解除」できます。「購読を解除」で現在のデバイスの購読を取り消せます。
+
+### プラットフォームの条件
+
+- **HTTPS が必須** です。V2 は HTTPS でホストされたサイトでのみ確実に動作します
+- **iOS Safari** では、まず「共有 → ホーム画面に追加」でアプリ（PWA）としてインストールし、ホーム画面のアイコンから開いた状態で購読する必要があります
+- Web Push API に対応していないブラウザでは V2 セクションに非対応の旨が表示されます
+
+## 通知するイベント
+
+V1・V2 共通で、以下のイベントごとに受信のオン・オフを切り替えられます。
+
+- タスク開始 (running)
+- タスク完了 (succeeded)
+- タスク失敗 (failed / aborted)
+- ユーザー回答待ち (waiting_human)
+
+これらのトグルはマスター ON のときのみ操作できます。
+
+## プライバシー: 詳細を含めるか
+
+V2 が利用できる環境では、「通知にタスクの詳細（タイトル・piece 名）を含める」トグルがあります。
+
+- **OFF（デフォルト）** — 「タスク #N 完了」のように最小限の内容のみ
+- **ON** — タスクのタイトルや piece 名を通知本文に含める
+
+共有端末やロック画面に出る通知の内容が気になる場合は OFF のままにしてください。
+
+## 管理者向けの設定
+
+V2（Web Push）の有効化には、サーバー側で `config.yaml` の `notifications.push.enabled: true` 設定と VAPID 鍵が必要です（鍵は初回起動時に自動生成されます）。サーバー側設定の概要は [設定](17-settings.md)、管理操作は [管理者向け](19-admin.md) を参照してください。