儀表板

輸入申請人 AD 帳號查詢；系統依結果引導發行新 Key 或管理既有 Key

貼上 AD 帳號清單（每行一個，也接受逗號／分號／空白分隔），或上傳文字檔；系統自動查 AD 屬性並發 key

—

選一位使用者或一個部門（或全公司），指定起訖日期，畫出該期間的 API 預估金額曲線；指標也可切換成請求數／Tokens。
📌 部門的成員範圍與「部門報表」一致——以人員名冊分組，名冊查無但持有 Key／席次的帳號歸「（名冊未收錄）」。
📌 只計 API Key 的用量費用；Teams 席次是月固定訂閱費、無法拆到日，不在這張圖裡（席次費用請看「部門報表」）。
📌 金額為依模型單價表的估算，且多數費用來自 cache token；沒有用量的時段補 0，時間軸才連續。

—

—

—

依預估金額

曲線上每一個時段的原始數字

經過本 gateway 的每一筆 /v1/* 請求，依路徑、狀態碼與「是否計價」分類。
📌 Key 管理表格的「請求數」會比報表的請求數多：前者計入每一次代理呼叫，後者只計「有回傳用量、算得出費用」的請求。
📌 沒有用量的呼叫（如 /v1/messages/count_tokens 只回 token 數、認證或額度錯誤的回應）本來就沒有費用，因此不列入報表的請求數與每請求費用。
📌 非 200 的回應會一併記下上游的錯誤說明（例如「invalid_request_error: max_tokens…」），方便判斷是使用者的參數問題還是上游異常；成功的回應內容一律不落地。

Claude 管理後台 → Analytics → Members → Export 匯出的 members-analytics CSV；資料期間自檔名（…-2026-09-19-to-2026-10-18.csv）解析、可手動調整。
📌 與既有期間日期重疊（含相同期間）時，先刪除重疊期間的整份舊資料，以本次上傳為準。
📌 座位等級以匯出檔為準：上傳最新期間的檔案時，系統會自動把「Teams Account」的座位等級更正成檔案裡的官方等級，匯出檔沒有的付費座位改為未指派；更正的名單會列在上傳結果。上傳比現有資料更舊的檔案則不會更動座位等級。
📌 建議每週一 08:00 前上傳「上週一～上週日」的匯出檔，處長週報的 Cowork 段落才會是上週的數字；沒有與上週重疊的匯出時，週報會改用最近一次匯出並註明期間。

Claude Code Teams 匯出的每人程式碼行數檔（如 claude_code_team_2026_07_01_to_2026_07_31.csv，欄位 User, Lines）；資料期間自檔名解析、可手動調整。
📌 上傳後資料會持續保存於系統資料庫，所有管理員登入後皆可查看。
📌 若上傳期間與既有資料的日期重疊（含相同期間），系統會先刪除重疊期間的整份舊資料，以本次上傳的檔案為準。
📌 「🗑 刪除此期間資料」會同步刪除資料庫中該期間的全部紀錄，且無法復原。

Claude Code Teams 訂閱的席次等級（Premium／Standard／未指派）。每次在「🤝 Cowork」頁上傳最新的 members-analytics 匯出檔，系統會以檔案裡的官方等級自動更正這份名單（匯出檔沒有的付費座位改為未指派），因此在這裡手動改的等級，下次上傳後會被匯出檔蓋過；帳號＝Email「＠」前段（與名冊帳號、Gateway 申請人帳號同一把鍵）。
📌 名單來自所有已上傳的 Teams 期間成員；曾設定過但已不在名單中的帳號也會列出。
📌 席次月費會用在「部門報表」：部門的 Claude 總費用＝API 費用＋席次費用（席次費＝單價 × 期間涵蓋的日曆月數，不到一個月以一個月計）。
📌 「最近期間行數」是最後一次上傳的那個期間；「累計行數」是全部已上傳期間的加總（每個月各傳一份就會逐月累加），兩者不同屬正常。
📌 改完務必按「💾 儲存變更」；儲存後下方報表與部門報表的席次欄位、費用會同步更新。

統計部門　☑☐

—

USD／依所選粒度分桶（僅統計範圍內的部門）。席次費用是月固定訂閱費、無法拆到日，因此不在這張圖裡

—

依總費用（API＋席次）由多至少；部門名稱下方的小字是「總費用」的處內／全公司名次。點一列展開該部門的成員明細與四項指標的完整名次

各部門實際持有的 Premium／Standard 席次與持有人，以及月費與本期費用——用來核對「席次費用為什麼是這個數字」
📌 席次名單與單價在「Teams Account」頁維護；本表以目前的名單回推所選期間

這些數字不在上方部門統計內，列出以免無聲遺漏

以本報表的數據（總費用＝API＋席次、效率指標與排名，依部門與處）請 Claude 產出分析與建議；產生後會一併寫進「⬇ 匯出 PDF」。
📌 兩種費用可相加為總費用；效率一律在同一產品內相除（席次費÷行數、API 費÷請求數），不會出現「API 費用÷Teams 行數」這種跨產品比值。
📌 分析經本 gateway 自身的 API 呼叫，該次消耗會照常計量入帳；資料量大時需要數十秒。

每週自動把「上一週」（週一～週日）各處的用量統計分析寄給該處主管，副本給指定收件者；同一處若設定了處長與副處長，**寄出一封、兩人同列收件者**；內容含概況／各部門／Teams 席次／成員明細與 AI 分析，並附一份同期間的 PDF 報表。統計同時涵蓋 API Key 費用與 Teams 席次。
📌 啟用與收件者在伺服器設定檔（.env）的 weekly_report_* 參數：weekly_report_enabled（開關）、weekly_report_heads（處名:AD帳號 或 處名:AD帳號:職稱，同一處可列多位）、weekly_report_cc（副本）、weekly_report_weekday／weekly_report_hour（寄送時點）、weekly_report_ai（是否附 AI 分析）；改完需重新啟動服務。
📌 席次費用是「整月月費」（不到一個月以一個月計），週報會與「本週 API 費用」分開陳述、不相加成「本週支出」。
📌 「測試寄送」只寄到你填的位址，不寄給處長也不寄副本；「立即寄給處長」會真的發信給處長與副本，且不影響排程的已寄紀錄。

—

接受人事系統匯出的 11 欄 CSV（無表頭）或本系統整理後的名冊檔（帶表頭）；帳號取 Notes 帳號「／」前段（＝Email「＠」前段），為所有統計的比對鍵。
📌 名冊是部門統計的唯一依據——Key 上的部門是發行當時的 AD 快照（帶成本中心代碼、同部門有多種寫法），不用於分組。
📌 「更新／新增」以工號為鍵，既有資料會被更新；「整份取代」會先清空整份名冊，且無法復原。

供「部門報表」以處為單位快速選取。預設依公司組織表（管理處／開發工程處／行銷服務處／產品開發處／工程及製造處）；如組織調整可在此修改，改完按「💾 儲存變更」即生效，不需重新部署。
📌 「（未分處）」代表不屬於任何處（例如總經理室、董事長室），仍可單獨勾選統計，但不會被任何處的快速選取鈕勾到。

—