feat: TrackedEntity JDBC insert [DHIS2-21378]

[enricocolasante]

Summary

Phase 4a of the Hibernate→JDBC tracker bundle persist migration (DHIS2-21378): replace the Hibernate-driven insert path for TrackedEntity with a JDBC multi-row INSERT, while leaving all
other entity types and TEAVs on EntityManager until their respective phases.

• Pre-allocates primary keys from trackedentityinstance_sequence in a single round-trip (select nextval(seq) from generate_series(1, ?)), and assigns the id to the converted DTO before
  staging so any TEAV/changelog code reading convertedDto.getId() sees the final value.
• Replaces EntityWriteBatch.flush(EntityManager) with flush(EntityManager, Connection). TrackedEntity inserts now go through a chunked multi-row JDBC INSERT (128 rows / statement, 15
  columns including ST_GeomFromText(...,4326) and ::jsonb userinfo); everything else still delegates to em.persist / em.merge.
• Introduces AbstractTrackerPersister.sequenceName() as the per-subclass opt-in: only TrackedEntityPersister returns "trackedentityinstance_sequence"; Enrollment / TrackerEvent /
  SingleEvent / Relationship return null and keep their current behavior.
• Updates getTrackedEntityAttributeValueMap to gate the "load existing TEAVs" JPQL on batch.isStagedAsInsert(te) instead of te.getId() == 0, because pre-allocated ids are no longer a
  reliable transient marker.
• Switches TrackerImportReportTest from H2ControllerIntegrationTestBase to PostgresControllerIntegrationTestBase since ST_GeomFromText and ::jsonb are PostgreSQL-only.

Design notes

• Flush ordering. batch.flush(em, conn) runs JDBC TE inserts first, then em.flush() (TEAVs, other types), then changelog inserts. TEAVs persisted via em.persist reference a TE that
  is not in the persistence context but carries a pre-allocated id; Hibernate writes the FK from te.getId() without managing the TE. Changelog FKs see the TE row because both run on the
  same Spring-bound connection inside one transaction.
• Sequence-name interpolation. sequenceName() is concatenated into the SQL (not bound) because PostgreSQL's nextval takes a regclass. Safe — the value is a hardcoded constant on
  each persister subclass, never user input.
• Defensive guards. bindTrackedEntityRow throws if it encounters a staged TE with id == 0, and assignId throws IllegalStateException for any DTO type the dispatch doesn't yet
  handle — future phases will plug in additional types.

[muilpp]

could we not make this one return null by default and make TrackedEntityPersister override it? this way we would get rid of the boilerplate code in the other persisters

[enricocolasante]

I just changed to be this way because this is the skeleton for next steps.
Every persister will need to implement this, so there will be no null returned in the end

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
3 Accepted issues

Measures
1 Security Hotspot
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud