merge: integrate JPA production capability

# Conflicts:
#	.github/ci-gate-matrix.yml
#	.github/scripts/verify-gate-matrix.sh
#	.github/workflows/ci-quality-gates.yml
#	src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/transaction/SpringTransactionPort.java
This commit is contained in:
donghyeon-ka
2026-07-31 23:57:29 +09:00
142 changed files with 13206 additions and 325 deletions
@@ -8,7 +8,9 @@ package dev.caskeleton.shared.error;
* log only.
*
* <p>See the module README for the leak-prevention contract (SQLState / SQL / exception class never
* reach the client) and why it lives in {@code shared.error}.
* reach the client) and why it lives in {@code shared.error}. Observation adapters must never log
* or trace this carrier directly because its cause can contain SQL values, constraints,
* credentials, and endpoints; they emit a cause-free event containing only {@link #errorCode()}.
*/
public class PersistenceFailureException extends RuntimeException implements ApiErrorCarrier {
@@ -18,9 +20,8 @@ public class PersistenceFailureException extends RuntimeException implements Api
/**
* @param errorCode the classified, client-facing code (a {@code DB_*} {@link OperationalError})
* @param diagnosticMessage server-log-only detail (may name the SQLState) — never surfaced to the
* client by the web adapter
* @param cause the raw persistence exception, kept for the server log
* @param diagnosticMessage internal classification detail — never surfaced to the client
* @param cause the raw persistence exception for in-process classification/reconciliation only
*/
public PersistenceFailureException(
ApiErrorCode errorCode, String diagnosticMessage, Throwable cause) {