選配模組

從 v0.3.0 起提供。預設只啟用「首頁」模組；後台管理、稽核紀錄與 API 模式需自行加入。

範本核心很小。需要的功能再用一行指令加進來，不需要就不付任何代價（檔案、資料表、程式大小都不會多）。

模組	給你什麼	適合誰
首頁（landing）	/ 變成對外介紹頁（功能、方案、常見問題），原本的儀表板搬到 /dashboard	有對外網站的產品
管理後台（admin-panel）	/admin/users 管理使用者角色與存取、/admin/system 系統狀態與清除快取、/admin/account 我的帳號	有多位管理者的團隊
稽核紀錄（audit-log）	記錄「誰在何時做了什麼」，/admin/audit 可篩選並匯出 CSV	需要留存紀錄的單位
純 API 模式（api）	/api/v1/items JSON 介面、API 金鑰、OpenAPI 文件	給其他系統呼叫

「安裝」是什麼意思？

模組是預先寫好的功能包，放在程式庫的 registry/。「安裝」就是用一行指令把它的程式碼複製進你的專案、補上需要的資料表遷移，部署後網站就多出那個功能（例如 /admin/users）。不需要時再用一行指令移除。它不是在網站上點按鈕安裝：要由維護程式庫的人執行指令並重新部署。

加入與移除

node scripts/module.mjs list              # 看有哪些模組
node scripts/module.mjs add admin-panel   # 加入
pnpm db:migrate:local                     # 套用新資料表
node scripts/module.mjs remove admin-panel

移除只刪程式檔，資料表與資料會保留；需要清掉資料請另外寫一份明確的 migration。

管理後台怎麼用

• 使用者：搜尋 email 或名稱；可把人設為 admin / user，或「移除存取」（對方將無法再登入）。你不能改自己的角色，也不能降級最後一位管理員。變更會在對方下次登入時生效，目前登入中的帳號最長維持 12 小時。
• 系統狀態：看 D1、R2、KV、Queue 是否正常與回應時間；「清除 KV 快取」會讓首頁統計立即重算。
• 稽核紀錄（若已安裝）：每次建立／修改／刪除項目、登入、改角色都會留下一筆，只增不改；超過 2,000 字的內容會被截斷，含 password / token 等字眼的欄位會被遮蔽。

當成 API 伺服器

1. 只加 api 模組，並在 wrangler.jsonc 的 vars 設 "UI": "off"：所有頁面回 JSON 404，只剩 /api/*、/health。
2. 建立金鑰（只顯示一次）：node scripts/modules/api/api-key.mjs create my-bot --scope write --env stg --remote
3. 呼叫：curl -H "Authorization: Bearer <金鑰>" https://<網址>/api/v1/items
4. 文件：/api/openapi.json。read 金鑰只能讀；金鑰可隨時用 revoke 停用。

錯誤格式固定為 {"error":{"code","message"}}。瀏覽器跨網域呼叫預設關閉，需要時設定 CORS_ORIGINS。