FR-196.1 · 定版 SPEC · 現況描述
必收事件與群組推送由租戶管理員決定;完整規格併在 FR-196 spec 六頁對應節
FR-196 通知中心之上,本案把兩件事從「每個人自己決定」改成「租戶管理員決定」:哪些事件必收、哪些事件推到租戶的 Discord 與 Telegram 群組。本頁只放摘要與指向,欄位、規則與畫面的完整描述在 FR-196 spec 各頁。
租戶管理員在系統設定 › 通知管理決定兩件事:每個事件要不要推到 Discord、Telegram 群組(兩個頻道各自勾),以及哪些事件必收(全租戶站內與 Email 關不掉、Email 當場寄)。個人通知設定頁只剩站內與 Email 兩欄。租戶沒存過規則時照出貨型錄:原廠建議的九個必收,任務指派、批次指派、批次完成、專案啟動四個推群組。
| 主題 | 現況 | 完整規格 |
|---|---|---|
| 必收的判準與名單 | 型錄 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 維運與收口 |
%%{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: 回寫進收件匣的列數
mandatory,兩個頻道取型錄 default_chat;之後版本新增的事件也自動採用。tenant_id 取自登入身分;PUT 是全表覆寫,未列的事件回到型錄預設。PUT 是全表覆寫,所以每顆儲存只送本分頁的欄位、其他欄位送伺服器值,避免把別的分頁未確認的改動一起存進去。| 沒做完的事 | 說明 | 誰接 |
|---|---|---|
| 套件發版與改回釘版 | 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 個人綁定 | 現在是租戶頻道 | 候選 |
| 你想知道 | 看哪份 |
|---|---|
| 現在長什麼樣、欄位與規則 | 本頁與 FR-196 spec 六頁對應節 |
| 為什麼這樣決定、排除了什麼 | design.md(設計,凍結)、discussion.md(討論稿) |
| 畫面示意 | prototype/index.html |
| 哪一棒做了什麼 | Notion 母卡與子卡回寫、git log |