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

FR-175 機制問答資訊集中區

狀態:進行中:問答持續累積,發現的問題交各案首腦開卡 文件 2 份 handoff 2 份

FR-175 機制問答資訊集中區

決策者與 PM 對產品「怎麼運作」的提問,集中在這裡回答。每題對回程式碼那一行或三台主機的實查結果,先給結論再給事實。範圍目前是線上更新、安裝、發版、主機與容器、密碼與設定檔;之後問到別的機制也放這裡。

這裡只回答與整理,不改程式。查到的缺陷寫進問答頁「發現的問題」,由各案首腦開卡修正。

§1

🔴 先看哪一份

你想知道 看這份 這份的性質
某個機制怎麼運作(升級流程、發版、密碼放哪、compose 參數…) 機制問答 qa/mechanism-qa.html 定版參考,左側選單一題一頁,問到新題就增修
怎麼維護問答頁:新增一題、發布線上版、給其他帳號編輯 維護手冊 GUIDE-qa-maintenance.md 操作手冊
接手問答 session 要讀什麼、界線在哪、目前問到哪 交接現況 handoff/fr175-STATE.md 交接,就地更新
每一棒問了什麼、改了什麼 交接日誌 handoff/fr175-LOG.md 歷史紀錄,append-only
線上更新本身的定版規格 FR-167 FINAL-SPEC 另一案的定版

問答頁線上版:https://claude.ai/artifact/AmUhtjZVptzoqExGEUhjhx 。repo 那支檔與線上是同一份,本機用瀏覽器直接開也看得到圖、可點擊放大。

§2

結論

  1. 問答頁是單一一支 HTML:qa/mechanism-qa.html,本機直接開與線上發布共用,不另存副本。畫圖用 FR 站共用的 _shared/mermaid.min.js,離線也能畫;點圖放大與 FR 文件站同一套操作。
  2. 分六組、一題一頁:安裝與設定、發版與簽章、升級過程、備份、待討論、發現的問題。補問併在主題頁內,不另分頁。
  3. 每題的寫法固定:先結論再事實,每個說法對回程式碼行號或實查結果,查不到就說查不到;有問題用「問題、建議、理由」三段。
  4. 只查不修:主機與資料庫只做唯讀查詢,設定檔只列鍵名不讀值。發現的問題由各案首腦開卡,本區不動手修。
  5. 最優先的一條發現:升級失敗時,程式與系統噴出的錯誤原文進不了系統,只有預寫的一句話,無法判斷錯在哪。已標「另開卡,出貨前修」。
§3

📊 總進度

棒 日期 做什麼 狀態
1 2026-10-31 回答 PM 會議 23 條提問中的機制題(Q5~Q20)、升級接力圖 ✅
2 2026-11-01 決策者追問 Q6、Q7、Q11、Q12 補問;安裝目錄結構圖;發現的問題六條 ✅
3 2026-11-02 改成一題一頁;升級觸發機制、資料庫停兩次、健康檢查更正;發版流程與 CI(含 FR-172/173 改版後);新增 Q21 compose 與設定檔;本機可直開、圖可放大;開本 FR ✅
4 — 密碼機制討論(起點已整理在 STATE) ⬜ 待開始

問答頁現況(2026-11-02 實數):選單 18 項、問答 29 段(含補問)、6 組、5 張流程圖與時序圖;發現的問題 13 條(原 6 條+11-02 追加 7 條,其中「升級觸發機制」一條含 4 個子項)、待討論 9 條。

§4

需求討論紀錄

  • 2026-10-31:PM 會議提出 23 條問題,決策者要求機制題逐一對回程式碼回答,不照簡報措辭。
  • 2026-11-01:決策者要求問答整理進 FR 文件;頁面固定亮色(深色下流程圖看不見);Q8「現況打折」段拿掉。
  • 2026-11-02:
    • 補問不另分頁,跟主題同頁看上下文。
    • 標題要專業、不要口語(「一次升級的接力」被退)。
    • 目錄結構用樹狀文字圖,不用流程圖。
    • Q18 進度檔維持原文不改。
    • 決策者說「先別寫」時只回答,問完一輪說「更新文件」才一次寫。
    • 升級失敗要看得到程式與系統噴出的錯誤,只有步驟的訊息「就是個廢物訊息」,另開卡處理。
    • api_logs_old、system_logs_old 殘留表「沒用直接刪」,建議寫 migration 隨下一版出,不手動動 POC。
    • 2.0 授權傾向「有買維護就能一直升」,等商業模式定了再調;本輪只探討做法。
    • 問答頁要本機可直接開、圖可點擊放大,與 FR 文件站一致;並開本 FR 做資訊集中區。
§5

文件

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

說明與手冊

文件 類型 標題 最後更新
GUIDE-qa-maintenance / md 說明/手冊 機制問答頁維護手冊 2026-11-02

qa/(1 份)

其他文件

文件 類型 標題 最後更新
mechanism-qa 文件(手刻 HTML) 線上更新機制問答 2026-11-02

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

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

日期 文件 標題
2026-11-02 fr175-STATE / md FR-175 機制問答首腦:交接現況(STATE)
2026-11-02 fr175-LOG / md FR-175 機制問答首腦:交接日誌(LOG)