Saltar al contenido
3.5.12
El
mecanismo

Declaras el modelo.Quarum funde el resto.

La clase que describes es la tabla, el formulario, el listado, el permiso y el CSV. Sin una segunda copia del modelo que mantener sincronizada a mano, y sin reescribir el CRUD de cada entidad.

o lee la documentación

metadata → artefactos
{  "name": "book",  "label": "Libros",  "plural": "books",  "fields": [    { "name": "title",  "type": "String" },    { "name": "year",   "type": "Integer" },    { "name": "author", "type": "connected_table",      "connected_to": "Author" }  ],  "permissions": [{ "usergroup": "Administrativo",                    "read": true, "edit": true }]}
  • esquemaTabla book con title, year y la clave author_id hacia author.
  • modeloproject/models/production/book.py, generado y regenerable.
  • migraciónUna revisión nueva en la rama app, colgada de su cabeza.
  • panelAlta con selector de autor, listado con búsqueda por título y orden.
  • permisosUna fila por grupo en _qcore_permission.
  • salidaCSV y PDF de la tabla, sin escribir el exportador.
Los modelos de project/models/production/ son artefactos: se regeneran desde la metadata, no se editan.
Las tres
capas

Una frontera que se puede señalar con el dedo

El framework se instala; el proyecto solo declara; la instancia guarda lo que es de cada despliegue. De esa separación sale la ventaja que más se nota con los años: actualizar Quarum no te obliga a reescribir tu aplicación, y tu aplicación no te obliga a bifurcar Quarum.

01

Quarum — el framework

Se instala como paquete. No se copia dentro del proyecto ni se parchea.

site-packages/quarum/

  • Motor declarativo, panel, permisos y capa de consulta.
  • Su propia rama de migraciones, con su cabeza de Alembic.
  • Se actualiza con quarum upgrade, sin tocar tu código.
02

Payload — la aplicación

Lo que declara este proyecto. Es portátil entre instalaciones.

project/ · plugins/ · classes/ · migrations/

  • classes/*.json: la fuente de verdad de las clases y sus campos.
  • events.py y actions.py: lo que la metadata no puede decir.
  • plugins/: tablas y rutas propias, cargadas por convención.
03

Instancia — el despliegue

Credenciales, datos y configuración de este servidor y de ningún otro.

.env · wsgi.py · uploads/ · logs/ · backups/

  • MySQL o MariaDB con InnoDB; una base por instalación.
  • Originales en uploads/ o en un bucket compatible con S3.
  • Un solo fichero de código propio: wsgi.py.

La regla de la casa: el payload declara y Quarum lee. Nunca al revés. Por eso actualizar el framework no reescribe tu aplicación, y por eso el esquema se cambia con una revisión y no con un ALTER a mano.

El trato

Lo que ganas, y lo que te pide a cambio

Quarum no es low-code ni un panel de administración genérico. Es una apuesta concreta: el modelo de datos manda y el CRUD es del framework. De ahí salen ventajas que se notan el primer día y otras que se notan al tercer año; también salen exigencias, y están en la misma tabla porque elegir a ciegas sale más caro que leer esto dos veces.

Seis decisiones de diseño, con lo que dan y lo que piden
La decisión Lo que ganas Lo que te pide
El modelo es la fuente de verdad Cambias una clase y se regeneran el esquema, el panel, los permisos y las exportaciones. Una sola definición, ni una copia que se desincronice. Cambiar de idea es migrar: no hay atajos por fuera de la metadata.
El panel se sirve en el servidor Sin capa de serialización ni estado duplicado en el navegador. Menos superficie, menos código y pantallas que responden con la base delante. Para una interacción muy fina, el JavaScript lo escribes tú.
Una base: MySQL o MariaDB Lo que los equipos ya saben operar: copias, réplicas, monitorización y años de oficio encima. Si el proyecto exige PostgreSQL, Quarum no es la herramienta.
El framework es un paquete aparte Actualizas Quarum sin tocar tu aplicación, y tu aplicación sin bifurcar el framework. Dos clientes comparten motor sin compartir base ni secretos. Hay que respetar la frontera: el payload declara, no parchea.
El árbol y las tablas conectadas son nativos Jerarquías, relaciones M2M y permisos por clase vienen resueltos: es lo que un catálogo o un directorio necesitan el primer día. El panel impone su forma de navegar; para algo muy distinto, una ruta o un plugin propios.
Los plugins son código tuyo Se depuran con el mismo log y el mismo depurador que el resto: no hay caja negra ni lenguaje aparte. Corren en el proceso de la aplicación: la contención la pones tú.

Y una ventaja que no cabe en una fila: el JSON. Quarum no autogenera una API REST, así que no hay una capa de serialización que se quede vieja cada vez que cambia el modelo. Si necesitas JSON, es una ruta tuya con session.newQuery() y @verify_permission delante: diez líneas, y hace exactamente lo que pides.

En
producción

Donde ya está trabajando

UniCo CMS es el CMS de colecciones de Nible Tecnología y corre sobre Quarum. Una de sus instalaciones cataloga patrimonio con fichas jerárquicas, autores, técnicas, periodos y préstamos, y sirve las imágenes en alta resolución desde un bucket S3.

7 372 originales catalogados en una sola instalación
218 GB de imágenes en alta resolución, servidas con URL firmada
  • La jerarquía de categorías y las tablas conectadas son parte del panel, no un añadido.
  • El catálogo se exporta a PDF y a CSV sin escribir un exportador por tabla.
  • De ahí salió el framework: lo que un archivo pedía en cada proyecto acabó siendo el motor.
Dónde
se usa

Sistemas donde el dato es el trabajo

Quarum nació dentro de un CMS de colecciones y se ha usado en encuestas, directorios y backends de gestión. Son cuatro problemas distintos con la misma raíz: muchas entidades, muchas relaciones y un panel que hay que mantener años. Eso es justo lo que Quarum quita de en medio.

  • Colecciones y patrimonio

    UniCo CMS · museos y archivos

    Fichas catalográficas con jerarquías, autores, técnicas, periodos, préstamos e imágenes en alta resolución. El árbol de categorías y las tablas conectadas son parte del panel, no un añadido.

  • Encuestas y estudios

    Ingesta y microdatos

    Cuestionarios con validaciones por perfil, registros concurrentes y salida a CSV para el análisis. La captura y la explotación comparten el mismo modelo.

  • Directorios institucionales

    Catálogos públicos

    Organizaciones, sedes y contactos con búsqueda facetada, permisos por grupo y una parte pública que se sirve con el mismo esquema.

  • Sistemas de gestión a medida

    Backend RAD

    Cuando el modelo de datos es atípico y el plazo corto: se declara el modelo, se genera el panel y se escribe solo lo que de verdad es del negocio.

Acceso

Trae el modelo. Nosotros ponemos el motor.

Quarum no se descarga de un registro público: se instala por proyecto. Eso tiene una ventaja concreta: la primera conversación es sobre tus entidades y tus reglas, no sobre una demo. Si el modelo encaja, la instancia se levanta y el equipo que la va a mantener queda dentro desde el principio.

  • Una sesión técnica sobre tu modelo, con tus datos delante.
  • Revisión de encaje: versión, base de datos, almacenamiento y despliegue.
  • La documentación es pública: puedes leerla —y discutirla— antes de escribir.

Se responde desde soporte@nibletecnologia.com. Sin listas de correo.

Solicitud enviada. Te contestamos desde soporte@nibletecnologia.com.

El código que no escribes es el que no tienes que mantener.

Fichas de museo, préstamos, encuestas y directorios: cuatro problemas distintos que piden la misma pieza. El modelo se declara una vez y el framework se encarga del resto. Si quieres verlo con tu modelo delante, pídelo; si prefieres leerlo antes, la documentación es pública y se lee en una tarde.

Solicitar acceso