Version: 1.0
Fecha: 24 de Mayo, 2026
Estado: NORMATIVO - Registro de Upgrades del Stack
Arquitecto: Carlos Alberto Torres Camargo
Esta subseccion documenta cada upgrade del stack Simappe que el licenciante entrega al ecosistema Centrica. Cada upgrade incluye cambios en una o varias librerias y servicios del stack base (Simappe), con su correspondiente impacto en los componentes de negocio (Nebula).
El objetivo es mantener trazabilidad cronologica y tecnica de:
Audiencia: Arquitectos, lideres tecnicos y desarrolladores backend que necesitan entender el estado del stack en un momento dado, planificar nuevas entregas o investigar el origen de un comportamiento.
upgrades/
INDICE_UPGRADES.md <- este documento (entrada de la seccion)
HISTORIAL_CAMBIOS.md <- log cronologico unificado (todas las versiones)
stack-YYYY-MM-DD/ <- una carpeta por upgrade
INDICE_STACK_*.md
RESUMEN_EJECUTIVO.md
CAMBIOS_POR_REPOSITORIO.md
MIGRACION_*.md (opcional, segun el upgrade)
BREAKING_CHANGES.md
MEJORAS_NUEVAS.md
ESTRATEGIAS_OPERATIVAS.md
INCIDENTES_RESUELTOS.md
PENDIENTES_POST_UPGRADE.md
Convencion de naming: stack-YYYY-MM-DD/ usando la fecha del cutoff del release branch en el licenciante.
| # | Upgrade | Fecha | Alcance | Estado |
|---|---|---|---|---|
| 1 | stack-2026-05-23 | 23-05-2026 | Migracion multitenant F1-F5 (Commons 3.0.0 -> 4.7.4), bumps SemVer, fix bean kafka, sync simappeconfig env-var-resoluble | INTEGRADO EN DEV |
Para entradas futuras, agregar fila aqui + entrada en
HISTORIAL_CAMBIOS.md+ crear el directoriostack-YYYY-MM-DD/con los documentos del patron.
El log unificado de todos los upgrades vive en HISTORIAL_CAMBIOS.
Permite ver la evolucion del stack sin abrir cada subdirectorio: que version de Commons/Model/Shared estuvo activa en cada periodo, que servicios cambiaron, que features se activaron o desactivaron.
Cuando llegue un nuevo upgrade del licenciante:
stack-YYYY-MM-DD/ con la fecha del release branch del licenciante.INDICE_UPGRADES.md con la nueva version del HISTORIAL DE CAMBIOS al final.| Documento | Ubicacion | Relacion |
|---|---|---|
| Indice Simappe Stack | 03-simappe-stack | Indice de la seccion padre |
| Arquitectura Simappe-Nebula | 03-simappe-stack | Contexto general de la arquitectura sobre la cual aplican los upgrades |
| Configuracion POM de Proyectos | 03-simappe-stack | Versiones de librerias declaradas en los pom |
| Flujo de Arranque Local | 03-simappe-stack/flujos | Procedimiento de arranque que puede cambiar entre upgrades |
| Version | Fecha | Autor | Descripcion |
|---|---|---|---|
| 1.0.0 | 2026-05-24 | Carlos Torres | Creacion de la subseccion upgrades con la primera version documentada (stack-2026-05-23) |