Integración entre facultades
Esta guía resume los componentes técnicos que enlazan a las distintas facultades del ecosistema Dikaia. Incluye arquitectura, servicios compartidos y flujos de despliegue para que los equipos de tecnología puedan extender o consumir las integraciones disponibles.
Arquitectura general
[Facultades cliente] -> [API unificada] -> [Servicios compartidos] -> [Bases de datos por facultad]- API unificada: capa expuesta en api.dikaia.io que valida tokens y enruta solicitudes.
- Servicios compartidos: autenticación, almacenamiento de archivos, motor de notificaciones y facturación.
- Bases de datos: cada facultad mantiene su esquema pero comparte catálogos maestros mediante vistas materializadas.
Patrones de integración
| Patrón | Uso recomendado | Ejemplo |
|---|---|---|
| Sincronización por eventos | Datos que requieren consistencia inmediata | Creación de expedientes entre ERGON y FORUM |
| Consultas bajo demanda | Información de referencia o histórica | Buscar jurisprudencia desde ERGON en GNOSIS |
| Automatización programada | Tareas periódicas | Generación nocturna de reportes ejecutivos |
Servicios compartidos
- Identidad: gestión de usuarios, roles y MFA (Clerk).
- Documentos: almacenamiento en la nube con versionado y permisos granulares.
- Notificaciones: envío de correos, SMS y mensajes in-app.
- Facturación: administración de planes, métrica de uso y cobros recurrentes.
Cada facultad consume estos servicios a través de SDKs internos con manejo de reintentos y monitoreo.
Mapa de integraciones entre facultades
| Origen | Destino | Integración |
|---|---|---|
| ERGON | FORUM | Derivar sentencia laboral a cobranza ejecutiva |
| ERGON | AXIA | Calcular honorarios vinculados al expediente |
| ERGON | GNOSIS | Buscar jurisprudencia contextual al caso |
| ERGON | SCRIBE | Generar escritos judiciales con datos del expediente |
| PRAXIS | ERGON | Escalar consulta preventiva a litigio laboral |
| PRAXIS | PACT | Generar contratos dentro del flujo de práctica legal |
| FORUM | GNOSIS | Consultar precedentes de cobro ejecutivo |
| AEGIS | SCRIBE | Contestar sumarios MTESS desde hallazgos de auditoría |
| AEGIS | ERGON | Vincular hallazgos laborales a expedientes activos |
| ARGOS | ERGON/FORUM | Sincronizar novedades procesales con expedientes |
| UMBRA | SCRIBE/GNOSIS | Anonimizar documentos antes de procesarlos con IA |
Entornos y despliegues
| Entorno | URL | Objetivo |
|---|---|---|
| Desarrollo | *.dev.dikaia.io | Pruebas internas y QA funcional |
| Staging | *.stg.dikaia.io | Validación previa a producción |
| Producción | *.dikaia.io | 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 retención de 30 días.
- Métricas en Prometheus y tableros de Grafana.
- Alertas vía PagerDuty para eventos críticos.
Roadmap técnico
- 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 integración específica contacta a soporte técnico mediante el formulario de Reportar problemas.