Resumen ejecutivo
- SPPD opera como una solucion distribuida con un microfrontend Angular, un backend de dominio y un backend especializado en maquina de estados.
- La plataforma soporta captura de folios, promociones, aprobaciones, estados, trazabilidad e integracion con servicios corporativos.
- La reestructuracion documental separa el HLD de los anexos tecnicos para que la lectura deje de estar dominada por listados sin contexto.
- La prioridad arquitectonica actual es estabilizar seguridad, contratos de integracion y gobierno de persistencia.
Diagnostico de arquitectura
| Dimension | Estado actual | Lectura ejecutiva |
|---|---|---|
| Canal digital | Funcional, pero extenso y heterogeneo | Requiere modularidad por capacidad |
| API de negocio | Concentrada en alpura-sppd-main | Debe afirmarse como backend de dominio |
| Orquestacion | Aislada en state machine | Buena direccion, requiere frontera mas explicita |
| Integraciones | Amplias y parcialmente dispersas | Necesitan contrato y catalogo priorizado |
| Datos | Repartidos entre varias bases | Requieren gobierno y ownership |
| Seguridad | Riesgos criticos identificados | Necesita remediacion inmediata |
Hallazgos mas importantes
- Existen secretos y configuraciones sensibles en codigo y archivos de ambiente.
- Hay operaciones frontend sin backend claramente localizado.
- El uso de
ddl-auto: updateen ambientes altos introduce riesgo de drift. - La documentacion previa mezclaba HLD con evidencia forense, dificultando la toma de decisiones.
Norte arquitectonico
| Tema | Decision recomendada |
|---|---|
| Estructura documental | Mantener HLD corto y mover detalle a anexos |
| Backend | Separar dominio y orquestacion de forma mas estricta |
| Seguridad | Externalizar secretos y estandarizar autenticacion |
| Datos | Controlar cambios con migraciones y ownership claro |
| Integraciones | Documentar contratos por capacidad |