> ## 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 + процесс + база данных | Переиспользуйте подходящую активную базу данных перед созданием новой.                                                               |
| Автономная работа или мгновенная синхронизация между устройствами | Realtime приложение        | Включите синхронизацию и проверьте `sync: ready` перед подключением приложения.                                                      |
| Запланированная задача или вебхук                                 | Process приложение         | Используйте триггеры на компоненте процесса.                                                                                         |
| AI-функция внутри приложения                                      | Процесс + Kazzle AI API    | Используйте `/ai/*` с API ключом `kzl_`.                                                                                             |
| Инструмент, который ассистент должен вызвать позже                | Skill + процесс            | Добавьте папку skill (`SKILL.md` + `tools.ts`) и обеспечьте каждый инструмент `target.type: 'app'` маршрутом на компоненте процесса. |

## Рекомендации

* Начинайте с шаблона, если он подходит.
* Держите код фронтенда свободным от секретов и URL баз данных.
* Размещайте серверную работу в компоненте процесса.
* Используйте URL соседних компонентов вместо жёстко закодированных адресов localhost.
* Проверяйте предпросмотры на вкладке app-dev перед тем, как говорить, что приложение работает.