FR-196 · 需求討論稿 · 2026-11-11(v2:D1~D8 全定案;Agent 主控台 PM 裁不做)
現況盤點、成熟產品六個共通模式、功能建議、事件型錄、架構與模組化、三期分工、八項決策
現在使用者只會在兩種情況下被系統主動提醒:鈴鐺裡的待辦任務,以及 Email。公告發了沒人看到、掃描掃出嚴重弱點只寄信、系統有新版只寄給管理員、有人用本機管理員登入 Agent 也只寄信。這份稿子盤點現況、對照市面成熟產品的做法,提出一套可以分期做、做成獨立套件的通知中心;八項決策已於 2026-11-11 定案,設計落在 design.md。
一句話:把產品裡所有「要讓人知道一件事」的動作收進同一個入口,由通知中心決定誰收、站內還是 Email、立刻還是彙整,使用者在鈴鐺與收件匣看到、自己調偏好;做成獨立套件,Agent 主控台與其他產品直接裝。
建議分三期。第一期就讓人看得到東西:鈴鐺有未讀數、點開看最近通知、有一頁完整收件匣,先接四種最常發生的事件。第二期把十四種 Email 全部改走通知中心,加「通知設定」頁(23 個事件全部展開各自設定)。第三期即時推播與系統橫幅。Agent 主控台本案不做(PM 2026-11-11 裁),套件接口保留讓日後能裝。每一期結束都能親手驗一個動作,判定方法寫在分期那節。
先講畫面上看得到的。右上角的鈴鐺點開是一份清單,混放兩種東西:「指派給我的待辦任務」與「流程進到我負責的站」。這份清單只在頁面載入時抓一次,不會自己更新、沒有已讀未讀、沒有時間、點了不會消失(任務做完才消失)。除此之外畫面上沒有任何主動提醒;操作結果的 toast 是另一回事,那是當下回饋、三秒就消失、重整就沒了。
公告是獨立的一頁,要從首頁的連結點進去才看得到,發布新公告時沒有任何提示。公告有類別(系統、活動、新聞、其他)與發送範圍(全公司、指定部門),但沒有已讀紀錄,也沒有「置頂」或「橫幅」這種強提醒。
其他事情全靠 Email。程式碼裡總共十四種信,列在下面的事件型錄。收件人由各段程式自己決定(專案成員、租戶管理員、任務處理人),使用者沒有任何地方可以選「這種信我不要收」。Discord 與 Telegram 只有專案啟動與批次完成兩種事件會推,而且是租戶層級的設定,推到一個頻道,不是推給某個人。
/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 天內到期(管理員)、排定維護(全部人,由平台管理員手動發)。關閉後不再出現,但收件匣留一筆。
公告發布時自動產生一筆「公告」類通知給發送範圍內的所有人,點了到那則公告。公告頁本身不動。這樣公告終於有人看得到,也不用另外做「公告已讀」。
這張表是通知中心的核心資料,也是「通知設定」頁上會出現的每一行。每列寫事件什麼時候發生、誰該收、是必收還是可自選、為什麼。判準兩條同時成立才必收:①漏看會造成實際損失(資安曝險、系統停擺、被鎖在外面),不只是不方便;②收件人是因職責收到,不是因興趣。有一條不成立就讓人自己選。
| 類別 | 事件 | 誰收 | 必收/可自選 | 理由 |
|---|---|---|---|---|
| 任務與流程 | 新任務指派給我 | 被指派的人 | 可自選 | 量最大,有到期提醒兜底 |
| 批次指派(一次多張) | 被指派的人 | 可自選 | 同上 | |
| 任務今天到期/已逾期 | 處理人 | 可自選 | 延遲由 PM 追,不是損失 | |
| 流程進到我負責的站 | 該站負責人;無人時 PM | 可自選 | 同上 | |
| 關卡送審、核可、退回 | 下一關的人;退回時原處理人 | 可自選 | 同上 今天沒有 | |
| PM 手動寄任務提醒 | 勾選的處理人 | 可自選 | PM 主動發的,本來就是提醒 | |
| 批次任務完成 | PM | 可自選 | 資訊性 | |
| 專案 | 專案啟動、分派角色 | 專案成員 | 可自選 | 資訊性 |
| 輪次結束、專案結案 | 專案成員 | 可自選 | 資訊性 今天沒有 | |
| 結案報告產出 | PM、顧問 | 可自選 | 資訊性 今天沒有 | |
| 掃描與 Agent | 掃描新增嚴重/高風險弱點 | 專案 PM、資安負責人 | 必收 | 漏看=弱點放著不修 |
| 檢測任務完成、報告回收 | 任務處理人 | 可自選 | 任務狀態也看得到 今天沒有 | |
| Agent 離線超過 N 分鐘、恢復連線 | 租戶管理員 | 必收 | 離線=客戶端掃描與蒐證全停 今天沒有 | |
| Agent 憑證即將到期 | 租戶管理員 | 必收 | 過期要重註冊 | |
| Agent 更新失敗 | 租戶管理員 | 必收 | 可能卡在半更新 今天沒有 | |
| Agent 更新完成 | 租戶管理員 | 可自選 | 資訊性 今天沒有 | |
| 系統與帳號 | 系統有新版可更新 | 平台管理員 | 可自選 | 更新中心也看得到;含資安修正時目前分不出來,先不鎖 |
| 授權、支援合約即將到期 | 租戶管理員 | 必收 | 到期進唯讀 | |
| 排定維護 | 全部使用者 | 必收 | 要知道何時不能用 今天沒有 | |
| 有人用本機管理員登入 Agent | 租戶管理員 | 必收 | 繞過主系統身分的登入 | |
| 我的密碼即將到期、帳號被鎖 | 本人 | 必收 | 不收會被鎖在外面 今天沒有 | |
| 公告與回饋 | 新公告發布 | 發送範圍內的人 | 可自選 | 重要的事應走「排定維護」 今天沒有 |
| 我的回饋有原廠回覆 | 送件人 | 可自選 | 資訊性(回饋第二期) |
「今天沒有」共十個:現在完全沒有任何提醒的事件。登入 OTP、建帳號設密碼是交易信,必須寄、不能關、不進收件匣,不在表內。必收的意思:那一行的站內與 Email 兩格鎖住並標「必收」,使用者看得到但改不了;聊天工具那格仍可自選。必收名單出貨寫死,要改等版本。
三個畫面加一條橫幅,全部用產品現有的卡片語彙畫,區塊一律上下疊。文案是示意,實作時依既有 i18n 用語重寫。
畫面示意見 prototype/index.html(四個分頁:鈴鐺、通知中心、通知設定、系統橫幅)。
核心主張:通知中心是一個「事件進來、通知出去」的樞紐,它不認識任務、專案、掃描這些業務概念,只認識「事件代碼、收件人、連結、內容參數」。業務程式只做一件事:發生了什麼就呼叫一次「通知」;誰收、走哪個管道、要不要彙整、存在哪裡,全部由樞紐決定。這樣既有十四個寄信點每個只改成一行,而且 Agent 或其他產品裝上同一套件就有同一套行為。
%%{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
%%{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 與登入驗證(把拔掉的通知頻道接回來);管理員身分判定(「誰算管理員」沿用授權到期通知那份定義,不另寫一份)。
改成接通知中心的:十四個寄信點各改成一行「通知」呼叫,信的主旨與內文範本沿用;鈴鐺元件換成讀收件匣,「待辦任務」那一段從鈴鐺移除(它屬於「我的任務」頁,不是通知);現有那張寄信紀錄表降級為投遞紀錄(成功、失敗、重試),不再被鈴鐺反查。
新開的:套件本身(事件型錄、收件匣、偏好、路由、摘要);收件匣頁、偏好頁、管理頁三個前端頁面;橫幅元件;兩張資料表(收件匣、偏好)與一張租戶層的事件設定表。
套件不綁 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 離線、恢復、更新完成、更新失敗事件給管理員;套件的接口保留,日後要讓主控台裝只換儲存與帳號名冊兩張接口。
每項先寫定案,再寫為什麼、排除了什麼。D2 與 D3 討論後合併成一項。
D1 定案 鈴鐺只放通知;底部固定一行「我的待辦任務(N)」連到任務頁
鈴鐺點開是通知收件匣,紅點數字只算通知未讀數。最底下固定一行「我的待辦任務(12)」,點了到「我的任務」頁,那個數字不計進紅點。通知是「發生了一件事」,看過可標已讀;待辦是「還沒做完的工作」,看過還在。同一張任務會同時產生一則「被指派」通知與一筆待辦,進鈴鐺的是前者。
排除「鈴鐺上下兩段都放清單」:未讀數會混淆(紅點 5 是五則通知還是五張沒做的任務),而且待辦永遠清不空、鈴鐺永遠亮著。
D2+D3 定案 只做一頁「通知設定」,23 個事件全部展開各一行、三個管道自選;不做類別總開關;8 個必收鎖住、出貨寫死
不分「管理員通知管理頁」與「個人偏好頁」兩頁,只做個人設定裡的一頁。23 個事件全部展開,每個事件一行、三格開關(站內、Email、聊天工具);5 個類別只當分組標題,不做「一鍵開關整類」。決策者裁:純類別級做不到「同一類裡只關一個」,兩層可展開又多一個動作,直接全部展開最直接。資料按事件存。
必收名單 8 個(判準見事件型錄):掃描新增嚴重弱點、Agent 離線、Agent 憑證到期、Agent 更新失敗、授權到期、排定維護、本機管理員登入 Agent、密碼到期與帳號鎖定。這 8 個的站內與 Email 鎖住、標「必收」,聊天工具仍可自選。名單出貨寫死,要改等版本。
新事件要改程式(「什麼時候算發生」是程式判斷的),跟著新功能一起出,開發時在事件型錄表登記一列,與新權限點、新選單同一套做法;事件的名稱、類別、預設管道存資料表,不寫死。
沒做的三件(有客戶要再補一頁管理頁,資料層不用改):管理員關掉整個租戶的某事件、看近三十天發送量、增減必收名單。
D4 定案 未讀永遠留;已讀與封存 90 天後清;投遞紀錄另留 180 天
天數進系統設定讓管理員改。投遞紀錄(寄了沒、失敗原因)給客服排障用。
D5 定案 即時推播放第三期,第一期每 60 秒輪詢未讀數
通知不是聊天,一分鐘延遲沒人會抱怨;先把事件接齊比快三秒重要。第三期接回 SocketIO 通知頻道,只推「未讀數變了」訊號不推內容。
D6 定案(先照此,可再議) Discord、Telegram 維持租戶層級頻道,不做個人綁定
通知設定頁那一欄的意思是「要不要推到租戶的頻道」。個人綁定(每個人綁自己的 Telegram)列第五期候選。
D7 定案(後 PM 裁 Agent 主控台本案不做) Agent 狀態由主系統發;Agent 端收件匣不做
主系統管理員要的是「Agent 狀態」(離線、憑證、更新),由主系統在收到心跳或事件時自己發。Agent 主控台本身不裝通知中心;套件接口保留讓日後能裝。
D8 定案 新套件 jedi-notification-center,依賴 jedi-notification 當外送實作
jedi-notification 維持純投遞(怎麼寄),登入 OTP、設密碼這類交易信繼續直接用它,不經過中心。通知中心塞進去會把投遞與路由綁死,其他產品要裝通知中心就得連 SMTP 那堆一起帶。
鈴鐺兩種來源:前端頂欄元件與「流程站等你接手」查詢;十四種 Email:程式碼中的信件主旨語系鍵;公告類別:資料庫選單表 BULLETIN_CATEGORY;已拔除的通知頻道:變更紀錄「拔除沒人用的流程討論:即時通知頻道與流程留言 API」;投遞套件:jedi-notification 1.2.4;公告套件:jedi-bulletin 1.2.2。DEV 資料庫查詢皆為唯讀。