> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kazzle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 應用模式

> 為常見工作選擇合適的 Kazzle 應用架構。

# 應用模式

選擇最小的應用架構來滿足工作需求。只在應用需要時才添加流程、資料庫、同步或 AI API。

| 使用者需求            | 使用                 | 備註                                                                       |
| ---------------- | ------------------ | ------------------------------------------------------------------------ |
| 登陸頁面、報告、靜態頁面     | UI 應用              | 一個 UI 元件就足夠了。                                                            |
| 儀表板或內部工具（含伺服器資料） | UI + 流程            | 將 API 路由和認證保存在流程元件中。                                                     |
| 應用資料持久化          | UI + 流程 + 資料庫      | 重用合適的現有資料庫，再考慮建立新的。                                                      |
| 離線或即時跨裝置資料       | 即時應用               | 啟用同步並驗證 `sync: ready`，再連接應用。                                             |
| 排程工作或 Webhook    | 流程應用               | 在流程元件上使用觸發器。                                                             |
| 應用內的 AI 功能       | 流程 + Kazzle AI API | 使用 `/ai/*` 搭配 `kzl_` API 金鑰。                                             |
| 助手稍後應呼叫的工具       | 技能 + 流程            | 新增技能資料夾（`SKILL.md` + `tools.ts`），並在流程元件的路由上支援每個 `target.type: 'app'` 工具。 |

## 預設做法

* 有合適的範本時，從範本開始。
* 保持前端程式碼不含機密和資料庫 URL。
* 將伺服器專用工作放在流程元件中。
* 使用同層元件 URL，而非硬編碼的 localhost 位址。
* 在應用開發分頁中驗證預覽，再確認應用正在執行。