allra-database-schema
Aplicar los estándares de base de datos de Allra
Los equipos de backend necesitan reglas consistentes para entidades JPA, repositorios QueryDSL, proyecciones DTO y transacciones. Esta skill guía a Claude, Codex y Claude Code para aplicar las convenciones de base de datos de Allra durante la implementación y la revisión.
Descargar el ZIP de la skill
Subir en Claude
Ve a Configuración → Capacidades → Skills → Subir skill
Activa y empieza a usar
Recursos legibles por agentes
Usa estos enlaces cuando un AI Agent, crawler o script necesite contexto limpio en lugar de leer toda la página.
Pruébalo
Usando "allra-database-schema". Un servicio tiene métodos de solo lectura sin anotaciones de transacción.
Resultado esperado:
La respuesta identifica cada método de lectura y recomienda anotaciones de transacción de solo lectura. Separa los métodos que modifican el estado y necesitan transacciones de escritura.
Usando "allra-database-schema". Una consulta QueryDSL comienza desde User pero está ubicada en un repositorio Order.
Resultado esperado:
La respuesta señala el problema de ubicación del repositorio y recomienda mover la consulta a la capa de soporte del repositorio User.
Usando "allra-database-schema". Una nueva entidad Order tiene relaciones eager y le faltan campos de auditoría.
Resultado esperado:
La respuesta recomienda carga lazy de relaciones, reglas explícitas de columnas de unión y campos estándar de marca de tiempo de creación y actualización.
Auditoría de seguridad
SeguroStatic analysis reported external command, network, weak crypto, and reconnaissance patterns, but review found these are false positives in Markdown documentation and Java examples. No executable scripts, network endpoints, credential handling, prompt injection attempts, or malicious intent were found in SKILL.md.
Problemas de riesgo bajo (4)
Puntuación de calidad
Lo que puedes crear
Crear una nueva entidad
Usa la skill para dar forma a campos de entidad, constructores, métodos factory, columnas de auditoría y relaciones lazy.
Revisar repositorios QueryDSL
Usa la skill para comprobar la ubicación de repositorios, interfaces de soporte, proyecciones DTO y compatibilidad con QueryDSL.
Estandarizar transacciones
Usa la skill para decidir cuándo los métodos de servicio necesitan anotaciones de transacción de solo lectura o escritura.
Prueba estos prompts
Revisa este servicio Spring y agrega la anotación @Transactional correcta a cada método public usando las reglas de Allra.
Crea una entidad JPA para este objeto de dominio usando las reglas de diseño de entidades de Allra, incluidas columnas, enums, auditoría y carga de relaciones.
Implementa un patrón de soporte de repositorio QueryDSL para este requisito de búsqueda y coloca la consulta en el repositorio que coincida con la cláusula from.
Revisa estos cambios en repositorio, servicio, DTO y entidad frente a los estándares de base de datos de Allra. Informa cada problema y sugiere correcciones enfocadas.
Mejores prácticas
- Proporciona al modelo juntos los archivos relevantes de entidad, repositorio, DTO y servicio.
- Indica el motor de base de datos objetivo cuando la compatibilidad o las funciones importen.
- Pide una checklist de revisión al aplicar la skill a una pull request.
Evitar
- No uses la skill como reemplazo de la revisión de migraciones de base de datos.
- No solicites inyección directa de implementación de repositorio en servicios.
- No apliques reglas de proyección QueryDSL cuando el proyecto no use QueryDSL.
Preguntas frecuentes
¿Esta skill crea migraciones de base de datos?
¿Puede usarse sin QueryDSL?
¿Es compatible con PostgreSQL y MySQL?
¿Inspeccionará datos de producción?
¿Puede revisar límites de transacción?
¿Esta skill es específica de Allra?
Detalles del desarrollador
Autor
Allra-FintechLicencia
MIT
Repositorio
https://github.com/Allra-Fintech/allra-ai-skills/tree/main/backend-plugin/skills/database-schemaRef.
main
Estructura de archivos
📄 SKILL.md