本卡屬 FR-196(母卡 CM-3875(已建)),卡 M-5,第二期批 7。只改 BE(主 repo,Repo 欄空著)。依賴:M-3。
補今天完全沒有提醒的六種事件:關卡送審/核可/退回、輪次結束與結案、結案報告產出、檢測任務完成、Agent 更新完成與失敗、密碼即將到期與帳號鎖定。各在對應的業務程式加一行 notify。密碼那兩個在主系統實作 jedi-iam 通知接口的地方掛,不改 jedi-iam。
extend 各處加一行 notify:關卡在 app/flow_control/service/review_step_service.py 的送審/核可/退回三個 method;輪次結束在 app/flow_engine/service/stage_advance_service.py 結案分支;結案報告在 app/project_summary_report 匯出成功處;檢測完成在 app/flow_control/service/job_service.py 完成分支(檢測類任務);Agent 更新結果在 app/product_update/service/agent_rollout_service.py::record_result;密碼到期與鎖定在 common/iam_ports.py 的 iam port adapter(主系統已在這裡實作 iam 的 INotifier,jedi-iam 不動)
repo:~/Projects/Billows/Audit-Manager/compliance-manager-be
改既有:app/flow_control/service/review_step_service.py
改既有:app/flow_engine/service/stage_advance_service.py
改既有:app/project_summary_report/service/(匯出 service)
改既有:app/flow_control/service/job_service.py
改既有:app/product_update/service/agent_rollout_service.py
改既有:common/iam_ports.py
新開:test/test_notification_center_events_gaps.py(六個事件各一條)
review_step_service.py 送審→task.review_step(params.action=submit,收件人=下一關的人);核可→同事件 action=approve(收件人=原處理人);退回→action=reject(原處理人);型錄只有一個事件碼,action 進 params 讓範本分文案。stage_advance_service.py 進結案站或輪次 closed 的分支 → project.round_closed,Role('project_members', project_uid)。app/project_summary_report/service/ 匯出成功 → project.closing_report,收件人 PM+顧問(用專案參與者 role 篩)。job_service.py 任務完成分支且任務類型為檢測 → scan.task_completed,處理人。agent_rollout_service.py::record_result → result 成功 agent.update_completed、失敗 agent.update_failed,Role('tenant_admin')。common/iam_ports.py 已實作 jedi-iam 的 INotifier;查 jedi-iam 契約有哪些回呼(notify_password_expiring/notify_account_locked 之類,grep -n 'def ' jedi-iam/jedi_iam/domain/ports*.py),對應的 adapter 方法裡加 notify('account.password_expiring', [user_id]);若契約沒有「即將到期」回呼,改成每日排程 tick 查 users.expire_date/密碼最後變更+政策天數(走 core/scheduler_notification.py 加第四個 tick),卡上兩條路擇一做完回寫哪條。DEV:送審一張任務 → 下一關的人 inbox 多一列 task.review_step;退回 → 原處理人一列;一輪結案 → 成員各一列 project.round_closed;匯出結案報告 → PM 一列;Agent 更新回報失敗 → 管理員一列 mandatory;密碼到期前 N 天登入 → 本人一列(走 iam 既有的到期判定);六條測試綠
~/Projects/Billows/Audit-Manager/compliance-manager-be/docs/features/FR-196-2611-notification-center/design.md §3 決策定案、§5 詳細設計(§5.1 套件職責與 port、§5.2 資料表、§5.3 API、§5.5 前端)、§6 拆卡表本卡那列、§8 風險;討論稿(Artifact,連結在 README)只在想知道「為什麼這樣裁」時看~/Projects/Billows/Audit-Manager/compliance-manager-be/docs/features/FR-196-2611-notification-center/prototype/index.html(四個分頁:鈴鐺、通知中心、通知設定、系統橫幅;純畫面,只取結構與資訊順序;文案依 i18n 重寫)infra/task_alert/(entity/model/mapper/repo+domain/task_alert/service/task_alert_notification_domain_service.py claim/mark);排程先例 core/scheduler_update.py;SocketIO 登記 config/socketio_namespaces.py(檔頭紅線)與 handler 先例 jedi-survey app/handler/fill_survey_socketio_handler.py;橫幅先例 FE src/components/ai-quota/AiQuotaBanner.vue、掛點 src/layout/AppLayout.vue 124;iam 通知接口 common/iam_ports.py;十個寄信點行號在 design.md 表 4-1