Saltar para o conteúdo
Verificado

Escolher entre o Slim e a CLI

A questão da fonte da verdade que decide em que caminho de escrita começar e como passar de um para o outro.

A melhor forma de escolher é perguntar quem é dono da fonte da verdade: uma página ou um projeto.

Escolha o Slim quando

  • a página é pequena ou incorporada
  • o HTML é a superfície de escrita natural
  • a árvore de runtime é gerada diretamente
  • quer um ponto de entrada leve
  • está a criar documentação, demonstrações ou uma superfície de marketing interativa

Escolha a CLI quando

  • está a criar uma aplicação completa a partir de ficheiros-fonte
  • quer uma estrutura de projeto canónica
  • as unidades de lógica, como get_data, set_data, batch, api e alert, devem ficar em pastas dedicadas
  • as tabelas, as rotas e os agentes de IA precisam de recursos explícitos
  • quer que a sincronização e os documentos de runtime gerados sejam tratados por si

Um caminho prático de migração

Muitas equipas começam no Slim e passam para a CLI mais tarde, e esse caminho funciona porque os conceitos do runtime não mudam por baixo: as expressões de campos continuam a usar @field_name, os programas continuam a compilar para o mesmo modelo de documento, e as tags estruturais e os painéis continuam a ser importantes. Nada do que aprender no modo Slim se desperdiça quando um projeto o ultrapassa.

Uma regra simples

Se a página parece um documento ou um widget incorporado, comece pelo Slim. Se o projeto parece uma aplicação, comece pela CLI.

Erros do primeiro dia a evitar

  • prog_id errado. Se não corresponder a um programa que o Slim consiga encontrar, carrega a coisa errada ou nada é apresentado.
  • Esperar um modelo mental diferente. O Slim é mais leve para começar, mas segue sempre os conceitos de runtime do Xuda.
  • Assumir que a conversão automática de HTML funciona fora de <template>. O caminho automático verificado de HTML para progUi é orientado por templates; apoie-se em tags <template id="..."> para essa conversão.
  • Valores de atributos tipo JSON mal formados. Um atributo que parece um objeto ou array mas não é JSON válido continua a ser uma string simples em vez de se tornar dados estruturados.
  • Escolher trabalho de CLI e chamar-lhe trabalho de Slim. Se o projeto precisa de rotas, de uma estrutura de aplicação maior e de uma organização de código-fonte duradoura, a CLI é o melhor ponto de partida.