graph-vl
Capa de verificación de identidad auto-alojada con GraphQL desarrollada por VerifID. Utiliza Python/FastAPI, PostgreSQL y Redis para validar documentos oficiales como pasaportes o DNI mediante flujo de 4 pasos: registro, selfie, documento y verificación.
Ficha actualizada 18 sept 2026, 21:06 · upstream 29 oct 2025, 7:06 · release 0.1.0
Qué es graph-vl
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
graph-vl es la capa de verificación de identidad del proyecto VerifID, construida con GraphQL. Funciona como API auto-alojada especializada en verificar tarjetas de identidad o pasaportes, complementando al núcleo principal VL. El sistema se ejecuta como contenedor Docker o Kubernetes y documenta todos sus endpoints mediante GraphiQL.
Para el almacenamiento utiliza PostgreSQL como base de datos relacional con SQLAlchemy como ORM, manteniendo una estructura simplificada con dos tablas principales. El flujo de verificación consta de cuatro pasos: creación de usuario con datos personales, subida de selfie, fotografía del documento oficial y llamada al endpoint verify para obtener resultados.
El proyecto depende de módulos Python open source y VerifID, requiriendo Python 3.6+ (versión obsoleta), PostgreSQL y las dependencias listadas en requirements.txt. Soporta despliegue en clúster Kubernetes mediante archivos YAML predefinidos para deployment y servicios.
- Verificación de identidad digital para usuarios finales mediante autenticación biométrica y documental
- Integración con sistemas legacy que requieren validación de documentos oficiales europeos
- Auditoría de identidad en plataformas fintech o banca online auto-alojadas
- Validación de pasaportes y DNI europeo en entornos controlados sin proveedores externos
- Arquitectura GraphQL con endpoints documentados en GraphiQL para consultas y mutaciones claras
- Soporte nativo para despliegue en Docker y Kubernetes con archivos de configuración YAML
- Base de datos PostgreSQL simplificada con SQLAlchemy, reduciendo complejidad de esquema
- Flujo de verificación estandarizado en 4 pasos: registro, selfie, documento y validación
- Dependencia de Python 3.6+ (versión obsoleta desde 2021), incompatible con entornos modernos
- Ausencia de autenticación OAuth2 explícita en el README, requiriendo implementación manual
- Falta de soporte nativo para documentos no europeos o formatos específicos
- Configuración manual obligatoria de variables de entorno PostgreSQL sin validación automática
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Requiere instancia PostgreSQL externa (puerto 5432) con credenciales configuradas. Construir imagen Docker con argumentos PG_SERVER, PG_USER, PG_PASSWORD y PG_DB. Ejecutar en puerto 8000 mapeado. Para Kubernetes usar deployment-postgres.yml y deployment-graphvl.yml con servicios correspondientes. Validar compatibilidad de Python antes de producción.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.