Reconocedor Facial
Kapital
Sistema de identificación biométrica en tiempo real usando inteligencia artificial. Permite registrar, reconocer y administrar rostros de colaboradores de forma segura y eficiente.
¿Qué quieres hacer?
Salta directamente a la sección que necesitas.
Reconocer un Rostro
Identifica a una persona en tiempo real usando la cámara del dispositivo.
Esta función está disponible en la pantalla principal del sistema (/). Al abrir la aplicación, la pestaña Reconocer está activa por defecto.
Abrir la aplicación
Navega a la dirección del sistema en tu navegador. Verás la interfaz principal con las pestañas Reconocer, Registrar y Base de Imágenes.
Iniciar la Cámara
Haz clic en el botón 🎥 Iniciar Cámara. El navegador solicitará permiso para acceder a la cámara — acepta el permiso. El video en vivo aparecerá en pantalla.
Posicionarse correctamente
Colócate frente a la cámara, mira de frente, asegúrate de tener buena iluminación y que tu rostro no esté cubierto (sin mascarillas, gorras bajas, etc.).
Capturar y Reconocer
Presiona el botón 📷 Reconocer. El sistema capturará un fotograma y lo analizará. En pocos segundos verás el resultado.
Leer el resultado
El resultado aparece en la parte inferior de la tarjeta. Puede mostrar el nombre y porcentaje de confianza si fue reconocido, o un mensaje de advertencia si no se detectó rostro.
Iluminación: Asegúrate de tener luz frontal suficiente. Evita contraluz (ventana detrás de ti). El sistema aplica mejoras automáticas, pero en condiciones extremas puede fallar.
Registrar una Persona
Agrega un nuevo colaborador a la base de rostros local del sistema.
📷 Opción A — Tomar foto con la cámara
- Ve a la pestaña Registrar.
- Escribe el nombre de la persona en el campo de texto.
- La sub-pestaña Tomar foto debería estar activa. Si no, haz clic en ella.
- Presiona 🎬 Activar Cámara.
- Posiciona el rostro y presiona 📸 Capturar.
- Revisa la foto. Si no es buena, presiona 🔄 Repetir. Si es correcta, presiona 💾 Guardar.
📁 Opción B — Subir imagen desde archivo
- Ve a la pestaña Registrar.
- Escribe el nombre de la persona.
- Haz clic en la sub-pestaña Subir archivo.
- Selecciona una imagen
.jpg,.jpego.pngdesde tu dispositivo. - Se mostrará una vista previa de la imagen seleccionada.
- Presiona 💾 Guardar.
Al guardar exitosamente, verás el mensaje "[Nombre] guardado correctamente (N rostros en total)". El sistema actualiza automáticamente la base de reconocimiento.
💡 Recomendaciones para una foto de calidad
- Usa una foto con el rostro bien iluminado y centrado en el encuadre.
- Evita usar fotos con lentes de sol, gorras o mascarillas.
- Usa fotos tomadas en condiciones similares a las del reconocimiento (misma iluminación, mismo ambiente).
- El nombre de la persona será usado como identificador, así que usa nombres únicos (ej. cédula o código de empleado).
- Formatos aceptados:
JPG,JPEG,PNG.
Base de Imágenes
Consulta, visualiza y elimina rostros registrados en el sistema local.
Acceder a la Base
Haz clic en la pestaña 📋 Base de Imágenes en la parte superior de la página principal. La lista se carga automáticamente.
Ver una foto registrada
Cada registro muestra el nombre y el formato del archivo. Haz clic en el botón 🖼 Ver para abrir la foto en un modal emergente.
Eliminar un rostro
Haz clic en el botón 🗑️ Eliminar junto al nombre de la persona. Se pedirá confirmación. Al aceptar, el registro es eliminado permanentemente.
Actualizar la lista
Si acabas de registrar alguien o sospechas que la lista no está actualizada, presiona el botón 🔄 Actualizar lista.
Advertencia: La eliminación de un rostro es permanente e inmediata. El sistema deja de reconocer a esa persona al instante. No existe forma de recuperar un registro eliminado.
Módulo de Reconocimiento por Empresa
Cada empresa tiene su propia URL de acceso al reconocedor, con sus colaboradores sincronizados automáticamente.
¿Cómo funciona?
El sistema permite crear módulos independientes para diferentes empresas. Cada módulo tiene una URL única con el formato:
http://[servidor]/[slug-de-empresa]
Ejemplo: /fernandoi, /kapital, /corporativo.
Acceder al módulo de tu empresa
Tu administrador te proporcionará la URL específica para tu empresa. Ábrela en el navegador del dispositivo donde se realiza el reconocimiento.
Permitir acceso a la cámara
El navegador pedirá permiso para usar la cámara. Acepta para que el video en vivo aparezca en pantalla.
Reconocimiento automático con timbrada
Al presionar Reconocer, el sistema:
- Sincroniza los colaboradores desde la API de tu empresa.
- Analiza el rostro capturado.
- Si encuentra coincidencia, registra automáticamente la timbrada (entrada/salida) con fecha y hora exactas.
Interpretar el resultado
El mensaje mostrará el colaborador reconocido con su porcentaje de confianza y el estado del registro de timbrada.
Timbrada automática: El sistema registra la asistencia en el sistema de tu empresa automáticamente en el momento del reconocimiento. No es necesario realizar ningún paso adicional.
Iniciar Sesión como Administrador
El panel de administración permite configurar empresas, APIs y credenciales.
Acceso al panel de administración
El panel de administración se accede en la siguiente URL:
/admin/login
Ingresa tu nombre de usuario y contraseña. Si las credenciales son correctas, serás redirigido al Dashboard.
Sesión: La sesión de administrador expira automáticamente tras 30 minutos de inactividad por seguridad. Guarda los cambios antes de alejarte.
Si no recuerdas tus credenciales o necesitas crear un usuario administrador, contacta al responsable técnico del sistema. Las contraseñas se almacenan de forma segura (hash bcrypt) y no pueden ser recuperadas, solo restablecidas.
Panel de Control — Administrador
Vista general del panel de administración y sus funciones principales.
📊 Dashboard de Administración
Al iniciar sesión verás el Dashboard de Administración con:
- Barra lateral izquierda: navegación y enlace de cierre de sesión.
- Tabla principal: listado de todas las configuraciones de empresa (subdominios) creadas.
- Botón "+ Nuevo Subdominio": abre el formulario para agregar una nueva empresa.
| Columna | Descripción |
|---|---|
| Empresa | Nombre de la organización configurada. |
| Subdominio (URL) | El slug único para acceder al reconocedor de esa empresa (ej. /kapital). |
| API Rostros | URL parcial de la API de donde se obtienen las fotos de colaboradores. |
| API Timbradas | URL parcial de la API donde se registran las asistencias. |
| Acciones | Editar configuración, Eliminar, o Ver la página del reconocedor. |
Gestionar Configuraciones de Empresa
Crea, edita o elimina las configuraciones de cada empresa en el sistema.
➕ Crear una nueva configuración
- Haz clic en el botón + Nuevo Subdominio.
- Completa el formulario con los siguientes campos:
| Campo | Descripción | Obligatorio |
|---|---|---|
| Slug (Subdominio) | Identificador único en minúsculas. Define la URL de acceso (ej. fernandoi → /fernandoi). |
✅ Sí |
| Nombre Empresa | Nombre descriptivo que aparece en la aplicación de reconocimiento. | ✅ Sí |
| API URL (Rostros) | Endpoint completo del servicio que retorna la lista de colaboradores con sus fotos en Base64. | ✅ Sí |
| API URL (Timbradas) | Endpoint donde se enviarán los registros de asistencia al reconocer un colaborador. | ⬜ Opcional |
| JWT Token | Token de autenticación requerido para comunicarse con las APIs de la empresa. | ✅ Sí |
Al guardar, el sistema sincroniza automáticamente los rostros de la API configurada. El módulo queda disponible de inmediato en la URL /[slug].
✏️ Editar una configuración
En la fila de la empresa, haz clic en Editar. Se abrirá el mismo formulario con los datos actuales precargados. Modifica los campos necesarios y guarda. Los rostros se vuelven a sincronizar automáticamente.
🗑️ Eliminar una configuración
Haz clic en Eliminar en la fila de la empresa. Confirma la acción. El módulo dejará de estar disponible y la URL /[slug] devolverá error 404.
Mensajes del Sistema
Guía de interpretación de todos los mensajes que puede mostrar la aplicación.
| Mensaje | Significado | Acción recomendada |
|---|---|---|
| ✅ Reconocido: [Nombre] (XX% confianza) | Persona identificada correctamente. | Ninguna. Proceso exitoso. |
| ✅ Colaborador Reconocido: [ID] (XX%) | Colaborador identificado vía módulo empresarial. | Ninguna. Timbrada registrada automáticamente. |
| ⚠️ No se detectó ningún rostro | El algoritmo no encontró un rostro en la imagen. | Mejorar iluminación, acercarse más a la cámara. |
| ❌ Rostro no reconocido | Se detectó un rostro pero no coincide con nadie en la base. | Verificar que la persona esté registrada, mejorar condiciones. |
| ❌ No se recibió imagen | Error al capturar el fotograma de la cámara. | Reiniciar la cámara e intentar nuevamente. |
| ❌ Colaborador no identificado | No hay coincidencia en la base del módulo empresarial. | Verificar que el colaborador esté registrado en el sistema origen. |
| ✅ [Nombre] guardado correctamente | Registro exitoso de un nuevo rostro. | Ninguna. El sistema ya puede reconocer a la persona. |
| ❌ Formato inválido. Usa JPG o PNG | El archivo subido tiene un formato no permitido. | Usar solo archivos .jpg, .jpeg o .png. |
| | ✅ Timbrada registrada | La asistencia fue enviada al sistema empresarial con éxito. | Ninguna. |
| | ⚠️ Error Timbrada: [mensaje] | La API de timbradas respondió con un error. | Contactar al administrador con el mensaje de error. |
| ❌ Usuario o contraseña incorrectos | Las credenciales de administrador no son válidas. | Verificar usuario y contraseña. Contactar soporte si persiste. |
Consejos y Buenas Prácticas
Obtén los mejores resultados siguiendo estas recomendaciones.
🌟 Para mejorar el reconocimiento
- Usa luz frontal difusa (no directa).
- Evita contraluz (no te pongas de espaldas a una ventana).
- Mira directamente a la cámara.
- Mantén el rostro despejado (sin lentes de sol, mascarillas).
- Ubícate a 40–80 cm de la cámara.
📸 Para fotos de registro de calidad
- Registra la foto en el mismo lugar y condiciones del reconocimiento.
- Usa una sola foto por persona (con el mismo identificador).
- Resolución mínima recomendada: 640 × 480 px.
- Evita imágenes borrosas, pixeladas o muy oscuras.
- Un primer plano del rostro funciona mejor.
🔧 Para administradores
- El JWT token debe estar vigente. Si expira, la sincronización fallará.
- Verifica que el slug sea único por empresa.
- Tras editar una configuración, la re-sincronización es automática.
- Revisa la consola del servidor si algún slug falla silenciosamente.
🔒 Seguridad y privacidad
- Cierra sesión de administrador cuando termines.
- No compartas el JWT token en canales no seguros.
- La sesión expira en 30 min por defecto.
- Los rostros eliminados no pueden recuperarse.
Preguntas Frecuentes
Respuestas a los problemas más comunes.
¿Por qué la cámara no inicia?
El navegador puede haber bloqueado el acceso. Verifica que el ícono de cámara en la barra de direcciones no esté tachado. Haz clic en él y selecciona Permitir. También asegúrate de que ninguna otra aplicación esté usando la cámara simultáneamente.
¿Por qué dice "No se detectó ningún rostro"?
Las causas más comunes son: poca iluminación, rostro muy pequeño en el encuadre, cara de perfil en lugar de frente, o elementos cubriendo el rostro. Acércate más, mejora la luz y mira directamente a la cámara.
¿Por qué el registrado no es reconocido luego?
Si la foto de registro fue tomada en condiciones muy diferentes a las del reconocimiento (diferente luz, ángulo, etc.), el sistema puede tener dificultades. Re-registra la persona con una foto que refleje las condiciones habituales de uso.
¿Cuántas personas puede reconocer el sistema?
No hay un límite fijo en la cantidad de personas registradas. Sin embargo, a mayor base de datos, el tiempo de procesamiento puede aumentar levemente. Para instalaciones con más de 500 personas, se recomienda revisar la capacidad del servidor.
¿Qué pasa si registro a la misma persona dos veces?
Si usas el mismo nombre, el sistema sobreescribe el archivo anterior. Si usas nombres diferentes, existirán dos registros independientes y el sistema podría reconocer a la persona con cualquiera de los dos nombres.
¿La timbrada se registró, pero dice "Error Timbrada"?
El reconocimiento fue exitoso, pero el envío a la API de asistencias falló. Esto puede deberse a que la API de timbradas está caída, el JWT expiró, o hubo un error en el servidor externo. Contacta al administrador con el mensaje de error completo.
¿Cómo sé si el sistema está funcionando correctamente?
Al ingresar a la aplicación, si la cámara inicia sin errores y el botón de reconocer responde, el sistema está operativo. Los administradores pueden verificar el estado de los módulos empresariales en el Dashboard de Administración revisando que los rostros estén cargados en memoria.
¿El sistema funciona en celulares?
Sí. La interfaz es responsive y funciona en navegadores móviles modernos (Chrome, Safari). En iOS, asegúrate de dar permiso a la cámara en configuración del navegador. En algunos dispositivos Android muy antiguos puede haber limitaciones de compatibilidad.
Manual de Usuario v1.0 · Abril 2026
Para soporte técnico, contacta al equipo de tecnología de Kapital.