문제: High·P1을 고친 뒤에도 P2·P3 약 90건이 남았다. 연결·구독·메시지 크기 상한이 없는 전송(WebSocket·gRPC·GraphQL deadline), 낙관적 충돌의 500, upsert 경쟁, Mongo 무제한 timeout, 샘플 목록 N+1, 갈라진 복사본 (TenantId 3벌, 이벤트 ID 문법 5곳, SQLState 표 2벌), 문서를 읽는 PR 테스트와 캐시를 막는 lane 설정 등이다. 새 기능을 어디에 어떤 순서로 만드는지 알려 주는 문서와 도구가 없었다. MinIO 공식 이미지가 사라져 객체 저장소 lane이 돌지 않았다. 방법: 영역별 묶음으로 실패 테스트를 먼저 쓰고 고쳤다. 고치는 중에 찾은 결함도 함께 고쳤다(durable operation id가 UUIDv4라 이벤트가 전부 DEAD, S3 어댑터 생성·작은 chunk 읽기 실패, Redis 조건부 기록의 EVALSHA 권한). MinIO는 pgsty/minio를 digest로 고정했다(Chainguard는 태그·실행 사용자· mc 이미지 문제로 버림). docs/manual/에 작업 순서와 판단 지점을 쓰고, scripts/new-feature.sh가 5개 leaf에 뼈대를 만든다. 생성→빌드→통과 왕복을 verifyFeatureScaffold가 mainCheck에서 본다. 묶음별 결과와 결정은 리뷰 README 14절에 있다. 위험·한계: 파생 서비스 동작이 바뀐다. JDBC batch 50 기본, 운영 jar에서 H2 제거, 트랜잭션 30초 제한, 격리 수준을 Hikari에서 고정, gRPC· WebSocket·GraphQL 새 한도, correlation ID 규칙 밖이면 서버가 교체, 샘플 키 오류 코드 IDEMPOTENCY_KEY_INVALID. 새 leaf 두 개 (composition:durable-operation, adapter:inbound:messaging)와 새 마이그레이션(postgresql V20·V21, notification V11·V12, sample V8_1, grpc-ledger V002)이 생긴다. V21 유일 인덱스는 기존 중복이 있으면 실패한다(runbook에 확인 쿼리). 검증: ci, mainCheck(생성 명령 왕복 포함), integrationCheck(MinIO 포함 전 컨테이너 lane), -p optional-platforms ci integrationCheck 통과. Refs: docs/reviews/2026-11-01-maturity-review/README.md 14절 BREAKING CHANGE: JDBC batch 기본 켜짐, H2 운영 의존 제거, 트랜잭션 기본 제한 30초, gRPC·WebSocket·GraphQL 서버 한도 기본값 추가, 샘플 Idempotency-Key 오류 코드 변경.
174 lines
13 KiB
Plaintext
174 lines
13 KiB
Plaintext
# JPA persistence leaf public API surface — every public top-level type in src/main/java.
|
|
# A public type in a single-jar leaf is reachable from every adopter's code, so
|
|
# additions are reviewed rather than discovered. `api` is the intended external
|
|
# surface; the rest is implementation that has not been moved under an internal
|
|
# root yet.
|
|
# Update only after review with:
|
|
# ./gradlew :adapter:outbound:persistence-jpa:updateJpaApiSurface -PapproveJpaApiSurfaceChange
|
|
# types: 165
|
|
dev.caskeleton.adapter.outbound.persistence.api.PersistenceOperationName
|
|
dev.caskeleton.adapter.outbound.persistence.api.capability.CapabilitySupport
|
|
dev.caskeleton.adapter.outbound.persistence.api.capability.JpaCapability
|
|
dev.caskeleton.adapter.outbound.persistence.api.capability.SupportLevel
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.CheckConstraintViolationException
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.ConnectionUnavailableException
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.ConstraintCode
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.ConstraintViolationDetails
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.DataCorruptionException
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.DeadlockDetectedException
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.FailureCategory
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.ForeignKeyViolationException
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.JpaEntityNotFoundException
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.JpaFailureContext
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.JpaPersistenceException
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.NotNullConstraintViolationException
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.OptimisticConflictException
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.PessimisticLockTimeoutException
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.QueryTimeoutException
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.SchemaMismatchException
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.SerializationFailureException
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.SqlExceptionSqlStateResolver
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.TransactionCompletionUnknownException
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.TransactionTimeoutException
|
|
dev.caskeleton.adapter.outbound.persistence.api.error.UniqueConstraintViolationException
|
|
dev.caskeleton.adapter.outbound.persistence.api.query.CursorPayloadCodec
|
|
dev.caskeleton.adapter.outbound.persistence.api.query.KeysetPageRequest
|
|
dev.caskeleton.adapter.outbound.persistence.api.query.KeysetSlice
|
|
dev.caskeleton.adapter.outbound.persistence.api.query.NoopQueryObservation
|
|
dev.caskeleton.adapter.outbound.persistence.api.query.QueryName
|
|
dev.caskeleton.adapter.outbound.persistence.api.query.QueryObservation
|
|
dev.caskeleton.adapter.outbound.persistence.api.query.QueryScope
|
|
dev.caskeleton.adapter.outbound.persistence.api.query.SignedJsonCursorCodec
|
|
dev.caskeleton.adapter.outbound.persistence.api.query.SortDirection
|
|
dev.caskeleton.adapter.outbound.persistence.api.transaction.TransactionCompletionEvidence
|
|
dev.caskeleton.adapter.outbound.persistence.audit.AuditContextPort
|
|
dev.caskeleton.adapter.outbound.persistence.audit.AuditableEntity
|
|
dev.caskeleton.adapter.outbound.persistence.audit.DomainContextAuditContext
|
|
dev.caskeleton.adapter.outbound.persistence.cache.CacheConcurrencyStrategy
|
|
dev.caskeleton.adapter.outbound.persistence.cache.CacheRegionCatalog
|
|
dev.caskeleton.adapter.outbound.persistence.cache.HibernateCacheGuard
|
|
dev.caskeleton.adapter.outbound.persistence.cache.HibernateCachePolicy
|
|
dev.caskeleton.adapter.outbound.persistence.cache.HibernateCacheSettings
|
|
dev.caskeleton.adapter.outbound.persistence.config.PersistenceJpaConfig
|
|
dev.caskeleton.adapter.outbound.persistence.config.PersistenceVendorSettings
|
|
dev.caskeleton.adapter.outbound.persistence.envers.EntityRevision
|
|
dev.caskeleton.adapter.outbound.persistence.envers.EnversConfigurationGuard
|
|
dev.caskeleton.adapter.outbound.persistence.envers.EnversHistoryPolicy
|
|
dev.caskeleton.adapter.outbound.persistence.envers.EnversRevisionMetadata
|
|
dev.caskeleton.adapter.outbound.persistence.envers.HibernateEnversHistoryReader
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.database.TenantDataSourceLifecycle
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.database.TenantDataSourceRegistry
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.database.TenantPoolBudget
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.replica.ConsistencyAwareDataSourceRouter
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.replica.ConsistencyToken
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.replica.ReadConsistency
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.replica.ReplicaLagMonitor
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.replica.ReplicaRoutingDecision
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.replica.ReplicaTarget
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.replica.TransactionContext
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.rls.RlsPolicyVerifier
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.rls.RlsTenantSessionBinder
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.schema.SchemaMultiTenantConnectionProvider
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.schema.SchemaTenantMigrationOrchestrator
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.schema.SchemaTenantRegistry
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.schema.TenantMigrationStatus
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.tenant.TenantAwareRepositoryGuard
|
|
dev.caskeleton.adapter.outbound.persistence.experimental.tenant.TenantContext
|
|
dev.caskeleton.adapter.outbound.persistence.failure.PersistenceExceptionTranslator
|
|
dev.caskeleton.adapter.outbound.persistence.failure.SqlStateErrorMapping
|
|
dev.caskeleton.adapter.outbound.persistence.failure.StandardSqlStateErrorMapping
|
|
dev.caskeleton.adapter.outbound.persistence.h2.H2PersistenceConfig
|
|
dev.caskeleton.adapter.outbound.persistence.h2.H2SqlStateErrorMapping
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.HibernateProviderPolicy
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.HibernateStatisticsCollector
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.HibernateStatisticsSnapshot
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.JdbcBatchCounter
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.NamedStatementInspector
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.QueryNameContext
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.batch.BatchExecutionResult
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.batch.HibernateBatchConfigurationGuard
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.batch.HibernateJpaBatchExecutor
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.batch.JpaBatchProfile
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.bulk.AffectedRowsExpectation
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.bulk.BulkDmlResult
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.bulk.BulkOperationName
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.bulk.HibernateBulkDmlExecutor
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.stateless.HibernateStatelessSessionRunner
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.stateless.StatelessRowCapExceededException
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.stateless.StatelessWorkName
|
|
dev.caskeleton.adapter.outbound.persistence.hibernate.stateless.StatelessWorkResult
|
|
dev.caskeleton.adapter.outbound.persistence.idempotency.jpa.IdempotencyReaper
|
|
dev.caskeleton.adapter.outbound.persistence.idempotency.jpa.IdempotencyRecordJpaRepository
|
|
dev.caskeleton.adapter.outbound.persistence.idempotency.jpa.entity.IdempotencyRecordEntity
|
|
dev.caskeleton.adapter.outbound.persistence.idempotency.postgresql.IdempotencySchemaStream
|
|
dev.caskeleton.adapter.outbound.persistence.idempotency.postgresql.PostgreSqlIdempotencyStore
|
|
dev.caskeleton.adapter.outbound.persistence.liveevent.JpaLiveEventReplay
|
|
dev.caskeleton.adapter.outbound.persistence.liveevent.LiveEventJpaRepository
|
|
dev.caskeleton.adapter.outbound.persistence.liveevent.entity.LiveEventEntity
|
|
dev.caskeleton.adapter.outbound.persistence.lock.DistributedLockPersistenceConfig
|
|
dev.caskeleton.adapter.outbound.persistence.lock.LockRegistryDistributedLock
|
|
dev.caskeleton.adapter.outbound.persistence.lock.LockSettings
|
|
dev.caskeleton.adapter.outbound.persistence.migration.FlywaySchemaPolicy
|
|
dev.caskeleton.adapter.outbound.persistence.migration.SchemaManagementMode
|
|
dev.caskeleton.adapter.outbound.persistence.observation.JpaMetricTags
|
|
dev.caskeleton.adapter.outbound.persistence.observation.LowCardinality
|
|
dev.caskeleton.adapter.outbound.persistence.observation.MicrometerQueryObservation
|
|
dev.caskeleton.adapter.outbound.persistence.observation.SqlDiagnosticRedactor
|
|
dev.caskeleton.adapter.outbound.persistence.operation.DurableOperationJpaRepository
|
|
dev.caskeleton.adapter.outbound.persistence.operation.JpaDurableOperationStore
|
|
dev.caskeleton.adapter.outbound.persistence.operation.entity.DurableOperationEntity
|
|
dev.caskeleton.adapter.outbound.persistence.outbox.h2.H2OutboxClaimRepository
|
|
dev.caskeleton.adapter.outbound.persistence.outbox.jpa.JpaOutboxStore
|
|
dev.caskeleton.adapter.outbound.persistence.outbox.jpa.OutboxClaimRepository
|
|
dev.caskeleton.adapter.outbound.persistence.outbox.jpa.OutboxEventJpaRepository
|
|
dev.caskeleton.adapter.outbound.persistence.outbox.jpa.OutboxReaper
|
|
dev.caskeleton.adapter.outbound.persistence.outbox.jpa.entity.OutboxEventEntity
|
|
dev.caskeleton.adapter.outbound.persistence.outbox.postgresql.PostgreSqlOutboxClaimRepository
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.PostgreSqlPersistenceConfig
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.PostgreSqlSqlStateErrorMapping
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.array.PostgreSqlArraySupport
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.constraint.PostgreSqlConstraintCatalog
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.constraint.PostgreSqlConstraintViolationTranslator
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.copy.BoundedCopyInputStream
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.copy.CopyAdminCapability
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.copy.CopyFormat
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.copy.CopyLimits
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.copy.CopyOperationName
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.copy.CopyResult
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.copy.RegisteredCopyStatement
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.copy.RegisteredPostgreSqlCopyLoader
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.error.PostgreSqlExceptionTranslator
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.error.PostgreSqlFailureClassifier
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.error.PostgreSqlServerErrorFields
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.error.PostgreSqlState
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.json.JsonDocument
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.json.JsonDocumentCodec
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.json.JsonPathName
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.json.PostgreSqlJsonQuerySupport
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.lock.PostgreSqlLockExceptionTranslator
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.lock.PostgreSqlLockOptions
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.range.PgRange
|
|
dev.caskeleton.adapter.outbound.persistence.postgresql.range.PgRangeCodec
|
|
dev.caskeleton.adapter.outbound.persistence.querydsl.PredicatePolicy
|
|
dev.caskeleton.adapter.outbound.persistence.querydsl.QueryPage
|
|
dev.caskeleton.adapter.outbound.persistence.security.DatabasePrivilegeReport
|
|
dev.caskeleton.adapter.outbound.persistence.security.DatabaseRolePolicy
|
|
dev.caskeleton.adapter.outbound.persistence.security.PostgreSqlRuntimeRoleVerifier
|
|
dev.caskeleton.adapter.outbound.persistence.security.SearchPathPolicy
|
|
dev.caskeleton.adapter.outbound.persistence.springdata.EntityGraphCatalog
|
|
dev.caskeleton.adapter.outbound.persistence.springdata.FetchPlanApplier
|
|
dev.caskeleton.adapter.outbound.persistence.springdata.FetchPlanName
|
|
dev.caskeleton.adapter.outbound.persistence.springdata.JpaKeysetQuerySupport
|
|
dev.caskeleton.adapter.outbound.persistence.springdata.JpaRepositoryFragmentSupport
|
|
dev.caskeleton.adapter.outbound.persistence.springdata.JpaStreamExecutor
|
|
dev.caskeleton.adapter.outbound.persistence.springdata.KeysetPredicateBuilder
|
|
dev.caskeleton.adapter.outbound.persistence.springdata.KeysetSliceAssembler
|
|
dev.caskeleton.adapter.outbound.persistence.springdata.KeysetTerm
|
|
dev.caskeleton.adapter.outbound.persistence.springdata.RegisteredQuery
|
|
dev.caskeleton.adapter.outbound.persistence.springdata.SafeSortField
|
|
dev.caskeleton.adapter.outbound.persistence.springdata.SafeSortMapper
|
|
dev.caskeleton.adapter.outbound.persistence.springdata.SafeSortRegistry
|
|
dev.caskeleton.adapter.outbound.persistence.springdata.ScrollPolicy
|
|
dev.caskeleton.adapter.outbound.persistence.transaction.CallerTransaction
|
|
dev.caskeleton.adapter.outbound.persistence.transaction.SpringTransaction
|