本卡屬 FR-196(母卡 CM-3875(已建)),卡 M-3,第二期批 6。只改 BE(主 repo,Repo 欄空著)。依賴:P-3、S-2、M-2。

這張卡做什麼(白話)

主系統把套件的外送接起來:外送紀錄寫進擴欄後的 FR-137 表(既有的「同物件同收件人只寄一次」去重沿用);第一期四處「照舊寄」的 Email 改由中心決定(把既有寄信呼叫拿掉,只留 notify);三個排程:每小時寄到時的摘要、每日 03:00 清過期已讀、每分鐘判 Agent 離線。做完後 Email 是否寄完全看使用者設定。

reuse/extend/new

extend:_notification_center_ports.py 加 OutboundStore(包 task_alert_notification_domain_service.claim/mark,address 用既有 recipient_email,新四欄一起寫);第一期 M-2 加的四處 notify 旁邊的既有寄信呼叫拿掉(改由中心寄);排程照 core/scheduler_update.py 形狀新檔;清理用 system_configs 的兩個天數,批次 delete 每批 5000

在哪裡

repo:~/Projects/Billows/Audit-Manager/compliance-manager-be
改既有:core/plugins/_notification_center_ports.py
改既有:core/plugins/notification_center.py(adapters 加 outbound_store)
改既有:core/app_factory.py(註冊 scheduler_notification,照 scheduler_update 那一行)
改既有:app/flow_engine/service/workflow_execution_service.py(1246 附近:拿掉既有寄信,只留 notify)
改既有:app/flow_engine/service/stage_entered_notify_service.py(同)
改既有:app/task_alert/service/scan_alert_app_service.py(同)
新開:core/scheduler_notification.py
新開:test/test_notification_center_scheduler.py(清理只刪已讀逾期;離線 tick 對 last_seen_at 超過分鐘數的 agent 發一次且不重發)

怎麼做

驗收(首腦照這個驗)

DEV:指派任務給自己(Email 設定開)→ 收到一封且 task_alert_notifications 多一列帶 inbox_id/channel=email;關掉 Email 再指派 → 沒信、inbox 有;設 daily → 列的 scheduled_at 是明早 09:00;把 retention 設 1、造一筆兩天前已讀 → 跑 tick 消失、未讀不消失;停一台 Agent 容器 16 分鐘 → 管理員 inbox 多一列 agent.offline,再等一分鐘不重發;三條測試綠;BE 重啟無錯

必讀