Agent skill · software engineering · aiskillstore
allra-database-schema
Allra 데이터베이스 설계 및 QueryDSL 사용 규칙. Use when creating JPA entities, writing QueryDSL queries, or adding @Transactional annotations.
Why this skill is useful
Defines specific QueryDSL patterns and JPA transaction management standards that the AI wouldn't reliably generate on its own.
What it needs
About 3k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Allra Database 설계 및 QueryDSL 규칙 Allra 백엔드 팀의 데이터베이스 설계, JPA, QueryDSL, 트랜잭션 관리 표준을 정의합니다. 프로젝트 기본 정보 이 가이드는 다음 환경을 기준으로 작성되었습니다: Java: 17 이상 Spring Boot: 3.2 이상 ORM: JPA/Hibernate Query Library: QueryDSL (선택 사항) Testing: Testcontainers (선택 사항) 참고: 프로젝트별로 사용하는 데이터베이스(MariaDB, PostgreSQL, MySQL 등)와 라이브러리가 다를 수 있습니다. QueryDSL 사용 규칙 1. Repository 구조 (Allra 권장 패턴) JPA Repository와 Support 인터페이스를 함께 사용: 참고: Support 패턴은 선택 사항입니다. 프로젝트에 따라 @Query 어노테이션이나 다른 방식을 사용할 수 있습니다. 2. QueryDSL DTO Projection Record와 @QueryProjection 사용: 빌드 설정: Gradle: Maven: 3. From 절에 맞는 Repository 위치 From절에 해당하는 Repository에 정의하는 것을 권장: 4. 데이터베이스 호환성 QueryDSL 작성 시 사용 중인 데이터베이스의 특성을 고려: 참고: 윈도우 함수나 특정 DB 함수는 데이터베이스 버전에 따라 지원 여부가 다를 수 있습니다. 5. xxxRepositorySupport 직접 의존 금지 반드시 JPA Repository 인터페이스를 통해 사용: @Transactional 사용 가이드 필수 규칙 각 서비스 메서드에 명시적으로 선언: 1. 조회 쿼리만: @Transactional(readOnly = true) 2. 변경 쿼리 포함: @Transactional 예제 참고: 트랜잭션 전파(Propagation)는 기본값(REQUIRED)을 사용하며, 특수한 경우에만 명시합니다. JPA Entity 설계 가이드 기본 구조 연관관계 매핑 참고: 연관관계는 지연 로딩(LAZY)을 기본으로 사용하는 것을 권장합니다. When to Use This Skill 이 skill은 다음 상황에서 자동으로 적용됩니다: JPA Entity 생성 및 수정 QueryDSL 쿼리 작성 Repository 인터페이스 및 구현체 작성 Service 메서드에 @Transactional 추가 DTO Projection 작성 Checklist 데이터베이스 관련 코드 작성 시 확인사항: [ ] QueryDSL Support가 JPA Repository에 상속되어 있는가? (Support 패턴 사용 시) [ ] QueryDSL 구현체가 From절에 맞는 Repository에 있는가? [ ] DTO Projection에 @QueryProjection이 적용되었는가? (QueryDSL 사용 시) [ ] Service의 모든 public 메서드에 @Transactional이 명시되었는가? [ ] 읽기 전용 메서드에 readOnly = true가 적용되었는가? [ ] MariaDB 호환성을 고려했는가? [ ] Entity의 연관관계가 지연 로딩(LAZY)으로 설정되었는가? [ ] xxxRepositorySupport 구현체를 직접 주입하지 않았는가?
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/allra-database-schema