Community코딩 & 개발github.com

giuseppe-trisciuoglio/spring-data-jpa

Spring Data JPA를 사용하여 영속성 레이어를 구현하기 위한 패턴을 제공합니다. 리포지토리 생성, 엔티티 관계 설정, 파생 쿼리 및 `@Query` 작성, 페이지네이션, 데이터베이스 감사, 트랜잭션, UUID 기본 키, 다중 데이터베이스, 데이터베이스 인덱싱을 설정할 때 사용합니다.

spring-data-jpa란 무엇인가요?

이 스킬은 Spring Data JPA를 기반으로 한 영속성 레이어 구현을 위한 포괄적인 패턴과 모범 사례를 제공합니다. 개발자는 이 스킬을 사용하여 리포지토리 인터페이스 생성, 엔티티 간 관계 매핑 (One-to-One, One-to-Many, Many-to-Many 등), 파생 쿼리 메서드와 `@Query` 애노테이션을 활용한 사용자 정의 쿼리 작성, 페이지네이션 및 정렬, 데이터베이스 감사(auditing), 트랜잭션 관리, UUID 기반 기본 키 생성, 다중 데이터 소스 구성, 그리고 데이터베이스 인덱싱을 쉽게 설정할 수 있습니다. 이 스킬은 Claude Code, Cursor, Codex와 같은 AI 에이전트에서 사용하도록 설계되었으며, SKILL.md 문서에 상세한 예제와 설명이 포함되어 있어 개발자와 AI 에이전트 모두가 Spring Data JPA의 복잡한 설정을 손쉽게 처리할 수 있도록 돕습니다. 특히, 반복적인 설정 작업을 자동화하고 일관된 코드 스타일을 유지하는 데 유용합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/giuseppe-trisciuoglio/developer-kit/tree/main/skills/spring-data-jpa

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

spring-data-jpa은(는) 무엇을 하나요?

Spring Data JPA를 사용하여 영속성 레이어를 구현하기 위한 패턴을 제공합니다. 리포지토리 생성, 엔티티 관계 설정, 파생 쿼리 및 @Query 작성, 페이지네이션, 데이터베이스 감사, 트랜잭션, UUID 기본 키, 다중 데이터베이스, 데이터베이스 인덱싱을 설정할 때 사용합니다.

주요 기능

  • 리포지토리 생성: JpaRepository를 상속받아 기본 CRUD 작업을 자동으로 제공합니다.
  • 엔티티 관계 설정: @OneToOne, @OneToMany, @ManyToOne, @ManyToMany를 사용한 관계 매핑.
  • 파생 쿼리: 메서드 이름만으로 쿼리를 자동 생성합니다 (예: findByName, findByAgeGreaterThan).
  • @Query 애노테이션: JPQL 또는 네이티브 SQL을 사용한 사용자 정의 쿼리.
  • 페이지네이션 및 정렬: Pageable과 Sort 객체를 사용한 데이터 페이징 및 정렬.
  • 데이터베이스 감사: @CreatedDate, @LastModifiedDate, @CreatedBy, @LastModifiedBy 애노테이션을 통한 자동 감사.
  • 트랜잭션 관리: @Transactional을 사용한 선언적 트랜잭션 경계 설정.
  • UUID 기본 키: UUID 타입의 기본 키 생성 및 사용 방법.
  • 다중 데이터베이스: 여러 데이터 소스와 각각의 EntityManagerFactory 및 TransactionManager 구성.
  • 데이터베이스 인덱싱: @Index 애노테이션을 사용한 인덱스 생성 및 성능 최적화.

사용 예시

리포지토리 인터페이스

public interface UserRepository extends JpaRepository<User, Long> {
    List<User> findByLastName(String lastName);
    Page<User> findByAgeGreaterThan(int age, Pageable pageable);
}

엔티티 간 관계

@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @OneToMany(mappedBy = "user", cascade = CascadeType.ALL)
    private List<Order> orders;
}

@Query 애노테이션 사용

@Query("SELECT u FROM User u WHERE u.email = :email")
User findByEmail(@Param("email") String email);

지원하는 도구

  • Claude Code
  • Cursor
  • Codex
  • 기타 AI 에이전트

시작하기

  1. 프로젝트에 Spring Data JPA 의존성을 추가하세요 (Maven 또는 Gradle).
  2. application.yml 또는 application.properties에 데이터베이스 연결 정보를 설정하세요.
  3. 엔티티 클래스와 리포지토리 인터페이스를 생성하고, 필요한 비즈니스 로직을 구현하세요.
  4. 이 스킬의 패턴을 따라 일관된 방식으로 영속성 레이어를 구축하세요.

참고 사항

  • 모든 예제는 Spring Boot 3.x 이상과 Java 17 이상을 기준으로 합니다.
  • 데이터베이스 특화 기능 (예: MySQL의 @Index)은 해당 데이터베이스 방언(dialect)에 따라 달라질 수 있습니다.
  • 트랜잭션 관리는 서비스 레이어에서 처리하는 것을 권장합니다.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

giuseppe-trisciuoglio/aws-lambda-java-integration

Provides AWS Lambda integration patterns for Java with cold start optimization. Use when deploying Java functions to AWS Lambda, choosing between Micronaut and Raw Java approaches, optimizing cold starts below 1 second, configuring API Gateway or ALB integration, or implementing serverless Java applications. Triggers include "create lambda java", "deploy java lambda", "micronaut lambda aws", "java lambda cold start", "aws lambda java performance", "java serverless framework".

giuseppe-trisciuoglio/aws-lambda-php-integration

Provides AWS Lambda integration patterns for PHP with Symfony using the Bref framework. Creates Lambda handler classes, configures runtime layers, sets up SQS/SNS event triggers, implements warm-up strategies, and optimizes cold starts. Use when deploying PHP/Symfony applications to AWS Lambda, configuring API Gateway integration, implementing serverless PHP applications, or optimizing Lambda performance with Bref. Triggers include "create lambda php", "deploy symfony lambda", "bref lambda aws", "php lambda cold start", "aws lambda php performance", "symfony serverless", "php serverless framework".

giuseppe-trisciuoglio/aws-lambda-python-integration

Provides AWS Lambda integration patterns for Python with cold start optimization. Use when deploying Python functions to AWS Lambda, choosing between AWS Chalice and raw Python approaches, optimizing cold starts, configuring API Gateway or ALB integration, or implementing serverless Python applications. Triggers include "create lambda python", "deploy python lambda", "chalice lambda aws", "python lambda cold start", "aws lambda python performance", "python serverless framework".

giuseppe-trisciuoglio/aws-lambda-typescript-integration

Provides AWS Lambda integration patterns for TypeScript with cold start optimization. Use when creating or deploying TypeScript Lambda functions, choosing between NestJS framework and raw TypeScript approaches, optimizing cold starts, configuring API Gateway or ALB integration, or implementing serverless TypeScript applications. Triggers include "create lambda typescript", "deploy typescript lambda", "nestjs lambda aws", "raw typescript lambda", "aws lambda typescript performance".

giuseppe-trisciuoglio/aws-rds-spring-boot-integration

Provides patterns to configure AWS RDS (Aurora, MySQL, PostgreSQL) with Spring Boot applications. Configures HikariCP connection pools, implements read/write splitting, sets up IAM database authentication, enables SSL connections, and integrates with AWS Secrets Manager. Use when setting up RDS connections in Spring Boot, configuring connection pooling, or managing database credentials securely.

giuseppe-trisciuoglio/aws-sdk-java-v2-bedrock

Provides Amazon Bedrock patterns using AWS SDK for Java 2.x. Invokes foundation models (Claude, Llama, Titan), generates text and images, creates embeddings for RAG, streams real-time responses, and configures Spring Boot integration. Use when asking about Bedrock integration, Java SDK for AI models, AWS generative AI, Claude/Llama invocation, embeddings for RAG, or Spring Boot AI setup.

giuseppe-trisciuoglio/aws-sdk-java-v2-core

Provides AWS SDK for Java 2.x client configuration, credential resolution, HTTP client tuning, timeout, retry, and testing patterns. Use when creating or hardening AWS service clients, wiring Spring Boot beans, debugging auth or region issues, or choosing sync vs async SDK usage.

giuseppe-trisciuoglio/aws-sdk-java-v2-dynamodb

Provides Amazon DynamoDB patterns using AWS SDK for Java 2.x. Use when creating, querying, scanning, or performing CRUD operations on DynamoDB tables, working with indexes, batch operations, transactions, or integrating with Spring Boot applications.

giuseppe-trisciuoglio/aws-sdk-java-v2-kms

Provides AWS Key Management Service (KMS) patterns using AWS SDK for Java 2.x. Use when creating/managing encryption keys, encrypting/decrypting data, generating data keys, digital signing, key rotation, or integrating encryption into Spring Boot applications.

giuseppe-trisciuoglio/aws-sdk-java-v2-lambda

Provides AWS Lambda patterns using AWS SDK for Java 2.x. Use when invoking Lambda functions, creating/updating functions, managing function configurations, working with Lambda layers, or integrating Lambda with Spring Boot applications.

giuseppe-trisciuoglio/aws-sdk-java-v2-messaging

Provides AWS messaging patterns using AWS SDK for Java 2.x for SQS queues and SNS topics. Handles sending/receiving messages, FIFO queues, DLQ, subscriptions, and pub/sub patterns. Use when implementing messaging with SQS or SNS.

giuseppe-trisciuoglio/aws-sdk-java-v2-rds

Provides AWS RDS (Relational Database Service) management patterns using AWS SDK for Java 2.x. Use when creating, modifying, monitoring, or managing Amazon RDS database instances, snapshots, parameter groups, and configurations.

giuseppe-trisciuoglio/aws-sdk-java-v2-s3

Provides Amazon S3 patterns and examples using AWS SDK for Java 2.x. Use when working with S3 buckets, uploading/downloading objects, multipart uploads, presigned URLs, S3 Transfer Manager, object operations, or S3-specific configurations.

giuseppe-trisciuoglio/aws-sdk-java-v2-secrets-manager

Provides AWS Secrets Manager patterns for AWS SDK for Java 2.x, including secret retrieval, caching, rotation-aware access, and Spring Boot integration. Use when storing or reading secrets in Java services, replacing hardcoded credentials, or wiring secret-backed configuration into applications.

giuseppe-trisciuoglio/better-auth

Provides Better Auth integration patterns for NestJS backend and Next.js frontend with Drizzle ORM and PostgreSQL. Use when setting up Better Auth with NestJS backend, integrating Next.js App Router frontend, configuring Drizzle ORM schema, implementing social login (GitHub, Google), adding plugins (2FA, Organization, SSO, Magic Link, Passkey), implementing email/password authentication with session management, or creating protected routes and middleware.

giuseppe-trisciuoglio/chunking-strategy

Provides chunking strategies for RAG systems. Generates chunk size recommendations (256-1024 tokens), overlap percentages (10-20%), and semantic boundary detection methods. Validates semantic coherence and evaluates retrieval precision/recall metrics. Use when building retrieval-augmented generation systems, vector databases, or processing large documents.

giuseppe-trisciuoglio/clean-architecture

Provides implementation patterns for Clean Architecture, Hexagonal Architecture (Ports & Adapters), and Domain-Driven Design in Java 21+ Spring Boot 3.5+ applications. Use when structuring layered architectures, separating domain logic from frameworks, implementing ports and adapters, creating entities/value objects/aggregates, or refactoring monolithic codebases for testability and maintainability.

giuseppe-trisciuoglio/docs-updater

Provides automated documentation updates by analyzing git changes between the current branch and the last release tag. Performs git diff analysis to identify modifications, then updates README.md, CHANGELOG.md following Keep a Changelog standard, and discovers documentation folders for contextual updates. Use when preparing a release, maintaining documentation sync, or before creating a pull request. Triggers on "update docs", "update changelog", "sync documentation", "update readme", "prepare release documentation".

giuseppe-trisciuoglio/drawio-logical-diagrams

Creates professional logical flow diagrams and logical system architecture diagrams using draw.io XML format (.drawio files). Use when creating: (1) logical flow diagrams showing data/process flow between system components, (2) logical architecture diagrams representing system structure without cloud provider specifics, (3) BPMN process diagrams, (4) UML diagrams (class, sequence, activity), (5) data flow diagrams (DFD), (6) decision flowcharts, or (7) system interaction diagrams. This skill focuses on generic/abstract representations, not AWS/Azure-specific architectures (use aws-drawio-architecture-diagrams for cloud diagrams).

giuseppe-trisciuoglio/drizzle-orm-patterns

Provides comprehensive Drizzle ORM patterns for schema definition, CRUD operations, relations, queries, transactions, and migrations. Proactively use for any Drizzle ORM development including defining database schemas, writing type-safe queries, implementing relations, managing transactions, and setting up migrations with Drizzle Kit. Supports PostgreSQL, MySQL, SQLite, MSSQL, and CockroachDB.

관련 스킬