CEP

Encontre e salve seus endereços mais importantes.

Status do Projeto: Primeira versão concluída em 24/08/2022 v1.0.0+1 :heavy_check_mark:

---

---

Descrição do projeto :pencil:

A partir da utilização da API pública da plataforma Via Cep, o aplicativo CEP permite ao usuário pesquisar e salvar como favoritos CEPs de todo o Brasil. Além disso, o número de pesquisas feitas também é salvo.

O principal objetivo da criação do app foi desenvolver uma aplicação simples que:

• Utilizasse um gerenciador de estados, nesse caso o Getx;
• Fosse capaz de fazer solicitações à uma RESTapi. CEP usa o package Dio para isso.
• Fizesse o uso de alguma arquitetura, como a Clean Architecture que uso aqui.
• Usasse qualquer package para persistência de dados, mas aqui decidi usar 2 tipos de persistência. O package Sqflite para criar um banco de dados local e o Get Storage para salvar variáveis simples.
• Tivesse testes unitários em cada camada da arquitetura.

Tecnologias utilizadas :paperclip:

Ferramentas

• Via Cep API
• Extensão Flutter Coverage para VsCode
• Extensão Coverage Gutters para VsCode

Plugins

• auto_size_text
• mocktail
• dio
• either_dart
• sqflite
• path_provider
• logger
• mask_text_input_formatter
• flutter_svg
• get_storage

O que o app é capaz de fazer :crystal_ball:

:trophy: Procurar e exibir a informações sobre qualquer logradouro do Brasil.

:trophy: Salvar o endereço pesquisado em um banco de dados offline.

:trophy: Mostrar a lista de endereços salvos.

:trophy: Excluir qualquer endereço salvo.

:trophy: Mostrar se o endereço pesquisado já está salvo no banco de acordo com o CEP.

:trophy: Salvar o número de pesquisas bem sucedidas feitas.

Bora dar uma clonada? :computer:

Obs.: Certifique-se de ter o Flutter 3.0 ou superior instalado, caso não esteja, execute:

flutter upgrade

Com Flutter atualizado execute:

git clone https://github.com/danieldcastro/cep
cd cep
flutter pub get
flutter run

Se precisar, baixe aqui a versão release do projeto.

---

Se você gostou deste repositório, por favor apoie dando uma :star:

Feito com ❤️ e lutter por Daniel Marciano!