> ## 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.

# Wzorce aplikacji

> Jaki kształt aplikacji Kazzle wybrać do typowych zadań.

# Wzorce aplikacji

Wybierz najmniejszy kształt aplikacji, który pasuje do zadania. Dodaj proces, bazę danych, synchronizację lub API AI tylko wtedy, gdy aplikacja tego wymaga.

| Użytkownik chce                                       | Użyj                          | Uwagi                                                                                                                             |
| ----------------------------------------------------- | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| Strona docelowa, raport, strona statyczna             | Aplikacja UI                  | Jeden komponent UI wystarczy.                                                                                                     |
| Dashboard lub narzędzie wewnętrzne z danymi serwera   | UI + proces                   | Przechowuj trasy API i poświadczenia w komponencie procesu.                                                                       |
| Trwałe dane aplikacji                                 | UI + proces + baza danych     | Ponownie użyj odpowiedniej aktywnej bazy danych przed utworzeniem nowej.                                                          |
| Dane offline lub natychmiastowe na wielu urządzeniach | Aplikacja czasu rzeczywistego | Włącz synchronizację i sprawdź `sync: ready` przed podłączeniem aplikacji.                                                        |
| Zaplanowane zadanie lub webhook                       | Aplikacja procesu             | Użyj wyzwalaczy na komponencie procesu.                                                                                           |
| Funkcja zasilana AI wewnątrz aplikacji                | Proces + API AI Kazzle        | Użyj `/ai/*` z kluczem API `kzl_`.                                                                                                |
| Narzędzie, które asystent powinien wywołać później    | Umiejętność + proces          | Dodaj folder umiejętności (`SKILL.md` + `tools.ts`) i wspieraj każde narzędzie `target.type: 'app'` trasą na komponencie procesu. |

## Ustawienia domyślne

* Zacznij od szablonu, jeśli się nadaje.
* Utrzymuj kod frontendu wolny od sekretów i adresów URL baz danych.
* Umieść pracę tylko dla serwera w komponencie procesu.
* Używaj adresów URL komponentów równorzędnych zamiast zakodowanych na stałe adresów localhost.
* Sprawdź podglądy w karcie app-dev przed stwierdzeniem, że aplikacja działa.