Control de Visitas

Control de Visitas CL-007Permisos 671/672/673

Registro de visitas a clientes con motivo, detalle de los trabajos realizados, fotos de respaldo, ubicación GPS y estado de la atención. Diseñado mobile-first para que los técnicos y agentes de campo lo usen desde el celular durante la visita y luego se consulte desde escritorio.

Para qué sirve

• Llevar bitácora de visitas de soporte técnico, mantenimiento, capacitación o entregas
• Registrar trabajos realizados con evidencia fotográfica
• Geolocalizar la visita (GPS desde el móvil) para validar asistencia y mantener historial de ubicaciones
• Dar seguimiento a casos abiertos (Pendiente / En proceso / Resuelto / Cancelado)
• Auditar visitas por cliente, por fecha, por motivo o por usuario

Lista de visitas

Listado paginado con filtros combinables:

• Código de cliente exacto
• Nombre de cliente contiene (LIKE)
• Motivo contiene (texto libre, sin catálogo)
• Estado — Todos / Pendiente / En proceso / Resuelto / Cancelado
• Rango de fechas Desde / Hasta
• Usuario que registró la visita

Crear / Editar visita

Bloque Cliente

• Buscador inline (debounce 300-350 ms) por código, nombre o cédula
• Al seleccionar, se muestra nombre, código, teléfono y dirección

Bloque Detalles

• Fecha y hora * — datetime-local; por defecto la fecha actual
• Motivo * — texto libre, máximo 150 caracteres. Ej: "Soporte impresora caja 2"
• Estado — cuatro botones: Pendiente, En proceso, Resuelto, Cancelado
• Trabajos realizados / observaciones — textarea sin límite

Bloque GPS

Solo funciona en dispositivos con servicio de ubicación activo:

• Botón "Capturar" toma la ubicación del GPS del teléfono (alta precisión; espera hasta unos 20 segundos)
• Si el navegador pide permiso, el usuario debe aceptarlo
• Las coordenadas se guardan con 7 decimales y se muestra link directo a Google Maps
• Desde escritorio normalmente no devuelve coordenadas: el botón existe pero la captura es de campo

Bloque Fotos

Imágenes de respaldo del trabajo realizado:

• Dos botones — Cámara (en el celular abre la cámara directo) y Galería (se pueden escoger varias)
• En el celular, las fotos grandes se achican antes de subir para que suban rápido con datos
• Formatos aceptados: JPG, PNG, WebP. Tamaño máximo: 12 MB por imagen
• El servidor valida el MIME real con finfo (no confía en el header del cliente)
• Click en una foto abre la versión original en pestaña nueva
• Botón × en la esquina elimina la foto (pide confirmación)

Estados de la visita

En el celular

En el celular (o cualquier pantalla de hasta 900 px de ancho) el módulo se abre en unas pantallas hechas para el teléfono. Si la ventana se agranda, pasa sola a la versión de computadora, y al revés.

Lista de visitas

• Cada visita sale en una tarjeta con el estado, la fecha y hora, el cliente, el motivo, cuántas fotos tiene, si tiene GPS y el usuario. Tocando la tarjeta se abre la visita.
• Los filtros están a la vista: el período (Desde – Hasta) y el buscador de cliente. El período arranca vacío, o sea, con todas las fechas; si pone fechas, sale una pastilla y con su ✕ vuelve a todas las fechas. En Más filtros están el estado, el código del cliente, el motivo y el usuario. Debajo se ve cuántas visitas hay. Ver Los filtros en el celular.
• El botón redondo + de abajo a la derecha crea una visita nueva (sin el permiso 672 se ve gris).
• Abajo quedan fijos Anterior y Siguiente para pasar de página.
• Imprimir es un botón del encabezado.
• El botón con la flecha de la derecha es Regresar.

Nueva visita / editar

• Los campos van uno debajo del otro: cliente, fecha y hora (con el calendario y el reloj del teléfono), estado, motivo y trabajos realizados.
• Capturar mi ubicación toma el GPS del teléfono y muestra la precisión en metros (por ejemplo «± 12 m») y un enlace Abrir en Mapas. La primera vez el teléfono pregunta si deja usar la ubicación: hay que decir que sí. Si dice «Permiso de ubicación denegado», se habilita en los permisos del sitio en el navegador.
• Las fotos se toman con Cámara o se escogen con Galería (primero hay que guardar la visita).
• Guardar y Cancelar quedan fijos abajo. Eliminar visita es un botón del encabezado (sale gris si no tiene el permiso 673).
• Regresar o Cancelar vuelven a la lista.

Visibilidad

Cualquier usuario con el permiso 671 (Visitas Ver) puede consultar todas las visitas de la empresa, sin importar quién las haya creado. El registro guarda el código del usuario que creó cada visita y, si fue editada, quién la modificó por última vez.

Eliminar visita

Con el permiso 673 (Visitas Eliminar) aparece el botón rojo en el editor. Al eliminar:

• Se borra el registro de la visita
• Se eliminan en cascada todos los registros de imágenes asociados
• Se borran también los archivos de las fotos
• La operación pide confirmación y no se puede deshacer

Tablas y archivos

• Tabla ClientesVisitas — datos de la visita
• Tabla ClientesVisitasImagenes — relación 1:N con FK ON DELETE CASCADE
• Almacenamiento físico de fotos: /img/<empresa_db>/clientes/visitas/<visita_id>/