Skip to main content

Criar um rastreador de PTO para a equipe

Descreva sua ferramenta e o Devin a cria, testa e verifica de ponta a ponta.
AuthorCognition
CategoryDesenvolvimento de funcionalidades
1

(Opcional) defina o escopo da base de código com o Ask Devin

Se você já tem ferramentas internas na sua aplicação, use o Ask Devin para entender os padrões existentes antes de escrever sua especificação. Isso é especialmente útil se você quiser que a nova ferramenta siga a mesma arquitetura do que já existe:Use as respostas para preencher sua especificação com referências específicas de arquivos, nomes de componentes e padrões, para que o Devin construa algo consistente com suas ferramentas existentes. Você também pode iniciar uma sessão do Devin diretamente a partir do Ask Devin, e ele levará em conta tudo o que aprendeu como contexto.
2

Redija uma especificação detalhada

Ferramentas internas — rastreadores de PTO, painéis administrativos, scripts de dados, utilitários de CLI — são essenciais, mas raramente priorizadas. Elas são ideais para o Devin porque os requisitos são bem definidos, o público é o seu time e “funcionar corretamente” importa mais do que um design pixel-perfect.Seja específico sobre o que a ferramenta faz, quais dados ela armazena e a quais serviços ela se conecta. Quanto mais detalhes você incluir, mais a primeira versão vai corresponder ao que você precisa.Você também pode iterar na sua especificação usando o Ask Devin — cole um rascunho e peça para ele identificar lacunas ou sugerir melhorias com base na sua base de código.
3

Adicionar credenciais

Passe quaisquer chaves de API ou tokens de que o Devin precise via Secrets — neste caso, a URL do webhook do Slack.A abordagem mais simples é armazená-los como segredos da organização antes de iniciar a sessão:
  1. Vá para Settings > Secrets e adicione SLACK_WEBHOOK_URL
  2. O Devin acessa segredos como variáveis de ambiente, de modo que eles nunca fiquem gravados diretamente no seu código-fonte.
Segredos da organização devem ser adicionados antes de iniciar a sessão — eles são injetados no início da sessão. Como alternativa, você pode fornecer segredos durante a sessão usando o chat, e o Devin também pedirá proativamente quaisquer credenciais de que precisar quando encontrar variáveis de ambiente ausentes.
4

Oriente a sessão com comandos de barra (/)

Assim que a sessão começar, você pode usar comandos com barra para orientar o fluxo de trabalho do Devin:
  • /plan — Peça ao Devin para criar um plano de implementação detalhado antes de escrever qualquer código. Revise o plano e sugira alterações antes que ele comece a implementar.
  • /test — Diga ao Devin para executar todos os testes e validar seu trabalho. Use isso após cada marco importante para detectar problemas cedo.
  • /review — Peça ao Devin para revisar o próprio código em busca de bugs, casos extremos e problemas de estilo antes de abrir a PR.
Esses comandos funcionam a qualquer momento durante a sessão — use /plan no início, /test depois que cada funcionalidade for implementada e /review antes da PR final.
5

Devin cria e verifica se funciona

Devin trata ferramentas internas como qualquer funcionalidade de produção — escreve o código, adiciona testes e depois abre o app em seu navegador integrado para verificar se a UI funciona de ponta a ponta.
  1. Investiga sua base de código — Encontra seus componentes DataTable e Calendar, lê seu esquema Prisma e estuda o layout existente da página /internal/
  2. Cria a migration do banco de dados — Adiciona as tabelas pto_requests e pto_balances via Prisma
  3. Constrói as páginas — Formulário de envio de solicitações, fila de aprovação do gerente, visualização em calendário e dashboard de saldos em /internal/pto
  4. Integra o Slack — Envia notificações via webhook quando solicitações são enviadas e quando são aprovadas ou negadas
  5. Escreve testes — Testes unitários para cálculos de saldo de PTO e detecção de sobreposição de datas, testes de API para os endpoints de solicitação, testes de integração para o fluxo de aprovação
  6. Abre o app em seu navegador — Navega por cada página, envia uma solicitação de PTO de teste, aprova a partir da visão do gerente, verifica se o calendário é atualizado, confere os números do dashboard e testa casos limite como datas sobrepostas e saldo excedido
  7. Abre um PR — Entrega tudo: migration, script de seed, código da aplicação, testes e uma seção no README explicando como usar a ferramenta
A verificação no navegador captura problemas que testes automatizados não detectam — layouts de formulário quebrados, um calendário que renderiza mas não responde a cliques, ou um botão de envio que não limpa o formulário após o sucesso.
6

Expanda sua ferramenta

Once the base tool works, add features in follow-up sessions:
7

Revise o PR com o Devin Review

Quando o Devin abrir o PR, use o Devin Review para revisar as alterações. O Devin Review tem contexto completo da sua base de código e pode detectar bugs, problemas de segurança e inconsistências de estilo em todo o diff.