К основному содержанию
скилл CX Codex

springboot-patterns · rohitg00 — скилл для Claude Code

Скилл springboot-patterns задаёт слоистую структуру Spring Boot проекта и шаблоны контроллеров, сервисов и репозиториев с разбором типичных ошибок.

Apache-2.0 ★ 2 858 обновлён 2026-05-12

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add rohitg00/awesome-claude-code-toolkit --skill springboot-patterns -a claude-code
Открыть на GitHub

Что делает springboot-patterns

Скилл описывает разбиение Java-пакета на config, controller, service, repository, model (entity, dto, mapper), exception и security, где контроллер только принимает HTTP-запрос и передаёт его сервису. В примерах — REST-контроллер на Spring MVC с пагинацией, JPA-сущность Order со связями @ManyToOne и @OneToMany, репозиторий с @Query и @EntityGraph против N+1, сервисный слой с @Transactional и глобальный обработчик ошибок через ProblemDetail по RFC 7807.

Отдельный список антипаттернов называет внедрение репозитория прямо в контроллер, FetchType.EAGER по умолчанию и возврат сущностей JPA вместо DTO. Чеклист в конце требует @Valid на входных DTO и интеграционные тесты через @SpringBootTest с testcontainers — без них часть пунктов проверить не на чём.

Все примеры на Java с Lombok-аннотациями @RequiredArgsConstructor и @Getter/@Setter, так что скилл предполагает именно этот стек, а не Kotlin или чистый Spring без Lombok.

Какие задачи решает

  • разложить модуль заказов по слоям controller, service, repository
  • избежать N+1 запросов через @EntityGraph или JOIN FETCH
  • вернуть ошибки в формате ProblemDetail по RFC 7807
  • заменить сущности JPA на DTO в ответах контроллера
  • настроить @Transactional с правильным read/write скоупом

Примеры запросов агенту

  • Разбей сервис заказов на слои controller, service и repository по этому скиллу
  • Проверь JPA-сущность Order на лишний FetchType.EAGER
  • Добавь глобальный обработчик ошибок с ProblemDetail для контроллера

Как установить springboot-patterns

1Через Skills CLI (Vercel)

npx skills add rohitg00/awesome-claude-code-toolkit --skill springboot-patterns -a claude-code

2Вручную: положить файлы

~/.claude/skills/springboot-patterns/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/springboot-patterns/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о springboot-patterns

Как установить springboot-patterns в Claude Code?

Выполните npx skills add rohitg00/awesome-claude-code-toolkit --skill springboot-patterns -a claude-code, скилл появится в ~/.claude/skills/springboot-patterns/SKILL.md.

Что делает скилл springboot-patterns?

Он задаёт слоистую архитектуру Spring Boot приложения и даёт шаблоны REST-контроллера, JPA-сущности с репозиторием, сервиса с транзакциями и обработчика исключений, а также список типичных ошибок и чеклист проверки.

Для какого стека подходит springboot-patterns?

Примеры написаны на Java с аннотациями Lombok (@RequiredArgsConstructor, @Getter, @Setter) и Spring Data JPA, так что скилл рассчитан на классический Spring Boot стек с этими библиотеками.

Исходный текст

SKILL.md · Apache-2.0
---
name: springboot-patterns
description: Spring Boot patterns including JPA repositories, REST controllers, layered services, and configuration
---

# Spring Boot Patterns

## Layered Architecture

```
src/main/java/com/example/app/
  config/          # @Configuration beans
  controller/      # @RestController (thin, delegates to service)
  service/         # @Service (business logic)
  repository/      # @Repository (data access via JPA)
  model/
    entity/        # @Entity JPA classes
    dto/           # Request/response DTOs
    mapper/        # MapStruct or manual mapping
  exception/       # @ControllerAdvice, custom exceptions
  security/        # SecurityFilterChain, JWT filters
```

Controllers handle HTTP concerns. Services contain business logic. Repositories handle persistence.

## REST Controller

```java
@RestController
@RequestMapping("/api/v1/orders")
@RequiredArgsConstructor
public class OrderController {

    private final OrderService orderService;

    @GetMapping
    public Page<OrderResponse> list(
            @RequestParam(defaultValue = "0") int page,
            @RequestParam(defaultValue = "20") int size) {
        return orderService.findAll(PageRequest.of(page, size));
    }

    @PostMapping
    @ResponseStatus(HttpStatus.CREATED)
    public OrderResponse create(@Valid @RequestBody CreateOrderRequest request) {
        return orderService.create(request);
    }

    @GetMapping("/{id}")
    public OrderResponse getById(@PathVariable UUID id) {
        return orderService.findById(id);
    }
}
```

## JPA Entity and Repository

```java
@Entity
@Table(name = "orders")
@Getter @Setter @NoArgsConstructor
public class Order {
    @Id
    @GeneratedValue(strategy = GenerationType.UUID)
    private UUID id;

    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "customer_id", nullable = false)
    private Customer customer;

    @OneToMany(mappedBy = "order", cascade = CascadeType.ALL, orphanRemoval = true)
    private List<OrderItem> items = new ArrayList<>();

    @Enumerated(EnumType.STRING)
    private OrderStatus status = OrderStatus.PENDING;

    @CreationTimestamp
    private Instant createdAt;
}

public interface OrderRepository extends JpaRepository<Order, UUID> {
    @Query("SELECT o FROM Order o JOIN FETCH o.items WHERE o.customer.id = :customerId")
    List<Order> findByCustomerWithItems(@Param("customerId") UUID customerId);

    @EntityGraph(attributePaths = {"customer", "items"})
    Optional<Order> findWithDetailsById(UUID id);
}
```

## Service Layer

```java
@Service
@Transactional(readOnly = true)
@RequiredArgsConstructor
public class OrderService {

    private final OrderRepository orderRepository;
    private final OrderMapper orderMapper;
    private final EventPublisher eventPublisher;

    public OrderResponse findById(UUID id) {
        Order order = orderRepository.findWithDetailsById(id)
                .orElseThrow(() -> new ResourceNotFoundException("Order", id));
        return orderMapper.toResponse(order);
    }

    @Transactional
    public OrderResponse create(CreateOrderRequest request) {
        Order order = orderMapper.toEntity(request);
        order = orderRepository.save(order);
        eventPublisher.publish(new OrderCreatedEvent(order.getId()));
        return orderMapper.toResponse(order);
    }
}
```

## Global Exception Handler

```java
@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(ResourceNotFoundException.class)
    @ResponseStatus(HttpStatus.NOT_FOUND)
    public ProblemDetail handleNotFound(ResourceNotFoundException ex) {
        return ProblemDetail.forStatusAndDetail(HttpStatus.NOT_FOUND, ex.getMessage());
    }

    @ExceptionHandler(MethodArgumentNotValidException.class)
    @ResponseStatus(HttpStatus.BAD_REQUEST)
    public ProblemDetail handleValidation(MethodArgumentNotValidException ex) {
        ProblemDetail detail = ProblemDetail.forStatus(HttpStatus.BAD_REQUEST);
        Map<String, String> errors = ex.getFieldErrors().stream()
                .collect(Collectors.toMap(FieldError::getField, FieldError::getDefaultMessage));
        detail.setProperty("errors", errors);
        return detail;
    }
}
```

## Anti-Patterns

- Injecting repositories directly into controllers (bypassing service layer)
- Using `FetchType.EAGER` on entity relationships by default
- Returning JPA entities directly from controllers instead of DTOs
- Missing `@Transactional(readOnly = true)` on read-only service methods
- Catching generic `Exception` instead of specific types
- Hardcoding configuration values instead of using `@Value` or `@ConfigurationProperties`

## Checklist

- [ ] Controllers are thin and delegate to services
- [ ] All JPA relationships use `FetchType.LAZY` by default
- [ ] DTOs used for request/response, never raw entities
- [ ] `@Transactional` applied at service level with correct read/write scoping
- [ ] Validation annotations (`@Valid`, `@NotNull`, `@Size`) on request DTOs
- [ ] Global exception handler returns `ProblemDetail` (RFC 7807)
- [ ] Entity graphs or `JOIN FETCH` used to avoid N+1 queries
- [ ] Integration tests use `@SpringBootTest` with test containers

© rohitg00 · Apache-2.0 · rohitg00/awesome-claude-code-toolkit

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →

Сначала — springboot-patterns от других авторов.

springboot-patterns affaan-m Скилл springboot-patterns подсказывает архитектурные и API-паттерны для Java Spring Boot. Пригодится при создании или ревью REST-бэкенда. CX Codex +1 6 900установок spring-boot-crud-patterns giuseppe-trisciuoglio Скилл spring-boot-crud-patterns собирает полный CRUD-слой для сервисов на Spring Boot 3: агрегаты, JPA-репозитории, DTO и REST-контроллеры по feature-архитектуре. CX Codex +1 4 100установок spring-boot-patterns decebals Скилл spring-boot-patterns для Claude Code задаёт структуру и шаблоны Spring Boot-проекта: контроллеры, сервисы, репозитории. Направляет агента при написании нового кода и разборе чужого. CX Codex +1 375установок java-springboot официальный github Скилл java-springboot пишет и проверяет код в существующем проекте Spring Boot 3 или 4: контроллеры, валидацию, доступ к данным. Подключается при добавлении и изменении фич, а не при создании нового проекта. CX Codex +1 21 272установок java-springboot-jpa-cursorrules-prompt-file PatrickJS Правило java-springboot-jpa-cursorrules-prompt-file для Cursor задаёт структуру Java-проектов на Spring Boot с JPA, DTO и разделением слоёв. Генерирует REST API по единой схеме. CX Codex +1 ★ 41 178звёзд репо jpa-patterns affaan-m Скилл jpa-patterns подсказывает правила моделирования JPA-сущностей, устранения проблемы N+1 и настройки пула HikariCP в Spring Boot. Пригодится при написании репозиториев и оптимизации запросов. CX Codex +1 6 400установок spring-boot-engineer https://github.com/Jeffallan Скилл spring-boot-engineer разворачивает архитектуру Spring Boot 3.x, контроллеры, репозитории Spring Data JPA и правила Spring Security 6. Пригодится при сборке REST API, реактивных сервисов и микросервисов на Java. CX Codex +1 8 900установок

Из того же набора178

Весь набор →
rust-systems Скилл rust-systems помогает писать системный код на Rust: работать с владением, ошибками, трейдами и асинхронностью. Подключайте его при проектировании библиотек и сервисов. CX Codex +1 ★ 2 858звёзд репо ml-engineer Субагент ml-engineer для Claude Code разрабатывает конвейеры машинного обучения от подготовки данных до развёртывания модели. Он подключается к задачам по обучению, оценке и мониторингу моделей. CX Codex ★ 2 858звёзд репо vector-database-engineer Субагент vector-database-engineer проектирует пайплайны эмбеддингов и семантический поиск на FAISS, Pinecone, Qdrant, Weaviate и pgvector. Помогает настроить чанкинг, фильтрацию метаданных и гибридный поиск. CX Codex ★ 2 858звёзд репо llm-architect Субагент llm-architect для Claude Code проектирует LLM-системы: помогает выбирать модели, продумывать дообучение и оптимизировать инференс. Сравнивает варианты на своих данных. CX Codex ★ 2 858звёзд репо database-admin Субагент database-admin помогает проектировать схемы данных, настраивать индексы, писать миграции и выстраивать репликацию для PostgreSQL, MySQL и MongoDB. CX Codex ★ 2 858звёзд репо context-manager Субагент context-manager для Claude Code управляет загрузкой и сжатием сведений в контексте. Работает с задачами, где много файлов и обсуждений. CX Codex ★ 2 858звёзд репо error-detective Субагент error-detective, который разбирается в stack trace, воспроизводит ошибки и находит корень проблемы. Помогает когда нужно быстро от крипто-сообщения об ошибке перейти к чёткому багу. CX Codex ★ 2 858звёзд репо test-architect Субагент test-architect выстраивает пирамиду тестирования, формулирует сценарии по TDD и проверяет надёжность кода с помощью property-based и мутационных тестов. CX Codex ★ 2 858звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой