本卡屬 FR-167(母卡 CM-3241),卡 P1-8,階段 P1 升級變安全、批 1。只改 FE(compliance-manager-fe)。依賴:無。
升級時後端會停幾分鐘,使用者打開網址不該看到一片錯誤。前門 nginx 在後端連不上時改送一頁維護頁,頁面每 3 秒讀進度檔畫出「現在到第幾步、剩多久」,沒有任何按鈕。
獨立於主系統、要在後端停掉時能跑;規格=雛形 ②
extend:nginx.onprem.conf 加 error_page 502 503 =503 /maintenance.html 與 /upgrade-progress.json alias;頁面純 HTML+少量 JS,不用框架、不接 API
repo:~/Projects/Billows/Audit-Manager/compliance-manager-fe
改既有:nginx.onprem.conf
新開:public/maintenance.html
細節在 design.md §5 對應段(~/Projects/Billows/Audit-Manager/compliance-manager-be/docs/features/FR-167-2610-online-update-channel/design.md,開 design.html 看導覽);本段只列本卡要做到的點:
nginx.onprem.conf:error_page 502 503 =503 /maintenance.html;、location = /maintenance.html { root /usr/share/nginx/html; internal; }、location = /upgrade-progress.json { alias /guidant/upgrade/upgrade-progress.json; }(掛載路徑由 P1-4 compose 提供,本卡先寫路徑)。public/maintenance.html:純 HTML+原生 JS,每 3 秒 fetch 進度檔,畫步驟清單(步名、狀態、耗時、時限)、總進度、「請勿關機」;讀不到檔時顯示「系統維護中」;無按鈕、無框架、無 border-left;配色用現有 token。停掉 api 容器打首頁得 503 與維護頁;放一份假進度檔,頁面每 3 秒更新步驟、耗時、剩餘時限;沒有任何按鈕;grep border-left 0;e2e conf 不變
對照雛形:~/Projects/Billows/Audit-Manager/compliance-manager-be/docs/features/FR-167-2610-online-update-channel/prototype/index.html(上方「跟著走」)。
docs/claude/domain-capabilities.md。三擇一、預設不新增:reuse → extend 加參數 → 都沒有才新增。回寫列出 reuse 了哪些、新增了哪些、為什麼不能 reuse。