O Github é uma rede social de programadores que possui uma funcionalidade interessante que permite curtir o repositório alheio. Trata-se de um botão escrito Star encontrado na página de cada repositório. Rick é um usuário ativo do Github, que está sempre buscando novos projetos e curtindo aqueles que são interessantes. Ele gostaria de poder adicionar um label ou tag para marcar o repositório de modo que ele possa filtrar. Por exemplo, ele encontrou um repositório chamado react e gostaria de adicionar as tags javascript e frontend. Como o Github não possui essa funcionalidade, Rick precisa de um sistema que consiga ajudá-lo com essa tarefa de um modo simples.

O desafio consiste em desenvolver uma aplicação web que obtém todos os repositórios que um determinado usuário "curtiu". Uma vez obtidos os repositórios a applicação deve permitir o gerenciamento de tags (adicionar, editar e remover). Deve ser possivel filtrar os repositórios do usuário pelas tags. O sistema deve ter um mecanismo de sugestão de tags. Os critérios para sugestão de tags são de livre escolha do desafiante (linguagem do repositório, tags atribuidas a outros repositorios, ontras informações disponibilizadas pelo GitHub, etc).

Requisitos:

• Recuperar repositórios "starred" do GitHub de determinado usuário.
• Gerenciar tags dos repositórios recuperados (adicionar, editar, excluir).
• Filtrar repositórios por tags.
• Sugestão de tags para os repositorios.

Como usuário, eu quero fornecer meu username recuperar todos os repositórios que eu curti para depois conseguir adicionar minhas tags.

• Deve obter os repositórios com star utilizando a API Rest v3 do Github. Utilizar a API v4 com GraphQL é um plus.
• As informações que devem ser recuperadas são: ID do repositório, nome do repositório, descrição, URL HTTP e linguagem.

Como usuário, eu quero poder adicionar tags (labels) para cada repositório para eu poder efetuar uma busca por tag.

• Um repositório não pode ter tags duplicadas.

Como usuário, quero poder fornecer uma tag e obter os repositórios que possuem essa tag.

• A busca deve funcionar para consultas com strings pela metade. (ex: ao filtrar pela string doc tanto repositórios com a tag docker quanto com a tag documentation devem ser retornados)

Como usuário, quero receber recomendações de tags para meu repositório.

• Cada repositório deve receber ao menos uma recomendação de tag.

Você deve escolher entre back-end e front-end. Se optar por entregar os dois desafios (back-end e front-end), vamos levar em conta como um ponto adicional.

• Deve ser implementada uma API REST utilizando JSON.
• Cada ação deve possuir sua rota específica respeitando a convenção de http verb e status code.
• Os repositórios e suas tags devem ser persistidos em um banco local.
• O uso de Docker para configurar o ambiente é recomendado¹.

• As telas devem respeitar as especificações dos wireframes:
  • home
  • loading
  • repositories list
  • manage tags
  • filter by tags
• Os repositórios e suas tags devem ser persistidos no local storage do usuário.
• O uso de libs como Redux, Vuex ou Flux é recomendado¹.
• O uso de Docker para configurar o ambiente é recomendado¹.

¹ Recomendado mas não obrigatório.

Queremos avaliar sua capacidade em entregar um produto completo e com documentação mínima suficiente para outros desenvolvedores conseguirem contribuir com o projeto. É essencial que o README.md contenha as intruções para configurar e rodar o projeto, bastando apenas um ctrl+c/ctrl+v no terminal do Linux e do OSX para conseguir rodar a aplicação.

Outros pontos que vamos considerar na avaliação:

• Código bem escrito, limpo e coeso.
• Implementação da solução.
• Testes automatizados (Cobertura de testes).
• Linter/Análise estática do código.
• README.md bem escrito, curto e com os comandos necessários para rodar a aplicação
• Design da API RESTful, utilizando corretamente os verbos HTTP e os devidos STATUS CODE [backend]
• Documentação da API utilizando API Blueprint, não podendo ser utilizado pdf, txt ou qualquer outro formato [backend]
• Conhecimento em Javascript, HTML5 e CSS3 [frontend]
• Capacidade de implementar as telas EXATAMENTE como está no wireframe fornecido, considerando a posição dos elementos na tela [frontend]

Na brainn não trabalhamos com uma linguagem ou um framework apenas. Somos poliglotas e incentivamos o uso de novas tecnologias desde que o time concorde em conjunto e esteja preparado para assumir os riscos da implementação. Nesse momento, nossas opções são específicas do nosso time. Escolha entre as opções abaixo para o desafio:

• Elixir
• Ruby
• Golang
• Nodejs
• Python
• React
• Vue

1. Crie um arquivo README.md descrevendo como configurar o projeto, contendo os comandos que devem ser executados para rodar o software e os testes;
2. Crie um ZIP do projeto sem as dependências instaladas;
3. Disponibilize o arquivo para download e nos envie a URL por email.

Obs: Se você fez uso de algum Linter (esling, rubycop, credo, etc.), envie o arquivo de configuração junto com o projeto e descreva qual linter está sendo utilizado no README do projeto.

Entendemos as dificuldades do dia-a-dia para quem trabalha em ter que dedicar um tempo para resolver esse tipo de desafio. Por isso pedimos para que mesmo que você não consiga completar o desafio, nos envie assim mesmo. Não queremos julgar nossos candidatos, queremos apenas entender melhor a maneira como cada um pensa e age diante de um problema comum.

Qualquer dúvida pode entrar em contato conosco. Boa sorte!