develop-backend
Создание бэкендов на Spring Boot с тестами и проверками качества
Создание бэкенд API на Spring Boot требует следования правильным паттернам, миграциям базы данных и прохождения проверок качества. Этот навык предоставляет полный рабочий процесс разработки с требованиями к покрытию тестами и валидацией линтера.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "develop-backend". Создать API профиля пользователя с CRUD операциями
النتيجة المتوقعة:
- Создана миграция V010__create_user_profiles_table.sql
- Создана сущность UserProfile с обязательными колонками
- Созданы DTO UserProfileRequest и UserProfileResponse
- Созданы интерфейс UserProfileMapper и XML
- Создан UserProfileService с бизнес-логикой
- Создан UserProfileController с REST эндпоинтами
- Добавлено 12 модульных тестов, покрывающих все CRUD операции
- Покрытие тестами: 87%
- Все проверки линта пройдены
استخدام "develop-backend". Добавить валидацию email в эндпоинт регистрации пользователя
النتيجة المتوقعة:
- Обновлен DTO UserRegistrationRequest с валидацией @Email
- Добавлена валидация @NotBlank для обязательных полей
- Создан DTO для ответа ошибки валидации
- Добавлено 5 модульных тестов для сценариев валидации
- Все тесты проходят с покрытием 92%
- Отчеты Checkstyle и SpotBugs показывают 0 нарушений
استخدام "develop-backend". Оптимизировать mapper запросов order для лучшей производительности
النتيجة المتوقعة:
- Обнаружен N+1 запрос в select orderItems
- Добавлен resultMap для жадной загрузки элементов
- Оптимизирован SQL с INNER JOIN вместо отдельных запросов
- Покрытие сохранено на уровне 85% после изменений
- Отчет JaCoCo показывает покрытие всех ветвей
التدقيق الأمني
مخاطر منخفضةThe static analyzer flagged 72 potential issues but all are FALSE POSITIVES. This is a documentation/metadata file describing a Spring Boot development workflow. The 'external_commands' detections are markdown code blocks showing legitimate Gradle/git commands, not executable code. The 'weak cryptographic algorithm' and 'obfuscation' findings are references to JwtUtil class names and technical documentation. The skill-report.json in the same directory already correctly classified this as low risk with no blocking issues. All detected patterns are standard development documentation patterns, not security threats.
مشكلات منخفضة المخاطر (1)
عوامل الخطر
⚙️ الأوامر الخارجية (1)
📁 الوصول إلى نظام الملفات (1)
درجة الجودة
ماذا يمكنك بناءه
Реализация новых REST эндпоинтов
Добавление новых API эндпоинтов в соответствии с конвенциями проекта с правильным разделением слоев и тестами
Создание схем базы данных
Проектирование таблиц базы данных с помощью Flyway миграций и обновление связанных классов сущностей/DTO
Проверка качества кода
Запуск проверок линта и обеспечение покрытия тестами не менее 80% перед слиянием
جرّب هذه الموجهات
Создать новый REST API эндпоинт для [resource-name] со стандартными CRUD операциями в соответствии с паттернами проекта. Включить Flyway миграцию, сущность, DTO, mapper, service и controller. Обеспечить 80% покрытие тестами.
Добавить валидацию входных данных в API [existing-endpoint]. Использовать аннотации Bean Validation и возвращать корректные ответы об ошибках. Обновить модульные тесты для покрытия сценариев валидации.
Создать интеграционные тесты для эндпоинта [api-name]. Проверить успешные сценарии, ошибки валидации и граничные случаи. Убедиться, что покрытие соответствует порогу 80%.
Проверить mapper [mapper-name] на наличие проблем N+1 запросов или отсутствующих индексов. Оптимизировать SQL запросы и добавить соответствующие result maps. Проверить изменения с помощью `./gradlew check`.
أفضل الممارسات
- Следовать существующим паттернам из похожих реализаций в кодовой базе
- Использовать утилиты из пакета product.util вместо создания дубликатов
- Запускать `./gradlew check` и исправлять все проблемы перед коммитом
تجنب
- Пропуск проверки покрытия тестами перед слиянием
- Написание блоков try-catch вместо использования ExceptionHandler
- Ручное логирование, когда AOP обрабатывает логирование автоматически