FR-196 · 需求索引 · 本頁由 build 掃資料夾生成

FR-196 通知中心

✅ 已交付(2026-11-14):三期 22 張+手測修正 R-1~R-5 全部 Done;套件 0.2.0 已發版、主系統已改釘、出貨基線已重產、三 repo 已 push;未合 main、未上 STG/POC

狀態:✅ 已完成 文件 10 份 handoff 3 份
§1

🔴 先看哪一份

文件 性質 什麼時候看
FINAL-SPEC.md 定版(隨現況改寫) 現在長什麼樣:交付物總表與索引
spec/01 事件型錄~07 維運與收口 定版,一題一頁 要查事件、表、API、套件接口、主系統接線、前端、維運時直接開對應頁
design.md 設計(v1.0 定稿) 為什麼這樣決定、排除了什麼;§6 拆卡表
discussion.md 設計(討論稿 v2) 現況盤點、成熟產品對照、八項決策理由
prototype/index.html 設計(純畫面雛形) 畫面示意
handoff/cards.py 證據(拆卡底表) 22 張卡的範圍與驗收
§2

結論

  • 通知做成新套件 jedi-notification-center:事件型錄、收件匣、通知設定、路由與摘要;既有 jedi-notification 維持純投遞;交易信(OTP、設密碼)不進中心。
  • 鈴鐺只放通知,底部一行「我的待辦任務(N)」,N 不計紅點。
  • 通知設定一頁:23 個事件全部展開各一行、三個管道開關;8 個必收鎖住、名單出貨寫死;不做租戶管理頁。
  • 即時推播第三期;Discord/Telegram 維持租戶頻道;Agent 主控台本案不做(PM 裁),Agent 離線/更新事件由主系統發,套件 port 契約保留。
  • 新開五張表(型錄、收件匣、個人設定、個人設定檔、維護排程)+擴充 FR-137 既有的寄信紀錄表當外送佇列;主系統 8 條 API+2 條維護排程。
  • 重複設計盤點後改沿用:橫幅用頁面頂部既有四支元件(補兩支)、投遞紀錄不另開表、去重改靠合併鍵、通知設定頁另開路由。
§3

📊 總進度

棒 卡 做什麼 狀態
討論稿 — 現況盤點、模式對照、八項決策 ✅ 2026-11-11 定案
設計 v1.0 — 資料表、API、port 契約、三期;重複設計盤點修四處 ✅ 2026-11-11 過稿
E-1 CM-3876 批 1 · 環境卡 ✅ Done
P-1 CM-3877 批 1 · jedi-notification-center 0.1 ✅ Done
S-1 CM-3878 批 2 · 主線 seed migration ✅ Done
P-2 CM-3879 批 2 · jedi-notification-center RES ✅ Done
M-1 CM-3880 批 3 · 主系統掛載 jedi-notification-cent ✅ Done
F-3 CM-3881 批 3 · FE 登記型檔 owner ✅ Done
F-1 CM-3882 批 4 · FE 鈴鐺元件 NotificationBell.vue ✅ Done
F-2 CM-3883 批 4 · FE 通知中心頁 NotificationInboxVi ✅ Done
M-2 CM-3884 批 4 · 主系統第一期四個事件接入 notify() ✅ Done
P-3 CM-3885 批 5 · jedi-notification-center 外送層 ✅ Done
S-2 CM-3886 批 5 · 主線 migration ✅ Done
F-4 CM-3887 批 5 · FE 通知設定頁 NotificationSetting ✅ Done
M-3 CM-3888 批 6 · 主系統外送接線 ✅ Done
M-4 CM-3889 批 7 · 主系統其餘寄信點改接 notify()(第 5~14 處 ✅ Done
M-5 CM-3890 批 7 · 主系統今天沒有的事件補發(第二期) ✅ Done
M-6 CM-3891 批 7 · 退役第一期前的舊鈴鐺端點與查詢 ✅ Done
F-5 CM-3892 批 8 · FE 退役舊鈴鐺殘留 ✅ Done
P-4 CM-3893 批 8 · jedi-notification-center 合併 ✅ Done
P-5 CM-3894 批 8 · jedi-notification-center 即時 ✅ Done
S-3 CM-3895 批 8 · 主線 seed ✅ Done
M-7 CM-3896 批 9 · 主系統第三期接線 ✅ Done
F-6 CM-3897 批 10 · FE 第三期 ✅ Done
§4

需求討論紀錄

  • 2026-11-14 收尾:套件 jedi-notification-center 0.2.0 首次發 Nexus、主系統改釘、出貨基線重產(含通知中心結構與能力點)、三 repo push;SPEC 手冊三頁與使用手冊開卡 CM-3937(FR-196.1.D-2)。總結見 handoff/2026-11-14-FR-196-SUMMARY.md,設計取捨見 docs/analysis/2026-11-14-notification-center-design-decisions.md。

  • 2026-11-11 決策者:通知功能半殘,只有任務在鈴鐺;要照成熟產品的通知中心做、模組化、Agent 能用;產出先用 Artifact 分享。

  • 2026-11-11 決策者裁 D1 鈴鐺只放通知+底部待辦一行;D2 原裁「照類別」,追問後改「全部展開」(純類別做不到同類只關一個,可展開版多一個動作);D3 討論「必收名單怎麼來」後裁掉管理員頁,一頁通知設定、必收出貨寫死;D4~D8 照建議,D6 註記「先照此,可再議」。

  • 2026-11-11 PM 裁 Agent 主控台先不做:第四期拿掉,三期交付;Agent 相關事件留在主系統端第二期。

  • 2026-11-12 工作坊一夜跑完 22 張;首腦實質驗收:套件 171 測試、主 repo 179 passed(1 紅是基線重產前的預期)、FE build/lint/8 測試綠,8010 起工作區 BE 實打十條端點(401/404/412/冪等/持久化)皆對;DEV 收件匣 44 筆、外送 26 筆。設計差異:事件 25 個(密碼到期與鎖定、離線與恢復各拆兩個)、掃描警示對 SSP Party 聯絡人保留直寄。

  • 2026-11-12 決策者要求把實際改了什麼回寫成詳細開發規格、拆多頁:FINAL-SPEC.md+spec/ 七頁,站 builder 加 spec/ 歸「定版交付」。

  • 2026-11-11 決策者裁「半夜無人值守跑」「收尾由我們驗收不開卡、只開開發卡」;先裁分批開卡(第一期 9 張 CM-3875 母~3884),隨後改「三期都開」,補第二、三期 13 張 CM-3885~3897;共 22 張 10 批。卡上每個分岔定死、rules 加無人值守條。

  • 2026-11-11 決策者問「有沒有看過重複設計」:補盤後抓到四處(橫幅已有四支元件、FR-137 表已有去重與摘要合信、兩處去重戳、個人資料頁無分頁),設計改為沿用,不開 v1.1(未定稿直接改)。

  • 2026-11-11 決策者點名三次稿子呈現問題(暗色主題圖被吃、圖字太小、頁面鎖窄欄),落成圖表規範(記憶 feedback_diagram_font_18px_no_shrink_fixed_light)。

§5

文件

以下全部由 build 掃資料夾產生,新增檔案重 build 即自動出現。標題連結指向渲染後的 HTML,md 連向源檔。

定版交付

文件 類型 標題 最後更新
FINAL-SPEC / md 定版交付 ▸ 通知中心 定版 SPEC 2026-11-12

需求與討論

文件 類型 標題 最後更新
discussion / md 需求討論稿 通知中心:從「鈴鐺只有任務」到一個完整的通知系統 2026-11-11

設計

文件 類型 標題 最後更新
design / md 設計 通知中心 — 設計文件 v1.0 2026-11-12

spec/(7 份)

定版交付

文件 類型 標題 最後更新
01-事件型錄 / md 文件 01 事件型錄 未提交
02-資料表 / md 文件 02 資料表 未提交
03-API / md 文件 03 API 2026-11-12
04-套件接線 / md 文件 04 套件接線 未提交
05-主系統接線 / md 文件 05 主系統接線 未提交
06-前端 / md 文件 06 前端 未提交
07-維運與收口 / md 文件 07 維運與收口 未提交

交接與收口時間軸(handoff/,3 份)

由新到舊。每份是某一棒次交接當下的完整現況快照,看某個時間點「當時知道什麼」請從這裡進。

日期 文件 標題
2026-11-13 FR-196-STATE / md FR-196 通知中心 交接現況(STATE)
2026-11-13 FR-196-LOG / md FR-196 通知中心 交接日誌(LOG,append-only)
未提交 2026-11-14-FR-196-SUMMARY / md FR-196 通知中心+FR-196.1 租戶層通知管理 收尾總結

資產子資料夾(無文件,不建頁):prototype/(1 個檔)

§6

Notion 卡

卡片內容(決策紀錄、驗收條件)以 Notion 為準,本頁只記座標。

關係 卡號 標題 狀態
母案 CM-3875 FR-196 母案 —
子卡 CM-3876 FR-196.E-1 Done
子卡 CM-3877 FR-196.P-1 Done
子卡 CM-3878 FR-196.S-1 Done
子卡 CM-3879 FR-196.P-2 Done
子卡 CM-3880 FR-196.M-1 Done
子卡 CM-3881 FR-196.F-3 Done
子卡 CM-3882 FR-196.F-1 Done
子卡 CM-3883 FR-196.F-2 Done
子卡 CM-3884 FR-196.M-2 Done
子卡 CM-3885 FR-196.P-3 Done
子卡 CM-3886 FR-196.S-2 Done
子卡 CM-3887 FR-196.F-4 Done
子卡 CM-3888 FR-196.M-3 Done
子卡 CM-3889 FR-196.M-4 Done
子卡 CM-3890 FR-196.M-5 Done
子卡 CM-3891 FR-196.M-6 Done
子卡 CM-3892 FR-196.F-5 Done
子卡 CM-3893 FR-196.P-4 Done
子卡 CM-3894 FR-196.P-5 Done
子卡 CM-3895 FR-196.S-3 Done
子卡 CM-3896 FR-196.M-7 Done
子卡 CM-3897 FR-196.F-6 Done