FR-063 Nuitka 落地版打包 — STATE(living,只描述此刻)

最後更新:2026-08-15 晚(第三任首腦收案交棒:FR-063 全案 Done、image 已出貨 Harbor;戰線移交 FR-064) 本檔為 STATE/LOG 雙檔制的 living 檔;脈絡與決策軌跡見同資料夾 FR-063-LOG.md(16 blocks)

§1

🧭 Arc 定位(WHY)

產品進入落地版(on-premise)交付階段——客戶主機上不可再出現一行可讀業務原始碼。本案把 BE 整包用 Nuitka standalone 編成機器碼 binary、包進 Linux Docker image 交付,與 FR-062 license 執法構成雙保險。

  • 三階段戰線第一棒:FR-063 Nuitka 編譯(本案,母案 CM-1187,✅ Done)→ FR-064 防竄改(母案 CM-1188,決策者親做中)→ FR-065 Installer + Windows(母案 CM-1189)。
§2

角色定位

本 arc 首腦 session = 分析決策 / 協調者:只做需求釐清、拍板、拆棒開卡、派工 prompt、驗收抽查;一切實作走 runner session。本案已收案——接手本檔者的工作是「戰線延續」(見下方待辦),不是 FR-063 本身。

§3

當前狀態(2026-08-15 晚,全案收口)

FR-063 全數完結:.1 七卡+.2 四卡+.3+.4=13 工作卡+CM-1190/1191 兩子需求卡+母案 CM-1187 全 Done。場外衍生 CM-1206(socket 共編存檔 bug)一併修復收 Done。

項目 最終狀態
交付物 Harbor 192.168.50.171(=harbor.jedicogy.com.tw:8081,188 /etc/hosts 有映射)專案 guidant-aiguidant-ai-be:1.14.0latest(digest sha256:bba0449d…,壓縮 0.55GB)
產物身分 commit bake cc7714d2(含 CM-1206 socket 修復+CM-1192 全部修正);業務 .py=0;翻譯 en/zh_Hant_TW 均 65/65(100%);摘要報告範本由 build script 自動收
起服務 docker run … guidant-ai-be:1.14.0(RUN_MODE=api→8000/socketio→8002,單 image 雙模式);環境變數清單 docs/features/FR-063-2608-nuitka-packaging/deployment-env.md
Build 管線 build_release.sh(穩態 ~12m,dry-run 預檢+完整性斷言+i18n --statistics)→ build_image.shprobe_container.sh(七項探針,上輪 PASS=11 FAIL=0)
Push 狀態 BE 與 origin 同步至 2834cf4c(user 已推);FE 967e67b 已推;jedi 無新異動
§4

關鍵座標

素材 路徑
設計文件 docs/features/FR-063-2608-nuitka-packaging/design.md(D1–D11+§5)
部署環境變數清單 同資料夾 deployment-env.md(必填/一般/功能模組+jedi-* 16 項+掛載表+交付前 checklist)
Notion 母案 CM-1187(Done,末段有全案收口摘要) https://app.notion.com/p/FR-063-Nuitka-Linux-3bc346da4cd0814582fbdb74185bd1b0
Notion CLI python3 scripts/notion_case.py get/status/append/query;開卡走 API 直打(見 memory reference_notion_case_cli)
Build 機 188 /opt/guidant_ai(工作樹乾淨、gitlab SSH 金鑰可用——前 runner 說無金鑰是誤判,同步一律 git pull);Harbor login 已存(certs.d+insecure-registries 既存設定)
§5

待辦地圖(戰線延續,2026-08-15 晚定稿)

待辦 備註
1 FR-064 防竄改(CM-1188) 決策者親做,非派工項;首腦待命支援
2 CM-1207(FR-065.0 DB 初始化基線)盤點棒 卡已開、派工 prompt 已交 user(LOG Block 16);盤點棒唯讀可先行;實作棒等 FR-064 完成後才派
3 FR-065 installer(CM-1189) 前置=FR-064+CM-1207 都齊;FE image/產品 compose 明確劃入此案(2026-08-15 拍板:compose 形狀由 installer 決定,不提早做)
4 FR-063 文件類收尾 ✅ 已完成(2026-08-15 晚,user 下令後 subagent 執行) SUMMARY handoff/2026-08-15-FR-063-SUMMARY.md(0e7368a0)+analysis 兩篇 docs/analysis/2026-08-15-nuitka-*.md(feccea4e)+memory feedback(起遠端 build 先 pgrep)。spec/使用手冊不觸發(build 基建無終端使用者操作變更)
場外 CM-1204(手冊下載死碼端點)待排程 不掛任何 FR
§6

環境紀律提醒

  • 🔴 開發只動 DEV;STG/POC 寫入類異動一律等決策者當次明示。
  • 🔴 部署機程式碼一律走 git pull(2026-08-15 新立 memory):禁 rsync/scp/直接編輯;188 金鑰實測可用,無藉口。
  • STG 188 兩服務(8000/8002)跑的是舊產物 36708b35(非最終版),去留/是否換新 image 由決策者定。
  • 188 /opt/guidant_ai/.build/ 有產物與快取(dist 809MB+nuitka-out);~/certs/ 有 proxy.csr/key(8/13 nginx 實驗遺留,已從 repo 樹搬出)。
  • .env.bak / .env.bak-20260814-pre1g 為 user 自留備份,不入版控不清。
§7

本 session 遺留待辦(第三任交棒,2026-08-15 晚)

  • CM-1207 盤點棒 prompt 已交 user,等 user 擇時派出(新 session)。
  • 文件收尾已完結(上表第 4 項);本機 commits 待 push(f7d8c316→feccea4e 共 4 筆 docs/chore)。
  • zh_Hant_TW 翻譯已 100%(死條目 non_existent_key 清除,非漏翻——jedi-system-config 測試 fixture 被 extract 誤收)。