Manual de Usuario

1. Introducción

La App Programa Sucre Escucha es una herramienta comunitaria para el seguimiento de casos, registro de actividades, bitácoras diarias y aplicación de tamizajes psicosociales en el departamento de Sucre. Funciona como aplicación web progresiva (PWA) y puede instalarse en el celular para un acceso rápido, similar a una app nativa.

La aplicación permite a los equipos de campo (EMTAP) y a la Línea Amiga telefónica:

• Registrar y dar seguimiento a casos comunitarios o llamadas.
• Documentar la jornada diaria mediante bitácoras.
• Planificar y reportar actividades comunitarias con generación de actas en PDF.
• Aplicar instrumentos de tamizaje (RQC, CRAFFT, ASSIST, SRQ).
• Consultar reportes, mapas y exportaciones (según el rol del usuario).

2. Requisitos y acceso

3. Instalación en el celular

Android (Chrome)

1. Abra la app en Chrome con la URL indicada arriba.
2. Toque el menú del navegador (tres puntos ⋮).
3. Seleccione «Agregar a pantalla de inicio» o «Instalar aplicación».
4. Confirme el nombre #KsosMovil y acepte.
5. El icono quedará en el escritorio del celular.

iPhone (Safari)

1. Abra la app en Safari.
2. Toque el botón Compartir (cuadrado con flecha hacia arriba).
3. Seleccione «Agregar a inicio».
4. Confirme y pulse Agregar.

4. Inicio de sesión

Al abrir la app verá la pantalla de inicio con el logo de Sucre Escucha y las opciones de acceso.

Opción A — Entrar con Gmail (recomendada)

1. Pulse el botón verde «Entrar con mi Gmail».
2. Seleccione su cuenta de Google en la ventana emergente.
3. Si su correo está registrado en el sistema, ingresará automáticamente.
4. No necesita clave adicional.

Opción B — Correo que no es Gmail

1. Escriba su correo electrónico en el campo correspondiente.
2. La primera vez, pulse «Olvidé clave» para recibir un enlace de restablecimiento en su correo.
3. Asigne una clave segura (no use su número de cédula).
4. Escriba correo y clave, luego pulse «Entrar».

Primera vez — Asignación de municipio

Si es gestor nuevo, puede aparecer un aviso preguntando en qué municipio está asignado(a). Seleccione su municipio y pulse «Reportar». Solo se le preguntará una vez.

5. Barra de navegación

Tras iniciar sesión, aparece una barra superior con siete iconos. Cada uno abre un módulo de la app:

Casos abiertos

Seguimiento

Casos cerrados

Actividades

Bitácoras

Tamizajes

Servicios en línea

6. Roles de usuario

7. Casos y llamadas

7.1 Ver casos abiertos

1. Toque el icono Casos abiertos (documento verde con check).
2. Verá la lista de casos asignados a usted, con colores según la antigüedad de la última actualización.
3. Use los filtros Municipio/Comunidad y Tipo de Caso para acotar la lista.
4. Toque un caso de la lista para abrir su ficha de edición.

7.2 Colores del semáforo de casos

Verde actualizado hace 10 días o menos   Amarillo entre 11 y 20 días   Rojo más de 20 días sin actualizar

El icono de semáforo en el encabezado muestra un resumen por gestor (supervisión).

7.3 Crear un caso nuevo

1. En Casos abiertos, pulse «Agregar Caso» (o «Agregar Llamada» en Línea Amiga).
2. Permita el acceso al GPS si el navegador lo solicita.
3. Complete los campos obligatorios (*): fecha, municipio, nombre, edad, EPS, tipo de caso, descripción de la situación.
4. Opcionalmente use «Iniciar Dictado» en campos de texto largos.
5. Adjunte fotos o documentos en Anexos (requiere Internet).
6. Pulse «Agregar» para guardar.

7.4 Editar y cerrar un caso

1. Abra el caso desde la lista.
2. Modifique los campos necesarios.
3. Pulse «Actualizar campos».
4. Para cerrar: «Cerrar Caso» → confirme. El caso pasa a Casos cerrados.
5. Desde Casos cerrados puede consultar y, si es necesario, «Reabrir caso».

7.5 Línea Amiga — particularidades

• Los casos se llaman «Llamadas».
• Campos adicionales: hora inicio/fin, duración, canal, reincidencia, quién llama, efectividad.
• Botones flotantes para registrar inicio y fin de la llamada.
• Al guardar una llamada nueva, puede cerrarla de inmediato si ya fue atendida.

8. Seguimientos

Los seguimientos documentan el avance periódico de un caso o llamada.

Desde el menú Seguimiento

1. Toque el icono de Seguimiento (lupa sobre documento).
2. Seleccione el caso en la lista desplegable.
3. Indique la fecha del seguimiento.
4. Escriba la actualización o avances (campo obligatorio).
5. Complete acciones propuestas y tareas pendientes si aplica.
6. Adjunte anexos y pulse «Grabar».

Desde la ficha de un caso

1. Abra el caso en Casos abiertos.
2. Pulse «Agregar seguimiento» (se abre una ventana emergente).
3. Complete los campos y pulse «Grabar seguimiento».
4. Para ver el historial: «Seguimientos» / «Ocultar» en la misma ficha.

9. Bitácoras

La bitácora registra las actividades realizadas en la jornada diaria del gestor. Solo disponible para perfiles EMTAP.

Registrar la bitácora del día

1. Toque el icono Bitácoras.
2. Pulse «Agregar bitácora».
3. Indique fecha, hora de inicio y municipio.
4. Describa la(s) actividad(es) realizadas.
5. Seleccione el tipo de actividad principal (obligatorio).
6. Adjunte al menos un anexo en la actividad 1 (foto o evidencia).
7. Si hubo más de una jornada en el día, use «Agregar actividad» (hasta 4).
8. Pulse «Grabar bitácora».

Tipos de actividad en bitácora

Gestión de caso, Conversatorio, Taller, Asesoría personalizada, Animación comunitaria, Sancocho comunitario, Acompañar ensayos, Asistencia reunión externa, Capacitación personal del proyecto, Actividad unidad móvil, Participación actividad externa, Otro.

10. Actividades comunitarias

Crear una actividad

1. Toque el icono Actividades.
2. Pulse «Agregar actividad».
3. En la ventana de alta/edición complete: línea estratégica, objetivo, tipos de actividad, lugar, fecha, hora, municipio, participantes.
4. Indique si es presencial o virtual y el estado de la actividad.
5. Pulse «Guardar».

Después de realizar la actividad

1. En la lista, pulse «Editar» sobre la actividad.
2. Complete desarrollo de la agenda, asistencia, compromisos y anexos (fotos, listados, documentos).
3. Actualice el estado y guarde.
4. Pulse «Generar Acta» y luego «Imprimir Acta» para obtener el PDF.

Líneas estratégicas

Articulación con Actores, Fortalecimiento de Redes, Articulación con RBC, IEC, SiDiEs, Otras.

11. Tamizajes

Aplicar un tamizaje

1. Toque el icono Tamizajes y permita el acceso al GPS.
2. Complete municipio, coordenadas, lugar (institución educativa) y edad de la persona.
3. Pulse «Iniciar Tamizaje».
4. Según la edad, el sistema ofrece el instrumento correspondiente:

5. Responda todas las preguntas del instrumento.
6. Pulse «Procesar [instrumento]».
7. El resultado queda guardado automáticamente. Use «Volver a TAMIZAJES» para un nuevo registro.

12. Servicios en línea

Este módulo concentra herramientas de sesión, descargas y reportes. Algunas opciones solo son visibles para administradores.

Para todos los usuarios

• Cambiar mi clave — solo correos no Gmail.
• Cerrar sesión — finaliza la sesión y vuelve a la pantalla de login.

Para Super Admin y coordinación

• Descargar casos / actividades / bitácoras / tamizajes — exportación a Excel.
• Exportar tamizajes a PDF — generación masiva por municipio y fechas.
• Mapa App — visualización geográfica de casos, tamizajes y actividades.
• Reporte Consolidado — gráficos e informe en PDF.
• Check GPS actividades — revisión de coordenadas registradas.

13. Semáforos de supervisión

Semáforo de casos

En el encabezado de Casos abiertos, el icono de semáforo muestra cuántos casos están en rojo, amarillo y verde, desglosados por gestor. Sirve a coordinadores y administradores para identificar casos que requieren atención urgente.

Semáforo de bitácoras

En el módulo de Bitácoras, el semáforo mensual (visible para administradores) indica el cumplimiento de las bitácoras diarias por cada gestor del equipo.

14. Conexión a Internet

• Se requiere Internet para iniciar sesión, guardar registros y subir anexos.
• Sin conexión, la app puede mostrar una página de mantenimiento o limitar funciones.
• El módulo Servicios en línea se oculta automáticamente cuando no hay red.
• Los campos de carga de archivos (anexos) también se desactivan sin Internet.

15. Preguntas frecuentes

¿No puedo entrar con mi Gmail?

Verifique que su correo esté registrado en el personal de Sucre Escucha. Contacte a Recursos Humanos si el problema persiste.

¿Olvidé mi clave (correo no Gmail)?

Use el botón «Olvidé clave» en la pantalla de login. Revise también la carpeta de spam.

¿Puedo usar la app sin instalarla?

Sí, puede usarla directamente en el navegador. La instalación en pantalla de inicio solo facilita el acceso.

¿Por qué mi caso aparece en rojo?

Porque lleva más de 20 días sin una actualización o seguimiento registrado. Agregue un seguimiento para mantenerlo al día.

¿Cómo uso el dictado por voz?

En campos con el botón «Iniciar Dictado», pulse el botón y hable claramente. Funciona en navegadores compatibles (Chrome recomendado).

¿No puedo subir fotos?

Verifique su conexión a Internet y que haya iniciado sesión. Los anexos requieren red activa.

16. Glosario