Padrões de aplicativos

Escolha o menor formato de aplicativo que se adeque à tarefa. Adicione um processo, banco de dados, sincronização ou API de IA apenas quando o aplicativo precisar dessa funcionalidade.

O usuário quer	Use	Notas
Página de destino, relatório, página estática	Aplicativo de UI	Um componente de UI é suficiente.
Painel ou ferramenta interna com dados do servidor	UI + processo	Mantenha rotas de API e credenciais no componente de processo.
Dados persistentes do aplicativo	UI + processo + banco de dados	Reutilize um banco de dados ativo adequado antes de criar um.
Dados offline ou síncronos instantâneos em múltiplos dispositivos	Aplicativo em tempo real	Ative a sincronização e verifique `sync: ready` antes de conectar o aplicativo.
Tarefa agendada ou webhook	Aplicativo de processo	Use acionadores em um componente de processo.
Recurso alimentado por IA dentro de um aplicativo	Processo + API de IA Kazzle	Use `/ai/*` com uma chave de API `kzl_`.
Ferramenta que o assistente deve chamar depois	Skill + processo	Adicione uma pasta de skill (`SKILL.md` + `tools.ts`) e respaldar cada ferramenta `target.type: 'app'` com uma rota em um componente de processo.

Padrões

Comece a partir de um modelo quando um se adequar.
Mantenha o código frontend livre de segredos e URLs de banco de dados.
Coloque o trabalho apenas do servidor em um componente de processo.
Use URLs de componentes irmãos em vez de endereços localhost codificados.
Verifique visualizações na aba app-dev antes de dizer que o aplicativo está em execução.