Formularios y cuestionarios¶
¿Qué es?¶
El módulo de Formularios permite crear cuestionarios y checklists que los empleados deben completar desde la aplicación móvil. Se pueden asignar a empleados individuales, por proyecto o por zona. Desde el portal se gestionan los cuestionarios (estructura de preguntas), se asignan a los empleados y se consultan las respuestas con estadísticas de completitud.
Vista principal — Lista de cuestionarios¶
La tabla muestra todos los cuestionarios con las siguientes columnas:
- Cuestionario — Título del cuestionario en negrita con la descripción debajo en texto pequeño gris. Ancho máximo 320 px, truncado.
- Cliente — El cliente dueño del cuestionario, o General; un cuestionario general que los clientes pueden ver lleva además la marca «visible a clientes». Ver Cuestionarios generales o de un cliente.
- Estado — Badge de color según el estado del cuestionario (form-level state).
- Asignados — Total de empleados asignados para completar el cuestionario. Alineado a la derecha.
- Completados — Total de empleados que ya enviaron sus respuestas. Alineado a la derecha.
- Progreso — Barra de progreso visual con el porcentaje de completitud:
- Verde — 80% o más.
- Ámbar — Entre 40% y 79%.
- Rojo — Menos del 40%. Ancho 180 px.
- Preguntas — Número total de preguntas en el cuestionario. Alineado a la derecha.
- Creado — Fecha de creación en formato AAAA-MM-DD. Ancho 110 px.
Al hacer clic en cualquier fila, se navega a la página de resultados del cuestionario (forms-results/{id}).
Filtros¶
- Buscar por título o descripción... — Campo de texto libre.
- Estado — Selector con opciones:
Todos,Borrador,Abierto,Cerrado. (Los estados Pendiente y Finalizado existen en respuestas individuales pero no en este filtro). - Activo — Selector:
Todos,Activos,Inactivos. - Cliente — Buscador de cliente: deja solo los cuestionarios de ese cliente.
La columna y el filtro Cliente no aparecen en el portal de clientes, a propósito: allí cada cliente ya ve solo lo suyo.
Ordenación por defecto¶
Ordenada por fecha de creación descendente.
Estados de un cuestionario (form-level)¶
| Estado | Badge | Descripción |
|---|---|---|
| Borrador | Gris | En construcción, no visible para empleados |
| Abierto | Verde | Disponible para que los empleados respondan |
| Cerrado | Rojo | Ya no acepta nuevas respuestas |
| Pendiente | Ámbar | Asignado pero el empleado no ha empezado (solo en respuesta individual) |
| Finalizado | Azul claro | El cuestionario terminó (solo en respuesta individual) |
Estados de una respuesta individual¶
| Estado | Badge | Descripción |
|---|---|---|
| Nuevo | Gris | Asignado, el empleado no ha abierto el cuestionario |
| En curso | Ámbar | El empleado empezó pero no lo envió |
| Completado | Verde | El empleado envió todas las respuestas |
Acciones en la lista¶
Botón "Nuevo cuestionario"¶
Visible con permiso forms: create. Navega al constructor de cuestionarios (forms-detail sin ID).
Exportar¶
Botón de exportación. Descarga un archivo cuestionarios con la lista de cuestionarios y sus estadísticas.
Constructor de cuestionarios (forms-detail)¶
Página de creación y edición de cuestionarios. Se accede haciendo clic en Nuevo cuestionario o desde los resultados al editar un cuestionario existente.
Metadatos del cuestionario¶
- Título — Nombre del cuestionario (obligatorio).
- Descripción — Texto introductorio que verá el empleado antes de comenzar.
- Mensaje de finalización (
description_done) — Texto que verá el empleado al enviar sus respuestas. - Estado — Selector:
Borrador,Abierto,Cerrado. - Activo — Toggle para activar/inactivar el cuestionario.
- Cuestionario de — General o Un cliente (con buscador «Buscar cliente...»). Si es General aparece la casilla Visible para clientes. Es obligatorio elegir: «Elige el cliente del cuestionario, o márcalo como General.» Ver Cuestionarios generales o de un cliente.
Tipos de pregunta disponibles¶
| Tipo | Descripción |
|---|---|
Opción simple (simple_choice) |
Una sola respuesta de una lista |
Opción múltiple (multiple_choice) |
Varias respuestas de una lista |
Texto corto (char_box) |
Campo de texto de una línea |
Texto largo (text_box) |
Campo de texto multilínea |
Numérico (numerical_box) |
Solo números |
Fecha (date) |
Selector de fecha |
Escala (scale) |
Escala numérica (ej. del 0 al 10) |
Matriz (matrix) |
Tabla de filas × columnas con opciones |
Estructura de preguntas¶
Cada pregunta tiene:
- Texto de la pregunta — Enunciado.
- Descripción — Texto explicativo opcional.
- Obligatorio — Toggle para hacer la pregunta obligatoria.
- Opciones de respuesta — Para tipos simple_choice y multiple_choice: lista editable de opciones.
Configuraciones avanzadas (botón "Avanzado"):
- Validación de rango — Para tipos numérico y escala: valor mínimo y máximo aceptados.
- Validación de longitud — Para texto: longitud mínima y máxima de caracteres.
- Validación de email — Para texto corto: verifica formato de email.
- Rango de fechas — Para tipo fecha: fecha mínima y máxima permitidas.
- Mensaje de error de validación — Texto a mostrar si la respuesta es inválida.
- Permitir comentarios — Toggle para agregar un campo de comentario libre.
- Mensaje del comentario — Label del campo de comentario.
- Contar comentario como respuesta — Toggle.
- Pregunta condicional — Muestra la pregunta solo si una pregunta anterior tiene una respuesta específica (triggering_question_id + triggering_answer_id).
Para tipo Escala¶
Además de rango mínimo/máximo, acepta etiquetas para los extremos (ej. "Muy malo" — "Excelente").
Para tipo Matriz¶
Define filas (opciones de la izquierda) y columnas (opciones de la parte superior) de la tabla.
Advertencias al editar cuestionarios con respuestas¶
Si el cuestionario ya tiene respuestas (responsesCount > 0), el sistema advierte que modificar preguntas o respuestas puede afectar la trazabilidad histórica. Las advertencias aparecen específicamente al eliminar preguntas o respuestas que ya existían en el sistema.
Guardar cuestionario¶
Botón Guardar en la barra superior. Si hay cambios sin guardar (isDirty), el sistema advierte antes de navegar fuera.
Resultados del cuestionario (forms-results)¶
Al hacer clic en un cuestionario de la lista, se abre la página de resultados con tres pestañas:
Encabezado¶
- Nombre del cuestionario.
- Estado del cuestionario (badge clickeable con permiso de edición).
- Botón Editar cuestionario — Navega al constructor.
- Estadísticas rápidas: total asignados, completados, en curso, sin responder.
Pestaña Resumen¶
Vista agregada de todas las respuestas por pregunta:
- Para cada pregunta muestra:
- Texto de la pregunta.
- Tipo de pregunta.
- Gráfico/estadística de las respuestas (distribución de opciones, promedios de escala, etc.).
Pestaña Respuestas¶
Tabla con cada respuesta individual. Columnas:
- Empleado — Nombre + código de empleado.
- Estado — Badge: Nuevo / En curso / Completado.
- Inicio — Fecha y hora de inicio en formato
AAAA-MM-DD HH:MM. - Última actualización — Fecha y hora de la última modificación.
- Score — Puntuación total (si el cuestionario tiene sistema de puntos). Si supera el umbral: verde en negrita. Si no supera: rojo en negrita.
Filtros de la pestaña Respuestas:
- Buscar empleado, código... — Campo de texto libre.
- Estado — Selector: Todos, Nuevo, En curso, Completado.
Al hacer clic en una fila se abre el modal de detalle de respuesta con todas las preguntas y sus respuestas:
- Para opción simple/múltiple: badge azul con la opción seleccionada.
- Para matriz: formato Fila → Columna.
- Para numérico/escala: valor monoespaciado.
- Para fecha: fecha formateada.
- Para texto largo: texto con saltos de línea respetados.
- Si la pregunta fue omitida: texto en cursiva "Omitida".
- Para fotos e imágenes (evidencias): al hacer clic se abren en el visor del portal a pantalla completa, con las demás evidencias de esa misma respuesta para pasar de una a otra y la opción de descargar.
Pestaña Asignados¶
Lista de empleados asignados, con buscar y paginar. La columna Plazo muestra solo la fecha (o «Sin plazo») y se edita con un clic; cada fila tiene Quitar asignación y, si ya respondió, Reiniciar respuesta. El botón Reiniciar todas borra todas las respuestas para que los empleados respondan de nuevo.
Panel de asignación lateral (slide-over):
El botón Asignar empleados abre el panel «Asignar cuestionario». En Asignar a se elige el modo: - Empleados — Busca y selecciona empleados uno por uno. - Clientes — Asigna a todos los empleados de todos los proyectos de los clientes seleccionados. - Proyectos — Asigna a todos los empleados de los proyectos seleccionados. - Zonas — Asigna a todos los empleados de las zonas seleccionadas. - Todos — Todos los empleados activos.
Campos comunes: - Plazo de entrega — Fecha máxima para responder (opcional). No puede superar la fecha "Disponible hasta" del cuestionario. - Vista previa — Muestra cuántos empleados se asignarán con la selección actual. - Botón Asignar — Ejecuta la asignación.
Cuestionarios generales o de un cliente¶
En Cuestionarios, cada cuestionario es General o de un cliente. Se elige en Portal › Cuestionarios → Nuevo o Editar → Cuestionario de:
- Un cliente — Sirve cuando un cliente pide algo específico. Solo ese cliente lo ve en su portal de clientes, con todas sus respuestas, sin importar en qué puesto se diligenciaron.
- General — Es de la empresa. Los clientes solo lo ven si se marca Visible para clientes, y entonces cada cliente ve únicamente las respuestas diligenciadas en sus propios puestos.
En el portal de clientes, el cliente ve la pestaña Respuestas; no ve el Resumen, los Asignados ni las cifras de toda la empresa.
Asignar un cuestionario a clientes¶
En Cuestionarios, un cuestionario se puede asignar a uno o varios clientes: Portal › Cuestionarios → cuestionario → Asignados → Asignar empleados → Clientes. Equivale a elegir a mano todos los proyectos de esos clientes: se asigna a todos los empleados de esos proyectos, y la vista previa anuncia cuántos son.
Si el cuestionario es de un cliente, el panel abre ya en Clientes con ese cliente elegido.
Cambiar o quitar el plazo a varias asignaciones¶
En Cuestionarios, pestaña Asignados, al seleccionar varias filas aparece la barra flotante de abajo con el número de asignaciones seleccionadas y estas acciones:
- Plazo + Aplicar — Pone la misma fecha de plazo a todas las seleccionadas.
- Sin plazo — Deja las asignaciones seleccionadas sin plazo.
- Quitar asignación — Solo con permiso de borrar cuestionarios. Pide un segundo clic en «¿Confirmar?». Las respuestas que ya existan se conservan en el historial.
Al aplicar, cambian solo las filas seleccionadas y la selección se limpia. Si el plazo supera la fecha fin del cuestionario, se ajusta a esa fecha y el portal lo avisa.
El plazo de una asignación es un día completo¶
En Cuestionarios, el plazo de una asignación es un día completo: el empleado puede responder hasta el final de ese día. Por eso la columna Plazo muestra solo la fecha, sin hora (la app tampoco usa la hora).
Antes, un plazo puesto en el portal se veía en la app un día antes, y el editor del portal abría en el día anterior. Ya está corregido: si pones el plazo el día 20, la app dice 20 y el editor abre en el 20.
La app guarda el puesto del turno al responder¶
Cuando un empleado responde un cuestionario en la app, se guarda el puesto de su turno en curso. Así cada cliente ve en su portal solo las respuestas diligenciadas en sus puestos (en los cuestionarios generales visibles para clientes). Si el empleado responde sin turno en curso, no se guarda puesto, a propósito, para no atribuir la respuesta a un cliente equivocado; esa respuesta no le aparece a ningún cliente en un cuestionario general.
Modal de cambio de estado del cuestionario¶
Al hacer clic en el badge de estado en la página de resultados (con permiso):
- Muestra estado actual → estado nuevo.
- Opciones:
Borrador,Abierto,Cerrado. - Campo de notas opcional.
- Botón Confirmar cambio.
Permisos¶
| Acción | Permiso requerido |
|---|---|
| Ver cuestionarios | forms: view |
| Crear cuestionario | forms: create |
| Editar cuestionario | forms: edit |
| Exportar | forms: export |
Páginas relacionadas¶
- Empleados — Los empleados que reciben las asignaciones.
- Proyectos — Asignación masiva por proyecto.
- Zonas — Asignación masiva por zona.
- Clientes — Dueños de los cuestionarios de un cliente y asignación por cliente.
- Portal de clientes — Donde los clientes ven sus cuestionarios.
Preguntas frecuentes¶
¿Puedo crear un cuestionario solo para ciertos empleados? Sí. Usa la pestaña Asignados en los resultados del cuestionario y asigna por empleados, clientes, proyectos o zonas.
¿Qué pasa si edito un cuestionario que ya tiene respuestas? El sistema advierte que los cambios pueden afectar la trazabilidad. Las respuestas ya enviadas no se modifican, pero si eliminas preguntas, sus respuestas quedan sin referencia.
¿Los empleados pueden ver el cuestionario si está en Borrador? No. Solo los cuestionarios en estado Abierto son visibles para los empleados en la app.
¿Qué es la puntuación (Score) en las respuestas? Si el cuestionario tiene preguntas de opción simple/múltiple con respuestas correctas marcadas, el sistema calcula un puntaje total. Se muestra en verde si supera el umbral de aprobación o en rojo si no supera.
¿Puedo ver el progreso en tiempo real? La página de resultados muestra las estadísticas actuales al cargar. No se actualiza automáticamente; recarga la página para ver el progreso más reciente.
¿Cómo hago un cuestionario solo para un cliente? Al crearlo o editarlo, en Cuestionario de elige Un cliente y búscalo. Solo ese cliente lo verá en su portal, con todas sus respuestas. Ver Cuestionarios generales o de un cliente.
¿Mis clientes ven los cuestionarios generales? Solo si marcas Visible para clientes, y cada cliente ve únicamente las respuestas diligenciadas en sus propios puestos.
¿Un cliente puede ver las respuestas de otro cliente? No. En un cuestionario general cada cliente ve solo las respuestas de sus puestos; uno de un cliente solo lo ve ese cliente.
¿Cómo asigno un cuestionario a todos los empleados de un cliente? En Asignados → Asignar empleados, elige el modo Clientes y selecciona el cliente. Ver Asignar un cuestionario a clientes.
¿Cómo cambio el plazo a muchas asignaciones a la vez? En Asignados selecciona las filas: en la barra flotante pon la fecha en Plazo y toca Aplicar, o usa Sin plazo para quitarlo. Ver Cambiar o quitar el plazo a varias asignaciones.
¿Por qué la app mostraba el plazo un día antes? Era un error ya corregido: ahora el plazo es un día completo y se ve igual en el portal y en la app. Ver El plazo de una asignación es un día completo.
¿Por qué una respuesta no le aparece al cliente? En un cuestionario general, la respuesta se atribuye al cliente del puesto del turno en curso. Si el empleado respondió sin turno, no queda puesto y no se le muestra a ningún cliente. Ver La app guarda el puesto del turno al responder.
¿Cómo veo en grande las fotos de una respuesta? En la pestaña Respuestas abre la respuesta y haz clic en la foto: se abre el visor del portal con las demás evidencias de esa respuesta y la opción de descargar.