---
title: "通知中心 — 需求討論稿 (FR-196)"
brand: "Guidant AI · **FR-196** 通知中心"
eyebrow: "FR-196 · 需求討論稿 · 2026-11-11（v2：D1～D8 全定案；Agent 主控台 PM 裁不做）"
h1: "通知中心：從「鈴鐺只有任務」到一個完整的通知系統"
subtitle: "現況盤點、成熟產品六個共通模式、功能建議、事件型錄、架構與模組化、三期分工、八項決策"
lede: "現在使用者只會在兩種情況下被系統主動提醒：鈴鐺裡的待辦任務，以及 Email。公告發了沒人看到、掃描掃出嚴重弱點只寄信、系統有新版只寄給管理員、有人用本機管理員登入 Agent 也只寄信。這份稿子盤點現況、對照市面成熟產品的做法，提出一套可以分期做、做成獨立套件的通知中心；八項決策已於 2026-11-11 定案，設計落在 [design.md](design.md)。"
chips: [
  {text: "D1～D8 全定案（2026-11-11）", kind: ok},
  {text: "現況數字來自程式碼與 DEV 資料庫唯讀實查", kind: accent},
  {text: "參考：Jira、GitHub、Linear、Slack、Microsoft 365、Notion", kind: accent},
  {text: "畫面示意：prototype/index.html", kind: accent}
]
footer: "FR-196 · 通知中心 — 需求討論稿 · 2026-11-11 v2 · 同內容的 Artifact 版：https://claude.ai/artifact/1ttV3B84VKnAtBnfqpWvuu"
---

## 30 秒摘要

**一句話**：把產品裡所有「要讓人知道一件事」的動作收進同一個入口，由通知中心決定誰收、站內還是 Email、立刻還是彙整，使用者在鈴鐺與收件匣看到、自己調偏好；做成獨立套件，Agent 主控台與其他產品直接裝。

- **2** 鈴鐺現在只顯示的來源（待辦任務、流程進站）
- **14** 只靠 Email 送的事件種類（程式碼實查）
- **0** 已讀狀態、個人偏好、即時推播、公告推送
- **3** 可直接沿用的既有底座（投遞套件、SocketIO、公告套件）

建議分三期。**第一期**就讓人看得到東西：鈴鐺有未讀數、點開看最近通知、有一頁完整收件匣，先接四種最常發生的事件。**第二期**把十四種 Email 全部改走通知中心，加「通知設定」頁（23 個事件全部展開各自設定）。**第三期**即時推播與系統橫幅。Agent 主控台本案不做（PM 2026-11-11 裁），套件接口保留讓日後能裝。每一期結束都能親手驗一個動作，判定方法寫在分期那節。

## 現況：使用者今天會被怎麼提醒

先講畫面上看得到的。右上角的鈴鐺點開是一份清單，混放兩種東西：「指派給我的待辦任務」與「流程進到我負責的站」。這份清單只在頁面載入時抓一次，不會自己更新、沒有已讀未讀、沒有時間、點了不會消失（任務做完才消失）。除此之外畫面上沒有任何主動提醒；操作結果的 toast 是另一回事，那是當下回饋、三秒就消失、重整就沒了。

公告是獨立的一頁，要從首頁的連結點進去才看得到，發布新公告時沒有任何提示。公告有類別（系統、活動、新聞、其他）與發送範圍（全公司、指定部門），但沒有已讀紀錄，也沒有「置頂」或「橫幅」這種強提醒。

其他事情全靠 Email。程式碼裡總共十四種信，列在下面的事件型錄。收件人由各段程式自己決定（專案成員、租戶管理員、任務處理人），使用者沒有任何地方可以選「這種信我不要收」。Discord 與 Telegram 只有專案啟動與批次完成兩種事件會推，而且是租戶層級的設定，推到一個頻道，不是推給某個人。

### 底層的三個事實

1.  **有一支投遞套件，但它只管「怎麼送出去」。**Email、Discord、Telegram 三條管道的實際投遞邏輯都在 jedi-notification 套件裡，產品裡十二個呼叫點直接用它寄。「什麼時候寄、寄給誰、內容是什麼」散在各段業務程式，沒有統一入口。這支套件要留，通知中心疊在它上面。
2.  **有一張寄信紀錄表，鈴鐺其中一種來源就是從它反查出來的。**週期任務那個需求建了一張表記每封提醒信（寄給誰、結果、對應的任務），鈴鐺的「流程進站」就是去這張表找「寄給我、而且那一站還沒做完、三十天內」的紀錄。這是用寄信紀錄充當收件匣，能動但撐不起通知中心：它只存信箱不存使用者、只有四種事件寫進來、沒有已讀。
3.  **即時推播的底座在，但通知那條頻道已經被拔掉。**SocketIO 與登入驗證都在跑（問卷共同填答在用），原本有一條 `/socket/notification` 頻道，因為沒有人用，資安掃描時當作多餘暴露面拔掉了。要做即時推播是把它接回來、改成推給個人，不是從零蓋。

## 成熟產品怎麼做：六個共通模式

Jira、GitHub、Linear、Slack、Microsoft 365、Notion 的通知設計細節各有不同，拆開看是同一組零件。下面六張卡每張說明這個模式是什麼、哪些產品有、對我們代表什麼。

#### 收件匣，不是跑馬燈

通知是一筆一筆的紀錄，有未讀、已讀、封存三態；鈴鐺顯示未讀數，點開是最近幾筆，另有一頁完整收件匣可以篩選、搜尋、批次標已讀。

GitHub Notifications、Linear Inbox、Jira 鈴鐺

對我們：鈴鐺從「待辦清單」變成「收件匣」。待辦任務仍在「我的任務」頁，鈴鐺只放事件。

#### 每一筆都能點進去做事

通知帶連結，點了直接到那張任務、那份報告、那則公告；重要的在通知上就有動作（核可、查看、關閉）。

Linear、Slack、Jira

對我們：每個事件定義「點了去哪」，由產品端提供連結規則，套件不認識路由。

#### 分類與篩選

通知依性質分幾個固定類別（指派給我、提及我、系統），收件匣可以按類別、按未讀切換。

GitHub 的 filters、Microsoft 365 的「重要／其他」

對我們：四大類：任務與流程、專案、掃描與 Agent、系統與帳號；公告另成一類。

#### 個人偏好：事件 × 管道

使用者在個人設定裡決定每一類通知要站內、Email、還是外部聊天工具；可以選「每日摘要」而不是每封都寄；有勿擾時段。

Jira 個人通知設定、GitHub Notification settings、Slack Preferences

對我們：目前零偏好。做成每個事件一行全部展開，8 個必收事件鎖定不可關。

#### 系統公告走橫幅，不只進收件匣

維護、新版、授權快到期這種「每個人都要知道、而且有時限」的事，在頁面頂部放一條可關閉的橫幅，同時進收件匣留紀錄。

Microsoft 365 訊息中心、Notion 的頂部提示、Slack 的 banner

對我們：新版可更新、授權到期、排定維護三種先走橫幅。

#### 同一件事合併成一筆

同一張任務十分鐘內有三個動作，收件匣只顯示一筆「任務 X 有 3 項更新」；同一份掃描報告的多筆警示合併。

GitHub、Linear、Slack 的 thread 彙整

對我們：第三期再做，第一期先每事件一筆，但資料表從第一天就留「合併鍵」欄位。

沒有列進來的模式：瀏覽器桌面推播（Web Push）與手機 App 推播。原因在「不做什麼」那節。

## 功能建議

照上面六個模式，對應到我們產品，建議做的功能分五塊。每塊先寫使用者看到什麼，再寫背後的規則。

### 一、鈴鐺與收件匣

鈴鐺顯示未讀數（上限顯示 99+），點開是最近十筆，上面一排分類切換（全部、任務、掃描、系統、公告），每筆有圖示、標題、所屬專案或來源、相對時間、未讀點；底部「全部標為已讀」與「查看全部通知」。收件匣頁是完整清單：按今天、昨天、更早分組，可篩未讀、可按類別、可搜尋標題，每筆可標已讀、封存，支援勾選批次。點任一筆就跳到對應頁面並自動標已讀。

規則：通知保留 90 天後自動清掉（可設定）；封存的不計未讀；未讀數每 60 秒自動更新（第三期改即時）。

### 二、通知設定（一頁，個人設定裡）

個人設定多一頁「通知設定」。一張表，23 個事件全部展開各一行，依 5 個類別分組顯示（類別只是分組標題，沒有整類開關）；每行三個管道開關：站內、Email、聊天工具。站內預設全開，Email 照現在的行為預設開，聊天工具預設關。8 個必收事件的站內與 Email 兩格鎖住、標「必收」。表下方兩個設定：Email 摘要（每封都寄、每日早上九點彙整、每週一）與勿擾時段（時段內的 Email 延後到時段結束一次寄出，站內不受影響）。

不做租戶層的「通知管理」頁。原本想讓管理員關掉整個租戶的某個事件、看近三十天發送量、增減必收名單，這三件都是管理員層級的例外處理，有客戶要了再加一頁補回來，資料層不用改。現有的 Discord、Telegram 設定頁維持原樣。

### 四、系統橫幅

三種事件在所有頁面頂部顯示一條可關閉的橫幅：系統有新版可更新（只有平台管理員看得到）、授權或支援將在 N 天內到期（管理員）、排定維護（全部人，由平台管理員手動發）。關閉後不再出現，但收件匣留一筆。

### 五、公告接進來

公告發布時自動產生一筆「公告」類通知給發送範圍內的所有人，點了到那則公告。公告頁本身不動。這樣公告終於有人看得到，也不用另外做「公告已讀」。

## 事件型錄：23 個事件、5 個類別、8 個必收

這張表是通知中心的核心資料，也是「通知設定」頁上會出現的每一行。每列寫事件什麼時候發生、誰該收、是必收還是可自選、為什麼。判準兩條同時成立才必收：①漏看會造成實際損失（資安曝險、系統停擺、被鎖在外面），不只是不方便；②收件人是因職責收到，不是因興趣。有一條不成立就讓人自己選。

| 類別 | 事件 | 誰收 | 必收／可自選 | 理由 |
|----|----|----|----|----|
| 任務與流程 | 新任務指派給我 | 被指派的人 | 可自選 | 量最大，有到期提醒兜底 |
|  | 批次指派（一次多張） | 被指派的人 | 可自選 | 同上 |
|  | 任務今天到期／已逾期 | 處理人 | 可自選 | 延遲由 PM 追，不是損失 |
|  | 流程進到我負責的站 | 該站負責人；無人時 PM | 可自選 | 同上 |
|  | 關卡送審、核可、退回 | 下一關的人；退回時原處理人 | 可自選 | 同上 今天沒有 |
|  | PM 手動寄任務提醒 | 勾選的處理人 | 可自選 | PM 主動發的，本來就是提醒 |
|  | 批次任務完成 | PM | 可自選 | 資訊性 |
| 專案 | 專案啟動、分派角色 | 專案成員 | 可自選 | 資訊性 |
|  | 輪次結束、專案結案 | 專案成員 | 可自選 | 資訊性 今天沒有 |
|  | 結案報告產出 | PM、顧問 | 可自選 | 資訊性 今天沒有 |
| 掃描與 Agent | 掃描新增嚴重／高風險弱點 | 專案 PM、資安負責人 | 必收 | 漏看＝弱點放著不修 |
|  | 檢測任務完成、報告回收 | 任務處理人 | 可自選 | 任務狀態也看得到 今天沒有 |
|  | Agent 離線超過 N 分鐘、恢復連線 | 租戶管理員 | 必收 | 離線＝客戶端掃描與蒐證全停 今天沒有 |
|  | Agent 憑證即將到期 | 租戶管理員 | 必收 | 過期要重註冊 |
|  | Agent 更新失敗 | 租戶管理員 | 必收 | 可能卡在半更新 今天沒有 |
|  | Agent 更新完成 | 租戶管理員 | 可自選 | 資訊性 今天沒有 |
| 系統與帳號 | 系統有新版可更新 | 平台管理員 | 可自選 | 更新中心也看得到；含資安修正時目前分不出來，先不鎖 |
|  | 授權、支援合約即將到期 | 租戶管理員 | 必收 | 到期進唯讀 |
|  | 排定維護 | 全部使用者 | 必收 | 要知道何時不能用 今天沒有 |
|  | 有人用本機管理員登入 Agent | 租戶管理員 | 必收 | 繞過主系統身分的登入 |
|  | 我的密碼即將到期、帳號被鎖 | 本人 | 必收 | 不收會被鎖在外面 今天沒有 |
| 公告與回饋 | 新公告發布 | 發送範圍內的人 | 可自選 | 重要的事應走「排定維護」 今天沒有 |
|  | 我的回饋有原廠回覆 | 送件人 | 可自選 | 資訊性（回饋第二期） |

「今天沒有」共十個：現在完全沒有任何提醒的事件。登入 OTP、建帳號設密碼是交易信，必須寄、不能關、不進收件匣，不在表內。必收的意思：那一行的站內與 Email 兩格鎖住並標「必收」，使用者看得到但改不了；聊天工具那格仍可自選。必收名單出貨寫死，要改等版本。

## 設計稿

三個畫面加一條橫幅，全部用產品現有的卡片語彙畫，區塊一律上下疊。文案是示意，實作時依既有 i18n 用語重寫。

畫面示意見 [prototype/index.html](prototype/index.html)（四個分頁：鈴鐺、通知中心、通知設定、系統橫幅）。

## 架構與模組化：為什麼做成套件、Agent 怎麼裝

核心主張：通知中心是一個「事件進來、通知出去」的樞紐，它不認識任務、專案、掃描這些業務概念，只認識「事件代碼、收件人、連結、內容參數」。業務程式只做一件事：發生了什麼就呼叫一次「通知」；誰收、走哪個管道、要不要彙整、存在哪裡，全部由樞紐決定。這樣既有十四個寄信點每個只改成一行，而且 Agent 或其他產品裝上同一套件就有同一套行為。

```{.mermaid cap="圖 1　通知中心的位置。業務程式只碰最上面那個入口；套件靠下面五個接口與產品連接，所以能換產品、換資料庫。"}
%%{init: {'theme':'base','themeVariables':{'primaryColor':'#E2F0F1','primaryTextColor':'#14201F','primaryBorderColor':'#0E7C86','secondaryColor':'#EEF2F3','secondaryTextColor':'#14201F','tertiaryColor':'#FBFCFC','tertiaryTextColor':'#14201F','lineColor':'#4A5A5C','textColor':'#14201F','mainBkg':'#E2F0F1','nodeBorder':'#0E7C86','nodeTextColor':'#14201F','edgeLabelBackground':'#FBFCFC','titleColor':'#14201F','clusterBkg':'#FBFCFC','clusterBorder':'#E4EAEB','actorBkg':'#E2F0F1','actorTextColor':'#14201F','actorBorder':'#0E7C86','actorLineColor':'#C7D1D2','signalColor':'#4A5A5C','signalTextColor':'#14201F','labelBoxBkgColor':'#EEF2F3','labelBoxBorderColor':'#C7D1D2','labelTextColor':'#14201F','loopTextColor':'#14201F','noteBkgColor':'#F6EBD5','noteTextColor':'#14201F','noteBorderColor':'#9C6B12','activationBkgColor':'#EEF2F3','activationBorderColor':'#C7D1D2','sequenceNumberColor':'#FFFFFF','fontSize':'18px'},'fontSize':18,'flowchart':{'useMaxWidth':false,'nodeSpacing':44,'rankSpacing':52,'padding':14},'sequence':{'useMaxWidth':false,'messageFontSize':17,'noteFontSize':16,'actorFontSize':18,'width':200,'height':64,'messageMargin':52,'boxMargin':14,'actorMargin':80,'mirrorActors':false}}}%%
flowchart TB
  subgraph HOST[產品端（主系統或 Agent）]
    E1[任務指派] --> IN
    E2[掃描警示] --> IN
    E3[公告發布] --> IN
    E4[新版可更新] --> IN
    IN[「通知」入口：一行呼叫]
  end
  subgraph PKG[通知中心套件 jedi-notification-center]
    IN --> CAT[事件型錄：類別、預設管道、必收]
    CAT --> RES[收件人解析]
    RES --> PREF[個人偏好 × 租戶設定]
    PREF --> INBOX[(收件匣)]
    PREF --> OUT[外送佇列：即時或摘要]
    INBOX --> PUSH[未讀數：輪詢或即時推播]
  end
  OUT --> DELIV[jedi-notification 投遞<br/>Email · Discord · Telegram]
  PUSH --> UI[鈴鐺 · 收件匣頁 · 橫幅]
  subgraph PORTS[產品端提供的五個接口]
    P1[使用者名冊：信箱、語系、暱稱]
    P2[角色解析：誰是管理員、誰在專案裡]
    P3[連結規則：事件 → 要跳去哪一頁]
    P4[儲存：主系統 Postgres · Agent SQLite]
    P5[即時推播：SocketIO 或不推]
  end
  PKG -. 依賴 .-> PORTS
```

### 一筆通知從發生到被看到

```{.mermaid cap="圖 2　單一事件的完整路徑。第 1 步是業務程式唯一要寫的那一行；第 2 到 8 步是套件的事。"}
%%{init: {'theme':'base','themeVariables':{'primaryColor':'#E2F0F1','primaryTextColor':'#14201F','primaryBorderColor':'#0E7C86','secondaryColor':'#EEF2F3','secondaryTextColor':'#14201F','tertiaryColor':'#FBFCFC','tertiaryTextColor':'#14201F','lineColor':'#4A5A5C','textColor':'#14201F','mainBkg':'#E2F0F1','nodeBorder':'#0E7C86','nodeTextColor':'#14201F','edgeLabelBackground':'#FBFCFC','titleColor':'#14201F','clusterBkg':'#FBFCFC','clusterBorder':'#E4EAEB','actorBkg':'#E2F0F1','actorTextColor':'#14201F','actorBorder':'#0E7C86','actorLineColor':'#C7D1D2','signalColor':'#4A5A5C','signalTextColor':'#14201F','labelBoxBkgColor':'#EEF2F3','labelBoxBorderColor':'#C7D1D2','labelTextColor':'#14201F','loopTextColor':'#14201F','noteBkgColor':'#F6EBD5','noteTextColor':'#14201F','noteBorderColor':'#9C6B12','activationBkgColor':'#EEF2F3','activationBorderColor':'#C7D1D2','sequenceNumberColor':'#FFFFFF','fontSize':'18px'},'fontSize':18,'flowchart':{'useMaxWidth':false,'nodeSpacing':44,'rankSpacing':52,'padding':14},'sequence':{'useMaxWidth':false,'messageFontSize':17,'noteFontSize':16,'actorFontSize':18,'width':200,'height':64,'messageMargin':52,'boxMargin':14,'actorMargin':80,'mirrorActors':false}}}%%
sequenceDiagram
  autonumber
  participant B as 業務程式（指派任務）
  participant C as 通知中心套件
  participant DB as 收件匣
  participant D as jedi-notification
  participant W as 瀏覽器（鈴鐺）
  B->>C: 通知（事件＝任務指派，對象＝任務，收件人＝被指派者）
  C->>C: 查事件型錄：類別、預設管道、是否必收
  C->>C: 查收件人偏好與租戶設定
  C->>DB: 寫入一筆未讀通知（含連結與合併鍵）
  alt 偏好含 Email 且不在勿擾時段
    C->>D: 立即寄信
  else 選了每日摘要
    C->>DB: 排進摘要佇列，09:00 一次寄
  end
  C-->>W: 推送未讀數（第三期即時；第一期每 60 秒輪詢）
  W->>W: 鈴鐺紅點 5 → 6
  W->>DB: 點開那筆 → 標已讀，跳到任務頁
```

### 既有東西怎麼處理

沿用不動的：投遞套件 jedi-notification（它就是圖裡的「外送」）；租戶的 Discord、Telegram 設定；公告套件的發布流程（加一行發事件）；SocketIO 與登入驗證（把拔掉的通知頻道接回來）；管理員身分判定（「誰算管理員」沿用授權到期通知那份定義，不另寫一份）。

改成接通知中心的：十四個寄信點各改成一行「通知」呼叫，信的主旨與內文範本沿用；鈴鐺元件換成讀收件匣，「待辦任務」那一段從鈴鐺移除（它屬於「我的任務」頁，不是通知）；現有那張寄信紀錄表降級為投遞紀錄（成功、失敗、重試），不再被鈴鐺反查。

新開的：套件本身（事件型錄、收件匣、偏好、路由、摘要）；收件匣頁、偏好頁、管理頁三個前端頁面；橫幅元件；兩張資料表（收件匣、偏好）與一張租戶層的事件設定表。

### 為什麼其他產品（含日後的 Agent 主控台）能直接裝

套件不綁 Postgres、不綁多租戶隔離、不綁 Flask 的登入方式，這三樣都是透過接口由產品端提供。Agent 主控台是同一套前端框架、資料庫是 SQLite、使用者只有登入主控台的那幾個人，接上去就是：儲存接口換 SQLite 實作、使用者名冊接口換主控台的本機帳號、即時推播接口先給「不推、輪詢」。Agent 自己的事件（失聯、掃描完成、新版）寫進本機收件匣；要回主系統的事件（離線、憑證到期）則由主系統那邊在收到心跳或事件時發主系統的通知，兩邊各管各的收件匣，不同步。

### 資安邊界

通知內容不帶機敏資料：不放密碼、token、完整弱點細節，只放標題與連結，點進去照既有頁面權限判定。收件匣有租戶隔離，跨租戶查不到。Email 外送內容與現在相同，沒有新增外洩面。SocketIO 頻道接回來時只推「未讀數變了」這個訊號，不推內容，瀏覽器收到訊號再用一般 API 拉清單，避免即時頻道變成第二條資料出口。

## 分期與完成判定

三期。每期寫做什麼、怎麼親手驗、大概幾張卡（卡＝一個人一個 session 做得完的一棒，數字是估計，開卡時會再拆）。

### 第一期：看得見

**做什麼**：套件骨架與收件匣表、鈴鐺換成收件匣、通知中心頁、未讀數每 60 秒更新。先接四種事件：新任務指派、流程進站、掃描新增嚴重弱點、新公告發布。原有的 Email 照舊寄，不動。

**怎麼驗**：指派一張任務給自己：一分鐘內鈴鐺出現紅點，點開看到那筆，點進去到任務頁，回來那筆變已讀、紅點數字少一。發一則公告：範圍內的人鈴鐺多一筆。

**前提**：無。這期不改任何既有行為，只加。

### 第二期：全部事件改走中心，加偏好

**做什麼**：型錄裡每一列都接上（含十個今天沒有的）；十四個寄信點改成一行呼叫，Email 由中心照設定決定寄不寄；「通知設定」頁（23 行、8 個鎖住）。

**怎麼驗**：到通知設定頁把「新任務指派給我」的 Email 關掉，請人指派一張任務給你：站內有、信箱沒有。開回來再試一次：信有。「掃描新增嚴重弱點」那行是鎖的，點不動。

**前提**：第一期合回。

### 第三期：即時、橫幅、合併、摘要

**做什麼**：接回 SocketIO 通知頻道，未讀數即時更新；系統橫幅三種事件；同一物件短時間多筆合併成一筆；Email 每日、每週摘要與勿擾時段。

**怎麼驗**：開兩個瀏覽器分別登兩個帳號，A 指派任務給 B，B 不重整三秒內鈴鐺變。更新中心偵測到新版：平台管理員每一頁頂部出現橫幅，關掉後不再出現但收件匣有。

**前提**：第二期合回。

Agent 主控台本案不做（PM 2026-11-11 裁）。主系統仍在第二期發 Agent 離線、恢復、更新完成、更新失敗事件給管理員；套件的接口保留，日後要讓主控台裝只換儲存與帳號名冊兩張接口。

## 八項決策（2026-11-11 全部定案）

每項先寫定案，再寫為什麼、排除了什麼。D2 與 D3 討論後合併成一項。

::: {.callout .decided}

**D1 定案 鈴鐺只放通知；底部固定一行「我的待辦任務（N）」連到任務頁**

鈴鐺點開是通知收件匣，紅點數字只算通知未讀數。最底下固定一行「我的待辦任務（12）」，點了到「我的任務」頁，那個數字不計進紅點。通知是「發生了一件事」，看過可標已讀；待辦是「還沒做完的工作」，看過還在。同一張任務會同時產生一則「被指派」通知與一筆待辦，進鈴鐺的是前者。

排除「鈴鐺上下兩段都放清單」：未讀數會混淆（紅點 5 是五則通知還是五張沒做的任務），而且待辦永遠清不空、鈴鐺永遠亮著。

:::

::: {.callout .decided}

**D2＋D3 定案 只做一頁「通知設定」，23 個事件全部展開各一行、三個管道自選；不做類別總開關；8 個必收鎖住、出貨寫死**

不分「管理員通知管理頁」與「個人偏好頁」兩頁，只做個人設定裡的一頁。23 個事件全部展開，每個事件一行、三格開關（站內、Email、聊天工具）；5 個類別只當分組標題，不做「一鍵開關整類」。決策者裁：純類別級做不到「同一類裡只關一個」，兩層可展開又多一個動作，直接全部展開最直接。資料按事件存。

必收名單 8 個（判準見事件型錄）：掃描新增嚴重弱點、Agent 離線、Agent 憑證到期、Agent 更新失敗、授權到期、排定維護、本機管理員登入 Agent、密碼到期與帳號鎖定。這 8 個的站內與 Email 鎖住、標「必收」，聊天工具仍可自選。名單出貨寫死，要改等版本。

新事件要改程式（「什麼時候算發生」是程式判斷的），跟著新功能一起出，開發時在事件型錄表登記一列，與新權限點、新選單同一套做法；事件的名稱、類別、預設管道存資料表，不寫死。

沒做的三件（有客戶要再補一頁管理頁，資料層不用改）：管理員關掉整個租戶的某事件、看近三十天發送量、增減必收名單。

:::

::: {.callout .decided}

**D4 定案 未讀永遠留；已讀與封存 90 天後清；投遞紀錄另留 180 天**

天數進系統設定讓管理員改。投遞紀錄（寄了沒、失敗原因）給客服排障用。

:::

::: {.callout .decided}

**D5 定案 即時推播放第三期，第一期每 60 秒輪詢未讀數**

通知不是聊天，一分鐘延遲沒人會抱怨；先把事件接齊比快三秒重要。第三期接回 SocketIO 通知頻道，只推「未讀數變了」訊號不推內容。

:::

::: {.callout .decided}

**D6 定案（先照此，可再議） Discord、Telegram 維持租戶層級頻道，不做個人綁定**

通知設定頁那一欄的意思是「要不要推到租戶的頻道」。個人綁定（每個人綁自己的 Telegram）列第五期候選。

:::

::: {.callout .decided}

**D7 定案（後 PM 裁 Agent 主控台本案不做） Agent 狀態由主系統發；Agent 端收件匣不做**

主系統管理員要的是「Agent 狀態」（離線、憑證、更新），由主系統在收到心跳或事件時自己發。Agent 主控台本身不裝通知中心；套件接口保留讓日後能裝。

:::

::: {.callout .decided}

**D8 定案 新套件 jedi-notification-center，依賴 jedi-notification 當外送實作**

jedi-notification 維持純投遞（怎麼寄），登入 OTP、設密碼這類交易信繼續直接用它，不經過中心。通知中心塞進去會把投遞與路由綁死，其他產品要裝通知中心就得連 SMTP 那堆一起帶。

:::

## 不做什麼

- **Agent 主控台**：PM 2026-11-11 裁本案不做；主系統仍發 Agent 離線、恢復、更新完成、更新失敗事件給管理員；套件接口保留。
- **瀏覽器桌面推播（Web Push）**：需要 HTTPS 與 service worker，落地版客戶常用自簽憑證或 http 加 IP 開站，一半環境跑不起來；而且與落地版「不出網」的原則衝突（Web Push 要經瀏覽器廠商的推播伺服器）。列第五期以後候選。
- **手機 App 推播、簡訊**：沒有 App、沒有簡訊閘道，不做。
- **Email 讀取回條、連結點擊追蹤**：資安掃描會當追蹤器，不做。
- **通知裡直接回覆或留言**：留言功能屬於任務本身，不在通知層做。
- **登入 OTP、建帳號設密碼這類交易信**：必須寄、不能關、不進收件匣，維持現在的直接寄信。

## 附：現況數字的來源

鈴鐺兩種來源：前端頂欄元件與「流程站等你接手」查詢；十四種 Email：程式碼中的信件主旨語系鍵；公告類別：資料庫選單表 BULLETIN_CATEGORY；已拔除的通知頻道：變更紀錄「拔除沒人用的流程討論：即時通知頻道與流程留言 API」；投遞套件：jedi-notification 1.2.4；公告套件：jedi-bulletin 1.2.2。DEV 資料庫查詢皆為唯讀。
