FR-093 一頁看完

這個案子還沒收口，所以沒有定版交付（FINAL-SPEC）。收口時補一份，寫「補齊後這條鏈長什麼樣」。

1. 問題：套件會自己宣告「我需要哪些表」（自帶 SQL）與「我需要哪些權限」（能力點清單），但出貨線完全不讀這兩份宣告。結果是新版裝上去，功能在、表沒建、管理員點進去 403 而且沒有任何錯誤訊息說是缺資料。
2. 活生生的例子：有人把資產的「系統狀態」選項從大寫改成小寫（CM-1678），只寫在套件裡，三個環境一個都沒套到。這個案子拿它當第一個驗收案。
3. 做法分三段：① 出貨時把套件的 SQL 攤平進安裝包、升級時自動套；② 升級時自動把新權限寫進資料庫並補給管理員角色；③ 新頁面一定要綁權限（守衛擋），不綁就是靜默越權（沒綁權限的頁面預設全員可見）。
4. 定下一條長期規則：往後套件疆界的表只在套件改，主專案的 scripts/sql/ 不再新增套件表的 migration。代價是既有的資料庫要一次性補登記。
5. 刻意不做的：不擴充套件契約（不加 UI_ROUTES 宣告）——選單的位置、排序、圖示是前端版面知識，塞進套件等於把選單樹的一半搬進去。改用 SQL 現成寫法＋守衛測試擋。

十棒完成八棒。母卡 CM-1752。

🔴 已知缺口（.1d 留下的）

症狀：全新安裝出來的資料庫，資產的「系統狀態」選項還是大寫（OPERATIONAL）；既有資料庫升級上去才會變小寫。兩條路徑終態不一致。

為什麼：新裝走的是出貨基線檔 02-schema.sql，那份是從 188 那台的基線庫 dump 出來的，而基線庫本身還沒套過這支修正。安裝包卻已經把它標記成「已收斂進基線」，所以新裝時不會再套一次——那個標記目前是假的。

怎麼解：對 188 基線庫套一次 asset 002，再重新 dump 產生 02-schema.sql。這屬於動出貨基線，決策者 2026-09-14 裁示先不做，列為出貨前待辦，時間另定。在那之前這是已知缺口。

不採的兩個做法：把 002 從收斂清單排除讓新裝再套一次（純安裝路徑沒有升級步驟，仍會留大寫）；手改 02-schema.sql（違反 D3，那份是 dump 產物不是手寫檔）。

• 2026-09-13 D1–D8 拍板（全文見 design.md §3）：靜態併入（build 期攤平，不讓安裝程式現場掃描）／檔名用 packages/<套件>/序號 當命名空間／套件疆界的表只在套件改／權限資料改名稱反查不寫死編號／升級時 upsert 權限／管理員角色用「參照角色法」回補而非認 is_admin 旗標／不擴套件契約／前兩階段不動套件源碼不綁發版。
• 2026-09-14 決策者裁定（Q1）：DEV 用 psql 手套 asset 002 並補登記；升級程式的基線守門不放寬。理由：實查發現 STG 與 POC 都是安裝程式建的庫、守門對它們是通的，舊制庫只有 DEV 與 188 基線庫兩顆，客戶端沒有這個問題。runner 原本判斷「升級鏈對舊制庫整個失靈」被首腦複驗修正。
• 2026-09-14 決策者裁定（Q2）：188 基線庫不動，一律只在本機操作。基線庫套 002 ＋ 重產 02-schema.sql 列為出貨前待辦。
• .1d 的教訓（已入 LOG）：拆卡時假設「.1c 補登 23 支、獨留 002 給 .1d 驗收」，卡在更前面一關——DEV 根本不是升級程式認得的目標庫。開卡前對「這條路走不走得通」的假設要親手跑一次 dry-run，不能只看清單差集算出來的數字。
• .3b 的結果值得記一筆：24 支套件 SQL 對 DEV 逐支核對，全數通過、一支都沒改。原本預期會撈到一批（design 甚至點名 detection 缺 7 個外鍵），實際沒有。

從哪來：FR-089（套件結構統一）做的時候查出「出貨 image 只讀主專案的建表腳本，套件自帶的客戶端永遠套不到」，獨立成本案。上游還有 FR-080（25 支合併成 21 支）與 FR-091（21 支套用標準形狀）。

往哪去：.3c 要動套件源碼並發 jedi 1.1.0，發版等令。全案收口的驗收是「一台乾淨機器裝新版 ＋ 一顆舊資料庫升級上去」兩條路徑都對。

同期的姊妹案：FR-094 租戶隔離修正（13 張表沒開「每個客戶只看自己資料」的鎖）——跟本案同樣是 FR-089 連帶盤出來的，但兩案獨立，沒有相依。

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

需求與討論

設計

inventory/（4 份）

證據與盤點

交接與收口時間軸（handoff/，1 份）

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

卡片內容（決策紀錄、驗收條件）以 Notion 為準，本頁只記座標。

相關需求：

• FR-089 — package-shape-unification
• FR-091 — package-shape-rollout
• FR-092 — dead-code-cleanup
• FR-080 — jedi-consolidation-and-service-path
• FR-065 — onprem-installer
• FR-062 — license-management