Case Study / Post-Mortem

BioLink: A Post-Mortem on Biometric Infrastructure.

La anatomía de un sistema biométrico B2B. De un procesador de pagos a una plataforma de fidelización, y por qué el proyecto se pausó con el código de producción terminado.

Estado
Pausado
Backend
Completo, listo para producción
Repositorios
Buyer · Vendor · Admin · API
Causa de la pausa
Runway, no tecnología

01 / The Stack & Architecture

El desafío técnico.

Un sistema que identifica personas por el rostro y mueve saldo en una caja física no tiene margen para "casi correcto". Estas son las tres garantías sobre las que se construyó todo lo demás.

Stack

Node.jsRuntime de todos los servicios
TypeScriptContratos tipados entre Gateway y servicios
PostgreSQL (Aurora)Ledger de puntos con transacciones ACID
RedisLocks distribuidos y claves de idempotencia
AWS RekognitionVerificación facial, sin almacenamiento propio
fig. 1 — topología de requests
  1. Clientes

    Buyer App

    Usuario final

    Vendor / POS

    Caja del comercio

    Admin Panel

    Operación interna

    HTTPS · único punto público
  2. Edge

    Gateway API

    Autentica, resuelve el dominio de identidad y firma cada request interno con HMAC-SHA256.

    Red privada · request firmado + timestamp
  3. Servicios internos

    Identidad

    Dominios separados: Admin · Usuario · POS

    Puntos

    Commit exactly-once

    Biometría

    Verificación fail-closed

    Acceso solo desde servicios
  4. Datos y proveedores

    Aurora PostgreSQL

    ACID

    Redis

    Locks · idempotencia

    AWS Rekognition

    Sin persistir imágenes

HitoGarantíaRiesgo que elimina
Hito 1Zero-Trust & HMACUn servicio interno alcanzable o un request falsificado dentro de la red.
Hito 2Exactly-once CommitDoble gasto de puntos en la caja por reintentos, red inestable o doble tap.
Hito 3Privacy-by-designUna base de datos propia con rostros o templates biométricos es un pasivo permanente.
Hito 1

Zero-Trust & HMAC

El único punto expuesto es el Gateway API. Cada request que reenvía a un servicio interno va firmado con HMAC-SHA256; ningún servicio confía en la red, solo en la firma. Admin, Usuario y POS son dominios de identidad separados: un token de un dominio no sirve en otro.

gateway/sign.tsilustrativo
// Gateway → servicio interno
const ts = Date.now().toString();
const payload = [method, path, ts, sha256(body)].join('\n');

const signature = createHmac('sha256', INTERNAL_SECRET)
  .update(payload)
  .digest('hex');

headers['x-biolink-ts'] = ts;
headers['x-biolink-signature'] = signature;

// Servicio interno: compara en tiempo constante y
// rechaza si la firma no coincide o el ts está fuera de ventana.
Hito 2

Exactly-once Commit

Tres capas en serie: idempotencia HTTP para que un reintento devuelva la misma respuesta, un lock distribuido en Redis por billetera para serializar operaciones concurrentes, y una transacción ACID en Postgres como fuente de verdad del saldo.

points/commit.flowilustrativo
POST /points/commit
Idempotency-Key: 7f3c9a…

1  GET  idem:{key}                 → existe: devolver respuesta guardada
2  SET  lock:{wallet} NX PX 5000   → ocupado: 409 Conflict
3  BEGIN;
     SELECT balance FROM wallets WHERE id = $1 FOR UPDATE;
     INSERT INTO ledger (wallet_id, delta, idem_key) VALUES (...);
     UPDATE wallets SET balance = balance - $2 WHERE id = $1;
   COMMIT;
4  SET  idem:{key} = response
5  DEL  lock:{wallet}
Hito 3

Privacy-by-design

La verificación se delega a AWS Rekognition. El frame vive solo en memoria durante la llamada; no se guardan imágenes ni templates en bases de datos propias. Ante cualquier error, timeout o score insuficiente, el resultado es "no match": fail-closed.

biometrics/verify.tsilustrativo
// El frame nunca se escribe en disco ni en DB.
async function verify(frame: Buffer, userId: string) {
  try {
    const { FaceMatches } = await rekognition.searchFacesByImage({
      CollectionId,
      Image: { Bytes: frame },
      FaceMatchThreshold: THRESHOLD,
      MaxFaces: 1,
    });
    return FaceMatches?.[0]?.Face?.ExternalImageId === userId;
  } catch {
    return false; // fail-closed
  }
}

02 / The Business

El producto no son los pagos, es la biometría.

La tecnología funcionaba. El modelo de negocio, tal como estaba planteado, no era viable para un equipo sin capital. Lo que sigue es cómo lo entendimos y qué cambiamos.

  1. 01

    Flash

    La visión original: un rail de pagos biométricos. El usuario paga en la caja del comercio con su rostro, sin tarjeta ni teléfono.

  2. 02

    Choque con la regulación

    Reuniones con mentores clave del ecosistema de startups y directivos bancarios. Operar pagos exigía licencia de Institución Emisora de Dinero Electrónico (IEDE) ante el Banco Central, auditorías pesadas y un capital que no teníamos.

  3. 03

    BioLink

    Renombramos el proyecto a BioLink, el enlace biométrico. Pivotamos de BioPagos a BioPuntos.

“Están construyendo el cambio del siglo, pero en rueditas.”
El consejo que cambió el rumbo

El pivoteo

Mismo flujo de hardware en la caja del comercio, pero esquivando la regulación financiera. En lugar de competir como medio de pago, el foco pasó a construir el hábito del usuario y la retención para el cliente B2B.

FlashBioLink
ProductoBioPagosBioPuntos
Qué mueveDineroPuntos de fidelización
Requisito de entradaLicencia IEDE, auditorías, capital inmensoFuera de la regulación financiera
Hardware en cajaTerminal biométrica en el comercioMismo flujo, mismo hardware
Valor para el cliente B2BMedio de cobroHábito del usuario y retención

03 / The Reality

La trampa del Runway.

El backend estaba completado. Los repositorios estaban listos para producción, con un nivel de madurez bancaria. Aun así, el proyecto se pausó.

Levantar una startup de infraestructura con hardware físico requiere pista: meses de instalación en comercios, iteración en caja y ventas B2B de ciclo largo antes de ver ingresos.

Con uno de los fundadores sin empleo y el otro sosteniendo el proyecto con un sueldo de 30.000 pesos uruguayos, la decisión madura fue frenar.

No fue un fallo técnico ni de visión. Fue una falta de oxígeno financiero.

  • buyer

    App del usuario final

    production-ready

  • vendor

    App de caja / POS

    production-ready

  • admin

    Panel de operación

    production-ready

  • api

    Gateway y servicios

    production-ready

postmortem.yml
incident:        project_paused
status:          resolved — paused by decision

backend:         complete
repositories:    buyer, vendor, admin, api  → production-ready
security_bar:    banking-grade

technical_failure:  false
vision_failure:     false

root_cause:      runway
  founder_a:     sin empleo
  founder_b:     sueldo de UYU 30.000, sosteniendo el proyecto
  requirement:   infraestructura + hardware físico → pista larga

decision:        pausar