FR-196.1 · 定版 SPEC · 現況描述

▸ 租戶層通知管理 定版 SPEC

必收事件與群組推送由租戶管理員決定;完整規格併在 FR-196 spec 六頁對應節

FR-196 通知中心之上,本案把兩件事從「每個人自己決定」改成「租戶管理員決定」:哪些事件必收、哪些事件推到租戶的 Discord 與 Telegram 群組。本頁只放摘要與指向,欄位、規則與畫面的完整描述在 FR-196 spec 各頁。

套件 0.2.0、新增 2 條管理端點 新表 notification_tenant_event_rules;migration +1 支 不新增能力點 沒存過規則=照出貨型錄,舊客戶行為不變
§1

一句話

租戶管理員在系統設定 › 通知管理決定兩件事:每個事件要不要推到 Discord、Telegram 群組(兩個頻道各自勾),以及哪些事件必收(全租戶站內與 Email 關不掉、Email 當場寄)。個人通知設定頁只剩站內與 Email 兩欄。租戶沒存過規則時照出貨型錄:原廠建議的九個必收,任務指派、批次指派、批次完成、專案啟動四個推群組。

§2

交付物

主題 現況 完整規格
必收的判準與名單 型錄 mandatory 是原廠建議,租戶規則決定生效值 01 事件型錄「原廠建議必收」節
資料表 新表 notification_tenant_event_rules(每租戶每事件一列);個人設定表沒有 chat 欄;群組推送的外送列收件人是 chat:discord/chat:telegram 02 資料表
API GET/PUT /admin/tenant-rules,守門沿用 system.notify-config.read/update;/settings 沒有 chat 03 API「租戶規則」節
套件 生效值只在 effective_channels() 一處算,notify、設定頁 412、摘要寄前複查共用;群組推送每頻道各一列;chat_channels_provider 接口 04 套件接線「生效值規則」節
主系統接線 頻道可用性、send_chat 必帶代號、掛載時指定管理端點守門 05 主系統接線
前端 通知管理頁 Discord、Telegram 分頁各一張「推送的事件」卡,新增「必收事件」分頁;個人頁兩欄 06 前端
維運 主線 migration 2026-11-16-fr196-1-tenant-event-rules.sql(內容同套件 migrations/003) 07 維運與收口
§3

端到端

%%{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 jedi-notification-center
  participant R as notification_tenant_event_rules
  participant U as notification_user_settings
  participant H as 主系統(頻道設定、投遞)
  B->>C: notify(事件, 收件人, 主題, 參數)
  C->>C: 查型錄(類別、原廠建議必收、預設管道)
  C->>R: 查這個租戶對這個事件的規則
  C->>U: 查每位收件人的站內與 Email 設定
  C->>C: 每人生效值=個人設定;租戶必收則站內與 Email 強制開
  C->>C: 寫收件匣;Email 照個人彙整與勿擾排期,租戶必收則當場寄
  C->>H: chat_channels_provider():各頻道是否啟用
  loop 每個租戶勾選且啟用的頻道
    C->>H: 外送佇列寫一列(收件人 chat:頻道)並 send_chat(頻道, 文字)
  end
  C-->>B: 回寫進收件匣的列數
圖 1 一則事件怎麼決定送到哪。第 3 步查租戶規則,查不到列就用型錄;第 5 步必收看租戶生效值;群組推送每個頻道各自判斷、各自一列外送,一個失敗不影響另一個。
§4

要記得的規則

  • 沒有租戶規則列=照型錄:必收取型錄 mandatory,兩個頻道取型錄 default_chat;之後版本新增的事件也自動採用。
  • 頻道未啟用時勾了也不推;啟用後自下一則事件起生效,不補推。
  • 收件匣每列的「必收」標籤記的是寄出當時的生效值,租戶改規則不回頭同步;鎖定與 Email 強制看即時規則。
  • 管理端點只讀寫當前租戶,tenant_id 取自登入身分;PUT 是全表覆寫,未列的事件回到型錄預設。
  • 三個分頁各有一顆儲存,但 PUT 是全表覆寫,所以每顆儲存只送本分頁的欄位、其他欄位送伺服器值,避免把別的分頁未確認的改動一起存進去。
§5

這一輪沒做完的

沒做完的事 說明 誰接
套件發版與改回釘版 jedi-notification-center 0.2.0 還沒推 Nexus,主專案目前走本機路徑;發版後改釘 ==0.2.0 FR-196 收口
出貨基線重產 新表與 chat 欄移除還沒進 scripts/init/ FR-196 收口
SPEC 手冊頁 docs/spec-site/current/ 通知管理頁新增的兩個分頁 收口
管理員整個關掉某事件、發送量與投遞紀錄頁 型錄 enabled 欄已留,沒有 UI 有客戶要再開 FR
Discord/Telegram 個人綁定 現在是租戶頻道 候選
§6

這份文件的定位

你想知道 看哪份
現在長什麼樣、欄位與規則 本頁與 FR-196 spec 六頁對應節
為什麼這樣決定、排除了什麼 design.md(設計,凍結)、discussion.md(討論稿)
畫面示意 prototype/index.html
哪一棒做了什麼 Notion 母卡與子卡回寫、git log