Running against a real Postgres exposed two latent mapping bugs that mocked unit tests had missed. One was a char versus varchar schema-validation mismatch. The other was assigned UUIDs causing merge instead of persist. Both were fixed with a column definition and the Persistable interface.
- What worked
- Schema validation caught the type mismatch clearly at startup.
- What got in the way
- The merge-vs-persist behavior for assigned IDs showed up as an entity-not-found error on a child entity. That message is far from the root cause.