Una demostración puede enseñar una idea en pocos minutos y, aun así, acabar necesitando cuentas, almacenamiento, tareas de limpieza y soporte. Cada una de esas decisiones añade trabajo después de que el visitante cierre la página. Si no forma parte de lo que queremos demostrar, conviene preguntarse si realmente debe formar parte de la experiencia.
El objetivo de una demo no es reproducir todas las funciones de una aplicación final. Es permitir que una persona compruebe algo concreto y entienda qué puede y qué no puede concluir de ello. Para diseñarla hay que decidir qué hará el visitante, qué datos utilizará, cuánto tiempo permanecerán y quién mantendrá el entorno.
En el trabajo de demos vinculadas a Código BIM, cliente de Capricorn Nexus, se plantearon aplicaciones integradas en artículos mediante iframe. El repositorio de despliegue documenta dos experiencias con necesidades distintas: un gestor de incidencias que depende de autenticación de Autodesk y un observatorio de datos que no pide cuenta al visitante. Esa diferencia es útil: simplificar la entrada no significa eliminar un permiso que el servicio necesita.
Tabla de contenidos
Define qué debe poder comprobar el visitante
Antes de decidir la tecnología, termina esta frase: «Al terminar la demo, la persona habrá podido comprobar que…». La respuesta debe describir una acción o un resultado observable, no una promesa amplia como «descubrir el futuro de la gestión digital».
Para una demo de un catálogo, quizá baste con filtrar una colección de ejemplo y abrir una ficha. Para un comparador, puede ser cambiar dos opciones y entender por qué varía el resultado. En un gestor conectado a un servicio externo, el objetivo puede ser revisar un pequeño lote antes de decidir si se envía.
Cada objetivo implica un alcance distinto. Si solo necesitas mostrar cómo se ordena una lista, no hace falta crear cuentas personales. Si la experiencia accede a proyectos privados de un proveedor, la autorización de ese proveedor puede ser imprescindible. El diseño debe facilitar la tarea sin pedir más información de la necesaria.
Una definición práctica incluye cuatro decisiones:
- Qué entrada necesita la persona: un filtro, un archivo de ejemplo o una cuenta externa autorizada.
- Qué acción puede realizar: explorar, preparar una propuesta o confirmar una operación concreta.
- Qué resultado verá: una pantalla, una validación, una tabla o un recibo por elemento.
- Qué queda fuera: funciones no disponibles, datos que no se conservan o acciones que requieren otra autorización.
Esa última parte no tiene que esconderse en una página legal. Si un visitante espera guardar su trabajo para volver mañana y la demo no ofrece esa función, es mejor decirlo junto al recorrido que dejar que lo descubra después de invertir tiempo.
Una experiencia breve no siempre necesita registro
Para muchas demostraciones, el visitante puede entrar, probar con datos sintéticos y cerrar la página. Un registro local añadiría contraseñas, recuperación de acceso, gestión de perfiles y decisiones sobre qué hacer con las cuentas inactivas. Si ninguna de esas funciones ayuda a comprobar la idea, su coste puede superar su utilidad.
Hay excepciones. Una demo que interactúa con información privada de un proveedor necesita respetar la identidad y los permisos de ese proveedor. El repositorio de demos de Código BIM describe un gestor de incidencias que utiliza autenticación de Autodesk sin crear una cuenta local adicional. El visitante debe tener acceso y permisos en el entorno correspondiente; la demostración no los concede por sí sola.
La diferencia debe resultar clara en la interfaz. «Sin registro local» no equivale a «sin autenticación» cuando una cuenta externa es necesaria. Tampoco convierte una sesión de prueba en permiso para modificar cualquier proyecto. Antes de una acción que escriba datos, la persona debe entender qué se enviará y confirmar lo que corresponda al flujo y a sus permisos.
En cambio, el observatorio descrito en el mismo repositorio plantea un visor sin cuenta para el visitante. Ambos ejemplos responden a tareas diferentes; no existe una única regla de acceso adecuada para todas las demos.
Un iframe es una forma de presentar la demo, no todo su diseño
Integrar una aplicación dentro de un artículo puede mantener la explicación y la experiencia juntas. El lector entiende el contexto, interactúa y continúa leyendo sin tener que orientarse primero en otro producto completo. Esa cercanía es especialmente útil cuando la demo acompaña una decisión concreta del artículo.
Pero la integración añade preguntas que deben resolverse. ¿Tiene una altura suficiente en móvil? ¿Los controles se pueden utilizar sin que el marco tape parte de la página? ¿Qué ocurre si el navegador bloquea la carga, si la aplicación tarda o si un servicio externo no responde? ¿Hay una alternativa comprensible cuando el contenido no está disponible?
También hay que comprobar las políticas del servidor, el uso de HTTPS y las restricciones del marco en el entorno real. Un iframe que funciona en una página local no demuestra que vaya a funcionar en WordPress con su dominio, proxy y cabeceras definitivas. La prueba útil abre el artículo real en los dispositivos acordados y recorre la acción, no solo verifica que aparece un rectángulo.
Una opción de diseño para el móvil es mantener cerrados los paneles que cubren la parte principal de la demo y permitir que la persona los abra. Esa elección debe comprobarse con el contenido y los controles reales. No hace falta convertir cada interacción en una animación: lo importante es que el visitante pueda ver y usar lo que ha venido a probar.
Diseña límites que correspondan al uso
Cuando una demo acepta archivos, el límite no es solo una cifra junto al botón de subida. Hay que decidir qué formatos acepta, cuánto trabajo puede procesar el servidor, dónde se guarda el archivo durante la operación y qué recibe la persona si algo falla.
El repositorio de demos de Código BIM describe para Issues Manager una revisión de hasta veinte filas de un archivo XLSX de hasta 1 MiB. Esos límites pertenecen al diseño documentado de esa demostración; no son una recomendación universal para otros proyectos ni una afirmación sobre un ensayo de carga. La cifra adecuada depende del tipo de archivo, la operación, la concurrencia esperada y los recursos disponibles.
Antes de fijar el límite, comprueba si la tarea necesita procesar el archivo completo o solo una muestra representativa. Si una demo busca enseñar cómo se detectan errores en una importación, un lote pequeño y legible puede ser más útil que admitir miles de filas. El visitante puede revisar el resultado y el equipo puede entender mejor qué recursos consume cada prueba.
La interfaz debería explicar el límite antes de pedir el archivo y ofrecer un mensaje claro cuando se supera. Si hay una plantilla de ejemplo, debe dejar claro qué columnas se esperan y qué información no debe incluirse. No es una buena experiencia aceptar un documento y fallar después con un error técnico que no ayuda a corregirlo.
Qué datos necesitan permanecer
Hay tres escenarios distintos. Algunas demos pueden procesar información únicamente durante la sesión. Otras necesitan conservar un resultado temporal para que la persona complete una revisión. Y otras dependen de un servicio externo que mantiene sus propios registros. La política debe describir lo que realmente ocurre en cada caso.
Define para cada dato dónde se guarda, quién puede acceder, cuándo deja de ser necesario y cómo se elimina. No prometas «no guardamos nada» si existen registros de servidor, una base temporal o datos en un proveedor conectado. Del mismo modo, no anuncies una limpieza automática solo porque esté prevista en el diseño: hay que comprobar que el mecanismo exista y funcione.
Si la limpieza depende de una tarea programada, comprueba qué ocurre cuando esa tarea falla o el servicio se reinicia. Si depende de una acción del visitante, explica qué pasa si cierra la ventana antes de completarla. El equipo responsable necesita una forma de detectar acumulaciones y actuar, no solo una intención de borrar más adelante.
Distingue explorar, preparar y escribir
Una demo puede ofrecer niveles de interacción diferentes. Explorar un ejemplo sintético no tiene las mismas consecuencias que preparar una operación sobre datos propios. Y preparar una operación no debería confundirse con ejecutarla.
En el diseño documentado para el gestor de incidencias, la persona puede descargar una plantilla, revisar el lote y confirmar la creación de todas las filas válidas de esa revisión dentro de los límites definidos. La documentación separa la revisión del envío y prevé resultados por fila. Esa estructura ayuda a que el visitante vea el efecto previsto antes de autorizar una acción en el servicio externo.
Para cualquier integración similar, revisa las consecuencias con una pregunta concreta: «Si pulso este botón, ¿se modifica algo fuera de la demo?». Si la respuesta es sí, el texto y la confirmación deben decir qué se enviará y a qué destino. Los permisos del proveedor siguen aplicándose y una aprobación de la interfaz no sustituye la autorización necesaria en el sistema externo.
También importa el comportamiento ante una respuesta perdida. Si el usuario confirma una operación y después ve un error de conexión, no debería animársele a repetirla a ciegas: quizá el servicio haya procesado parte del lote. Una referencia de operación y un resultado recuperable pueden ayudar a investigar qué ocurrió antes de un nuevo intento.
Una ficha de alcance que el equipo pueda usar
Antes de construir la demo, escribe una ficha breve con las decisiones que afectan al visitante y a su mantenimiento:
| Pregunta | Decisión que debe quedar clara |
|---|---|
| ¿Qué se demuestra? | Una tarea concreta y el resultado que la persona puede observar |
| ¿Quién puede entrar? | Acceso abierto o autenticación necesaria, con sus permisos reales |
| ¿Qué datos se usan? | Ejemplos sintéticos, archivos aportados o datos de un proveedor autorizado |
| ¿Qué acciones tienen efectos? | Operaciones de solo lectura, preparación y posibles escrituras |
| ¿Qué límites existen? | Tamaño, filas, tiempo u otros límites comprobados para ese entorno |
| ¿Qué se conserva? | Ubicación, acceso, plazo y procedimiento real de limpieza |
| ¿Quién mantiene la demo? | Responsable de servicios, errores, credenciales y revisión de enlaces |
Si la demo todavía está en desarrollo, añade el estado de cada decisión para que el equipo sepa qué puede ofrecer al visitante y qué necesita completar.
No confundas preparación, despliegue y funcionamiento
Un repositorio con un Dockerfile muestra cómo se pretende construir un servicio. Una ejecución local puede demostrar que ciertos componentes arrancan en ese entorno. Una guía de despliegue explica los pasos previstos. Ninguna de esas pruebas, por sí sola, confirma que la demo esté disponible y funcione para un visitante en el dominio público.
En el trabajo de Código BIM, las decisiones sobre acceso, integración y límites se documentaron para cada demo. La disponibilidad pública de cada una debe comprobarse en el artículo y entorno correspondientes antes de presentarla como operativa.
La comprobación debe seguir el recorrido real: abrir la página pública, cargar el iframe, probar la acción permitida y observar qué ocurre en escritorio y móvil. Si la demo depende de un proveedor, identifica qué parte puedes verificar sin utilizar datos privados ni provocar cambios no autorizados. Una pantalla de acceso operativa no demuestra que una escritura externa haya funcionado.
El soporte también forma parte del alcance. Una demo pública puede recibir archivos incorrectos, accesos simultáneos o solicitudes que excedan lo previsto. Define a quién se notifican los errores y qué mensaje verá el visitante cuando el servicio esté temporalmente indisponible. Una experiencia mínima necesita una salida clara incluso cuando no puede completar la tarea.
Menos funciones, una decisión mejor explicada
Una demo bien delimitada deja que el visitante pruebe lo relevante y evita pedirle trabajo que no aporta a esa decisión. Para conseguirlo, empieza por la acción que quieres mostrar, separa exploración de escritura y diseña los límites de archivos, datos y mantenimiento alrededor del uso real.
Después verifica cada afirmación en el entorno correspondiente. Una propuesta puede ser prometedora sin estar desplegada; una demo puede estar disponible sin cubrir todas las funciones de un producto; y un ensayo local puede ser valioso sin convertirse en una prueba de producción. Explicarlo con claridad permite que el lector entienda el valor de la demostración y sus límites.
Si necesitas presentar una herramienta dentro de tu web y quieres definir una experiencia proporcionada a su objetivo, cuéntanos tu proyecto.
