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


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
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
Paso 1: la foto de la cédula, con qué hacer y qué evitar, y el consentimiento para los datos biométricos. Prueba de vida: el servidor pidió girar la cabeza a la izquierda. El rostro va difuminado a propósito. Identidad confirmada: la cuenta ya puede operar. La verificación dentro de la solicitud de una póliza: consejos antes de empezar y la opción de seguir en el celular. Verificación superada, con la concordancia con la cédula. La portada: una simulación real de crédito y el sello de identidad verificada.
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
