Registro de riesgos y decisiones
La documentacion previa mezclaba hallazgos repetidos con evidencia dispersa. Esta seccion consolida el backlog arquitectonico real de SPPD.
Riesgos priorizados
| Prioridad | Tema | Riesgo | Impacto |
|---|---|---|---|
| P1 | Seguridad | Secretos expuestos en codigo y configuracion | Compromiso de credenciales y acceso no autorizado |
| P1 | Datos | Cambios de esquema no gobernados por ddl-auto | Drift de base de datos y fallas no controladas |
| P1 | Gobierno API | Endpoints sin trazabilidad completa | Integraciones fragiles y deuda tecnica |
| P2 | Operacion | Endpoint de prueba activo en state machine | Ejecuciones indebidas y riesgo operativo |
| P2 | Canal | Propagacion de token no uniforme | Inconsistencia en autorizacion y soporte |
| P3 | Arquitectura | Frontera difusa entre dominio y orquestacion | Mayor acoplamiento y costo de evolucion |
Decisiones recomendadas
Seguridad y plataforma
- Externalizar secretos a una capacidad gestionada.
- Estandarizar manejo de configuracion por ambiente.
- Definir una politica de hardening para pipelines y artefactos.
Dominio y contratos
- Formalizar un contrato por capacidad: folios, aprobaciones, catalogos, reportes y estados.
- Declarar explicitamente que
alpura-sppd-maines el backend de dominio. - Reducir la superficie funcional de state machine a transiciones, validaciones y eventos.
Datos y persistencia
- Separar claramente datos de dominio y datos compartidos.
- Gobernar cambios estructurales con migraciones versionadas.
- Identificar tablas y entidades criticas con ownership tecnico.
Matriz de remediacion
| Horizonte | Acciones |
|---|---|
| Inmediato | Rotar secretos, cerrar endpoint de prueba, documentar endpoints huerfanos |
| Corto plazo | Adoptar migraciones, unificar interceptores y contratos, limpiar configuraciones |
| Mediano plazo | Reforzar modularidad por capacidad y observabilidad transversal |
Criterio de cierre
Un riesgo no se considera atendido solo por estar documentado. Debe contar con:
- responsable,
- accion implementada,
- evidencia de validacion,
- fecha de cierre.
Importante
Los anexos tecnicos conservan el detalle forense. Este registro mantiene solo lo necesario para la toma de decisiones de arquitectura.