> For the complete documentation index, see [llms.txt](https://docs.griaule.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.griaule.com/gbs/es/aplicaciones/gbs-identity.md).

# GBS Identity

![GBS Identity](https://content.gitbook.com/content/7Bx0xNdsdGHpCZ20yxbn/blobs/hNV9Ily3QXVgm9JhZrZb/images/capa-gbs-identity.png)

## 1. Visión general

GBS Identity es una aplicación web destinada a la creación y consulta de **registros biométricos** de individuos. Cada registro (llamado internamente de *encounter*) reúne:

* **Datos biográficos** — claves, nombre, filiación, fecha de nacimiento (según la configuración del entorno).
* **Biometrías** — imagen facial, huellas dactilares y firma.

Tras el envío, el sistema registra al individuo en el ABIS y dispara una **búsqueda biométrica 1:N** que devuelve perfiles coincidentes. El operador puede entonces visualizar la información de los perfiles encontrados en la base, validando la identidad.

Principales capacidades para el operador:

* Crear y enviar registros, incluso sin conexión (modo sin conexión).
* Buscar historial de registros.
* Visualizar resultados de búsqueda biométrica.
* Monitorear el estado de los dispositivos biométricos y de los servicios dependientes.
* Visualizar métricas agregadas de capturas, envíos y coincidencias.

## 2. Requisitos previos

### 2.1 Navegador e instalación

* Navegador recomendado: Google Chrome o Microsoft Edge actualizados.
* GBS Identity es una **PWA** (Progressive Web App). Puede utilizarse *sin conexión* y puede instalarse en el ordenador.
  * Después del primer acceso con internet, los recursos de la aplicación quedan en *caché* local, permitiendo el uso sin conexión.
  * Para instalarlo como aplicación del sistema operativo, haga clic en el icono de instalación en la barra de direcciones del navegador. GBS Identity pasará a abrirse como una ventana dedicada, sin necesidad del navegador, y quedará disponible en el *menú de Windows*.

{% hint style="info" %}
**Importante:** el primer acceso debe hacerse siempre con internet, para que el navegador instale el *Service Worker* y descargue los componentes necesarios para el uso sin conexión.
{% endhint %}

### 2.2 Extensión y dispositivos biométricos

La captura biométrica ocurre a través de la **Live Capture Extension**, que se comunica con los dispositivos USB del ordenador (cámara facial, lector biométrico de huellas y pad de firma). Antes de iniciar un registro, asegúrese de que:

* La **Live Capture Extension** está instalada en el navegador.
* El **Live Capture Connector** está instalado en el sistema operativo (*drivers* y *plugins* de los dispositivos).
* Los dispositivos físicos están conectados por USB y encendidos.

El estado de cada componente puede verificarse en cualquier momento en la página **Diagnóstico del sistema** y en el indicador en la esquina superior derecha (ver Sección 5).

### 2.3 Conexión y servidor

* Para el envío inmediato de registros, se requiere conexión a internet y disponibilidad del servidor de identificación (ABIS).
* Cuando está sin conexión, el registro se guarda localmente y se envía automáticamente en cuanto la conexión y el servidor vuelvan a estar disponibles.

## 3. Acceso e inicio de sesión

GBS Identity utiliza la nueva autenticación integrada de la suite GBS a través de *GBS Auth*. En esta modalidad, la *autenticación* está intermediada con el proveedor de identidad *(IdP - Identity Provider)* de la organización del cliente. Al acceder a la aplicación, se le redirige a la pantalla de inicio de sesión del proveedor de identidad. Tras autenticarse con sus credenciales, el navegador vuelve a GBS Identity ya con su sesión abierta.

El nombre del usuario aparece en la esquina superior derecha del encabezado. Las funcionalidades disponibles dependen de los **permisos** asignados a su perfil.

Para cerrar la sesión, haga clic en el avatar (esquina superior derecha) y seleccione **Salir**. Se le redirigirá de vuelta a la pantalla de inicio de sesión.

![Menú de cierre de sesión](https://content.gitbook.com/content/7Bx0xNdsdGHpCZ20yxbn/blobs/nY9QvHt1zAaoiH0xEDUs/images/login-logout.png)

## 4. Diseño de la aplicación

Toda página tiene la misma estructura: barra lateral a la izquierda, encabezado fijo en la parte superior y área de contenido central.

![Diseño de la aplicación](https://content.gitbook.com/content/7Bx0xNdsdGHpCZ20yxbn/blobs/ttC7OKLh9txcr20WeJ9i/images/layout-aplicacao.png)

### 4.1 Barra lateral (izquierda)

Muestra los elementos principales de navegación. Puede contraerse/expandirse mediante el botón de la base.

| Elemento           | Qué hace                                                                                      |
| ------------------ | --------------------------------------------------------------------------------------------- |
| **Inicio**         | Página de inicio. Acceso directo para crear un nuevo registro y ver la actividad reciente.    |
| **Nuevo registro** | Abre el formulario de creación de registro (solo si tiene permiso de escritura).              |
| **Registros**      | Lista y busca todos los registros (todos los usuarios, si es administrador) o solo los suyos. |
| **Métricas**       | Panel de indicadores agregados de uso (solo para usuarios con permiso de métricas).           |

Los elementos de menú a los que no puede acceder (por falta de permiso) permanecen ocultos. La versión de la aplicación se muestra en la parte inferior de la barra lateral.

### 4.2 Encabezado (parte superior)

El encabezado muestra el título de la página actual y, en la esquina derecha, los siguientes iconos (de izquierda a derecha):

* **Listos para enviar** — acceso directo al *Registro de envíos* (página con registros pendientes de sincronización). Aparece cuando hay registros pendientes de envío.
* **Indicador de estado del sistema** — señala en tiempo real si todos los componentes (dispositivos, extensión, ABIS, internet) están operativos. Al hacer clic abre la página de *Diagnóstico del sistema*. Colores: `VERDE` todo correcto, `AMARILLO` aviso (algo no crítico falló), `ROJO` crítico (impide nuevos registros).
* **Iniciar recorrido de la página** (icono de ayuda) — inicia un recorrido guiado contextual con explicaciones sobre cada elemento de la pantalla actual.
* **Avatar y nombre del usuario** — abre el menú de la cuenta, con la opción **Salir**.

### 4.3 Recorrido guiado y onboarding

En cada página, el botón de ayuda (icono con "?") inicia un **recorrido interactivo** con explicaciones paso a paso de los elementos de la pantalla. Los recorridos están disponibles en:

![Botón de recorrido](https://content.gitbook.com/content/7Bx0xNdsdGHpCZ20yxbn/blobs/njjfZ61yvBchFbJNfjBA/images/botao-tour.png)

* **Inicio** — presentación general de la aplicación, modo sin conexión e instalación como PWA.
* **Nuevo registro** — explicación de las etapas biográficas y biométricas.
* **Registros** — búsqueda y lectura del listado.
* **Detalles del registro** — lectura de los resultados de la búsqueda biométrica.

Los pasos mostrados en el recorrido se adaptan a sus permisos y al estado de la pantalla. Use los botones **Anterior**, **Siguiente** y **Finalizar** para navegar.

![Recorrido de onboarding](https://content.gitbook.com/content/7Bx0xNdsdGHpCZ20yxbn/blobs/N5CeprOGotH2xOCSv8uj/images/tour-onboarding.png)

## 5. Estado del sistema y diagnóstico

### 5.1 Indicador en el encabezado

Un pequeño panel en el encabezado supervisa continuamente cada componente. Al hacer clic en él se le lleva a la página **Diagnóstico del sistema**.

<figure><img src="https://content.gitbook.com/content/7Bx0xNdsdGHpCZ20yxbn/blobs/dlvaFIwAZQp4tfYPGYMd/images/indicador-diagnostico.png" alt="Indicador de Diagnóstico"><figcaption><p>Indicador de diagnóstico</p></figcaption></figure>

### 5.2 Página Diagnóstico del sistema

![Página de Diagnóstico del sistema](https://content.gitbook.com/content/7Bx0xNdsdGHpCZ20yxbn/blobs/kAorwHTA6WkAkL8WQBaG/images/pagina-diagnostico.png)

Accesible desde el indicador del encabezado o desde el menú de la cuenta. Verifica seis componentes:

| Componente                            | Qué verifica                                                                                 | ¿Crítico?                    |
| ------------------------------------- | -------------------------------------------------------------------------------------------- | ---------------------------- |
| **Sistema de captura**                | Live Capture Extension instalada y Connector activo (motor principal de captura biométrica). | Sí                           |
| **Dispositivo de captura facial**     | Cámara detectada, permiso de acceso concedido por el navegador.                              | Sí                           |
| **Escáner de huellas dactilares**     | Driver, SDK, dispositivo USB y acceso.                                                       | Sí                           |
| **Pad de firma**                      | Driver, SDK, dispositivo USB y acceso.                                                       | Sí                           |
| **Servicio de identificación** (ABIS) | Conexión con el sistema biométrico de búsqueda.                                              | No (limita la funcionalidad) |
| **Conexión a Internet**               | Conectividad de red.                                                                         | No (limita la funcionalidad) |

Cada componente se muestra en una tarjeta con su estado — `EN LÍNEA`, `SIN CONEXIÓN`, `CRÍTICO`, `NO DISPONIBLE`. Cuando hay una falla, la tarjeta muestra una sección **Pasos para la resolución** con instrucciones específicas.

### 5.3 Banners de estado

{% hint style="danger" %}
**Problema crítico identificado** — al menos un componente esencial (extensión o dispositivo biométrico) no está disponible. **No será posible iniciar nuevos registros** hasta que se resuelva. Siga los pasos indicados en la tarjeta correspondiente.
{% endhint %}

{% hint style="warning" %}
**Aviso del sistema** — los componentes no críticos no están disponibles (ABIS o internet). Puede seguir usando el sistema con funcionalidad limitada (por ejemplo, los registros se guardan localmente para su envío posterior).
{% endhint %}

### 5.4 Subestados comunes

| Estado               | Significado                                             | Acción típica                                                                |
| -------------------- | ------------------------------------------------------- | ---------------------------------------------------------------------------- |
| Denegado             | El navegador bloqueó el acceso al dispositivo.          | Revise los permisos en la barra de direcciones.                              |
| No encontrado        | El dispositivo no fue detectado por el sistema.         | Compruebe la conexión USB y el cable.                                        |
| En uso               | El dispositivo está siendo utilizado por otro programa. | Cierre otros programas que puedan estar usando el dispositivo.               |
| No instalado         | El driver o la extensión no fue instalada.              | Instale la Live Capture Extension/Connector (enlace clicable en la tarjeta). |
| Versión incompatible | La versión instalada no es compatible.                  | Actualice el driver/extensión a la versión recomendada.                      |

## 6. Inicio (Home)

![Página de inicio](https://content.gitbook.com/content/7Bx0xNdsdGHpCZ20yxbn/blobs/BHh5fyCBs3O91C2GkyGG/images/home.png)

Es la página de inicio de la aplicación, accesible mediante el elemento **Inicio** de la barra lateral. Contiene dos bloques:

### 6.1 Iniciar nuevo registro

Botón destacado en la parte superior. Al hacer clic abre la página de creación de un nuevo registro (Sección 7). Aparece solo si tiene permiso de creación.

### 6.2 Actividad reciente

Lista de los **5 registros más recientes** a los que tiene acceso, con nombre (cuando esté disponible), fecha de creación y estado actual. Cada elemento es clicable y lleva a la página de detalles del registro.

![Actividad reciente](https://content.gitbook.com/content/7Bx0xNdsdGHpCZ20yxbn/blobs/McGpe9hqdNK5zBMYdGtx/images/atividade-recente.png)

Comportamiento:

* **En línea:** muestra los 5 registros más recientes del servidor.
* **Sin conexión:** muestra los 5 registros más recientes almacenados localmente (aún no enviados).
* Cuando hay registros con estado **Búsqueda solicitada**, el panel se actualiza automáticamente cada 10 segundos para reflejar la evolución hasta que todos se completen.

El enlace **Ver más →** abre la página completa de registros (en línea) o el Registro de envíos (sin conexión).

## 7. Crear un nuevo registro

Esta es la funcionalidad central de GBS Identity. El flujo estándar tiene cinco etapas, mostradas en secuencia con indicador de progreso en la parte superior:

{% stepper %}
{% step %}

### Datos biográficos

Complete la información del individuo. Los campos mostrados dependen de la configuración de la instalación.

Los campos obligatorios aparecen en rojo. Algunos campos tienen máscara automática y validación inmediata — si el valor es inválido, el mensaje aparece debajo del campo y el botón **Siguiente** queda deshabilitado.

Haga clic en **Siguiente** para avanzar.

![Etapa de datos biográficos](https://content.gitbook.com/content/7Bx0xNdsdGHpCZ20yxbn/blobs/t13XG2VDK7vDTt8q4OGe/images/etapa1-dados-biograficos.png)
{% endstep %}

{% step %}

### Captura facial

El componente de captura en vivo muestra la imagen de la cámara. Por defecto, la captura comienza automáticamente y el sistema utiliza la verificación de calidad **ICAO** para garantizar una imagen adecuada.

Cuando la imagen se captura correctamente, aparece el mensaje *"Rostro capturado con éxito"* y el botón **Capturar nuevamente**. Evalúe la imagen en pantalla: si es necesario, repita antes de continuar.

![Etapa de captura facial](https://content.gitbook.com/content/7Bx0xNdsdGHpCZ20yxbn/blobs/aYkbQd4QK1VFqDp606GG/images/etapa2-captura-facial.png)

El botón **Siguiente** solo se habilita después de una captura exitosa. Use **Anterior** para volver a la etapa de datos biográficos.
{% endstep %}

{% step %}

### Huellas dactilares

El escáner solicita las huellas en secuencia. Coloque el dedo indicado por la interfaz y espere la captura — el sistema avanza automáticamente al siguiente dedo.

![Etapa de huellas dactilares](https://content.gitbook.com/content/7Bx0xNdsdGHpCZ20yxbn/blobs/dWrys1SwyIwNrOozdVxO/images/etapa3-impressoes-digitais.png)

El modo de captura es configurable por instalación. La imagen de referencia de arriba muestra una recogida de cuatro dedos. Los dedos que aún no han sido capturados se destacan.

![Dedos pendientes de captura](https://content.gitbook.com/content/7Bx0xNdsdGHpCZ20yxbn/blobs/7VjdAFpOLXeacwyVGyIZ/images/etapa3-dedos-pendentes.png)

Si un dedo no puede ser capturado (amputación, lesión), siga la interfaz de la extensión para marcar el motivo (la captura puede omitirse mediante las opciones específicas del dispositivo, cuando estén habilitadas por la configuración).

El mensaje *"Huellas dactilares capturadas con éxito"* aparece cuando el conjunto está completo.
{% endstep %}

{% step %}

### Firma

Solicite al individuo que firme en el pad de firma. La firma se muestra en tiempo real en la pantalla.

* Si la firma queda inadecuada, use **Capturar nuevamente**.
* Cuando la firma se captura, aparece *"Firma capturada con éxito"*.
* Si el individuo no puede firmar (analfabeto, lesión, bebé, etc.), marque la opción **No firma**. El sistema mostrará *"Firma no capturada"* y permitirá avanzar incluso sin firma.
  {% endstep %}

{% step %}

### Revise los datos ingresados

Muestra un resumen de todos los datos ingresados:

* **Datos biográficos** completados.
* **Datos biométricos** — para cada modalidad (Face, Huellas dactilares, Firma), indica si fue *Capturado* o *No capturado*, con vista previa cuando está disponible.

Léalo atentamente. Para corregir algo, use **Anterior** y vuelva a las etapas anteriores — los datos ya capturados se conservan.

Cuando todo esté correcto, haga clic en **Enviar**. Durante el envío, ambos botones quedan deshabilitados.

![Etapa de revisión](https://content.gitbook.com/content/7Bx0xNdsdGHpCZ20yxbn/blobs/GdRD3FnDHhnYlw8cSpcQ/images/etapa5-revisao.png)
{% endstep %}
{% endstepper %}

{% hint style="info" %}
El conjunto de etapas y los campos requeridos pueden variar según la configuración de implementación. En algunas instalaciones, GBS Identity funciona en modo **rápido** (formulario reducido con captura mínima — por defecto, solo huellas dactilares) en lugar del modo **completo** descrito arriba. En cualquier caso, el sistema solo permite avanzar cuando se han cumplido los requisitos de la etapa.
{% endhint %}

### Cancelar registro

![Encabezado del formulario de registro](https://content.gitbook.com/content/7Bx0xNdsdGHpCZ20yxbn/blobs/dBaT0CsRcWs85Q4ax7bT/images/cabecalho-formulario.png)

* **Cancelar** (esquina superior): aborta el registro y descarta todo lo capturado (con confirmación).

{% hint style="warning" %}
**Atención: esta acción no se puede deshacer.** Al cancelar o salir de un registro en curso, todos los datos biográficos y biométricos capturados (foto facial, huellas dactilares, firma y demás información asociada) se borran permanentemente. El sistema siempre muestra un modal de confirmación antes de descartar los datos.
{% endhint %}

### Después del envío

![Pantalla después del envío del registro](https://content.gitbook.com/content/7Bx0xNdsdGHpCZ20yxbn/blobs/f2oXGeAaqAlYg55ASXvD/images/apos-envio.png)

El comportamiento depende del estado de la conexión en el momento del envío:

| Escenario                  | Qué ocurre                                                                                | Mensaje                                                                                                 |
| -------------------------- | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| En línea + ABIS disponible | El registro se envía inmediatamente. Se le redirige a la página de detalles del registro. | *"Registro enviado con éxito"*                                                                          |
| Sin conexión               | El registro se guarda en el dispositivo (IndexedDB) y se añade a la cola de envío.        | *"Está sin conexión. El registro se guardó localmente y se enviará cuando se restablezca la conexión."* |
| Fallo en el envío en línea | El registro se guarda localmente y el sistema intentará reenviarlo automáticamente.       | *"Error en el envío. El registro se guardó localmente y se reenviará automáticamente."*                 |

## 8. Modo sin conexión y Registro de envíos

GBS Identity fue diseñado para funcionar sin conexión. Puede iniciar y completar un registro normalmente cuando esté sin conexión — se almacenará en el navegador y se enviará automáticamente en cuanto haya conexión y el servidor esté disponible.

### 8.1 Cómo identifica el sistema el estado sin conexión

* El navegador perdió acceso a internet, o
* El servidor de identificación (ABIS) está caído.

En ambos casos, el encabezado mostrará una indicación de estado amarilla/roja y algunas páginas mostrarán banners específicos.

### 8.2 Listos para enviar

Cuando hay registros pendientes de envío, aparece un botón **Listos para enviar** en el encabezado. Al hacer clic abre la página **Registro de envíos**.

![Botón Listos para enviar](https://content.gitbook.com/content/7Bx0xNdsdGHpCZ20yxbn/blobs/T0DW0jLg9Rb1FTtOhG3q/images/botao-prontos-para-enviar.png)

### 8.3 Página Registro de envíos

Lista todos los registros pendientes de envío almacenados localmente. Para cada uno, se muestran:

* Nombre (o *"Registro sin nombre"* cuando no está completado).
* Fecha de la última actualización.
* Indicador **Enviando** en tiempo real durante la sincronización.
* Indicador **Error en el intento de envío** cuando ocurre una falla.

Cuando el sistema está en línea, ABIS responde y hay registros pendientes, aparece el botón **Reenviar registros** en la parte superior de la página. Haz clic para forzar un nuevo intento de envío.

Cuando la cola está vacía, la página muestra *"Ningún registro pendiente de envío"*.

### 8.4 Banner de servidor offline

En la página **Registros** y en **Métricas**, cuando ABIS no está disponible, aparece un banner naranja:

{% hint style="warning" %}
**MODO OFFLINE — Servidor de Búsqueda Offline.** El servidor de búsqueda ABIS no está disponible en este momento. Solo los registros listos para envío están visibles. Los registros en línea no pueden accederse hasta que se restablezca la conexión con el servidor.
{% endhint %}

## 9. Listar y buscar registros

Accedida mediante el elemento **Registros** de la barra lateral. La página tiene tres bloques: filtros, lista paginada y paginación.

![Listado de registros](https://content.gitbook.com/content/7Bx0xNdsdGHpCZ20yxbn/blobs/lYxn0q5vR8dQijai9IeT/images/lista-registros.png)

### 9.1 Filtros

| Filtro                          | Cómo funciona                                                                                                  |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| **Buscar por...**               | Campo de texto con selector de tipo de clave. El valor se formatea automáticamente según el tipo seleccionado. |
| **Fecha inicial / Fecha final** | Filtra por la fecha de inicio de la captura del registro. Se puede usar solo una de las dos.                   |

Botones **Buscar** (aplica los filtros) y **Limpiar** (borra todos los filtros y vuelve a hacer la búsqueda). Pulsar la tecla `Enter` en el campo de búsqueda también dispara la búsqueda.

Los filtros aplicados **se conservan** al navegar a otras páginas. Al volver a Registros, tu búsqueda sigue mostrándose.

### 9.2 Lista de registros

Cada ítem muestra:

* Nombre (o *"Registro desconocido"*, cuando no hay "Nombre").
* Documentos identificadores.
* Cantidad de candidatos encontrados (después de que finaliza la búsqueda biométrica).
* **Badge de estado** indicando el estado del procesamiento:

| Estado                 | Significado                                                                                      |
| ---------------------- | ------------------------------------------------------------------------------------------------ |
| `Registrando`          | El individuo está siendo registrado en ABIS.                                                     |
| `Registrado`           | El enrolamiento se ha completado.                                                                |
| `Error al registrar`   | El enrolamiento falló.                                                                           |
| `Procesando`           | La búsqueda biométrica 1:N fue solicitada y está en curso.                                       |
| `Fallo en la búsqueda` | La búsqueda biométrica falló en el servidor.                                                     |
| `Completado`           | El procesamiento se ha completado — los candidatos (si los hay) están disponibles para análisis. |

Cada ítem tiene el botón **Ver** para abrir los detalles (Sección 10).

### 9.3 Paginación

En el pie de la lista, control de páginas (primera, anterior, siguiente, última) y selección de cantidad de registros por página (10, 15 o 50). La paginación solo aparece cuando hay resultados en línea.

## 10. Detalles del registro y búsqueda biométrica

Accedida mediante el botón **Ver** de cada registro o por la tarjeta de actividad reciente en el dashboard. La página tiene tres bloques:

![Página de detalles del registro](https://content.gitbook.com/content/7Bx0xNdsdGHpCZ20yxbn/blobs/MPEE1H8WlDKQRz6zzRUG/images/detalhes-registro.png)

### 10.1 Registro Actual

![Tarjeta del registro actual](https://content.gitbook.com/content/7Bx0xNdsdGHpCZ20yxbn/blobs/Z0m176WAPPb4UuzmXCLT/images/registro-atual.png)

Tarjeta en la parte superior, mostrando todos los datos del registro recién creado:

* Imagen facial capturada.
* Datos biográficos.
* Estado actual (badge).
* Indicación de si algún dedo tiene una anomalía (amputado, lesionado, etc.).

Mientras el estado del registro sea *Registrando*, *Registrado* o *Búsqueda solicitada*, esta página se actualiza automáticamente cada 5 segundos.

### 10.2 Resultado de la búsqueda biométrica

![Resultado de la búsqueda biométrica](https://content.gitbook.com/content/7Bx0xNdsdGHpCZ20yxbn/blobs/QS4pdjuCFw4uhw8QgMVi/images/resultado-pesquisa.png)

Justo debajo del registro actual, muestra el resultado de la búsqueda:

* **"X perfiles encontrados"** — total de candidatos en la esquina superior derecha de la sección.
* **"Ningún perfil encontrado"** — cuando la búsqueda no devolvió candidatos.

Cuando no hay candidatos, el sistema explica:

{% hint style="info" %}
**Sin perfiles coincidentes:** La búsqueda biométrica en la base de datos no devolvió ningún perfil coincidente.
{% endhint %}

### 10.3 Tarjeta de candidato

Cada candidato encontrado se muestra en una tarjeta con:

* **Imagen facial del candidato**.
* **Tipo de registro**: `CIVIL` (proveniente de la base civil) o `REGISTRO` (otro *encounter* ya existente en Identity).
* **Datos biográficos** resumidos.
* **Fecha de creación** del registro del candidato.
* **PGUID / TGUID** — identificadores únicos del candidato.
* Botón **Ver Detalles**.

Para cerrar la información detallada, haz clic en **Ocultar Detalles**.

### 10.4 Avisos de verificación por clave

Además de la búsqueda biométrica 1:N, GBS Identity realiza una **verificación 1:1** para cada clave informada. Estos avisos aparecen como banners destacados:

{% hint style="warning" %}
**Aviso:** El *(clave)* informado ya está registrado en un perfil en la base que **no tiene correspondencia biométrica** con el registro. Esto puede indicar fraude documental — investiga antes de aceptar el registro.
{% endhint %}

{% hint style="info" %}
**Aviso:** El *(clave)* informado **no está registrado en la base**. El documento informado no consta en el sistema.
{% endhint %}

### 10.5 Volver

El botón **Volver** en la parte superior retorna a la página de origen: **Registros** (si viniste del listado) o **Inicio** (si viniste del dashboard).

## 11. Completar registro

Cuando se ha creado un registro en el modo **rápido** (solo con biometría mínima) y la búsqueda biométrica no devolvió ningún candidato, el operador puede **completar el registro** añadiendo más biometrias y datos biográficos. Esto mejora la calidad del registro almacenado en ABIS para búsquedas futuras.

### 11.1 Cuándo aparece el botón

En la página de detalles del registro, cuando no se encuentra ningún candidato y el registro es del tipo rápido (y aún no ha sido completado), aparece el botón **Completar Registro**.

Si el registro ya tiene candidatos o ya ha sido completado, el botón no aparece y el sistema muestra *"El registro no puede completarse"* si intentas abrir la URL de complemento manualmente.

### 11.2 Flujo de complemento

Al hacer clic en **Completar Registro**, se abre el mismo formulario de cinco pasos usado en un nuevo registro, ya **prellenado** con los datos biográficos y biométricos del registro original. Agrega la información que falta y continúa hasta la etapa de revisión.

Al enviar, el sistema actualiza el registro en ABIS y devuelve el nuevo resultado de búsqueda. Se te redirige de vuelta a la página de detalles.

Si cancelas o intentas salir con cambios pendientes, el sistema muestra un modal:

{% hint style="warning" %}
**Descartar cambios — Atención: Tus cambios se perderán.** Cancelar descartará todos los cambios hechos en este registro, incluyendo nuevos datos biográficos y biométricos capturados.
{% endhint %}

## 12. Métricas

Accedida mediante el elemento **Métricas** de la barra lateral (solo para usuarios con permiso). Muestra tres indicadores agregados de uso para un período seleccionado.

### 12.1 Filtro de período

En la parte superior de la página, elige **Fecha Inicial** y **Fecha Final**. Atajos disponibles: **Hoy**, **Último Mes**, **Este Año**. El botón **Buscar** solo se habilita cuando ambas fechas están completas.

Después de buscar, se muestra una línea resumen (por ejemplo, *"Período seleccionado: 01/05/2026 - 27/05/2026 (27 días)"*) y las tres tarjetas de métrica.

### 12.2 Indicadores mostrados

![Panel de métricas](https://content.gitbook.com/content/7Bx0xNdsdGHpCZ20yxbn/blobs/6C6xVXC99r2VMUK15k89/images/metricas.png)

| Indicador                       | Qué mide                                                                                                    |
| ------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| **Total de Capturas Offline**   | Cuántos registros fueron capturados sin conexión (offline) en el período. Útil para seguir el uso en campo. |
| **Total de Registros Enviados** | Cuántos registros fueron efectivamente enviados a ABIS en el período.                                       |
| **Registros sin candidatos**    | Cuántos registros, al ser sometidos a la búsqueda biométrica, no tuvieron ningún candidato correspondiente. |

### 12.3 Indisponibilidad del servicio

Esta página requiere ABIS en línea. Si accedes mientras estás offline, serás redirigido a la página inicial con el mensaje *"El servicio de identificación no está accesible en este momento para consulta de métricas"*.

## 13. Mensajes, avisos y solución de problemas

### 13.1 Toasts y notificaciones comunes

| Mensaje                                                                                      | Significado / Acción                                                                                           |
| -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| *Registro enviado con éxito*                                                                 | Envío en línea completado. Registro disponible para consulta.                                                  |
| *Estás offline. Registro guardado localmente y será enviado cuando se restaure la conexión.* | El registro está seguro en el dispositivo. Revisa el encabezado para ver señales de que la conexión ha vuelto. |
| *Registro pendiente sincronizado con éxito*                                                  | Un registro que estaba en la cola fue enviado.                                                                 |
| *Error al sincronizar el registro. Lo intentaremos de nuevo.*                                | Error temporal. El sistema hará un nuevo intento automáticamente.                                              |
| *Error en el formato del registro. Contacta con soporte*                                     | El registro local está corrupto o en formato inválido. Contacta con soporte con el ID del registro.            |
| *Error al cargar registros. Intenta nuevamente.*                                             | Error temporal en la llamada al servidor. Recarga la página o vuelve a hacer la búsqueda.                      |
| *Página de nuevo registro no disponible mientras los dispositivos estén inactivos*           | Consulta la página de Diagnóstico del Sistema (Sección 5).                                                     |
| *Registro no encontrado. Se creará un nuevo registro.*                                       | El ID en la URL no existe. El sistema creó un registro en blanco.                                              |
| *Error al inicializar el registro. Intenta nuevamente.*                                      | Error al preparar la pantalla de nuevo registro. Vuelve a abrir la página.                                     |

### 13.2 Actualización de la aplicación (PWA)

Cuando se detecta una nueva versión, aparece un aviso flotante **"Nueva versión disponible — Actualiza la página para usar la versión más reciente de la app"**, con los botones:

* **Actualizar ahora** — recarga la aplicación en la nueva versión.
* **Más tarde** — pospone el recordatorio.
* **Descartar** — cierra el aviso (se mostrará nuevamente en otra ocasión).

### 13.3 Diagnósticos: qué hacer si algo está en rojo

| Síntoma                             | Causa probable                                                                | Qué hacer                                                                                                         |
| ----------------------------------- | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| Sistema de Captura en rojo.         | Live Capture Extension no instalada o desactivada.                            | Instala la extensión (enlace en la página de Diagnóstico). Reinicia el navegador.                                 |
| Dispositivo Facial en rojo.         | Cámara no conectada o permiso denegado.                                       | Revisa el cable USB. Concede permiso a la cámara en la barra de direcciones del navegador.                        |
| Escáner de Huellas en rojo.         | Controlador ausente, dispositivo en uso por otro programa o USB desconectado. | Vuelve a conectar el USB. Cierra otros programas de captura. Instala el controlador indicado.                     |
| Pad de Firma en rojo.               | La misma familia de causas que el escáner.                                    | Vuelve a conectar y prueba.                                                                                       |
| Servicio de Identificación en rojo. | ABIS fuera de servicio o VPN/firewall bloqueando.                             | Sigue trabajando offline — los registros se enviarán cuando el servicio vuelva. Contacta con soporte si persiste. |
| Conexión a Internet en rojo.        | Sin red (Wi-Fi/Ethernet) o router caído.                                      | Revisa la red del equipo. Sigue trabajando offline — GBS Identity funciona sin internet.                          |

## 14. Salir y cambiar de sesión

Haz clic en el **avatar** en la esquina superior derecha y selecciona **Salir**. El sistema cierra la sesión en el proveedor de identidad y te devuelve a la pantalla de inicio de sesión. Los datos locales no enviados (registros pendientes) permanecen almacenados en el dispositivo y se sincronizarán en la próxima sesión del mismo usuario.

{% hint style="info" %}
**Importante:** Los datos locales están vinculados al identificador del usuario. Al cambiar de usuario en el mismo equipo, cada usuario verá solo sus propios registros pendientes.
{% endhint %}

***

## Glosario

<table data-search="false"><thead><tr><th>Término</th><th>Definición</th></tr></thead><tbody><tr><td><strong>Registro</strong> (encounter)</td><td>Conjunto de datos biográficos y biométricos recopilados de un individuo en una sesión.</td></tr><tr><td><strong>ABIS</strong></td><td>Automated Biometric Identification System — servicio que almacena, indexa y busca biometrías.</td></tr><tr><td><strong>Enrolamiento</strong> (registro)</td><td>Proceso de insertar al individuo en ABIS para que pase a figurar en búsquedas futuras.</td></tr><tr><td><strong>Verificación (1:1)</strong></td><td>Comparación de los documentos del individuo contra un registro específico en la base, identificado por la misma clave.</td></tr><tr><td><strong>Búsqueda (1:N)</strong></td><td>Comparación biométrica del individuo contra toda la base, devolviendo candidatos con coincidencia.</td></tr><tr><td><strong>Perfil encontrado</strong></td><td>Registro existente en la base que presenta coincidencia biométrica (rostro, huella o firma) con el registro recién creado.</td></tr><tr><td><strong>CIVIL</strong></td><td>Origen del candidato: proveniente de la base civil (base de ciudadanos).</td></tr><tr><td><strong>REGISTRO</strong></td><td>Origen del candidato: proveniente de otros encounters ya existentes en Identity.</td></tr><tr><td><strong>PGUID / TGUID</strong></td><td>Identificadores únicos asignados por ABIS al individuo (PGUID) y al registro biométrico (TGUID).</td></tr><tr><td><strong>Live Capture Extension</strong></td><td>Extensión del navegador que permite a la aplicación web acceder a los dispositivos biométricos.</td></tr><tr><td><strong>Live Capture Connector</strong></td><td>Aplicación del sistema operativo que actúa como puente entre la extensión del navegador y los controladores de los dispositivos.</td></tr><tr><td><strong>PWA</strong></td><td>Progressive Web App — modelo de aplicación web que puede instalarse como app nativa y funcionar offline.</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.griaule.com/gbs/es/aplicaciones/gbs-identity.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.