本卡屬 FR-182(母卡 FR-182 母案(同清單上一張)),卡 L4,批 3。只改 license_center repo。依賴:L2、L3。
三張實作卡合回後,把 LC 的文件對齊現況:架構說明書的資料表、照檔格式、查案食譜、模組表各加 Agent 照一節;repo CLAUDE.md 的「與主產品的介面」表加三支端點;然後在 DEV 從頭走一輪(後台簽 3 張 → 離線開通 1 張 → 下載 → CLI 驗 → 內部 API 簽 2 張 → 線上開通端點開通 1 張)把指令與回應貼成證據檔,給首腦與決策者驗收用。只寫現況不寫沿革。
extend:docs/handbook/data-model.md 加 agent_license_issuance 一節(欄位、與 license_issuance 的差異、為什麼分表);license-format.md 加「Agent 照」一節(payload 欄位表、payload_type 判別、兩段式到期政策、與主系統照共用信封);operations.md 加查案食譜(「客戶說 Agent 開通失敗」→ grep agent_license_id/序號摘要;「序號逾期」→ 補發序號);architecture.md 模組表加 agent_licensing;CLAUDE.md 「與主產品的介面」表加三列、模組樹加一行、常用指令加五支 CLI;docs/api-contract-baseline.md 已由 L3 加,本卡只核。new:docs/features/FR-182-2611-agent-license/evidence/p1-e2e.md(在 BE repo)——DEV 從後台簽 3 張 → 離線開通 1 張 → 下載 → CLI 驗 → 內部 API 簽 2 張 → 線上開通端點開通 1 張 → 清單截圖描述,每步指令與回應貼上。mkdocs build --strict 綠
repo:~/Projects/Billows/Audit-Manager/license_center
改既有:docs/handbook/data-model.md
改既有:docs/handbook/license-format.md
改既有:docs/handbook/operations.md
改既有:docs/handbook/architecture.md
改既有:CLAUDE.md
新開:(BE repo)docs/features/FR-182-2611-agent-license/evidence/p1-e2e.md
docs/handbook/ 五支現況、mkdocs.yml nav、LC CLAUDE.md 末段「與主產品的介面」表;L1~L3 的回寫(實際路徑、函式名以 code 為準,不以 design 為準——grep 核對)。docs/handbook/data-model.md:加 agent_license_issuance 一節(欄位表、與 license_issuance 的差異、為什麼分表:tenant/plan/modules 必填塞不進去、狀態推算會長分支)。license-format.md:加「Agent 照」一節(payload 欄位表、payload_type 判別與向後相容支點、兩段式到期政策、共用信封與 armor、Agent 端驗章指定型別)。operations.md:環境變數總表若無新增就註明;查案食譜加「客戶說 Agent 開通失敗」(grep agent_license_id/序號摘要/fingerprint)、「序號逾期要補發」、「客戶換機要換綁」。architecture.md:模組表加 agent_licensing(擁有 agent_license_issuance)、共用層加 core/activation_code.py/web/unlock_helper.py/web/internal_auth.py。CLAUDE.md:「與主產品的介面」表加三列;模組樹加 agent_licensing/;常用指令加五支 CLI 一行;「四支端點的合約不可變」改「七支」。mkdocs.yml nav 若按檔案不必動;poetry run mkdocs build --strict 零警告。docs/features/FR-182-2611-agent-license/evidence/p1-e2e.md——DEV LC(本機起 5062):後台簽 3 張(截圖描述+批號)→ 離線開通 1 張(64 hex 假機器碼)→ 下載 → agent-verify 輸出貼上 → curl 內部 API 簽 2 張(token 名不貼值)→ curl 線上開通端點開通 1 張 → 清單五列狀態描述 → 拿主系統照餵 agent-verify 被拒的輸出。每步指令+回應(序號、token 遮掉)。BE repo 的 render_index.py 重 build 該站(python scripts/deliverables/render_index.py docs/features/FR-182-2611-agent-license/)並 commit 產物。grep -n "原本\|改判\|第 [0-9] 棒\|這次整理\|當初" docs/handbook/*.md CLAUDE.md 零命中。poetry run mkdocs build --strict 零警告;grep -n "原本\|改判\|第 [0-9] 棒\|這次整理" docs/handbook/*.md 零命中;證據檔每一步有指令+回應;CLAUDE.md 介面表三列與 L3 實際路徑逐字相同
~/Projects/Billows/Audit-Manager/compliance-manager-be/docs/features/FR-182-2611-agent-license/design.md(關鍵決策 D1~D8、§4.2 照 payload、§4.3 表、§4.4 六支 service、§4.5 五頁、§4.6 機器 API、§4.7 CLI、拆卡表本卡那列);討論稿 ~/Projects/Billows/Audit-Manager/compliance-manager-be/docs/features/FR-182-2611-agent-license/discussion.md §2 現況盤點(哪些 reuse/extend)~/Projects/Billows/Audit-Manager/compliance-manager-be/docs/features/FR-182-2611-agent-license/prototype/lc-agent-license.html(七場景,L2 對照用;L1/L3 看一眼知道資料要長什麼樣)~/Projects/Billows/Audit-Manager/license_center/CLAUDE.md(鐵律、安全紅線、log、常用指令、Alembic 三鐵則);docs/handbook/architecture.md(模組 SOP);docs/api-contract-baseline.md