參考資料總覽
- 端點 — 全部 43 條文件化路由(主 router、操作設定、機密、原始碼下載、範本、服務帳號)+ 10 條隱藏 invoke 路由,附權限關卡與精確錯誤 detail。
- Schema — 欄位完整的 Pydantic 模型與上限,包含操作設定、機密、服務帳號與範本。
- 列舉與狀態 — 每個封閉字彙集,含資料庫 CHECK;release 功能、provider 與操作設定狀態。
- 錯誤 — 外層格式(字串、清單、帶代碼)、精確的 403/409/413/422/503 目錄、票證錯誤代碼(雲端與地端)、builder 拒絕如何呈現、超過 100 個 builder 拒絕代碼、dispatcher/runtime 代碼。
- CLI —
teamsync-worker指令、旗標與關卡,以及本機 dev 機密檔。 - Manifest 規格 —
teamsync.worker.jsonv2 逐欄位規則。 - 環境變數 — 每個
EDGE_WORKERS_*變數:provider 選擇、每次呼叫的限制、服務帳號、builder 與範本、地端 provider、transport 相關設定。 - 資料庫模型 — 五張表、約束,以及「沒有 alembic」政策。
- 背景任務 — 部署任務、清理與控制面稽核調節器、Pub/Sub consumer。
各處通用的基本規則:API base {BASE}/private/module/edge-workers;只收人類使用者的 JWT(未帶憑證是 418,服務帳號是 403);租戶以 company_id + department_id 錨定;未授權通常表現為 404。所有數字上限彙整在限制一覽。
Last updated on