Persistencia (Hibernate / JPA)¶

Cómo persiste el backend: provider, dialecto propio, modo de flush, naming strategy y administración del DDL. Todo está configurado en application.yml y en com.tipre.tifacturaonlinemanager.action.db.SQLServerDialect + config.SeamCompatConfig. Para las entidades concretas ver Modelo de dominio; para por qué el flush es MANUAL, Invariantes.

De un vistazo¶

Dialecto propio: SQLServerDialect¶

action/db/SQLServerDialect.java extiende org.hibernate.dialect.SQLServerDialect (el de Hibernate, ya version-aware) y solo sobreescribe el mapeo de BOOLEAN:

public class SQLServerDialect extends org.hibernate.dialect.SQLServerDialect {
    @Override
    protected String columnType(int sqlTypeCode) {
        if (sqlTypeCode == SqlTypes.BOOLEAN) {
            return "bit";
        }
        return super.columnType(sqlTypeCode);
    }
}

Es un port del legacy (SPEC-002): el legacy registraba BOOLEAN -> "bit" para que los boolean del modelo (p. ej. EnteFacturador.habilitado, los flags de TipoComprobante) mapeen a columnas bit de SQL Server.

DDL administrado por el cliente¶

spring.jpa.hibernate.ddl-auto: none. El esquema lo administra el cliente, la app NO lo genera ni lo altera. Esta es una invariante explícita en application.yml.

Las tablas nuevas que introdujo la migración (no del legacy) se versionan como scripts SQL en src/main/resources/db/migration/ para que el cliente los aplique a mano (no es Flyway/Liquibase automático — son scripts de referencia):

• add-JobEjecucion.sql — tabla JobEjecucion.
• add-TrxErrorLog.sql — tabla TrxErrorLog.
• add-TrxErrorLog-mensajeCurado.sql — columna mensajeCurado en TrxErrorLog (mensaje humano del error curado). Orden de deploy sagrado: correr el script ANTES de subir el jar que la mapea; con la columna ausente Hibernate rompe al insertar/leer TrxErrorLog.
• add-cert-EntesFacturadores.sql — columnas certP12* en EntesFacturadores.
• add-EntesFacturadores-cuit-unique.sql — índice UQ_EntesFacturadores_cuit en EntesFacturadores(cuit), UNIQUE filtrado (WHERE cuit IS NOT NULL). El POS v2 identifica su comercio por CUIT, así que debe ser 1:1. Prerequisito: no puede haber CUIT duplicados antes de correrlo.
• add-validadoArca-SucPosPV.sql, add-unique-indexes-SucPosPV.sql, add-PV-validacion-obtencion-SucPosPV.sql — columnas/índices de SucPosPV.
• add-Trx-hot-query-indexes.sql — 4 índices NONCLUSTERED de soporte sobre Trx (2 filtrados) para las queries calientes: reconciliación de NC, dedup CAEA del notificador y el snapshot 5-min del cockpit. Ver detalle abajo.
• add-CockpitStat.sql, add-Trx-*.sql, schedule-nc-job.sql, cleanup-parametros-legacy.sql, drop-tablas-sin-uso.sql, verify-cae-caea-nc.sql.

Índices calientes de Trx (add-Trx-hot-query-indexes.sql)¶

Son puro soporte de lectura (no cambian datos ni constraints) para las queries calientes que ningún índice previo podía seekear: la reconciliación de NC (NotaCreditoReconciliacionService), el dedup CAEA del notificador (CaeaNotificacionService.findExistingCaea) y el snapshot 5-min del cockpit. Sin ellos, cada corrida diaria de reconciliación y cada dedup CAEA escanean el clustered completo del histórico Trx (minutos con años de datos).

Naming strategy¶

spring.jpa.hibernate.naming.physical-strategy: org.hibernate.boot.model.naming.PhysicalNamingStrategyStandardImpl.

La estrategia estándar respeta @Table/@Column tal cual: nombres literales en PascalCase, sin convertir a snake_case. Es el comportamiento del Hibernate 4 del legacy. Por eso las entidades pueden mapear tablas como EntesFacturadores, TiposComprobante, Caeas o columnas como idEnteFacturador y fFechaUltObtencionPOS sin transformación.

Flush MANUAL¶

El bean entityManager que usa el seam-compat se crea en SeamCompatConfig como shared entity manager y se le fija FlushModeType.COMMIT:

@Bean(name = "entityManager")
public EntityManager seamEntityManager(EntityManagerFactory emf) {
    EntityManager em = SharedEntityManagerCreator.createSharedEntityManager(emf);
    try { em.setFlushMode(FlushModeType.COMMIT); } catch (Exception ignored) {} // INVARIANTE 5.1 (MANUAL ~ COMMIT)
    return em;
}

Esto replica el default-flush-mode=MANUAL del components.xml legacy. En JPA no existe un MANUAL puro; COMMIT es el equivalente más cercano: Hibernate no auto-flushea antes de cada query, solo al commit de la transacción (o cuando se llama a flush() explícitamente).

Por eso el código de negocio hace flush() a mano donde necesita que algo pegue en la DB. El EntityHome del shim lo hace en persist()/update()/remove():

// org/jboss/seam/framework/EntityHome.java
getEntityManager().flush();   // INVARIANTE: flush explícito (modo MANUAL)
...
getEntityManager().flush();   // INVARIANTE 5.2: SOLO flush, sin merge

Otros puntos con flush() explícito: SucPosPVAdminService (backstop para que una violación de UQ salte en el flush y no en el commit), CaeaConsultaService, CockpitStatSnapshot, TrxNextGenPersistHelper.

Driver y datasource¶

Driver mssql-jdbc 12.8.1.jre11 (scope runtime; inerte en tests, que usan H2). La URL JDBC incluye encrypt=true;trustServerCertificate=true en dev y prod:

jdbc:sqlserver://<host>:<port>;databaseName=<db>;encrypt=true;trustServerCertificate=true

Detalle de hosts/credenciales por perfil y variables de entorno en Config y perfiles.

Cache de segundo nivel¶

Por dónde seguir¶

• Modelo de dominio — entidades y sus tablas.
• Config y perfiles — datasource por perfil y env vars.
• Invariantes — flush, idempotencia, lookup.