A visão do projeto

O que a agenda de contatos faz

Chegou o momento de juntar o curso em um único programa. Ao longo dos módulos anteriores você aprendeu peças soltas: classes, compreensões, tratamento de erros, leitura e escrita de arquivos, testes. Cada uma resolvia um problema pequeno. Um projeto é o que dá sentido a esse conjunto, porque força as peças a trabalharem juntas. A agenda de contatos foi escolhida por ser útil, pequena o bastante para caber em poucas aulas e completa o bastante para exercitar tudo que importa no nível intermediário.

Em termos práticos, a agenda é um programa que roda no terminal e mantém uma lista de contatos. Cada contato tem três informações: nome, telefone e e-mail. O usuário escolhe o que fazer por um menu de números: adicionar um novo contato, listar todos, procurar um pelo nome, remover um e exportar a lista para uma planilha. Entre uma execução e outra, os dados não se perdem, porque são gravados em um arquivo. É um programa modesto, mas de verdade: tem estado que persiste, tem entrada do usuário para validar e tem erros para tratar com cuidado.

Como será a conversa no terminal

Vale imaginar a experiência antes de codar. Quando você roda o programa, ele mostra um menu e espera um número. Você escolhe adicionar, informa os dados, e ele confirma. Escolhe listar, e ele imprime os contatos. Pensar na interação primeiro ajuda a decidir quais métodos as classes vão precisar. O bloco abaixo simula uma sessão típica, com o que o programa mostra e o que o usuário digita.

1) Adicionar  2) Listar  3) Buscar  4) Remover  5) Exportar CSV  0) Sair
Opcao: 1
Nome: Ana Souza
Telefone (so numeros): 11999998888
E-mail: ana@exemplo.com
Contato adicionado.

1) Adicionar  2) Listar  3) Buscar  4) Remover  5) Exportar CSV  0) Sair
Opcao: 2
Ana Souza | 11999998888 | ana@exemplo.com

1) Adicionar  2) Listar  3) Buscar  4) Remover  5) Exportar CSV  0) Sair
Opcao: 3
Nome a buscar: joao
Nao encontrei 'joao'.

1) Adicionar  2) Listar  3) Buscar  4) Remover  5) Exportar CSV  0) Sair
Opcao: 0
Ate mais!

Uma sessão de uso da agenda. O menu se repete até o usuário escolher sair.

Repare em detalhes que já anunciam decisões de projeto. O telefone é pedido só com números, o que sugere uma validação. A busca por um nome que não existe responde com uma mensagem amigável, não com um erro feio que derruba o programa, o que sugere tratamento de exceção. O menu volta sempre, o que sugere um laço. Cada uma dessas observações vira código nas próximas aulas. Essa é a virtude de visualizar a conversa antes: o programa nasce a partir do que o usuário vai viver, não de dentro para fora.

De onde vem cada peça

A agenda não inventa nada novo. Ela combina o que você já viu no curso. A tabela abaixo liga cada parte do projeto ao módulo que ensinou a técnica. É um bom lembrete de que um projeto é, no fundo, uma montagem consciente de ferramentas conhecidas, cada uma no lugar certo.

A estratégia daqui em diante é uma só: construir de forma incremental. Em vez de escrever o programa inteiro e torcer para funcionar, cada aula acrescenta uma peça e roda o resultado. A aula 2 cria as classes vazias que só guardam dados. A 3 dá ações à agenda. A 4 trata os erros. A 5 salva em arquivo. A 6 exporta e monta o menu final. A 7 escreve os testes. A cada etapa o programa continua rodando, um pouco mais completo. Assim, quando algo quebra, você sabe exatamente onde procurar, porque só uma coisa mudou.