Apps operativas
Apps operativas: visión general
Qué es una app operativa en Quantum, cómo se ejecuta y qué obtienes sin construirlo: historial, permisos, archivos, ejecuciones y analítica.
Actualizado: 2026-11-17
En esta guía
Qué es una app operativa
Una app operativa es una aplicación de trabajo diario (devoluciones, cierres de caja, conciliaciones, casos) que no programas desde cero. La describes como datos y Quantum la ejecuta.
Tú aportas dos cosas:
- Una definición: un documento JSON que declara los objetos, las acciones, los permisos, los archivos y las pantallas.
- Flujos: el código con tu lógica de negocio. Se ejecutan fuera de la definición, cuando una acción o un archivo los dispara.
Quantum aporta el resto: almacenamiento, validación, control de acceso, historial, subida de archivos, despacho de flujos y la interfaz en el panel.
Las piezas
- Tipos de registro: los objetos de tu app. Cada tipo tiene un esquema de campos y, opcionalmente, un ciclo de vida con estados y transiciones permitidas.
- Registros: las instancias. Cada registro guarda sus datos, su estado, su versión y su historial.
- Acciones: lo que una persona puede hacer. Una acción puede pedir datos, escribir campos, mover el registro de estado e iniciar un flujo.
- Flujos: tu lógica. Reciben un sobre estándar con el registro, los datos de la acción y la configuración de la app, y devuelven resultados escribiendo registros o filas de dataset.
- Permisos: roles con capacidades, asignados a usuarios o a roles de la organización, con alcance opcional (por ejemplo, por tienda).
- Archivos: ranuras donde se adjuntan archivos a un registro o a la app, con tipo, tamaño máximo y verificación de integridad.
- Datasets: tablas de filas de alto volumen que escriben los flujos y leen las pantallas.
- Vistas: las pantallas, compuestas con componentes ya construidos (tablas, métricas, detalle, acciones, archivos, gráficos) y, si hace falta, componentes propios.
Cómo se ejecuta
- Guardas los tipos de registro y la definición de la app en tu organización.
- Quantum valida la definición completa. Si algo referencia una pieza que no existe, la rechaza y te lista todos los errores.
- Un usuario abre la app en el panel. Solo ve lo que sus permisos le permiten.
- El usuario ejecuta una acción. Quantum comprueba permiso, alcance y estado, valida los datos, escribe el registro, guarda el historial y encola el flujo, todo en una sola operación.
- Tu flujo arranca con el sobre estándar, hace su trabajo y registra el resultado.
- La pantalla se actualiza sola con el nuevo estado.
Tu definición son datos. Tu lógica son flujos. Quantum ejecuta el contrato y no necesita conocer tu caso de uso.
Qué obtienes sin construirlo
- Historial: cada cambio guarda quién, cuándo, qué campos cambiaron y una copia del registro. Los cambios hechos por una acción guardan además la acción y los datos enviados.
- Permisos: capacidades por rol y alcance por dimensión, aplicados en el servidor en cada lectura y cada acción.
- Concurrencia segura: cada registro tiene versión. Si dos personas actúan sobre el mismo registro, la segunda recibe un conflicto en lugar de sobrescribir.
- Archivos verificados: la subida va directa al almacenamiento con suma SHA-256. Un archivo solo cuenta cuando Quantum comprueba que el contenido coincide.
- Ejecuciones: un flujo vinculado a una automatización aparece en Ejecuciones como cualquier otra corrida, con el usuario que la disparó.
- Arranque exactamente una vez: el inicio del flujo se guarda junto con el cambio del registro. Un reintento de la misma petición no arranca el flujo dos veces.
- Proyección analítica: cada versión de cada registro se copia al almacén analítico de Quantum para reportes.
- Entornos: la misma definición se instala por separado en QA y en producción.
Registros o datasets
Usa registros cuando el objeto:
- Tiene un ciclo de vida (solicitado, aprobado, cerrado).
- Recibe acciones de personas.
- Necesita historial, archivos adjuntos o permisos por alcance.
Usa datasets cuando los datos:
- Son muchas filas que produce un flujo (líneas de un extracto, resultados de un cruce, detalle de ventas).
- Solo se leen, se filtran y se grafican.
- Se pueden reescribir completos en cada corrida.
Una regla práctica: si alguien va a tomar una decisión sobre la fila, es un registro. Si la fila solo explica o respalda una decisión, es un dataset.
Ten en cuenta que los datasets no tienen alcance por fila: quien puede abrir la app puede leer todas las filas de sus datasets.
Siguientes pasos
- Inicio rápido: construye una app de devoluciones de punta a punta.
- Referencia de la definición: cada campo del documento.
- Flujos: cómo escribir la lógica.
- Vistas: cómo componer pantallas.
- Permisos y entornos: roles, alcance, QA y producción.