Integracion entre sistemas
Esta guia resume los componentes tecnicos que enlazan a los distintos productos del ecosistema Avanzia Legal. Incluye arquitectura, servicios compartidos y flujos de despliegue para que los equipos de tecnologia puedan extender o consumir las integraciones disponibles.
Arquitectura general
[Sistemas cliente] -> [API unificada] -> [Servicios compartidos] -> [Bases de datos por sistema]- API unificada: capa expuesta en api.avanzialegal.com que valida tokens y enruta solicitudes.
- Servicios compartidos: autenticacion, almacenamiento de archivos, motor de notificaciones y facturacion.
- Bases de datos: cada sistema mantiene su esquema pero comparte catalogos maestros mediante vistas materializadas.
Patrones de integracion
| Patron | Uso recomendado | Ejemplo |
|---|---|---|
| Sincronizacion por eventos | Datos que requieren consistencia inmediata | Creacion de expedientes entre SIGJUL y SIGEJE |
| Consultas bajo demanda | Informacion de referencia o historica | Buscar jurisprudencia desde SIGJUL en Avanzia Juris |
| Automatizacion programada | Tareas periodicas | Generacion nocturna de reportes ejecutivos |
Servicios compartidos
- Identidad: gestion de usuarios, roles y MFA.
- Documentos: almacenamiento en la nube con versionado y permisos granulares.
- Notificaciones: envio de correos, SMS y mensajes in app.
- Facturacion: administracion de planes, metrica de uso y cobros recurrentes.
Cada sistema consume estos servicios a traves de SDKs internos con manejo de reintentos y monitoreo.
Entornos y despliegues
| Entorno | URL | Objetivo |
|---|---|---|
| Desarrollo | *.dev.avanzialegal.com | Pruebas internas y QA funcional |
| Staging | *.stg.avanzialegal.com | Validacion previa a produccion |
| Produccion | *.avanzialegal.com | Plataformas usadas por los clientes |
Los pipelines de CI/CD ejecutan pruebas automatizadas y validaciones de enlaces antes de promover un cambio. Si se requiere integrar un nuevo servicio, coordina con el equipo de plataforma para registrar dominios y certificados.
Observabilidad
- Logs centralizados en Elastic Stack con retencion de 30 dias.
- Metricas en Prometheus y tableros de Grafana.
- Alertas via PagerDuty para eventos criticos.
Roadmap tecnico
- Exponer webhooks administrables por cliente.
- Incorporar colas de mensajes para procesar eventos de alto volumen.
- Publicar SDK oficial para integraciones externas en TypeScript y Python.
Si necesitas una integracion especifica contacta a soporte tecnico mediante el formulario de Reportar problemas.