Saltar al contenido

Artefactos

Un artefacto es la unidad que creas en wasabi: una definición declarativa de una parte de tu app, sin un backend y un frontend separados que mantener sincronizados. Hay cuatro tipos:

  • Un formulario define una pantalla de captura de datos y la forma de los registros que hay detrás, con validación y diseño.
  • Una fuente de datos incorpora datos de referencia y tabulares a tu app, desde tablas en línea, archivos o colecciones en vivo.
  • Un browser configura cómo se presenta una colección de registros y qué se puede hacer con ella.
  • Una plantilla genera texto, como un documento o el cuerpo de un correo, a partir de los datos de un registro.

Cada artefacto es una definición concisa, y los artefactos se referencian entre sí por nombre, por ejemplo un campo de formulario que apunta a @data/regiones, así que las piezas compartidas se definen una vez y se reutilizan.

yaml
kind: form
label: Cliente
fields:
  nombre: { type: string, required: true }
  region: '@data/regiones'

Cuando publicas, un compilador valida cada artefacto, resuelve esas referencias cruzadas, detecta ciclos y emite una instantánea inmutable con hash de contenido y procedencia completa: quién la publicó, cuándo y a qué versión resolvió exactamente cada referencia. Esa instantánea es lo que se despliega al runtime. Como una versión se identifica por el hash de su contenido, una app es reproducible y auditable por diseño, y nada cambia por debajo de una app en marcha hasta que vuelves a publicar.

Los artefactos son la base sobre la que se construyen el resto de estos conceptos: las vistas dan forma a una fuente de datos, los browsers la presentan, y los flujos de trabajo impulsan los formularios mientras las personas hacen su trabajo.