本卡屬 FR-167(母卡 CM-3241),卡 P1-8,階段 P1 升級變安全、批 1。只改 FE(compliance-manager-fe)。依賴:無。

這張卡做什麼(白話)

升級時後端會停幾分鐘,使用者打開網址不該看到一片錯誤。前門 nginx 在後端連不上時改送一頁維護頁,頁面每 3 秒讀進度檔畫出「現在到第幾步、剩多久」,沒有任何按鈕。

為什麼切這一張

獨立於主系統、要在後端停掉時能跑;規格=雛形 ②

reuse/extend/new

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 看導覽);本段只列本卡要做到的點:

怎麼驗(開發期:你在本機/DEV 就要能做完)

停掉 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(上方「跟著走」)。

紀律