# FR-175 機制問答首腦：交接日誌（LOG）

> **append-only**：每棒追加一個 block，寫完不改。發現舊 block 有誤，在新 block 的「推翻了什麼」寫更正。現況看 `fr175-STATE.md`。

---

## 第 1 棒（2026-10-31）：PM 會議機制題

**做了什麼**：PM 會議提出 23 條問題，回答其中機制題 Q5～Q9、Q11～Q20，加升級接力圖與「待討論」四條。成果發成 artifact，另有一份 10 張 PM 簡報。

**commits**：問答原檔與簡報收進 FR-167 `briefing/`（`5a722fc50`）。

**決策**：問答與簡報分開——簡報給 PM 看全貌，問答給逐題追問。

---

## 第 2 棒（2026-11-01）：決策者追問

**做了什麼**：決策者連續追問，補 Q11 預簽網址兩則、Q12 主版號與授權、Q7 密碼三則（明文、加密、docker 身分與入侵處置）、Q6 公鑰位置與安裝目錄結構；發現的問題六條。

**commits**：`fd173552a`（在 `feature/FR-139`）。

**決策**：
- 2.0 授權模式「技術上兩種都接得住，等商業模式定」。
- 目錄結構改用樹狀文字圖（流程圖被嫌難看），主欄放寬到 1180px。

**教訓**：
- 讀主機設定檔只列鍵名不讀值，這條在問密碼時特別要守。
- 口頭先說「189 app.log 沒輪替」是錯的，查到 jedi-common 預設保留 30 天才改正——先查再說。

---

## 第 3 棒（2026-11-02）：改版面、補機制、開本 FR

**做了什麼**：

- 問答頁改成左側選單、一題一頁；補問併回主題頁（決策者：「會看上下文」）。
- 升級觸發機制：更新單、systemd 監看、升級腳本組成、不用升級容器的完整論點與 PM 反問。
- 執行流程頁改正式標題與前言；draining 說明拆成背景工作與 Agent 兩件事；進度檔箭頭改「更新進度檔」。
- Q15 補資料庫停兩次；Q19 健康檢查更正；Q8 改寫成發版流程（現行＋改版後、CI 五 stage、四張圖）；新增 Q21 compose 與兩個設定檔。
- 發現的問題追加 7 條，最優先「升級失敗時錯誤原文進不了系統」，決策者裁另開卡。
- 修流程圖深色模式下看不見；問答頁改成本機可直接開、圖可點擊放大。
- 開 FR-175，問答頁從 FR-167 `briefing/` 搬來，原位置留轉址頁。

**commits**（皆在 `feature/FR-172`）：`2b8bb3075`、`304356adc`、`52eac6b8f`、`c95114006`、`4216e828a`、`5c48a5897`、`e0b796f94`、`1b6cbcaec`、`2e06df9a8`、`bb71df81d`、`23be81ec3`、`b6f21d053`，以及本棒開 FR 的 commit。

**決策**：
- 問答頁只維護一支，本機與線上共用；畫圖用 FR 站共用的 `_shared/mermaid.min.js`，不轉成靜態 SVG（多一份要同步，與 FR 站做法不一致）。
- 放大檢視照抄 `_shared/doc-diagram.js` 的 `open()`，不改全站共用檔。
- 問答頁搬家不刪舊位置：FR-167 的 README、FINAL-SPEC 是首腦的文件，連結不能斷，所以留轉址頁。
- 標題要專業、不要口語（「一次升級的接力」被退）；Q18 維持原文。

**教訓**：
- **flowchart 的 mermaid init 只給一半會在深色模式變黑**：平台用自己的深色配色補上沒指定的變數。要帶 `darkMode:false`、`mainBkg`、`nodeTextColor`。
- **手寫 HTML 給 artifact 時本機打不開**：平台發布時才補外殼、`[hidden]` 規則、畫圖程式。要本機能開就自帶這三樣，並讓畫圖程式偵測平台後讓位。
- **一頁一題時，隱藏的頁畫不出 mermaid**（量不到寬高），要切到那頁才畫。
- **README 的數字要實查**：先寫的「25 段、15 條」實數是 29 段、13 條。
- 工作樹會被別的 session 切 branch：本區 commit 落在 `feature/FR-172`，交接要寫明。

**推翻了什麼**：
- 第 2 棒的交接檔寫「發現的問題 6 條＋11-02 追加 9 條」，實數是 6＋7＝13 條。
- 第 2 棒報告 Q19 寫「管理員登入帶 token 打三支各要 200」，程式實際不登入、驗 401。已在問答頁更正。

## 執行流程頁改寫｜2026-11-03｜FR-172 發版首腦（決策者令）

- 決策者：「#flow 這邊幫她重寫，寫成現在的本體跟 Agent 的流程；時間軸表那種呈現方式不用了，直接用循序圖」。
- `#flow` 主答案改寫：三張循序圖（主系統升級、主系統發動 Agent 升級、Agent 主控台發動）＋主系統與 Agent 兩張逐步表＋常見問題；適用 1.28.3／Agent 1.5.5。三欄時間軸表與其說明整段拿掉（頁內 `.tl` 樣式留著未用）。補問「升級觸發機制」原樣保留。選單題名改「線上升級執行流程（主系統與 Agent）」。
- 更新的事實：Agent 不再靠心跳派工而是直推、drain 時不推新工作給 Agent；主系統升完有相容 Agent 新版就自動建推送列；同版重套兩個開關；Agent 升級維護模式與主控台鎖畫面時機。
- 同一份內容另落 FR-172 `upgrade-flow-guide.md`（說明與手冊），互相連結。
- 驗證：border-left 0、標籤平衡 0／0；Playwright 無頭開 `#flow` 連網與離線各一次，3 張圖皆畫成 SVG、點圖放大、ESC 關閉。線上版發布前完整讀過（內容與 repo HEAD 一致，只多平台外殼），發布為第 29 版。