O My Courses App é um projeto desenvolvido em Flutter, criado com o objetivo principal de aprimorar o entendimento de Clean Architecture, Test-Driven Development (TDD), bem como a implementação dos padrões Bloc e Cubit.
O My Courses App foi desenvolvido como uma aplicação de exemplo para demonstrar as melhores práticas de desenvolvimento de software, incluindo a implementação da arquitetura Clean Architecture, o uso dos padrões Bloc e Cubit, e a aplicação rigorosa do TDD. O foco principal do projeto é a qualidade do código e a manutenção, seguindo os princípios SOLID e a separação de preocupações.
-
Clean Architecture: O projeto é estruturado seguindo os princípios da Clean Architecture, garantindo uma separação clara das camadas de negócios, apresentação e dados.
-
Test-Driven Development (TDD): O desenvolvimento de recursos e funcionalidades é orientado por testes unitários, garantindo a robustez do código.
-
Bloc e Cubit: Utilizamos os padrões Bloc e Cubit para gerenciar o estado da aplicação de forma eficiente, tornando a aplicação mais previsível e fácil de manter.
Aqui, apresentamos um exemplo de tela do My Courses App para ilustrar a interface do usuário e como as funcionalidades são apresentadas aos usuários.
Na tela de início, inicialmente possui uma listagem com todos usuários cadastrados na plataforma.
Permite a criação de novos usuários.
Esta é apenas uma amostra das telas disponíveis no My Courses App.
A estrutura do projeto segue a organização típica da Clean Architecture, com as seguintes camadas principais:
-
Presentation: Esta camada contém a interface do usuário e a lógica de apresentação, gerenciada através dos Blocs e Cubits.
-
Domain: A camada de domínio contém a lógica de negócios, as entidades e os casos de uso da aplicação. Ela é independente da plataforma e se beneficia da previsibilidade proporcionada pelo Bloc e Cubit.
-
Data: A camada de dados lida com a obtenção e persistência de dados. Isso inclui acesso a APIs externas, bancos de dados locais e armazenamento em cache, tudo gerenciado de forma eficiente pelo Bloc e Cubit.
Implementamos um sistema abrangente de cobertura de testes usando o Codecov e o GitHub Actions para garantir a qualidade do código no My Courses App. Isso nos ajuda a identificar áreas do código que não estão adequadamente testadas e a manter a integridade do projeto.
Através do Codecov, monitoramos de perto a cobertura de testes em várias partes do projeto. Isso nos permite garantir que as funcionalidades e componentes essenciais sejam testados de forma adequada, proporcionando maior confiabilidade ao nosso aplicativo.
Aqui está um exemplo do painel do Codecov para a branch de desenvolvimento (develop) do projeto:
Este painel oferece uma visão geral da cobertura de testes em nossa branch de desenvolvimento, permitindo-nos identificar áreas que podem precisar de testes adicionais.
O uso do Codecov e do GitHub Actions demonstra nosso compromisso em manter a qualidade do código e garantir que o My Courses App seja uma aplicação sólida e confiável para nossos usuários.
Para configurar e executar o My Courses App localmente, siga estas etapas:
-
Clone este repositório para o seu ambiente de desenvolvimento:
git clone https://github.com/seu-usuario/my-courses-app.git
-
Navegue até o diretório do projeto:
cd my-courses-app -
Instale as dependências do Flutter:
flutter pub get
-
Execute o aplicativo em um emulador ou dispositivo físico:
flutter run
A contribuição para o projeto My Courses App é bem-vinda! Sinta-se à vontade para abrir problemas (issues) ou enviar solicitações de pull (pull requests) para melhorias, correções de bugs ou novas funcionalidades.
Este projeto está licenciado sob a Licença MIT. Sinta-se à vontade para usá-lo e modificá-lo de acordo com suas necessidades.
Esperamos que o My Courses App seja uma ferramenta útil para aprimorar seu conhecimento em Clean Architecture, TDD, Bloc e Cubit, além de servir como um exemplo de boas práticas de desenvolvimento de aplicativos Flutter. Se você tiver alguma dúvida ou precisar de assistência, não hesite em entrar em contato com a equipe de desenvolvimento. Aproveite o aprendizado e aprimoramento das suas habilidades de desenvolvimento!