https://github.com/origemjhanpoll/flutter_gs3_test
Aplicativo Flutter que exibe uma lista de cartões do cliente, permitindo visualizar transações e informações relevantes de cada cartão. Desenvolvido com MVVM e Atomic Design, utilizando Provider para gerenciamento de estado.
https://github.com/origemjhanpoll/flutter_gs3_test
android atomic-design dart flutter http ios mvvm mvvm-architecture test test-ui
Last synced: about 1 year ago
JSON representation
Aplicativo Flutter que exibe uma lista de cartões do cliente, permitindo visualizar transações e informações relevantes de cada cartão. Desenvolvido com MVVM e Atomic Design, utilizando Provider para gerenciamento de estado.
- Host: GitHub
- URL: https://github.com/origemjhanpoll/flutter_gs3_test
- Owner: origemjhanpoll
- Created: 2025-02-04T01:24:41.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-14T02:13:09.000Z (about 1 year ago)
- Last Synced: 2025-02-14T03:23:21.691Z (about 1 year ago)
- Topics: android, atomic-design, dart, flutter, http, ios, mvvm, mvvm-architecture, test, test-ui
- Language: Dart
- Homepage:
- Size: 10.7 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 📱 Aplicativo de Cartões
Este aplicativo exibe uma lista de cartões do cliente, permitindo visualizar transações e informações relevantes de cada cartão. Ele foi desenvolvido em **Flutter**, utilizando **MVVM** como padrão arquitetural e **Atomic Design** para organização dos componentes da UI.
## 📸 Capturas de Tela
## 🚀 Tecnologias Utilizadas
- **Linguagem:** Dart
- **Framework:** Flutter
- **Arquitetura:** MVVM
- **Padrão de UI:** Atomic Design (atoms, molecules, organisms, templates)
- **Gerenciamento de estado:** Provider
## 📂 Estrutura do Projeto
O projeto segue uma estrutura modularizada:
```
/lib
├── app
│ ├── models # Modelos de dados
│ ├── services # Serviços e requisições HTTP
│ ├── viewmodels # ViewModels (lógica de negócios e estado)
│ ├── views # Telas do aplicativo
│ │ ├── widgets # Componentes reutilizáveis
│ │ │ ├── atoms # Elementos básicos (ex: botões, textos)
│ │ │ ├── molecules # Pequenos agrupamentos de átomos
│ │ │ ├── organisms # Componentes mais complexos
│ │ │ ├── templates # Estruturas completas de tela
│ │ ├── home_view.dart # Tela principal
├── core
│ ├── shared # Componentes compartilhados (AppBar, Drawer, etc.)
│ ├── utils # Utilitários e funções auxiliares
│ ├── constants # Constantes globais do app
```
## ✅ Testes
O projeto inclui testes unitários e de widgets para garantir a qualidade do código e a estabilidade das funcionalidades. Os testes são escritos utilizando o pacote `mockito` para simulação de dependências e `flutter_test` para validação de widgets.
Para executar os testes, utilize o seguinte comando:
```bash
flutter test
```
## 🛠 Dependências Externas
As seguintes bibliotecas foram utilizadas no projeto:
```yaml
dependencies:
equatable: ^2.0.7
http: ^1.3.0
provider: ^6.1.2
flutter_svg: ^2.0.17
intl: ^0.20.2
dev_dependencies:
mockito: ^5.4.5
```
## 📌 Instruções para Execução
### Pré-requisitos
Certifique-se de ter instalado:
- **Flutter** ([https://flutter.dev/docs/get-started/install](https://flutter.dev/docs/get-started/install))
- **Dart**
- **Emulador ou dispositivo físico**
### Como rodar o projeto
1. Clone o repositório:
```bash
git clone https://github.com/origemjhanpoll/flutter_gs3_test
cd flutter_gs3_test
```
2. Instale as dependências:
```bash
flutter pub get
```
3. Execute o aplicativo:
```bash
flutter run
```
_(Para rodar no iOS, é necessário um Mac com Xcode instalado.)_
## ❌ Suporte para Web
Atualmente, este aplicativo **não possui suporte para Web**. Ele foi desenvolvido exclusivamente para **Android e iOS**.
## 🤝 Contribuição
Sinta-se à vontade para abrir issues ou contribuir com melhorias!
## 📄 Licença
Este projeto está sob a licença MIT.