---
title: "租戶層通知管理 — 定版 SPEC (FR-196.1)"
brand: "Guidant AI · **FR-196.1** 租戶層通知管理"
eyebrow: "FR-196.1 · 定版 SPEC · 現況描述"
h1: "▸ 租戶層通知管理 定版 SPEC"
subtitle: "必收事件與群組推送由租戶管理員決定；完整規格併在 FR-196 spec 六頁對應節"
lede: "FR-196 通知中心之上，本案把兩件事從「每個人自己決定」改成「租戶管理員決定」：哪些事件必收、哪些事件推到租戶的 Discord 與 Telegram 群組。本頁只放摘要與指向，欄位、規則與畫面的完整描述在 [FR-196 spec](../FR-196-2611-notification-center/FINAL-SPEC.md) 各頁。"
chips: [
  {text: "套件 0.2.0、新增 2 條管理端點", kind: accent},
  {text: "新表 notification_tenant_event_rules；migration +1 支", kind: accent},
  {text: "不新增能力點", kind: plain},
  {text: "沒存過規則＝照出貨型錄，舊客戶行為不變", kind: ok}
]
footer: "FR-196.1 · 定版 SPEC · 設計理由見 design.md、討論稿 discussion.md · 沿革見 Notion 母卡與 git log"
---

## 一句話 {#tldr nav="一句話"}

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

## 交付物 {#deliverables nav="交付物"}

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

## 端到端 {#flow nav="流程"}

```{.mermaid cap="圖 1　一則事件怎麼決定送到哪。第 3 步查租戶規則，查不到列就用型錄；第 5 步必收看租戶生效值；群組推送每個頻道各自判斷、各自一列外送，一個失敗不影響另一個。"}
%%{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: 回寫進收件匣的列數
```

## 要記得的規則 {#rules nav="規則"}

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

## 這一輪沒做完的 {#remaining nav="沒做完的"}

| 沒做完的事 | 說明 | 誰接 |
|---|---|---|
| 套件發版與改回釘版 | `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 個人綁定 | 現在是租戶頻道 | 候選 |

## 這份文件的定位 {#scope nav="本頁定位"}

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