Skip to main content

Crear un rastreador de PTO del equipo

Describe tu herramienta y Devin la crea, prueba y verifica de extremo a extremo.
AuthorCognition
CategoryDesarrollo de funcionalidades
1

(Opcional) Delimita la base de código con Ask Devin

Si ya cuentas con herramientas internas en tu aplicación, usa Ask Devin para entender los patrones existentes antes de escribir tu especificación. Esto es especialmente útil si quieres que la nueva herramienta coincida con la arquitectura de lo que ya hay:Usa las respuestas para completar tu especificación con referencias de archivos concretas, nombres de componentes y patrones, de modo que Devin construya algo coherente con tus herramientas existentes. También puedes iniciar una sesión de Devin directamente desde Ask Devin, y se conservará todo lo que haya aprendido como contexto.
2

Escribe una especificación detallada

Las herramientas internas — rastreadores de PTO, paneles de administración, scripts de datos, utilidades de CLI — son esenciales, pero rara vez se priorizan. Son ideales para Devin porque los requisitos están bien definidos, la audiencia es tu propio equipo, y que “funcione correctamente” importa más que un diseño de píxeles perfectos.Sé específico sobre lo que hace la herramienta, qué datos almacena y a qué servicios se conecta. Cuantos más detalles incluyas, más se parecerá la primera versión a lo que realmente necesitas.También puedes iterar sobre tu especificación usando Ask Devin: pega un borrador y pídele que identifique brechas o sugiera mejoras basadas en tu base de código.
3

Añadir credenciales

Pasa cualquier API key o token que Devin necesite mediante Secrets; en este caso, la URL del webhook de Slack.El enfoque más sencillo es almacenarlos como secrets de la organización antes de iniciar la sesión:
  1. Ve a Settings > Secrets y añade SLACK_WEBHOOK_URL
  2. Devin accede a los secrets como variables de entorno, de modo que nunca quedan hardcodeadas en tu código fuente.
Los secrets de organización deben añadirse antes de iniciar la sesión: se inyectan al inicio de la sesión. Como alternativa, puedes proporcionar secrets durante la sesión usando el chat, y Devin también te pedirá de forma proactiva cualquier credencial que necesite cuando detecte variables de entorno faltantes.
4

Guía la sesión con comandos de barra diagonal (/)

Una vez que comience la sesión, puedes usar comandos slash para guiar el flujo de trabajo de Devin:
  • /plan — Pídele a Devin que cree un plan de implementación detallado antes de escribir cualquier código. Revisa el plan y sugiere cambios antes de que empiece a implementar.
  • /test — Indícale a Devin que ejecute todas las pruebas y verifique su trabajo. Úsalo después de cada hito importante para detectar problemas a tiempo.
  • /review — Pídele a Devin que revise su propio código en busca de errores, casos límite y problemas de estilo antes de abrir la PR.
Estos comandos funcionan en cualquier momento durante la sesión: usa /plan al inicio, /test después de implementar cada funcionalidad y /review antes de la PR final.
5

Devin lo crea y comprueba que funciona

Devin trata las herramientas internas como cualquier funcionalidad en producción: escribe el código, añade pruebas y luego abre la aplicación en su navegador integrado para verificar que la interfaz funciona de extremo a extremo.
  1. Investiga tu base de código — Encuentra tus componentes DataTable y Calendar, lee tu esquema de Prisma y estudia el diseño actual de la página /internal/
  2. Crea la migración de la base de datos — Añade las tablas pto_requests y pto_balances a través de Prisma
  3. Construye las páginas — Formulario para enviar solicitudes, cola de aprobación para managers, vista de calendario y panel de saldos bajo /internal/pto
  4. Integra Slack — Envía notificaciones por webhook cuando se envían solicitudes y cuando se aprueban o rechazan
  5. Escribe pruebas — Pruebas unitarias para los cálculos de saldo de PTO y la detección de solapamiento de fechas, pruebas de API para los endpoints de solicitudes, pruebas de integración para el flujo de aprobación
  6. Abre la aplicación en su navegador — Navega a cada página, envía una solicitud de PTO de prueba, la aprueba desde la vista de manager, verifica que el calendario se actualiza, comprueba los números del panel y prueba casos límite como fechas solapadas y saldos excedidos
  7. Abre una solicitud de extracción (PR) — Entrega todo: migración, script de datos iniciales, código de la aplicación, pruebas y una sección en el README que explica cómo usar la herramienta
La verificación en el navegador detecta problemas que las pruebas automatizadas no capturan: diseños de formularios defectuosos, un calendario que se renderiza pero no responde a los clics, o un botón de envío que no limpia el formulario tras completarse correctamente.
6

Amplía tu herramienta

Una vez que la herramienta base funcione, agrega funciones en sesiones posteriores:
7

Revisa el pull request (PR) con Devin Review

Una vez que Devin abra el PR, utiliza Devin Review para revisar los cambios. Devin Review dispone de todo el contexto de tu base de código y puede detectar errores, problemas de seguridad e inconsistencias de estilo en todo el diff.