已完成（白話版）

這棒把 FR-068 正式發成 v1.17.0，並把 188（STG）和 189（POC）兩台都升上去了。189 的舊資料一根毛都沒掉，有逐項對照數據佐證。

版號怎麼定的

FR-068 是新功能（新表、新 API、新設定頁、新手冊章節），照 version-bump skill 的判準走功能版號：1.16.0 → 1.17.0。

七個步驟的結果

① 進版（commit 9e3b763b，BE／FE 都推了）

• release note docs/release_notes/v1.17.0.md，同步鏡射進 spec 站並在版本列表插一列
• pyproject.toml 1.16.0 → 1.17.0；FE package.json 同步（FE commit 0a47f5b）
• spec 凍結快照 docs/specs/v1.17.0/，兩次 build 都無「nav 未涵蓋」警告

② init 產物走正路（commit c84d4591）

• 基線庫（188 的 guidant_ai）補套 FR-068 兩支 migration，檔內驗證段都過（153 → 155 筆）
• 重跑三支產生器：gen_schema_sql.sh / gen_seed_sql.sh / gen_stamp_sql.sh
• marker 變成 __init_baseline_v1.17.0__，補登清單 135 → 137 支

🔴 這裡我多做了一個判斷，需要你知道：config.log_forwarding_settings 原本不在出貨 seed 的表清單裡。表結構有進 02-schema，但那一列預設全域設定是 migration 的 INSERT 生出來的——全新安裝不跑 migration，就會得到「有表但沒有那一列」。後果不只是少個預設值：讀取（GET）回 404 前端還能容忍，但儲存（PUT）也會因為找不到那一列而失敗，等於「功能在選單上看得到、表單也填得了、按儲存必定失敗」。所以我把這張表加進 seed 清單。這是本卡唯一的非機械性改動。

③ 出三顆正式 image（188 build 機）

• guidant-ai-be:1.17.0 / guidant-ai-fe:1.17.0 / guidant-ai-init:1.17.0
• 依裁示不走正式簽章（--skip-prod-key-check），出貨包 891M，sha256 82ffa99d…
• init image 的 stamp gate 自己通過（137 支一致）——這正是 CM-1406 那顆繞過去的關卡，代表這次走的是正路，全新安裝與升級兩條路都可用

④ 升 188 STG：1.16.0-fr068e → 1.17.0，六顆容器全 healthy、站台 200、users 2／projects 58 零變動、BE log 無 Traceback

⑤ 升 189 POC：1.16.0 → 1.17.0，只跑 install.sh --upgrade，沒有重裝、沒有重建庫