# Construa um registro de horas para uma equipe

Transforme um pedido de cinco frases em um sistema com cadastros, lançamento de horas, painel semanal e exportação, e saiba o que conferir antes de usar.

Fonte: https://guides.adapta.org/guias/casos-de-uso/por-plataforma/skip/registro-horas/

**TL;DR** · Exemplo com execução documentada: um pedido gerado pelo Início Guiado virou o sistema **Registro de Horas Aurora** em uma única execução do agente (37 etapas, pouco mais de quatro minutos, 10 créditos), com login, cadastros, lançamento de horas, painel semanal e exportação em CSV. O plano e a construção foram conferidos; o teste das telas por dentro do app fica com você.

## A situação

Uma agência com quatro pessoas precisa saber quantas horas cada uma dedicou a cada cliente na semana. Hoje isso fica em planilhas separadas. O objetivo é um sistema simples, com dados fictícios, que a equipe consiga usar no mesmo dia.

## O que você pratica

Escrever um pedido completo de uma vez (objetivo, público, funcionalidades, estilo), ler o plano que o agente propõe antes de aceitar o resultado e separar o que foi construído do que ainda precisa ser testado.

## Entrada e resultado conferido

O pedido foi montado pelo **Início Guiado** do workspace, com os cinco campos preenchidos, e enviado ao builder com o Skip Cloud como banco padrão:

````
Quero criar um sistema de registro de horas para a equipe da Agência Aurora
(dados fictícios) com foco em saber quantas horas cada pessoa dedicou a cada
cliente na semana incluindo cadastro de clientes e projetos, lançamento de horas
com data e descrição, painel semanal por pessoa e por cliente, exportação em CSV
em um visual claro, simples e objetivo.

````

O agente respondeu em duas partes. Primeiro, o entendimento do pedido e um plano de oito etapas, marcadas conforme concluídas:

1. Banco de dados e dados de exemplo.

2. Login e rotas protegidas.

3. Layout com menu lateral e versão para celular.

4. Páginas de entrada (login e criação de conta).

5. Painel semanal com seletor de semana, cartões de totais, gráficos, tabela e exportação em CSV.

6. Formulário de lançamento de horas com a lista dos últimos lançamentos.

7. Cadastros de clientes e projetos.

8. Verificação de qualidade.

Depois, o rastro da execução: cada arquivo criado ou editado aparece como uma linha ("Criado", "Editado", "Consultou o banco", "Verificou qualidade"), e o painel do plano mostra quantas etapas já foram concluídas. Ao final, a mensagem informou **37 etapas concluídas em 265 segundos**, o rodapé marcou **10 créditos** e o projeto ficou na **Versão 0.0.1**, com o nome **Registro de Horas Aurora** atribuído automaticamente.

|  O que o pedido dizia |  O que o agente entregou, segundo o resumo final |
| --- | --- |

|  Cadastro de clientes e projetos |  Páginas Clientes e Projetos, com criação, edição e exclusão |

|  Lançamento de horas com data e descrição |  Página Lançar Horas, com pessoa, cliente, projeto, data, horas e descrição, mais os lançamentos recentes |

|  Painel semanal por pessoa e por cliente |  Painel com navegação por semana, cartões de totais, gráficos por pessoa e por cliente e tabela |

|  Exportação em CSV |  Botões Exportar CSV nos gráficos, respeitando a semana selecionada |

|  Dados fictícios |  Equipe Ana, Carlos, Marina e Rafael; clientes TechNova, VerdeVida e MundoDoce; lançamentos de exemplo |

O pedido não falava em acesso, mas o agente criou um login com um usuário inicial, porque projetos no Skip Cloud nascem com autenticação. A pré-visualização abriu na tela de entrada do app: logo "AA", nome "Agência Aurora", e-mail, senha, "Esqueci minha senha", **Entrar** e **Criar conta**. As credenciais iniciais ficaram na conversa; troque a senha no primeiro acesso e nunca cole senhas no chat (veja [Cuidados com dados e chaves](https://guides.adapta.org/guias/skip/conta-e-organizacao/dados/)).

O resumo do agente descreve o que ele construiu, não o que você já validou. Antes de mostrar o sistema à equipe, entre no app, lance duas ou três horas em clientes diferentes, mude a semana no painel e abra o CSV exportado. Se algo não bater, peça a correção como um novo pedido pequeno, uma mudança por vez.

## Como levar para sua operação

Reaproveite a estrutura do pedido trocando o que está entre as vírgulas: o tipo de solução, o público, o objetivo, as funcionalidades e o estilo. Mantenha no máximo três funcionalidades na primeira versão e diga na restrição o que o agente não deve fazer (por exemplo, "não crie login" quando o sistema for público). O método está em [Como pedir à IA](https://guides.adapta.org/guias/skip/comece-aqui/preparar-pedidos/).

Cada nova versão é mais uma execução do agente e consome créditos; o custo aparece no rodapé de cada resposta. Consulte o saldo em [Créditos e plano](https://guides.adapta.org/guias/skip/conta-e-organizacao/creditos/) antes de uma sequência longa de ajustes.

**Dica do curso:** em *Os 10 Mandamentos do Skip*, Romário Melo recomenda construir por partes e começar pelo cadastro, porque painéis e gráficos nascem dos dados que ele guarda. Neste exemplo o pedido inteiro coube em uma execução; em sistemas maiores, peça primeiro os cadastros e deixe o painel para a segunda mensagem.

[Explore outros casos do Skip](https://guides.adapta.org/guias/casos-de-uso/por-plataforma/skip/).