本卡為 FR-182 母案。Agent 比照主系統拿照：License Center 簽發→序號→客戶抄 Agent 機器碼→離線開通→上傳；Agent 不分功能只分有照／沒照。P1 只做 License Center 端，4 張卡 3 批；P2（Agent）／P3（主系統）等 FR-181 與 FR-179 的 Agent 卡合回再拆。設計 ~/Projects/Billows/Audit-Manager/compliance-manager-be/docs/features/FR-182-2611-agent-license/design.md；子卡清單在末段。

這案在做什麼（白話）

主系統每個租戶要有一張簽過章的授權照才能用（FR-062），Agent 完全沒有——拿到註冊 token 就能裝、能跑、裝幾台都行。決策者 11-07 定調 Agent 要用跟主系統一樣的模式拿照。做完後：License Center 多一種「Agent 照」，一台一張、綁那台的機器碼、有到期日、沒有模組清單；員工在 LC 後台簽發（一次可簽 N 張）拿序號、客戶在 Agent 主控台看到機器碼、把序號＋機器碼交回、員工在 LC 離線開通把照寄回、客戶上傳；沒照的 Agent 主控台可登入看機器碼，但不向主系統註冊、不心跳、不掃描。客戶在封閉網路，所以離線開通是第一期必做；線上開通走 Agent → 主系統 → LC（Agent 永不直連 LC），第二期。

關鍵決策（D1～D8，決策者 11-07 全數同意，細節 design.md）

• D1 獨立一張照、記上層主系統照號；不把台數塞進主系統照（Agent 本機無法驗、離線做不出）。
• D2 LC 新模組 agent_licensing、新表；不動 license_issuance；序號與私鑰解鎖抽到共用層。
• D3 同一個信封、payload_type: agent_license、沒有模組與方案、到期政策只有提醒與寬限兩個數字。
• D4 機器碼直接用 Agent 的 device_uuid。
• D5 第一期離線開通；線上開通端點 LC 先做、主系統端第二期；Agent 不直連 LC。
• D6 沒照不擋啟動，但整個 sync 模組（註冊／心跳／FR-181 長輪詢）一道門不起；寬限期全功能。
• D7 簽發表單加「數量」，一次 N 張各自獨立、共一個批號。
• D8 Agent 端驗章用既有 common/integrity/verify.py，不裝 jedi-license-runtime。

怎麼拆（批＝可同時派的一組）

• 批 1（1 張）：L1 Agent 照地基
• 批 2（2 張）：L2 LC 後台「Agent 授權」五頁、L3 LC 機器 API 三支
• 批 3（1 張）：L4 文件與收口

批 1 L1 是地基，也當登記型檔（app.py／csrf.py／cli/main.py）的 owner 先把三個空 blueprint 掛好；批 2 L2（後台頁）與 L3（機器 API）只填自己的檔、互不相干可同時跑；批 3 L4 文件與端到端證據等兩張合回。

與 FR-181／FR-179 的接點（P2 才動，P1 零影響）

FR-181 把指令通道改成 Agent 長輪詢、F-2 是 Agent registry.py 的 owner；FR-179 A1 讓未註冊的主控台放行本機管理員、A2 做首次設定頁。本案 Agent 端的閘門放在「sync 模組背景元件起不起」整層（不逐條通道加 if）、新模組登記進 registry.py 排 F-2 之後、未開通可登入沿用 A1 的門、首次設定頁順序改「授權 → 註冊」、線上開通用註冊 token 認證（沒照的 Agent 還沒有通行證）。P2 等 FR-181 批 2＋5、FR-179 批 1＋2 合回後再拆卡。

共同設定