2026

Fiado

Verificación facial en vivo para una cooperativa de ahorro y crédito

La verificación dentro de la solicitud de una póliza: consejos antes de empezar y la opción de seguir en el celular.La prueba de vida pide un gesto sorteado por el servidor dentro del óvalo guía.

Simulador de créditos e inversiones. Implementé la verificación de identidad, el traspaso al celular, el registro, el inicio de sesión y la portada.

Año
2026
Contexto
Proyecto académico · Ingeniería Económica para Software, UTA
Equipo
6 personas
Código
Código privado
En línea
fiado-zeta.vercel.app
gestos al azar, sorteados por el servidor
2 de 3
seguir en el celular, en vivo en la computadora
QR + SSE
pruebas unitarias del módulo biométrico
30
puntos faciales para validar cada gesto
68

El sistema

Fiado simula créditos con amortización francesa o alemana, genera tablas en PDF y permite solicitar inversiones a plazo fijo. Para abrir una póliza, la persona debe verificar que es titular de la cédula.

Arquitectura

Arquitectura: FiadoHTTPSHTTPSPortal webNext.js · face-api.jsCelularNext.js · QRAPINestJS · PrismaSesióncookies · scryptBiometríaface-api · WASMTraspaso QRSSE · 10 minSimuladoresPDFPostgreSQLNeon
síncronoasíncrono

Decisiones técnicas

La detección en el navegador sólo guía; decide el servidor. El cliente pide dos gestos al azar, acompaña a la persona con el óvalo y envía un fotograma de frente, uno por gesto y otro de frente al cerrar. El servidor comprueba que todos son la misma persona, que cada gesto se hizo y que el rostro coincide con el de la cédula: una foto o un video grabado de antemano no sirven. Y el reconocimiento está detrás de una interfaz (BiometricProvider): cambiar face-api por un proveedor comercial no toca el resto.

Qué hace

  • Al registrarse, la cuenta existe pero no puede operar hasta que un rostro en vivo coincide con la foto de la cédula. Tras cinco intentos fallidos se bloquea y la desbloquea un administrador.
  • Prueba de vida por reto y respuesta: el servidor sortea dos gestos de tres (girar a la izquierda, a la derecha o sonreír) en una sesión de un solo uso que vence en tres minutos.
  • face-api corre en el backend NestJS sobre WebAssembly, sin GPU ni binarios nativos, y valida cada gesto sobre los 68 puntos faciales del fotograma.
  • La comparación con la cédula usa descriptores faciales de 128 dimensiones. El umbral y los intentos se configuran, y cada intento queda auditado con sus puntajes y el motivo del rechazo.
  • Sin cámara, se sigue en el celular con un QR de diez minutos. La computadora ve en vivo, por Server-Sent Events, en qué paso va el celular y si se cerró (latidos cada dos segundos). Los tokens se guardan como SHA-256.
  • La misma verificación sirve para el registro, la solicitud de una inversión y la recuperación de la contraseña.
  • Registro e inicio de sesión con cookies httpOnly. El refresh token rota en cada renovación y reusar uno ya rotado revoca toda su familia: una cookie robada no sobrevive a su dueño. Contraseñas con scrypt de node:crypto, sin dependencias nativas.
  • La portada muestra una simulación real (sistema francés) y los productos desde la API, con apariciones al desplazar que respetan el movimiento reducido.
  • 30 pruebas unitarias del módulo (las métricas de los gestos y el proveedor con rostros reales) y pruebas e2e de todo el flujo, con un proveedor simulado determinista.

Un reto concreto

Dos caras en una cédula

La primera versión exigía exactamente un rostro por imagen y rechazaba casi todas las cédulas: la ecuatoriana trae, además del retrato, un retrato fantasma más pequeño, y las fotos llegaban a veces giradas. Ahora en la cédula se toma el rostro más grande, se prueba a enderezar la foto si no aparece, y el descriptor sale de un recorte del retrato a resolución completa, no de la imagen reducida. En la selfie, un segundo rostro sólo invalida la captura si es claro y de tamaño parecido al principal: un cuadro en la pared o alguien que pasa al fondo ya no tumban la verificación.

Capturas

Mi parte

El flujo biométrico de punta a punta: el módulo de biometría en NestJS y Prisma (prueba de vida, comparación facial y auditoría de intentos), la confirmación de identidad del registro, el traspaso al celular con QR y Server-Sent Events, y sus pantallas guiadas en Next.js. Además, el registro y el inicio de sesión con rotación de refresh tokens, y la portada del sitio. En un equipo de seis.

AlcanceEl equipo desarrolló los simuladores de crédito e inversión, las tablas de amortización en PDF y el panel de administración.

Stack

  • NestJS
  • Prisma
  • PostgreSQL
  • Next.js
  • TypeScript
  • face-api
  • TensorFlow.js (WASM)
  • Server-Sent Events
  • Vitest
  • Vercel
  • Render
Siguiente proyectoGasoline SystemControl de combustible de una flota, en microservicios