FR-196 通知中心 交接日誌(LOG,append-only)

每棒追加一個 block,既有 block 不改;發現舊 block 有誤在新 block「推翻了什麼」寫明。現況看 FR-196-STATE.md。


§1

第 1 棒 · 首腦(2026-11-11 ~ 2026-11-12)

做了什麼

  • 探脈:鈴鐺兩種來源、14 種 Email、/socket/notification 已拔、jedi-notification 純投遞、FR-137 寄信表被鈴鐺反查;DEV 唯讀查公告與寄信表。
  • 討論稿(Artifact,後落站 discussion.md):六個成熟產品模式、23 事件型錄、六畫面、架構圖、四期分工、D1~D8。
  • 設計 design.md v1.0:五張表、9+1 API、七張 port;重複設計盤點修四處;PM 裁 Agent 不做改三期。
  • 拆卡 handoff/cards.py 22 張 10 批(斷言:依賴在更早批、同批同 repo 不撞檔;第一次抓到 M-4/M-5 與 M-3 同批);純畫面雛形;Notion 母卡 CM-3875+子卡 CM-3876~3897,四欄全填。
  • 工作坊一夜跑完 22 張;首腦實質驗收:套件 171 測試、BE 179 passed(1 紅是基線預期)、FE build/lint/8 測試;8010 起工作區 BE 實打十條端點(401/404/412/冪等/持久化);DEV 收件匣與外送有真實資料。
  • 定版 SPEC 八頁(FINAL-SPEC.md+spec/01~07),照工作區程式碼與 DEV 實查寫;站 builder spec/ 歸定版交付。
  • 決策者合回三 repo;首腦把 BE venv 的套件 editable 安裝從工作區改指主資料夾;重啟 8000/8002/5180 給決策者手測。

commits(BE 主 repo):53a564bc4 design v1.0、9448afc83 重複盤點修四處、acd7988d8 Agent 不做、3973443f6 第一期拆卡、507a54335 第一期建卡、9bb0b62de 三期開卡、f7a7ce07a 討論稿落站、6e40962bd 定版 SPEC 八頁、cad75304f 合回 ws-CM-3875(決策者)。規範類:8a555e331、05575df9b 圖表規範進 skill 與 memory。

決策

  • D1~D8 與重複盤點四處:見 STATE §2。
  • D2 從「照類別」改「全部展開」:決策者追問「類別模式就不能了對吧」後裁全部展開;D3「必收名單怎麼來」討論後裁掉管理員頁、出貨寫死。
  • 分批開卡 → 三期一次開(決策者同日改)。
  • 只開開發卡、收尾不開卡(決策者:「收尾都是由我們來驗收」)。
  • 無人值守:卡上分岔定死(E-1 自放骨架、S-1 路由對照填死、M-2 公告包 wrapper),rules 加「不要停下問,挑最接近先例做完回寫」。

教訓

  • Artifact 不吃專案文件站規範:雙主題、窄欄、宿主渲染 mermaid 把專案早踩過的坑全重踩,決策者連點四次(圖被吃、字小、頁窄、沒放大)。規範已進 mermaid-init-template.md 第 7、8 條與 memory;往後對外稿預設走文件站。
  • 用 s[:a]+s[b:] 切 HTML 時 b 找錯 </div> 把討論稿「八項決策」「不做什麼」整段吃掉,v14、v15 殘缺;改段落要用唯一錨點,改完 grep 節名。
  • .env 的 cm_app 受 RLS,用它查 users/tenants/system_configs 回 0 列不報錯,差點把「config seed 沒灌」當 bug;查現況一律 cmmgr。
  • zsh 裡 $UID 是唯讀內建變數,腳本裡拿它當變數名會炸。
  • E-1 runner 用 pip install -e 寫 venv .pth 而沒改 pyproject.toml,工作區清掉就斷;合回後要改指主資料夾,收口要補釘。

推翻了什麼

  • 設計稿 v1.0 首版的 notification_outbound 表、/banners API、banner 欄:重複盤點後拿掉,改擴 FR-137 表、沿用既有橫幅。
  • 設計 23 事件 → 實作 25(runner 拆密碼到期/鎖定、離線/恢復),已判定合理並寫進 SPEC。

交棒狀態:決策者人工測試中;收口未做(清單見 STATE §3)。


§2

第 2 棒 · 首腦(2026-11-12 18:20 ~ 19:40,決策者中途撤換)

做了什麼

  • 冷接盤點後接決策者手測回饋,一題一題查原因、給建議、等裁示;裁示全部定案(見 STATE §2 第二段)。
  • 首腦直接改個人通知設定頁(FE 99aed6b6):改名「個人通知設定」、Email 通知模式改單選+勿擾只掛即時寄送、通知開關改類別分頁並與表格合成一卡、說明全收進 (i)、文案正式化。用 test repo 的 Playwright headless 登入 5180 截圖驗過版面。
  • 開五張修正卡 CM-3899~3903(R-1~R-5)掛母卡;內文產生器 handoff/fix-round1.py,重寫內文用 patch_fix_round1.py。
  • 查清 /home:FE 6a158ee4(2024-12-26)把它指到 ModuleFrame 後就無人導向;登入與麵包屑首頁都是 /project/dashboard。決策者裁刪。

commits:BE b433da57b(開卡)、838868770(批次改 11~13);FE 99aed6b6。皆未 push。

決策:見 STATE §2「2026-11-12 決策者手測後裁示」,含 FR-196.1 的範圍(群組推送選 B、必收事件分頁、不做整租戶關事件)。

教訓(本棒被撤換的原因,下一棒務必避開)

  • 決策者還有四項沒裁就先建卡。被點名「要我裁示的都還沒裁決你開卡幹嘛」。開卡是裁示全部落地後的最後一步,不是先建再改。
  • 補卡批次填成 1~3。母卡 22 張已用到批 10,補卡依 .claude/rules/workshop.md 要接在最後一批之後(11 起)。我沒看母卡就填,工作坊立刻照批 1、2 派出四張、開了四個工作區。決策者原話「真的會被你害死」。補卡前先 notion_case.py get 母卡 看現有最大批次。
  • FE 版面沒自己先看就回報:分段按鈕在直向 flex 被撐滿、兩塊卡片風格不一致、說明文字太多,都是決策者截圖才發現。之後 FE 改動一律先 headless 截圖看過再回報(這棒後半有做到)。
  • 文案不是白話過頭就是術語:「每封都寄」「要通知我的事」被點名小學生文案;正式表單用正式用語,說明收進 (i)。
  • 必收 Email 會被彙整延後是本棒查套件測試才發現的設計缺陷(test_mandatory_still_follows_digest),第 1 棒的 SPEC 沒寫出這個行為。
  • 推翻第 1 棒:D3「不做租戶管理頁、必收出貨寫死」被決策者推翻——決策者說當初就講過必收要給管理員改,LOG 第 1 棒寫「討論後裁掉」但找不到決策者同意的原話。FR-196.1 就是補這個。

推翻了什麼

  • D3(租戶管理頁不做)→ 做,範圍見 STATE §2。
  • 型錄四個事件的連結(維護/回覆 → home、Agent 更新 → Agent 管理)→ R-1 改。
  • 套件「必收只管關不掉、不管立刻」→ R-4 改成必收一律即時。

交棒狀態:修正卡五張 Not started 批 11~13 待工作坊重派;FR-196.1 需求定案、分析與設計未開始;本棒 commit 未 push。


§3

第 3 棒 · 首腦(2026-11-12 19:45 ~ 21:10)

做了什麼

  • 冷接盤點後接令做 FR-196.1:探脈(套件 effective_channels 是三處共用的唯一規則;聊天推送是一顆布林、外送表唯一索引會讓兩頻道兩列撞;必收判定與 R-4 同一行)、討論稿 v1 → 決策者逐項裁 → v2 定案、雛形兩份(第一版被退重做)、design v1.0、cards.py(6 張 5 批,斷言過)、母卡 CM-3904+子卡 CM-3905~3910、四欄補齊、README 與登記表。
  • 答決策者兩題:「聊天推送是什麼」(我自取的統稱,統一改「群組推送」);「排定維護是新的嗎/進入維護會怎樣」(FR-196 第三期既有,只預告不鎖系統)。

commits(BE):5a760e01e 討論稿 v1+雛形 v1、81bed058e design+cards+雛形重做+討論稿 v2、本棒最後一個 開卡產物+STATE/LOG。皆未 push。

決策:D1~D6 見 FR-196.1 design §5;D2 決策者追問後由首腦自定(固定兩欄)。

教訓

  • 第一版雛形把 25 個勾選框倒成一片格子,決策者原話「一看就是 AI 跟沒想過硬做出來的爛東西」。該拿「決策者已經看過並點頭的個人通知設定頁」當範本,管理員頁與個人頁長同一個樣子,加每個事件「什麼時候會發」的灰字,必收分頁把原廠建議獨立一欄。雛形是給人審的,要先想使用情境。
  • D2 不該拿去問決策者:那是純程式內部取捨(兩欄 vs 代號清單),畫面與功能完全相同;問了三輪決策者還是看不懂,最後一句「還是你要改成不同事件不同頻道?」才點出我在問一個他感受不到差別的東西。只問會改變畫面或行為的題。
  • E-1 第一版寫成「不切換、只交腳本」是為了閃掉「工作區還沒開」的時序問題,結果變成一張沒產出的卡;正解是排到 P-1 之後、真的改 .pth。
  • 子卡引言用「母卡(同清單上一張)」佔位,小弟拿不到母卡號就填不了工作區路徑;建完卡要用 --parent 帶實際卡號重寫一次(本棒補了 rewrite_children.py)。
  • heredoc 裡有 $(...) 就不要用 shell 寫含程式碼的長 markdown,改 Python 寫檔。

推翻了什麼

  • FR-196 D3(必收出貨寫死、不做租戶管理頁)→ FR-196.1 整案;型錄 mandatory 語意改「原廠建議」。
  • 第 2 棒 STATE §3 列的「租戶規則存哪/chat 欄/API 放哪/R-4 交互」四個設計點:全部在 FR-196.1 design §4 定案。

追加(21:30):決策者令驗收 R-1~R-5(工作坊已跑完、首腦驗過一輪、五張 驗收通過待確認)。第 3 棒再實查:套件 174/BE 144/FE 8 測試、DEV 資料、R-3 截圖、R-5 五處、三 repo merge-tree 無衝突 → 全過;三 repo --no-ff 合回 feature/FR-172(BE 37a4604fa、FE dd46727a、套件 e59e273f);kill 核過的五個 PID 後重啟 8000/8002/5180;五張卡各 append 復核段。合回前 21:00 已依決策者令 push 三 repo(BE 36、FE 18、套件 15 個 commit)。

交棒狀態:R-1~R-5 已合回、等決策者手測後 Done;FR-196.1 六張(批 14~18)Not started 待工作坊派;合回 commit 尚未 push。

追加(23:55):決策者手測 FR-196 後陸續提四點,主資料夾直修並 commit(FE fbc1ce5d 個人頁拿掉聊天欄、f531ca65/9e1685d0 通知中心已讀未讀封存與鈴鐺全部已讀都加確認框+單列可標未讀、bbeb696a 鈴鐺分段標各類未讀數並拿掉待辦列)。過程中查出 F-1 起就有的鈴鐺紅點 :key bug(未讀數變動時 badge 指令拋錯、整輪畫面更新中斷、通知中心頁卡在載入中),一併修掉。 教訓:①頁面卡住先讀完整錯誤堆疊,那條 badge 警告第一輪就印出來了,我當小警告跳過、多繞六七輪;②分段數字一度想在套件 unread-count 加 by_category,決策者指出純前端就做得到,已還原未提交改動;需求先想「前端現有資料夠不夠」再決定要不要動後端。 FR-196.1 六張工作坊跑完,首腦獨立驗收通過(細節見母卡 CM-3904 末段);打折處:臨時 5181 字型被 Vite 擋、臨時 8013 未掛 system config,頻道啟用時的真機推送合回後補驗。

追加(11-13):決策者令合回。三 repo 合回 FR-196.1(BE acb652c41 含 D-1、FE 23dec94e、套件 cea10649);BE venv .pth 從 .worktrees/CM-3904 改回主資料夾;重啟三服務,8000 管理端點 200、5180 畫面正常。教訓:通知管理頁很長,用整頁長截圖時固定定位的側欄會被印在內容上,看起來像版面壞了;判斷版面要用單一視窗截圖,再跟既有頁對照。


§4

第 3 棒 · 首腦收尾(2026-11-13 ~ 2026-11-14)

做了什麼

  • 決策者手測合回後的版面:通知管理頁連線設定包成卡片、三個輸入框同一種元件、「尚未啟用」改細提示、推送與必收清單改類別分頁;兩頁 UI 統一(分頁只放類別名、右上一顆「開了幾個」、個人頁每列加「什麼時候會發」灰字)。FE beaaba5c。
  • 套件 jedi-notification-center 0.2.0 首次發 Nexus(0.1.0 從未發過);主系統改釘 ==0.2.0、移除 venv 的本機 .pth。BE f56e1c17e。
  • 出貨基線重產:188 基線庫依 manifest 行序補 4 支 active(含 FR-192 一支)+FR-196 六支 seed,重產 02/04/99,本機乾淨 init+migrate 驗證。BE b4d8247fe。test_plugin_capabilities_are_seeded 由紅轉綠。
  • 三 repo push。收尾:開文件卡 CM-3937(SPEC 手冊三頁+使用手冊,批 19)、analysis、SUMMARY、STATE 改成收尾後現況。

決策

  • SPEC 手冊與使用手冊屬定案後量產文件,照首腦規範開卡給工作坊,不由首腦自己寫。
  • 出貨基線差集一次補齊整份 manifest,連不屬於本案的 FR-192 一支、FR-190 一筆漏蓋章也補。
  • 個人頁的儲存鈕保留在卡片外(整頁同時存 Email 模式與開關),管理頁每份清單各自存、鈕在卡內——兩頁唯一刻意保留的差異。

教訓

  • poetry update <套件> 會照本線 pyproject 收斂整個環境,把別的 session 在共用 venv 先裝的新版(jedi-license-runtime 1.1.8,FR-197.1)降回去。跑完要讀每一行 Downgrading,發現就還原並通知那張卡。
  • 守衛「能力點未進出貨 seed」要轉綠,基線庫得連對應的 seed 支一起套,再跑 gen_seed_sql.sh;只套 active 結構不夠。
  • 02-schema 的刪除行不一定是遺失:改約束、改可空的 migration 會刪舊寫法,要逐行找新版對應再判斷。
  • zsh 沒有 PIPESTATUS,迴圈裡判退出碼改用 bash;path 不能當迴圈變數名(會蓋掉 zsh 的指令搜尋路徑)。
  • 通知管理頁很長,整頁長截圖會把固定的側欄印在內容上,看起來像版面壞了;判斷版面用單一視窗截圖並跟既有頁對照。

推翻了什麼

  • 第 3 棒前段 STATE §4「pyproject 沒釘套件」:已解(釘 0.2.0)。
  • 第 3 棒前段 STATE §4「工作坊四個照錯批次的工作區」:工作坊已清掉,不再存在。

交棒狀態:本案已交付。兩案子卡 Done,母卡收尾改 Done;CM-3937 待派;未合 main、未上 STG/POC。之後 bug 另開 session,讀 STATE 冷接。