dmencu 3.3.1 → 3.5.0

package/ayuda/asignacion.md

@@ -0,0 +1,16 @@
+---
+id: asignacion
+titulo: Asignación
+orden: 20
+modo: GABINETE
+permisos: [campo.editar]
+menu: [asignacion, asignacion/general, asignacion/encuestador, asignacion/ingresador, asignacion/recuperador, asignacion/supervisor]
+---
+En **asignación** se decide quién hace cada tarea.
+
+- **general**: una grilla por área con el recepcionista y la persona asignada en cada tarea.
+- **encuestador**, **ingresador**, **recuperador**, **supervisor**: una grilla por tarea. Se elige la persona en la columna del asignado. Desplegando una fila se ven las encuestas del área.
+
+Para que una encuesta llegue al dispositivo de la persona hay que asignarla y después **cargarla** (queda *a cargar*). La persona la recibe la próxima vez que sincroniza.
+
+Si sos **recepcionista**, sólo ves las áreas que tenés a cargo.

package/ayuda/circuito-encuesta.md

@@ -0,0 +1,27 @@
+---
+id: circuito-encuesta
+titulo: El recorrido de una encuesta
+orden: 10
+modo: GABINETE
+permisos: [campo.ver, campo.editar, encuestas.procesar]
+---
+Cada encuesta pasa por una serie de **tareas** (etapas). Las más comunes son:
+
+| Tarea | Quién la hace |
+| :-- | :-- |
+| encuesta (`encu`) | el encuestador, en el dispositivo móvil |
+| recuperación (`recu`) | el recuperador, cuando hay que volver a visitar el hogar |
+| supervisión (`supe`) | el supervisor, que vuelve a contactar una parte de los hogares |
+| ingreso (`ingr`) | el ingresador, que carga en gabinete una encuesta hecha en papel |
+| fin de campo y análisis de campo | la coordinación, antes de pasar a procesamiento |
+
+En cada tarea la encuesta tiene un **estado**. El circuito habitual es:
+
+1. **Disponible**: todavía no tiene a nadie asignado.
+2. **Asignado**: se le asignó una persona (ver [Asignación](ayuda:asignacion)).
+3. **A cargar** → **Cargado**: se marca para cargar y, cuando la persona sincroniza su dispositivo, la encuesta queda en el dispositivo.
+4. **A descargar** → **Descargado**: se marca para descargar y vuelve en la próxima sincronización.
+5. **Pendiente** → **Verificado**: en recepción se revisa la encuesta y, si no tiene inconsistencias sin justificar, se verifica (ver [Recepción](ayuda:recepcion)).
+6. Una vez verificada pasa a la tarea siguiente.
+
+Los estados y los pasos exactos pueden variar según el operativo.

package/ayuda/control.md

@@ -0,0 +1,13 @@
+---
+id: control
+titulo: Control
+orden: 70
+modo: GABINETE
+permisos: [campo.administrar, encuestas.procesar]
+menu: [control, control/encuestas_procesamiento_pasar, control/resumen, control/dominio, control/zona, control/comuna, control/área]
+---
+En **control** hay tableros con el avance del campo:
+
+- **resumen**: cantidad de encuestas por estado.
+- **dominio**, **zona**, **comuna**, **área**: el mismo avance abierto por cada agrupación.
+- **pasar encuestas a procesamiento**: lleva a procesamiento las encuestas que ya terminaron el campo.

package/ayuda/dm-cambiar-modo.md

@@ -0,0 +1,16 @@
+---
+id: dm-cambiar-modo
+titulo: Modo capacitación y producción
+orden: 30
+modo: RELEVAMIENTO
+permisos: [encuestas.relevar]
+menu: [cambiar_modo]
+---
+El dispositivo trabaja en uno de dos modos:
+
+- **producción**: las encuestas reales.
+- **capacitación**: encuestas de práctica que no se mezclan con las reales. La barra de arriba se ve de otro color y dice *MODO CAPACITACIÓN*.
+
+Para cambiar de modo, abrí el menú de configuración (el engranaje ⚙) y elegí **Cambio a modo...**. El cambio sincroniza el dispositivo (entrega lo cargado) y necesita conexión. Pide una contraseña, que te da tu coordinación.
+
+No todos los operativos permiten el modo capacitación.

package/ayuda/dm-relevamiento.md

@@ -0,0 +1,20 @@
+---
+id: dm-relevamiento
+titulo: Hoja de ruta
+orden: 10
+modo: RELEVAMIENTO
+permisos: [encuestas.relevar]
+menu: [relevamiento]
+---
+En **Hoja de Ruta** están las encuestas que tenés asignadas, agrupadas por área, con la dirección de cada una.
+
+- Tocá una encuesta para abrir el formulario y cargar las respuestas.
+- Lo que cargás queda guardado en el dispositivo y **no necesitás conexión** para trabajar.
+- Mientras trabajás, el dispositivo envía copias de respaldo cuando tiene conexión.
+- El color de cada encuesta indica su estado (incompleta, completa, con errores...).
+
+Arriba de la hoja de ruta se ve la versión de la aplicación y el número de la última sincronización.
+
+Para recibir encuestas nuevas y entregar las terminadas tenés que [sincronizar](ayuda:dm-sincronizar).
+
+Esta ayuda se descarga cada vez que sincronizás, así que también está disponible sin conexión.

package/ayuda/dm-sincronizar.md

@@ -0,0 +1,18 @@
+---
+id: dm-sincronizar
+titulo: Sincronizar
+orden: 20
+modo: RELEVAMIENTO
+permisos: [encuestas.relevar]
+menu: [sincronizar]
+---
+En **Sincronización**, el botón **Sincronizar** hace dos cosas de una sola vez, por eso necesita conexión:
+
+1. **Entrega** al sistema todo lo que cargaste en el dispositivo.
+2. **Recibe** tu nueva hoja de ruta: las encuestas que te cargaron desde gabinete.
+
+La pantalla muestra cuántas áreas y encuestas tiene el dispositivo. Al terminar aparece *Sincronización exitosa* con el número de sincronización.
+
+- Si una encuesta ya no está en tu hoja de ruta después de sincronizar es porque gabinete pidió descargarla o la asignó a otra persona.
+- Si el dispositivo no tiene hoja de ruta, o si entra otro usuario, la aplicación pide sincronizar antes de seguir.
+- **No cierres sesión sin sincronizar**: podrías perder lo que cargaste.

package/ayuda/fin-de-campo.md

@@ -0,0 +1,14 @@
+---
+id: fin-de-campo
+titulo: Fin de campo y análisis de campo
+orden: 50
+modo: GABINETE
+permisos: [campo.administrar]
+menu: [tareas_tem_fin_campo, tareas_tem_analisis_campo]
+---
+Cuando una encuesta termina el trabajo de campo pasa por dos grillas de la coordinación:
+
+- **espera fin de campo**: encuestas que esperan el cierre del campo antes de seguir.
+- **análisis de campo**: encuestas que la coordinación revisa antes de pasarlas a procesamiento.
+
+Las acciones de cada grilla mueven la encuesta al estado siguiente, como en [Recepción](ayuda:recepcion).

package/ayuda/metadatos.md

@@ -0,0 +1,14 @@
+---
+id: metadatos
+titulo: Textos del formulario (metadatos)
+orden: 90
+modo: GABINETE
+permisos: [casilleros_texto.editar]
+menu: [configurar/metadatos]
+---
+En **configurar → metadatos** se define el formulario: operativos, formularios, preguntas, opciones y variables (**plano** muestra todos los casilleros juntos).
+
+- **rea/norea**: las reglas que deciden si una encuesta es realizada o no realizada, y el motivo.
+- En los textos se pueden usar **comodines** entre arrobas, por ejemplo `@nombre@`, que en el formulario se reemplazan por la respuesta de esa variable.
+
+Los cambios llegan a los dispositivos en la próxima sincronización.

package/ayuda/muestra.md

@@ -0,0 +1,14 @@
+---
+id: muestra
+titulo: Muestra (TEM)
+orden: 85
+modo: GABINETE
+permisos: [campo.administrar, encuestas.procesar]
+menu: [configurar/muestra, configurar/muestra/tem, configurar/muestra/tem_edicion]
+---
+En **configurar → muestra** están las encuestas del operativo.
+
+- **TEM**: la lista completa de encuestas, con su estado, resultado, asignaciones y domicilio. Es de consulta: lo único que se puede cambiar ahí es si la encuesta está **habilitada**.
+- **edición TEM**: los datos de la encuesta que se corrigen a mano: cita, resultado de supervisión, fin de campo, proie, manzana y casa. Muestra también área, zona, dominio y la ubicación (comuna, fracción, radio) como referencia.
+
+La **manzana** y la **casa** sólo se pueden modificar en las encuestas de **dominio 5**, y las cambia el subcoordinador o un rol superior. En otro dominio, el sistema rechaza el cambio al grabar.

package/ayuda/procesar.md

@@ -0,0 +1,13 @@
+---
+id: procesar
+titulo: Procesamiento
+orden: 80
+modo: GABINETE
+permisos: [encuestas.procesar]
+menu: [procesar]
+---
+En **procesar** se trabajan las encuestas que ya terminaron el campo:
+
+- **encuestas**: las encuestas en procesamiento.
+- **consistencias** e **inconsistencias**: las reglas de control y las encuestas que no las cumplen. Las inconsistencias se corrigen o se justifican.
+- **variables**, **diccionarios**, **tabla datos**: para definir y revisar las variables de salida.

package/ayuda/recepcion.md

@@ -0,0 +1,20 @@
+---
+id: recepcion
+titulo: Recepción
+orden: 30
+modo: GABINETE
+permisos: [campo.editar]
+menu: [recepcion, recepcion/encuestador, recepcion/recuperador, recepcion/ingresador, recepcion/supervisor, recepcion/mis_supervisores]
+---
+En **recepción** se sigue el trabajo de cada persona y se reciben sus encuestas. Hay una grilla por tarea, con las personas asignadas. Desplegando una persona se ven sus encuestas y el estado de cada una.
+
+Las acciones que se pueden hacer sobre una encuesta dependen de su estado. Las más comunes son:
+
+| Acción | Para qué |
+| :-- | :-- |
+| cargar / no cargar | marcar la encuesta para que baje (o no) al dispositivo en la próxima sincronización |
+| descargar / no descargar | pedir que el dispositivo devuelva la encuesta en la próxima sincronización |
+| analizar | revisar las consistencias de una encuesta que ya volvió |
+| verificar / no verificar | dar por buena la encuesta; no se puede si quedan inconsistencias sin justificar |
+
+Después de verificar, la encuesta pasa a la tarea siguiente. Ver [El recorrido de una encuesta](ayuda:circuito-encuesta).

package/ayuda/supervision.md

@@ -0,0 +1,9 @@
+---
+id: supervision
+titulo: Supervisión
+orden: 40
+modo: GABINETE
+permisos: [campo.editar]
+menu: [supervision, supervision/supervisar]
+---
+En **supervisión → supervisar** aparecen las encuestas de supervisión que tenés asignadas a vos. Desde ahí se abren para cargar lo que surge del contacto de supervisión.

package/ayuda/usuarios.md

@@ -0,0 +1,12 @@
+---
+id: usuarios
+titulo: Usuarios y roles
+orden: 100
+modo: GABINETE
+permisos: [campo.administrar, encuestas.procesar]
+menu: [configurar/usuarios]
+---
+En **configurar → usuarios** se dan de alta las personas que usan el sistema. Cada usuario tiene un **rol**, que define qué menús ve y qué puede hacer.
+
+- **usuarios**: alta, baja y rol de cada usuario. También se puede blanquear la contraseña de los usuarios con roles que dependen del tuyo.
+- **roles** y **roles permisos**: qué puede hacer cada rol. Un cambio de permisos rige después de reiniciar el sistema.

package/ayuda/varios.md

@@ -0,0 +1,23 @@
+---
+id: varios
+titulo: Varios
+orden: 60
+modo: GABINETE
+permisos: [campo.editar, campo.administrar, encuestas.procesar]
+menu: [varios, varios/abrir_encuesta, varios/hoja_ruta, varios/encuestador_dms_mostrar, varios/encuesta_blanquear_previsualizar, varios/encuesta_borrar_previsualizar, varios/encuestas_capacitacion_borrar, varios/operativo_migrar, varios/encuesta_capa_a_prod_pasar, varios/intercambiar_encuestas]
+---
+Herramientas para casos puntuales. Según tu perfil vas a ver algunas de estas:
+
+| Opción | Para qué |
+| :-- | :-- |
+| abrir encuesta | abrir el formulario de una encuesta por su número |
+| hoja de ruta | ver las encuestas con su dirección, estado y persona asignada |
+| forzar descarga encuestas DM | ver qué encuestas tiene un dispositivo para pedir que las devuelva |
+| blanquear encuesta | borrar las respuestas de una encuesta (antes muestra qué se va a borrar) |
+| quitar encuesta de la muestra | sacar una encuesta de la muestra |
+| quitar encuestas de capa de la muestra | borrar las encuestas creadas en modo capacitación |
+| pasar encuestas de capa a prod | pasar a producción encuestas cargadas en modo capacitación |
+| migrar operativo | copiar datos de un operativo a otro |
+| intercambiar encuestas | intercambiar los datos de dos encuestas cargadas al revés |
+
+Varias de estas operaciones **no se pueden deshacer**. Revisá bien la vista previa antes de confirmar.