com.first-ticket.common-jpa

JPA 기본 엔티티 및 설정을 제공하는 공통 모듈입니다.

---

📝 버전

버전	변경 내용
0.0.1-SNAPSHOT	• JPA 기본 엔티티 및 설정 추가 (BaseEntity, BaseUserEntity, CommonJpaAutoConfiguration) • QueryDSL 설정 추가 (JPAQueryFactory 빈 등록) • SecurityAuditorAware 추가 - X-User-Id 헤더 기반 JPA Auditing 자동 주입 (createdBy/updatedBy)
0.0.2-SNAPSHOT	• CommonJpaAutoConfiguration에서 @EntityScan, @EnableJpaRepositories 제거 • 각 서비스 JpaConfig에서 필요한 패키지만 명시하도록 변경

---

📦 의존성 추가

배포 방법 및 의존성 추가는 common README를 참고해주세요.

implementation 'com.first-ticket:common-jpa:0.0.2-SNAPSHOT'

---

🗂️ 패키지 구조

com.firstticket.common.persistence
├── CommonJpaAutoConfiguration.java  ← EntityScan, JPAQueryFactory 설정, SecurityAuditorAware 등록
├── BaseEntity.java                  ← 생성/수정/삭제 시간
├── BaseUserEntity.java              ← BaseEntity + 생성/수정/삭제 유저
└── SecurityAuditorAware.java        ← X-User-Id 헤더 기반 JPA Auditor

---

🗄️ CommonJpaAutoConfiguration

⚠️ 0.0.2-SNAPSHOT부터 @EntityScan, @EnableJpaRepositories 자동 설정이 제거되었습니다. common-messaging을 사용하지 않는 경우 @SpringBootApplication 기본 스캔이 동작하므로 별도 설정이 필요 없습니다. common-messaging 사용 시 각 서비스 JpaConfig 설정이 필요합니다. 자세한 내용은 common-messaging README를 참고해주세요.

JPAQueryFactory 빈을 자동으로 등록하여 QueryDSL을 바로 사용할 수 있습니다.

QueryDSL 사용 시 JPAQueryFactory를 주입받아 바로 사용합니다.

@Repository
@RequiredArgsConstructor
public class SampleQueryRepositoryImpl implements SampleQueryRepository {

    private final JPAQueryFactory queryFactory;

    @Override
    public List<Sample> findBySpec(SampleSearchSpec spec) {
        return queryFactory
            .selectFrom(sample)
            .where(...)
            .fetch();
    }
}

---

🏗️ BaseEntity / BaseUserEntity

BaseEntity

생성 시간, 수정 시간, 삭제 시간을 자동으로 관리합니다.

필드	타입	설명
createdAt	LocalDateTime	생성 시간 (자동)
updatedAt	LocalDateTime	수정 시간 (자동, insert 시 null)
deletedAt	LocalDateTime	삭제 시간

@Entity
public class Sample extends BaseEntity {
    // createdAt, updatedAt, deletedAt 자동 포함
}

소프트 삭제가 필요한 경우 도메인 엔티티에서 delete()를 호출하는 메서드를 정의합니다.

// 도메인 엔티티
public void softDelete() {
    // 삭제 권한 검증
    delete();  // deletedAt 자동 설정
}

BaseUserEntity

BaseEntity를 상속받아 생성/수정/삭제 유저 UUID를 추가로 관리합니다.

필드	타입	설명
createdBy	UUID	생성 유저 (자동)
updatedBy	UUID	수정 유저 (자동, insert 시 null)
deletedBy	UUID	삭제 유저

@Entity
public class Sample extends BaseUserEntity {
    // createdAt, updatedAt, deletedAt, createdBy, updatedBy, deletedBy 자동 포함
}

소프트 삭제가 필요한 경우 도메인 엔티티에서 delete(UUID userId)를 호출하는 메서드를 정의합니다.

// 도메인 엔티티
public void softDelete(UUID userId) {
    // 삭제 권한 검증
    delete(userId);  // deletedAt, deletedBy 자동 설정
}

SecurityAuditorAware

createdBy / updatedBy는 SecurityAuditorAware가 자동으로 채워줍니다.

동작 조건	결과
API Gateway가 X-User-Id 헤더 주입	createdBy / updatedBy에 해당 UUID 자동 기록
헤더 없음 (내부 호출, Flyway 등)	null 유지 (예외 발생하지 않음)
헤더 값이 UUID 형식이 아닌 경우	null 유지 + warn 로그 출력