Escreva o contrato do projeto
A central recebe um CSV com identificador, cliente, tarefa e prazo. Ela mostra os pedidos, destaca campos ausentes e permite exportar o resultado. O primeiro MVP funciona localmente, sem envio de mensagens, contas de usuário ou integração com calendários.
Defina a unidade: uma linha corresponde a um pedido. Identificadores repetidos exigem uma decisão explícita. Se o conteúdo for igual, podem representar nova tentativa; se for diferente, devem aparecer como conflito. Essa regra precisa existir antes de desenhar a tela.
Por que aprender
O contrato combina os aprendizados iniciais e impede que o projeto cresça antes de funcionar. Ele estabelece uma entrega que pode ser demonstrada com poucos arquivos.
✓ Fazer
Separar regras de dados da interface.
✗ Evitar
Adicionar login antes de validar a importação.
Conceitos-chave
Prepare os dados de teste
Monte um arquivo com pedidos completos, um prazo ausente, um nome longo e um identificador repetido. Esses casos são dados de teste, não acidentes a corrigir manualmente. Guarde uma tabela com o resultado esperado para cada um.
Use apenas dados fictícios no exercício. O arquivo pode ser compartilhado com quem revisar o projeto sem carregar informações reais. Se usar vírgulas dentro de campos, confira o formato CSV adequado e a leitura pela ferramenta escolhida.
Por que aprender
Um conjunto variado evita que a central funcione apenas com a primeira linha. O resultado esperado serve como referência durante implementação e revisão.
Um caminho para aplicar
- Defina contrato e dados fictícios com resultado esperado.
- Implemente importação, validação, lista e exportação.
- Demonstre os casos e registre a revisão.
Conceitos-chave
Desenhe um fluxo pequeno
Represente importação, validação, lista e exportação. Uma entrada inválida precisa de uma mensagem que permita corrigir o arquivo. O erro não deve apagar os pedidos já carregados sem que isso seja explicado.
Separe a leitura do arquivo das regras de validação. Essa divisão facilita testar o comportamento sem depender da interface. Uma função pode receber registros e devolver registros válidos, pendências e conflitos, que a tela apresenta depois.
Por que aprender
A separação reduz acoplamento e torna a revisão mais clara. Você consegue investigar uma regra de dados sem refazer toda a experiência visual.
id,cliente,tarefa,prazo
P-01,Oficina fictícia Norte,Revisar catálogo,2026-11-02
P-02,Ateliê fictício Lua,Organizar imagens,
P-01,Oficina fictícia Norte,Revisar catálogo,2026-11-02
Regra esperada: P-01 não duplica; P-02 mantém prazo pendente.
Conceitos-chave
Construa a primeira entrega
Peça ao assistente que implemente somente o fluxo definido. Entregue contrato, dados fictícios, resultados esperados e restrições. Solicite que ele explique como executar e verificar a solução. Escolha uma tecnologia que você consiga manter.
Depois da primeira versão, teste manualmente os casos. Não use a afirmação do assistente como prova. Abra o arquivo exportado em outra ferramenta e confirme colunas, acentos, quantidade de linhas e preservação das pendências.
Por que aprender
A implementação ganha um limite claro e uma definição de pronto. A abertura da saída em outra ferramenta verifica se o resultado é utilizável fora da tela original.
✓ Fazer
Abrir o CSV exportado em outro programa.
✗ Evitar
Esconder duplicatas apenas na aparência da tabela.
Conceitos-chave
Revise os pontos de falha
Teste importação repetida, arquivo vazio e conteúdo inválido. Uma nova tentativa não deve duplicar silenciosamente pedidos nem substituir dados sem aviso. Confira também o comportamento quando o armazenamento do navegador estiver indisponível.
Faça uma revisão independente do código e dos resultados. Dê prioridade a perda de dados, duplicação e exportação incorreta. Melhorias visuais entram depois que o fluxo principal estiver confiável. Registre limitações conhecidas no README.
Por que aprender
Os testes aproximam a ferramenta das condições reais de uso. A revisão encontra riscos que não aparecem na demonstração de um único caminho bem-sucedido.
| Critério | Evidência esperada |
|---|---|
| Fluxo | Importar e exportar preserva campos e acentos. |
| Pendência | Prazo ausente continua identificado. |
| Repetição | Mesma entrada não gera efeitos extras. |
Conceitos-chave
Prática: demonstre a central
A entrega final reúne a ferramenta, os dados fictícios, o arquivo exportado e um registro das verificações. Faça uma demonstração curta: importar, localizar a pendência, lidar com uma duplicata e exportar.
Se uma parte ainda falhar, descreva o caso e a menor correção necessária. Não marque o projeto inteiro como concluído porque a tela abriu. A conclusão depende dos critérios definidos no início, que devem permanecer visíveis durante a revisão.
Por que aprender
O projeto mostra como várias pílulas se transformam em uma ferramenta pequena. Ele também ensina a entregar um resultado que outra pessoa consegue conferir e continuar.
Seu exercício
Implemente ou prototipe a central com os dados do exemplo. Acrescente um P-01 com tarefa diferente e descreva como o conflito aparece. Entregue README, entrada e saída.
Baixar ficha da práticaConferir resposta comentada
O P-01 idêntico é tratado como repetição. O P-01 divergente aparece como conflito que precisa de decisão, sem substituir a primeira tarefa silenciosamente. P-02 permanece com prazo pendente. A exportação deve permitir distinguir registros aceitos de pendências ou conflitos conforme o contrato adotado.
Cheque sua compreensão
Quando o MVP pode ser considerado concluído?
Conceitos-chave
O que fica deste módulo
Uma central local que importa pedidos, preserva pendências e exporta uma tabela.
- ✓ Importar e exportar preserva campos e acentos.
- ✓ Prazo ausente continua identificado.
- ✓ Mesma entrada não gera efeitos extras.
O progresso registra sua leitura. A prática fica concluída quando você confere a entrega.