Saltar al contenido
Verificada

Elegir entre Slim y la CLI

La pregunta sobre la fuente de verdad que decide con qué camino de creación empezar, y cómo pasar de uno a otro.

La mejor forma de elegir es preguntarse quién es dueño de la fuente de verdad: una página o un proyecto.

Elige Slim cuando

  • la página es pequeña o está incrustada
  • el HTML es la superficie de creación natural
  • el árbol del runtime se genera directamente
  • quieres un punto de entrada ligero
  • estás creando documentación, demos o una superficie de marketing interactiva

Elige la CLI cuando

  • estás creando una app completa a partir de archivos fuente
  • quieres una estructura de proyecto canónica
  • las unidades de lógica como get_data, set_data, batch, api y alert deben vivir en carpetas dedicadas
  • las tablas, las rutas y los agentes de IA necesitan recursos explícitos
  • quieres que se encarguen por ti la sincronización y los documentos de runtime generados

Un camino de migración práctico

Muchos equipos empiezan en Slim y pasan a la CLI más tarde, y ese camino funciona porque los conceptos del runtime no cambian por debajo: las expresiones de campo siguen usando @field_name, los programas siguen compilándose hasta el mismo modelo de documentos, y las etiquetas estructurales y los paneles siguen importando. Nada de lo que aprendes en el modo Slim se desperdicia cuando un proyecto lo supera.

Una regla general sencilla

Si la página se parece a un documento o a un widget incrustado, empieza con Slim. Si el proyecto se parece a una aplicación, empieza con la CLI.

Errores del primer día que conviene evitar

  • prog_id equivocado. Si no coincide con un programa que Slim pueda encontrar, se carga lo que no es o no se renderiza nada.
  • Esperar un modelo mental distinto. Slim es más ligero para empezar, pero sigue los conceptos del runtime de Xuda en todo momento.
  • Suponer que la conversión automática de HTML funciona fuera de <template>. El camino automático verificado de HTML a progUi está guiado por plantillas; apóyate en etiquetas <template id="..."> para esa conversión.
  • Valores de atributo tipo JSON mal formados. Un atributo que parece un objeto o array pero no es JSON válido sigue siendo una cadena simple en lugar de convertirse en datos estructurados.
  • Elegir trabajo de CLI y llamarlo trabajo de Slim. Si el proyecto necesita rutas, una estructura de app mayor y una organización del código fuente de larga duración, la CLI es el mejor punto de partida.