Version: 1.0
Fecha: 23 de Mayo, 2026
Estado: NORMATIVO - Detalle de versiones por componente
Arquitecto: Carlos Alberto Torres Camargo
Documento de referencia con el detalle de versiones antes y despues del upgrade, incluyendo commits relevantes y motivo de cada bump. Util para:
| Lib | Antes | Despues | Salto | Motivo principal |
|---|---|---|---|---|
| SimappeCommons | 3.0.0 | 4.7.4 | 4 majors | Migracion multitenant F1-F5 completa: TenantContext, propagacion a Kafka/Async/Scheduling, Mongo per-tenant, audit fields, Hibernate query filter. Mas housekeeping (JWT init via ApplicationRunner, validacion ACTIVE status, UserAuthorities helper, tenant observability autoconfig, propagacion TenantContext). |
| SimappeModel | 3.0.0 | 3.3.0 | 3 minors | DTOs nuevos: Action DTOs, OptionMenuDto.actions, AiQuotaDto, AiProviderConfigDto con flag isDefault y capabilities. |
| SimappeShared | (no existia en uso) | 1.0.2 | introducido | Libreria nueva para clientes Web autoconfigurados entre microservicios (AI Client Gemini como primer caso). Profile centrica agregado al pom para mvn deploy al Nexus del cliente. |
| Servicio | Antes | Despues | Cambios relevantes |
|---|---|---|---|
| SimappeAdmin | 4.5.1 | 4.5.4 | F5-02 AuditLog tenant fields (Mongo per-tenant). Distributed scheduling locks con ShedLock + Redis. Bumps de Commons 4.5.0 -> 4.6.0 -> 4.7.2 -> 4.7.4. Action DTOs + endpoint menu-with-actions. |
| SimappeOauth2Server | 1.4.6 | 1.4.8 | F2 propagacion TenantContext. Bumps de Commons 4.5.0 -> 4.6.0 -> 4.7.4. Refactor profiles (spring.profiles.active default removido del yml base). |
| SimappeGatewayServer | 2.1.4 | 2.1.6 | F2 propagacion TenantContext. Bumps de Commons 4.5.0 -> 4.6.0 -> 4.7.4. Maintenance window scope-aware (customer + company). |
| SimappeClient | 2.3.0 | 2.3.3 | Refactor DB-agnostic (Postgres y Oracle). Hibernate multitenant filter en Client (configurable). Mongo per-tenant en Client. Fix critico: producerFactory renombrado a clientProducerFactory para resolver BeanDefinitionOverrideException contra SimappeCommons.KafkaConfig.producerFactory. |
| Servicio | Version self | Detalle |
|---|---|---|
| SimappeEurekaServer | 1.0.0 (sin cambio) | Rebuild con Spring Boot 3.5.14 / Java 25. Imagen Docker regenerada para coherencia binaria con el resto del stack. |
| SimappeConfigServer | 1.0.0 (sin cambio self) | Rebuild + fix de seguridad del lado del cliente: parametrizacion ${CONFIG_GIT_URI:} / ${CONFIG_GIT_USERNAME:} / ${CONFIG_GIT_PASSWORD:} en application-*.yml (los 5 perfiles). Default vacio. Valores reales se inyectan via env_file: .env del compose del cliente. |
Nota sobre el hot fix de
simappeconfigserver: se aplico directamente en la ramarelease/2026-05-23del cliente con autorizacion explicita del arquitecto, como excepcion a la regla "no cambios locales en repos Simappe del cliente". Pendiente formalizar el cambio en la ramadevelopdel licenciante para que viaje a futuros clientes en la proxima release oficial.
simappeconfig)Cambios aditivos en dev-config/application-common.yml, local-config/application-common.yml, localhost-config/application-common.yml (prod no se toca en este upgrade):
application.security.db-encryption-key: ${DB_ENCRYPTION_KEY:} (env-resoluble, default vacio).server.forward-headers-strategy: ${SERVER_FORWARD_HEADERS_STRATEGY:framework}.spring.main.lazy-initialization: true.spring.threads.virtual.enabled: true.Cambios en archivos de servicio:
simappe-client-*.yml: bloque simappe.notification.* completo (master switch enabled: false, batch/rate-limit/kafka) y simappe.multitenant.mongo.enabled: false.simappe-admin-*.yml: bloque spring.flyway.* activo (schema admin, baseline-version 3.8, validate-on-migrate false).application-{dev,local,localhost}.yml: rename spring.data.redis.pool.* -> spring.data.redis.lettuce.pool.* (Spring Boot 3.x deprecated alias).El config de
prodno se modifica en este upgrade. Los servicios prod siguen usando el config previo hasta una nueva decision de promocion.
nodo-01)| Grupo | Path | Cambio |
|---|---|---|
business/server |
~/docker/compose/business/server/ |
Refactor: cada servicio usa env_file: .env (sin environment hardcoded). .env con APP_PROFILE, SPRING_PROFILES_ACTIVE=common,dev, CONFIG_GIT_* y DB_ENCRYPTION_KEY. |
business/business |
~/docker/compose/business/business/ |
Idem refactor. Para admin y client. |
nebula/cross-cutting |
~/docker/compose/nebula/cross-cutting/ |
Idem refactor. Para nebula-masters. .env adicional incluye TZ y DATABASE_TEMPLATE_NO_SQL (workaround propio del cliente). |
nebula/business-domains/finance |
~/docker/compose/nebula/business-domains/finance/ |
Idem refactor. Para nebula-accounting-core. |
Los archivos docker-compose.yml.bak.refactor-* quedan como backup en cada grupo. Se pueden depurar tras un periodo de estabilidad.
| Repo | Antes | Despues | Tipo de cambio |
|---|---|---|---|
| nebula-commons | 0.0.1-SNAPSHOT | 0.0.1-SNAPSHOT | Sin cambio funcional. Re-deploy al Nexus para registrar la version en la metadata del upgrade. |
| nebula-shared | 0.0.1-SNAPSHOT | 0.0.1-SNAPSHOT | Sin cambio funcional. Re-deploy al Nexus. |
| nebula-models | 0.0.2-SNAPSHOT / 0.0.3-SNAPSHOT | 0.0.3-SNAPSHOT | Bump declarativo simappe-model.version: 3.0.0 -> 3.3.0. Sin cambios de codigo. |
| nebula-masters | 1.0.0-SNAPSHOT | 1.0.0-SNAPSHOT (pom actualizado) | Bumps simappe-commons: 3.0.0 -> 4.7.4 y simappe-model: 3.0.0 -> 3.3.0. Sin cambios de codigo. |
| nebula-accounting-core | 1.0.0-SNAPSHOT | 1.0.0-SNAPSHOT (pom + codigo actualizado) | Bumps de dependencias mas migracion de codigo por breaking changes en Commons 4.7.4 (370 errores de compilacion resueltos a 0). DiferidoComponent refactorizado para cumplir el contrato PageResponseSupport<R, P> (introduccion del segundo type parameter P para el ID, mas dos endpoints expuestos: /get-record canonico y /get-record-detalle con info expandida). |
release/2026-05-23Estado de cada repo en GitLab Centrica tras la integracion en develop:
| Repo | Path GitLab | HEAD release |
|---|---|---|
| SimappeModel | simappe/core/SimappeModel |
bcf98c1 |
| simappecommons | simappe/core/simappecommons |
64b21cb |
| simappeshared | simappe/core/simappeshared |
6407066 |
| simappeeurekaserver | simappe/server/simappeeurekaserver |
033d76c |
| simappeconfigserver | simappe/server/simappeconfigserver |
c83f78e (rebased) |
| simappeoauth2server | simappe/server/simappeoauth2server |
85578dd |
| simappegatewayserver | simappe/server/simappegatewayserver |
c7aff75 (rebased) |
| simappeadmin | simappe/module/simappeadmin |
3f162a4 |
| simappeclient | simappe/module/simappeclient |
07563dc |
| simappeconfig | simappe/config/simappeconfig |
65168f8 (merged a main) |
| nebula-models | nebula/core/nebula-models |
30589fe (en develop como 6854cf2) |
| nebula-masters | nebula/cross-cutting/nebula-masters |
c315ee3 (en develop como da732da) |
| nebula-accounting-core | nebula/business-domains/finance/nebula-accounting-core |
7e791f3 (en develop como 6cdb400) |
Registry: 10.110.0.2:5000 (interno del cliente).
| Imagen | Tag | Servicios |
|---|---|---|
simappe/simappe-eureka-server |
latest |
Eureka Server |
simappe/simappe-config-server |
latest |
Config Server |
simappe/simappe-oauth2-server |
latest |
OAuth2 Server |
simappe/simappe-gateway-server |
latest |
Gateway Server |
simappe/simappe-admin |
latest |
Admin |
simappe/simappe-client |
latest |
Client |
nebula/cross-cutting/nebula-masters |
latest-dev |
Maestros |
nebula/business-domains/finance/nebula-accounting-core |
latest-dev |
Core de contabilidad |
Nota sobre tags: los servicios Simappe usan
:latest, los Nebula usan:latest-dev. Esta convencion la mantiene el cliente; el licenciante respeta el tag definido en eldeploy-centrica-dev.shy eldocker-compose.ymlde cada grupo.
| Artifact | Path Nexus | Versiones publicadas tras el upgrade |
|---|---|---|
| SimappeModel | com/catcsoft/simappe/SimappeModel |
3.0.0, 3.1.1, 3.3.0 |
| SimappeCommons | com/catcsoft/simappe/SimappeCommons |
3.0.2, 3.2.2, 3.3.0, 3.3.1, 4.7.4 |
| SimappeShared | com/catcsoft/simappe/SimappeShared |
1.0.2 (primera entrega) |
| nebula-commons | com/centrica/nebula/nebula-commons |
0.0.1-SNAPSHOT (re-deploy) |
| nebula-shared | com/centrica/nebula/nebula-shared |
0.0.1-SNAPSHOT (re-deploy) |
| nebula-models | com/centrica/nebula/nebula-models |
0.0.2-SNAPSHOT, 0.0.3-SNAPSHOT |
| Version | Fecha | Autor | Descripcion |
|---|---|---|---|
| 1.0.0 | 2026-05-24 | Carlos Torres | Detalle de cambios por repositorio para stack-2026-05-23 |