# FastLine ## Introducción El **GBS FastLine** es una aplicación de software para autenticación en filas de espera. Utiliza identificación facial de forma rápida y precisa para hacer que las personas sean identificadas de manera más ágil que por el proceso de verificación de documentos realizado por un operador humano. Usando FastLine, es posible reconocer, identificar y registrar individuos en una fila de forma automática. Este manual está actualizado para la versión 1.5.1 de FastLine. ### Versiones de la Aplicación GBS FastLine está disponible en dos versiones: #### Desktop Standalone Esta versión es para uso completo en un entorno desktop, sin necesidad de herramientas o requisitos externos. {% hint style="warning" %} GBS FastLine fue diseñado como un servicio, y su versión desktop se recomienda para procedimientos de prueba, validación y prueba de concepto, o para casos triviales de uso. {% endhint %} {% hint style="info" %} En este documento esta versión será referida solamente como **Desktop**. {% endhint %} #### Services En esta versión, GBS FastLine se proporciona como un servicio y debe ser controlado por una aplicación externa a través de su API. Esta versión también proporciona medios para supervisión externa. ### Licencia de Software GBS FastLine requiere una licencia de software para funcionar. La licencia no está vinculada a ninguna dirección de hardware (como MAC Address) y no expira. La licencia debe instalarse en: `C:\ProgramData\Griaule`, de acuerdo con las instrucciones presentes en el manual de licencia. {% hint style="info" %} Si se necesita más ayuda, póngase en contacto con el soporte de Griaule. {% endhint %} ### Instalación y Configuración Inicial de FastLine El instalador de FastLine tiene una pestaña de configuración, *GBDS Settings*: ![GBS Fast Line Installer](/files/3a3882b86280f04c76be7264f51ed9dbc4bd6c5c) #### Configuraciones de GBDS **GBDS URL Address** URL de dirección del servidor GBDS. Ejemplo: `http://192.168.0.1:8085`. **Username and Password** Credenciales utilizadas por FastLine para autenticación en GBDS. ## Interfaz de Usuario ### Iniciando la Aplicación Al iniciar FastLine, la *Pantalla Inicial* será mostrada: ![GBS Fast Line Main Page](/files/2e40c301a1682e4a15d1cf929212365e61edd8f6) ### Añadiendo Perfiles a la Base de Datos Esta sección muestra cómo poblar la base de datos local. #### Recuperando desde GBDS El formulario *Load base from GBDS*, mostrado abajo, puede usarse para recuperar perfiles de GBDS. Los perfiles pueden filtrarse por las claves biográficas. Si el filtro se deja vacío, todos los perfiles disponibles serán importados. ![GBDS filter](/files/d67fa518bcf8d7e06f80caacbdff1aa90e88e40e) #### Registro Local El botón **Capturar Foto** permite al usuario registrar una nueva persona en la base de datos local. Al seleccionar esta opción, se abrirá la ventana de captura de imagen: ![GBS FastLine Capture Image Screen](/files/bca18642c157b77e94c5c8192f359af7d2eb2510) La versión *Desktop* permite el registro mediante captura de imágenes en vivo, o mediante importación de archivos de imagen ya guardados. La versión *Services* permite registrar mediante importación de archivos de imagen, pero no mediante captura en vivo. Esta versión está enfocada en usos externos, para los cuales se espera una base de datos ya poblada con perfiles. ### Visualizando Perfiles La lista de perfiles se muestra en la barra lateral y muestra todos los perfiles disponibles para detección. El número de perfiles se muestra en la parte superior de la lista. ![Local database](/files/3ae189f58c320023a4d62dc99243b4f314c59274) El tamaño de la lista mostrada puede modificarse en las configuraciones de la aplicación. Pasar el cursor del mouse sobre un perfil muestra su foto. Los perfiles pueden seleccionarse o deseleccionarse al hacer clic en ellos. ### Eliminando Perfiles Para eliminar uno o más perfiles, selecciónelos haciendo clic en la lista de perfiles y presione el botón **Delete**. {% hint style="warning" %} Una vez que un perfil sea eliminado, no podrá recuperarse. {% endhint %} ### Configuraciones de la Aplicación Para configurar la aplicación, haga clic en **Configuraciones** en la página inicial: ![GBS FastLine Settings Screen](/files/5f7560766f5ac5122a44a54302b0805500335463) En esta pantalla, el usuario puede configurar el funcionamiento de la detección, así como la cámara que se utilizará. ## Flujo de Trabajo Estándar El flujo de trabajo estándar para usar FastLine es el siguiente: 1. Realizar el inicio de sesión 2. Llenar la base de datos 3. Comenzar la detección 4. Finalizar la detección 5. Verificar los resultados 6. Exportar el PDF con los resultados. ## Detección ### Pantalla de Detección La *Pantalla de Detección* es el núcleo de GBS FastLine. En esta pantalla, el usuario podrá visualizar las imágenes capturadas por la cámara, así como las personas ya identificadas y no identificadas. ![GBS FastLine Detection Screen](/files/50a60d4f702d1fd14b8b12e8f385f7f6d5e6e713) #### Realizando Detecciones Las detecciones pueden iniciarse a través de la interfaz de la versión *Desktop*, o a través de la API, en la versión de *Services*. Una vez iniciada, la aplicación comenzará el reconocimiento a través de la cámara configurada. Cada vez que un cuadro de la imagen en vivo coincida con un perfil de la base de datos, el evento será registrado y podrá enviarse una notificación (dependiendo de las configuraciones de la aplicación). Cada perfil puede ser reconocido solo una vez: cuando un perfil es reconocido, es eliminado de la *lista de observación*. Es posible detectar más de un rostro a la vez, reducir el área de detección de la cámara, especificar otras resoluciones de cámara, alternar entre cámaras, cambiar el umbral de identificación y otros recursos, a través de las configuraciones de la aplicación. Las detecciones se realizan en *sesiones de detección*, un concepto discutido abajo. #### Sesión de Detección Todo proceso de detección debe ocurrir dentro de una Sesión de Detección; estas sesiones pueden ser creadas por el usuario a través de la interfaz o de la API. Una vez creadas, las sesiones pueden iniciarse, pausarse, reanudarse y finalizarse. Mientras no sean finalizadas, las sesiones pueden tener las configuraciones y los datos alterados. Una vez finalizada, la sesión genera un informe de detección que ya no puede ser alterado. Una *Sesión de Detección* puede verse como un informe que está siendo escrito. Cuando está completo, se convierte en un informe de detección inmutable, garantizando la consistencia de los datos. Cada sesión de detección tiene su propio *UUID* (Identificador Único Universal, en inglés, *Universal Unique Identifier*), llamado **SGUID** (Identificador Único Global de Sesión, del inglés, *Session Global Unique Identifier*) ### Lista de Identificados La *Lista de Identificados* muestra a las personas que coincidieron con las personas registradas desde el inicio de la sesión: ![GBS FastLine Detected People List](/files/3d79fa852752875c9823efdbd34d5e25d35b76b8) ### Lista de No Identificados La *Lista de No Identificados* muestra a las personas que no coincidieron con las personas registradas desde el inicio de la sesión: ![GBS FastLine Unidentified People List](/files/bd64337aabfe291d4c3ad0388baa1f14f0acee9c) ### Informe de Resultados El usuario puede ver el estado de la sesión en la *Pantalla de Informe*: ![GBS FastLine Report Screen](/files/75be18129bc1f1ad2d3a613cb744e8d7abc6b592) Una vez que la sesión de detección termina, la lista de detección se convierte en un informe inmutable. El informe se guarda automáticamente en un archivo PDF o JSON. El formato del informe y la ubicación donde se guarda se determinan en las configuraciones de la aplicación. En la versión *Desktop*, la aplicación puede configurarse para mostrar automáticamente el informe cuando la sesión es finalizada. ![Export as PDF Button](/files/2a021fd46427d920695ab16df5fe5d1ade62a980) #### Generando Informe en Ejecución Puede generar un informe mientras FastLine está en ejecución. Este informe parcial solo está disponible si el parámetro de configuración `savePdfRunning` está definido como `true` en el archivo `config.properties`. Cuando este parámetro sea `true`, un botón llamado Exportar como PDF aparecerá en la pantalla de detección. Puede hacer clic en el botón para generar el informe. ![Export as PDF Button](/files/7225c2a98be9a33a5d521634668c28901e12fb96) ## Notificación Externa Cuando FastLine detecta un rostro, mostrará la imagen del rostro adquirido y del rostro de referencia. También se muestran otras informaciones, como el nombre y la puntuación de la persona. La información de coincidencia también puede enviarse a una URL determinada mediante la configuración `desktopStandalone.notifyUrl`. Para modificar la configuración, vaya a la carpeta FastLine, acceda al archivo `conf/config.properties` y cambie el parámetro `desktopStandalone.notifyUrl` a la URL que será notificada. Después de que FastLine realice una coincidencia, mostrará la información en la interfaz y notificará a la URL configurada con el siguiente JSON: ```json { "id": "FastLine001", "status": "MATCH", "matchSummary": { "referencePerson": { "template": "BYTEARRAY", "tguid": "29D99G74-BF97-4714-B78E-1A3A49DDF782", "name": "John Doe", "document": "88418861092", "key": "CPF", "profileImageByteArray": "BYTEARRAY" }, "score": 95.29505, "timestamp": "2022-08-08_08.08.08_BRT", "queryImage": "BYTEARRAY" } } ``` {% hint style="info" %} Tenga en cuenta que los valores de `profileImageByteArray`, `template` y `queryImage` serán arreglos de bytes con formato base64. {% endhint %} Los campos JSON son: * id: ID de FastLine, definido por la configuración `desktopStandalone.notifyId`. * status: Indica si hubo coincidencia o no. Puede devolver `MATCH` o `NOT_MATCH`. Cuando devuelva el valor `NOT_MATCH`, el JSON no tendrá un `matchSummary`. * template: ByteArray del template de imagen en GBDS. * tguid: ID único de la transacción en GBDS. * name: Nombre de la persona. Si no hay información biográfica disponible, este campo puede quedar en blanco. * document: valor de la clave definida en el campo `key`. * key: Clave de la persona en GBDS. * profileImageByteArray: ByteArray de la imagen en GBDS. * score: Puntuación de la coincidencia. * timestamp: Marca de tiempo de la coincidencia. * queryImage: ByteArray de la imagen capturada por FastLine. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.griaule.com/gbs/es/aplicaciones/fastline.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.