filipecancio/marvel-characters

See your favorite Marvel characters here!

Pre requisitos

• Versão recente do Android Studio
• versão recente kotlin
• java na versão 1.8
• celular ou emulador

Como rodar

🇧🇷 Primeiramente você precisa definir as variáveis locais para o projeto rodar. Você pode seguir os passos em nossa wiki Definindo Variáveis Locais.

Em seguida precisa colocar pasta app do projeto o arquivo google-services.json

Depois basta buildar e executar o projeto.

marvel-characters's Issues

App Challenge - Aplicativo de Gerenciamento de HQs Marvel

Objetivo

Integrar com a API da Marvel para listar personagens através do endpoint GET
/v1/public/comics, implementar paginação e adicionar um recurso para marcar HQs como favoritas.

Requisitos

Listar Personagens:

• Integrar com a API da Marvel. Done with #2
• Usar o endpoint GET /v1/public/comics para buscar personagens de HQs.
• Implementar paginação para exibir 15 personagens por vez. Done with #3
• Aumentar o número de personagens exibidos em 15 cada vez que o último personagem da lista for alcançado. Done with #3

Favoritar HQs:

• Implementar funcionalidade para marcar HQs como favoritas.
• Fornecer uma seção separada no aplicativo para listar todas as HQs favoritas.

Itens Obrigatórios:

Integração com API:

• Buscar personagens de HQs usando a API da Marvel.
• Implementar tratamento de erros adequado e exibir mensagens amigáveis ao usuário.

Paginação:

• Implementar carregamento dinâmico para buscar o próximo conjunto de personagens
  conforme o usuário rola a tela para baixo.
• Cada busca deve recuperar 15 personagens.

Gerenciamento de Favoritos:

• Permitir que os usuários marquem/desmarquem HQs como favoritas.
• Exibir a lista de HQs favoritas em uma seção separada.
• Armazenar as HQs favoritas localmente usando Room ou outro banco de dados local.

UI/UX:

• Criar uma interface amigável para listar HQs e gerenciar favoritos.
• Garantir rolagem suave e design responsivo.

Testes:

• Fornecer testes unitários para a lógica de negócios.
• Fornecer testes de interface para garantir que a interface do usuário funcione
  conforme esperado.

Documentação:

• Fornecer um README.md com instruções sobre como configurar e executar o projeto.
• Incluir uma breve descrição do propósito e das funcionalidades do projeto.
• Documentar a integração com a API da Marvel e quaisquer suposições ou limitações.

Itens Desejáveis

• Logging e Tratamento de Erros
• Qualidade dos Commits
• Qualidade do Código
• Documentação e Apresentação
• [ ]

Entrega:

Repositório GitHub:

• Hospedar o projeto em um repositório GitHub.
• Garantir que o repositório seja público e acessível.

2. Executando o Aplicativo:

• Incluir instruções claras no README.md sobre como configurar e executar o aplicativo.
• Fornecer quaisquer scripts de configuração ou arquivos de configuração necessários.

Seguindo essa estrutura, você criará um aplicativo abrangente e amigável que se integra com a API
da Marvel, demonstra habilidades em Kotlin e segue as melhores práticas no desenvolvimento
Android.