Tablas, campos y registros

Si te llevas una sola idea de esta documentación, que sea esta: tú eliges qué información guardar y el framework construye el panel para gestionarla. Todo lo demás son variaciones sobre este tema.

El modelo mental

Piensa en una hoja de cálculo tipo Excel o Google Sheets:

• Una tabla es una hoja completa. Por ejemplo: "Productos".
• Un campo (también llamado columna) es una columna de esa hoja. Por ejemplo: "Nombre", "Precio", "Stock".
• Un registro (también llamado fila) es una fila de esa hoja. Por ejemplo: "Camisa azul talla M, $12.990, 15 unidades".

En el framework:

• Tú creas las tablas desde el panel — clicks, sin escribir código ni SQL.
• Tú defines qué campos tiene cada tabla y de qué tipo son (texto, número, fecha, imagen, etc.).
• El framework genera automáticamente: el formulario para agregar registros, el listado para verlos, los filtros para buscarlos, y hasta la API para consumirlos.

Ejemplo mínimo: una tienda

Imagina que quieres montar una tienda online. Necesitas guardar tres tipos de información:

Tabla 1: Productos

Campo	Tipo	Ejemplo
Nombre	Texto	"Camisa azul"
Descripción	Área de texto	"Camisa de algodón..."
Precio	Dinero	$12.990
Stock	Número	15
Foto	Imagen	camisa-azul.jpg
Activo	Booleano	Sí

Tabla 2: Clientes

Campo	Tipo	Ejemplo
Nombre	Texto	"Juan Pérez"
Email	Email	juan@ejemplo.com
Teléfono	Texto	+56 9 1234 5678
Dirección	Texto	Av. Providencia 123

Tabla 3: Pedidos

Campo	Tipo	Ejemplo
Cliente	Relación	"Juan Pérez"
Producto	Relación	"Camisa azul"
Cantidad	Número	2
Fecha	Fecha	2026-07-29
Estado	Selección	"Enviado"

Con estas tres tablas ya tienes el corazón de una tienda funcionando. El framework te muestra un panel para gestionarlas, y podrás publicar las páginas del catálogo con el Generador de páginas.

¿Qué te genera el framework automáticamente?

Cuando das de alta una tabla en el panel, sin que hagas nada más obtienes:

• 📋 Listado con paginación, buscador y filtros por cada columna.
• ➕ Botón "Nuevo" que abre un formulario con los campos de la tabla.
• ✏️ Botón "Editar" en cada fila.
• 🗑 Botón "Eliminar".
• 📤 Exportar el listado a CSV, Excel o PDF.
• 📥 Importar registros desde un CSV.
• 🔌 Endpoints de API para consumirlos desde otras aplicaciones o desde el sitio público.

No configuras nada de eso — está incluido.

Vocabulario que vas a escuchar

Término	Qué significa
Tabla o Módulo	Un conjunto de datos con estructura fija (Productos, Clientes, etc.).
Campo o Columna	Cada uno de los "casilleros" que tiene la tabla (Nombre, Precio…).
Registro o Fila	Una entrada concreta (un producto específico, un cliente específico).
Tipo de campo	La clase de dato que guarda esa columna (texto, número, imagen, etc.). Ver Tipos de campo.
Relación	Un campo que apunta a un registro de otra tabla ("Cliente" en un pedido).
CMS	El panel de administración que estás usando (Content Management System).

¿Y las tablas del propio framework?

El framework también tiene sus tablas internas (usuarios, páginas, configuración global, plugins…). Están ocultas del panel principal para no confundir. Solo ves las tablas que tú creas.

Las tablas internas aparecen como opciones en otros lugares (por ejemplo, "Usuarios" tiene su propio menú, no está mezclado con tus tablas).

Errores comunes al empezar

• Crear una tabla por cada pantalla que quieres. No. Crea tablas por tipo de información (productos, clientes, pedidos). Las pantallas son otra cosa.
• Duplicar información entre tablas. Si el mismo cliente compra 5 veces, no lo guardes 5 veces — usa una relación (ver Relacionar tablas).
• Todo como campo de texto. El framework tiene tipos específicos (dinero, fecha, imagen) que se muestran mejor y validan solos. Úsalos.

¿Qué sigue?

• Módulos y menús — cómo se organiza el CMS con las tablas que creas.
• Usuarios, roles y permisos — quién ve y modifica qué.
• Cuando estés listo, ve a Crear una tabla para hacer tu primera de verdad.