Bem-vindo(a). Este é o desafio Back end!

O objetivo deste desafio é avaliar suas habilidades de programação. Quando sua solução estiver pronta, basta responder o e-mail que recebeu com o link do seu repo aqui no Github! Em seguida, enviaremos o feedback e as instruções dos próximos passos!

Caso tenha alguma dúvida, nós estamos disponíveis no email [email protected] Bom desafio!

⚠️ É importante que o seu repo esteja público, caso contrário não iremos conseguir avaliar sua resposta

• 🧠 Contexto
  • 🚰 Fluxo esperado
  • ⚔️ Desafio
  • 📓 Submissão
• ✔️ Critérios de Avaliação
  • 😎 Seria legal
• 🚀 Instruções
  • Docker
  • Kafka
  • GraphQL
  • 📓 To-do list

Para deixar a jornada dos nossos alunos mais completa, a Rocketseat disponibiliza desafios que estimulam a prática do conteúdo estudado. Sabendo disso, este projeto consiste em implementar um serviço que gerencie os desafios enviados por nossos alunos.

Neste projeto, está incluído o corrections (serviço de correção das submissões) já pré-configurado, sua missão será implementar os fluxos de:

• Interação com Desafios e Submissões. (Criar, buscar, editar e remover);
• Atualização das submissões utilizando a integração com o serviço corrections;

• Uma submissão de um desafio é enviada;
• A submissão é registrada com o status Pending;
  • ⚠️ Caso não exista o desafio ou a url não seja um repositório do github a submissão é registrada com status Error e um erro é retornado ao usuário, dando fim a esse fluxo;
• O serviço corrections é notificado e retorna a correção da submissão;
• O status e a nota da submissão são atualizados;

Operações necessárias

• Criar
• Remover
• Editar
• Listar
  • Paginação
  • Busca por título e descrição

Operações necessárias

• Enviar
• Listar
  • Filtros: desafio, intervalo de datas, status
  • Paginação

Além dos requisitos levantados acima, iremos olhar para os seguintes critérios durante a correção do desafio:

• Arquitetura (DDD, Clean Architecture)
• Documentação (comente sobre decisões técnicas, escolhas, requisitos, etc)
• Código limpo (utilização de princípios como DRY, KISS, SOLID, YAGNI)
• Testes (unitários, e2e, etc)
• Padrão de commits (Conventional)

• Utilizar Nest.js
• Custom Scalar Types

Chegou a hora de colocar a mão na massa!

Neste projeto já incluímos alguns arquivos para a configuração do projeto.

Criamos um docker-compose que faz a configuração de 3 containers incluindo as credenciais (login do postgres, database, etc):

Escolhemos o utilizar o Kafka para a comunicação com o serviço de corrections. Caso você utilize Nest.js, o mesmo possui uma integração completa com essa ferramenta.

Nas instruções do serviço de corrections estão especificados os tópicos e eventos que a aplicação deve utilizar.

⚠️ É necessário iniciar o serviço de corrections para que os tópicos do Kafka sejam criados.

A interação com os desafios e submissões deve ser feita via GraphQL, para isso deixamos uma sugestão das operações a serem criadas, porém sinta-se livre para modelar seu schema da melhor forma:

Query {
  challenges(...): [Challenge!]!
  answers(...): [Answer!]!
}

Mutation {
 createChallenge(...): Challenge!
 updateChallenge(...): Challenge!
 deleteChallenge(...): Challenge!

 answerChallenge(...): Answer!
}

• Fazer o fork do projeto
• Configurar ambiente de desenvolvimento (inclusive executar o serviço de corrections)
• Criar uma API GraphQL com o contexto acima utilizando Typescript
• Fazer a integração com o serviço de corrections através do Apache Kafka
• Incluir no README as instruções de instalação do projeto

ℹ️ Sinta-se livre para incluir quaisquer observações que achar necessário

O desafio acima foi cuidadosamente construído para propósitos de avaliação apenas. Já possuimos uma funcionalidade similar na nossa plataforma.

Made with 💜 at Rocketseat