定義一張表，API 就已經寫好了。

這份手冊怎麼用

快速開始照順序讀一次就好：它會讓你手上有 token、帳號裡有一張真的表。之後這個站就是隨查隨用的參考資料。

真正值得在設計 schema 之前讀完的是核心概念。欄位識別（顯示名稱與內部 col_<hex> 鍵）、三種範圍、權限模型，這三件事決定了後面每一次呼叫的行為，也是接接口時最常踩坑的地方。

操作指南是任務導向的，一頁對應一件你被交辦的事。實戰案例比較長，一個領域一篇，每篇都從零把一套表格設計做完。

API 參考和 Playground、程式碼產生器讀的是同一份端點目錄，所以同一個路由的參數、範圍、範例、錯誤，在任何地方看到都一致。變更紀錄則記錄哪裡動了、動到哪些端點。

內容從哪裡來

這份手冊與版控中的 OpenAPI 快照會同步到 data/openapi.source.json 記錄的精確後端 source revision。快照由該 revision 的完整 FastAPI app 產生，再過濾成手冊涵蓋的 route families。CI 會檢查 catalog／snapshot 覆蓋率、範例、型別、production build 與內部連結；另外比較 deployed staging 的步驟只提供 warning，因為 staging 與 origin/master 是兩條不同的 evidence lane。若要重現 source parity，必須在記錄的 backend commit 產生 OpenAPI，再以 scripts/sync-openapi.mjs --source ... --check 驗證。

另有 on-demand harness 可用呼叫者提供的 staging base URL 與 token 執行部分受支援範例。它不在 CI 執行，而 build 成功、source snapshot 相符或這份文件本身，都不能證明已部署或 staging 的實際行為。

AI 也是一等公民：/llms.txt 是索引，/llms-full.txt 是全文，每一頁在同一路徑後面加上 .md 就是純 Markdown 版本。

目前發行版 pin：v5.10.0，後端 9b8b95e598a7b1f606c030d8dd0f27f26c748c83。Snapshot 取自已驗證映像的 production API，來源證據記於 data/openapi.source.json；驗收範圍請見更新紀錄。