Integraciones y datos
Esta vista unifica lo que antes estaba fragmentado entre endpoints, evidencias, mapeos frontend-backend y tablas de base de datos.
Ciclo operativo
Integraciones clave
| Categoria | Proposito | Ejemplos identificados |
|---|---|---|
| Identidad | Autenticacion y obtencion de llaves | Keycloak realm Alpura |
| Catalogos | Datos maestros para operacion comercial | Catalogos de ventas, cuentas y clasificaciones |
| Integracion empresarial | Consulta o publicacion a servicios corporativos | APIs expuestas via gateway Alpura |
| Documental y notificaciones | Soporte a adjuntos y avisos | Servicios documentales y correo |
| Procesamiento asincrono | Desacoplar transiciones criticas | Pub/Sub y state machine |
Dominios de datos
| Dominio | Descripcion | Sistemas relacionados |
|---|---|---|
| Folios | Entidad central de operacion y seguimiento | Frontend, alpura-sppd-main |
| Promociones | Reglas, productos, familias y presentaciones | Frontend, alpura-sppd-main |
| Aprobaciones | Autorizadores, reemplazos e historico | Frontend, alpura-sppd-main |
| Estados | Transacciones, eventos y estatus | alpura-sppd-statemachine-main |
| Catalogos | Datos de referencia para captura y validacion | APIs corporativas + backend principal |
- Persistencia
- Contratos
- Riesgos de integracion
| Microservicio | Bases relevantes | Observacion |
|---|---|---|
alpura-sppd-main | alpurasppd, omnicanal | Mezcla dominio propio con consultas compartidas |
alpura-sppd-statemachine-main | maquina_estados, omnicanal | Especializado en transiciones y consulta operativa |
- El frontend conversa principalmente con
/spd/v1y/ssm/v1. - Existen operaciones confirmadas por codigo, pero varias siguen sin backend localizado.
- El HLD recomienda formalizar un catalogo de contratos por capacidad y no por archivo fuente.
| Riesgo | Impacto |
|---|---|
| Endpoints no trazados | Drift entre canal y backend |
| Contratos duplicados por feature | Mayor costo de cambio |
| Integraciones sin clasificacion | Baja gobernabilidad tecnica |
| Dependencias mezcladas con datos de ambiente | Mayor riesgo operativo |
Reglas de organizacion documental
- Integraciones externas se documentan por capacidad.
- Persistencia se resume por dominio y no por listado de tabla sin contexto.
- La trazabilidad detallada se conserva en anexos tecnicos.
- El inventario exhaustivo de endpoints no forma parte de la historia HLD principal.