JP Sámano

← Todo el trabajo

Verifaid

¿Quién puede firmar legalmente y con qué límites? Verifaid lee documentos societarios y poderes, cita la página exacta y deja la aprobación a un segundo revisor.

Rol
Desarrollador principal, LegalShelf
Periodo
jul 2026 – presente
Estado
Piloto controlado
Verifaid
  • Interfaz
  • Servicios
  • Datos y evidencia
  • Revisión humana

API de expedientes Python / FastAPI

Autenticar a quien llama y aplicar el alcance de la organización. La facultad para aprobar se concede explícitamente, sin inferirla de una cabecera.

Arquitectura lógica ilustrada. Selecciona un componente; las rutas animadas representan conexiones, no tráfico en vivo.

  • Python
  • FastAPI
  • PostgreSQL
  • Next.js
  • React
operaciones resueltas
50+
etapas del pipeline
7
commits en seis semanas
262
pruebas automatizadas
596

Cifras del piloto y referencia de pruebas: 11 de septiembre de 2026. Implementación revisada hasta el 14 de septiembre; estado revisado el 20 de octubre.

Cómo se conecta el sistema

  • Interfaz
  • Servicios
  • Datos y evidencia
  • Revisión humana

API de expedientes Python / FastAPI

Autenticar a quien llama y aplicar el alcance de la organización. La facultad para aprobar se concede explícitamente, sin inferirla de una cabecera.

Arquitectura lógica ilustrada. Selecciona un componente; las rutas animadas representan conexiones, no tráfico en vivo.

Problema

Antes de dispersar un crédito, los abogados leen los documentos corporativos del acreditado para confirmar que quien firma realmente tiene facultades para hacerlo, y hasta qué monto. Es lento, depende de quién lo lea y el razonamiento rara vez queda escrito de forma que otra persona pueda verificarlo.

Restricciones

  • El sistema puede recomendar, pero una persona identificada debe aprobar cada conclusión.
  • Nada puede afirmarse sin citar documento, versión, página y fragmento.
  • Solo datos sintéticos hasta superar una compuerta de datos reales; los originales se conservan intactos.
  • Los datos de cada organización cliente deben aislarse a nivel de base de datos.

Decisiones

  1. Citas antes que conclusiones

    Cada dato extraído lleva su fuente, y el visor de citas abre la página real con el fragmento resaltado. Una página citada vale más que un puntaje de confianza.

  2. Leer como lo haría un abogado

    Los límites se leen de la propia cláusula, incluidos los montos escritos con letra, y los apoderados se leen de la cláusula de nombramiento. El catálogo de facultades sigue el Código Civil.

  3. Aislamiento en la base de datos, aprobación como facultad otorgada

    La seguridad a nivel de fila en PostgreSQL aísla a cada organización, la API autentica a quien llama en lugar de confiar en un encabezado, y el derecho a aprobar se otorga explícitamente en vez de heredarse de un rol.

Resultado

Verifaid entrega una decisión, no un reporte: si la firma puede proceder, por qué no y quién tiene las facultades para firmar. Ha resuelto más de 50 operaciones para un cliente de pago. En seis semanas la plataforma pasó de un repositorio vacío a un piloto controlado: un pipeline de siete etapas, un visor de citas y una aprobación humana trazable donde cada revisión conserva su justificación y requiere una segunda persona. La implementación posterior añadió emisión de dictámenes aprobados en PDF con responsable, versión y huella, además de recuperación de lecturas fallidas. Emitir un PDF es distinto de liberar firma electrónica; las compuertas de datos reales y firma siguen explícitas.

Evidencia

  • Más de 50 operaciones resueltas para un cliente de pago.
  • 262 commits y 85 pull requests fusionados entre el 29 de julio y el 11 de septiembre de 2026.
  • 311 pruebas de API (52 de aislamiento entre organizaciones) y 285 pruebas web en la última corrida correcta.
  • Código privado bajo los términos de confidencialidad del cliente; puedo mostrarlo en una llamada.

Tecnologías

Python · FastAPI · PostgreSQL · Next.js · React · TypeScript · Claude API · Cloudflare R2 · Render · Vercel