README.md

Barbearia App

---

Tópicos 📋

• 📖 Sobre
• 📱 Preview
• 📦 Assets
• 🛠️ Funcionalidades e Tecnologias Estudadas
• 🤯 Desafios e Aprendizados ao longo do caminho
• 🤔 Como usar
• 💪 Como contribuir
• 📝 Licença

---

📖 Sobre

Projeto desenvolvido na Dart Week | 11ª Edição, um evento de lançamento para a Academia do Flutter (ADF), do Rodrigo Rahman.

Durante todo este ultimas duas semans, por ser um aluno da ADF (desde Outubro/2022), consegui entender com mais facilidade certos conceitos que ainda estavam confusos para mim, como a parte do RiverPod Flutter.

---

📦 Assets

• Coleção do PostMan
• UI Design criado para o evento: Barbearia

---

🛠️ Funcionalidades e Tecnologias Estudadas

• Usando o Dart 3:
  • Programação Funcional (Either) com Pure Dart (usando o poder do Dart 3)
  • Usando muitos métodos switch;
  • Usando pattern matching etc.
• Consulta da API usando o package Dio
• RiverPod como Gerenciamento de Estado e muito mais (grande novidade deste DW11)
• Fluxo de Login e Logout com a aplicação
• Persistência de dados com o SharedPreferences
• Pattern Matching com match
• Providers
• Telas:

  • Splash (tela inicial do app para transição)

  • Home (tela principal do app, tanto para o proprietario como o trabalhador)

  • Login (onde possui o fluxo de login)

  • Register (onde possui o fluxo de cadastro) Principais packages utilizados.

    • [dart sdk] = 3.2.6
    • [flutter_riverpod] - 2.4.10 https://pub.dev/packages/flutter_riverpod
    • [riverpod_annotation] - 2.3.4 (https://pub.dev/packages/riverpod_annotation)
    • [custom_lint] - 0.6.2 (https://pub.dev/packages/custom_lint)
    • [riverpod_lint] - 2.3.9 (https://pub.dev/packages/riverpod_lint)
    • [riverpod_generator] - 2.3.11 (https://pub.dev/packages/riverpod_generator)
    • [dio] - 5.4.1 (https://pub.dev/packages/dio)
    • [pretty_dio_logger] - 1.3.1 (https://pub.dev/packages/pretty_dio_logger)
    • [asyncstate] - 2.1.0 (Nacional) (https://pub.dev/packages/asyncstate)
    • [syncfusion_flutter_calender] - 22.2.11 (https://pub.dev/packages/syncfusion_flutter_calendar)
    • [top_snackbar_flutter] - 3.1.0 (https://pub.dev/packages/top_snackbar_flutter)
    • [shared_preferences] - 2.2.2 (https://pub.dev/packages/shared_preferences)
    • [loading_animation_widget] - 1.2.0+4 (https://pub.dev/packages/loading_animation_widget)
    • [intl] - 0.18.1 (https://pub.dev/packages/intl)
    • [validationles] - 1.2.3 (https://pub.dev/packages/validatorless)
    • [table_calendar] - 3.1.0 (https://pub.dev/packages/table_calendar)
    • [flutter_lints] - 3.0.1 (https://pub.dev/packages/flutter_lints)

    entre outros

🤯 Desafios e aprendizado ao longo do caminho

Sem dúvida, o maior aprendizado foi o Riverpod; Percebi que é muito interessante para gerenciar o estado de uma aplicação, indo além em pontos que podem ser cruciais (como poder ter vários provedores do mesmo tipo, realizar o descarte quando ela não for mais utilizada, entre outras coisas) .

Além disso, foi muito legal aprender mais sobre os poderes e usos do Dart 3 na prática, como o novo switch e o uso do pattern match; que se encaixam muito bem e tornam o código mais objetivo. Outro ponto que foi muito interessante foi o Either usado sem nenhuma dependência externa. Você pode usar programação funcional com correspondência de padrões para lidar com casos de erro e sucesso.

Vários outros aprendizados foram adquiridos e também reforçados; além de refatorações e melhorias de código feitas ao longo do caminho. Sempre há algo a ser melhorado e aprendido. 🚀

🤔 Como usar

É necessário ter o Flutter instalado. Para configurar o ambiente de desenvolvimento na sua máquina:
https://flutter.dev/docs/get-started/install

O aplicativo consome os dados do backend desenvolvido pela comunidade ADF chamado json_rest_server:
https://pub.dev/packages/json_rest_server

- Clone o repositório:
 $ git clone https://github.com/caneto/dartweek11_barbearia

- Entre no diretório:
$ cd dartweek11_barbearia\dw_barbershop

- Instale as dependências:
$ flutter pub get

- Instale o json_rest_server
$ dart pub global activate json_rest_server

- Abra a pasta em CMD, o backend
$ cd dartweek11_barbearia\dw_barbershop_api

- Para inicializá-lo, execute o comando:
$ jrs run

- Em outro terminal, no diretório raiz do projeto, execute:
$ flutter run

---

💪 Como contribuir

- Gosto bastante de seguir a seguinte Style Guide de Commits 😊:
https://udacity.github.io/git-styleguide/

- Dê um fork no projeto 

- Cria uma nova branch com suas mudanças:
$ git checkout -b my-feature

- Salve suas mudanças e faça uma mensagem de commit message sobre suas alterações:
$ git commit -m "feat: My new feature"

- Envie suas mudanças:
$ git push origin my-feature

---

📝 Licença

Esse repositório está sobre a Licença GNU General Public License v3.0, e você pode vê-la no arquivo LICENSE para mais detalhes. 😉

---

Esse projeto foi desenvolvido com ❤️ por @Carlos Alberto Pinto, com o instrutor @Rodrigo Rahman, no evento #DartWeek da [Academia do Flutter].
Se isso te ajudou, dê uma ⭐, e contribua, isso irá me ajudar também 😉