Version: 1.0
Fecha: 23 de Mayo, 2026
Estado: NORMATIVO - Upgrade integrado en ambiente DEV de Centrica
Arquitecto: Carlos Alberto Torres Camargo
| Aspecto | Valor |
|---|---|
| Fecha integracion DEV | 2026-05-23 |
| Tipo | MAYOR (cambio arquitectonico) |
| Repos Simappe afectados | 9 (Commons, Model, Shared, Admin, Oauth2, Gateway, Client, EurekaServer, ConfigServer) |
| Repos Nebula afectados | 3 (nebula-models, nebula-masters, nebula-accounting-core) |
| Configuracion (simappeconfig) | si — nuevas propiedades en application-common.yml (dev/local/localhost) |
| Compose del cliente | si — refactorizado a patron env_file: .env por grupo |
| Branch tag licenciante | release/2026-05-23 + tag stack-2026-05-23 |
| Branch destino cliente | develop (excepto simappeconfig que va a main) |
| # | Documento | Descripcion | Cuando consultar |
|---|---|---|---|
| 1 | Resumen Ejecutivo | Vision alto nivel: que entrego este upgrade, por que, impacto, decisiones clave | Primera lectura para cualquier rol |
| 2 | Cambios por Repositorio | Tabla con version antes -> despues, commits relevantes y razon, por cada repo del stack y Nebula | Cuando se quiere saber que cambio en un componente especifico |
| 3 | Migracion Multitenant F1-F5 | Detalle tecnico de las fases F1-F5 del programa multitenant que se incorporaron a Commons 4.7.4 | Cuando se planifique activar multitenant en Centrica o entender la arquitectura tenant-aware |
| 4 | Breaking Changes y Deprecados | APIs incompatibles, clases removidas, propiedades renombradas; con guia de migracion para consumidores | Cuando una rebuild rompe y se necesita identificar el cambio que la origina |
| 5 | Mejoras y Nuevas Features | Funcionalidades nuevas (cifrado JPA at-rest, Flyway en Admin, servicio de notificaciones, etc.) | Cuando se quiera explotar capacidades nuevas o decidir activacion |
| 6 | Estrategias Operativas | Patrones operativos del upgrade: .env por grupo, SPRING_PROFILES_ACTIVE=common,<profile>, activacion gradual de multitenant, manejo de secretos |
Antes de hacer un deploy o ajustar el compose en otro nodo |
| 7 | Incidentes Resueltos | Bugs identificados durante la integracion del upgrade y como se resolvieron (con causa raiz documentada) | Cuando se vea un sintoma parecido en futuras integraciones |
| 8 | Pendientes Post-Upgrade | Items detectados que no son criticos pero merecen atencion en proximos sprints (warnings Hibernate, rotaciones de keys, etc.) | Al planificar trabajo de mejora continua |
Lectura completa (~45 min):
Para diagnosticar un fallo en runtime:
Para planificar activacion de multitenant en Centrica:
| Documento | Ubicacion | Relacion |
|---|---|---|
| Indice Upgrades | upgrades/ | Indice padre |
| Historial Cronologico | upgrades/ | Posicion de este upgrade en la linea temporal |
| Arquitectura Simappe-Nebula | 03-simappe-stack | Contexto del stack |
| Configuracion POM de Proyectos | 03-simappe-stack | Mapa de versiones de librerias |
| Version | Fecha | Autor | Descripcion |
|---|---|---|---|
| 1.0.0 | 2026-05-24 | Carlos Torres | Creacion del indice del upgrade stack-2026-05-23 |