Projeto Alura

Bem-vinda ao teste para Pessoa Desenvolvedora Java da Alura!

Neste desafio, será simulado uma parte do domínio de uma plataforma educacional para que você possa demonstrar seus conhecimentos técnicos.

Não há respostas certas ou erradas, queremos avaliar como você aplica conceitos de lógica e orientação a objetos para resolver problemas.

Requisitos

• Java 18 ou superior
• Spring Boot
• Spring Data JPA
• MySQL
• Migrações de banco de dados manuais com Flyway

Instruções

1. Faça o upload do template inicial do projeto no seu repositório GitHub e mantenha-o público (seus commits serão avaliados).
2. Importe o projeto na IDE de sua escolha.
3. O código deve ser todo escrito em inglês, mesmo que os requisitos estejam em português.

Desafio

O projeto base já contém a configuração das tecnologias requeridas. Algumas funcionalidades relacionadas à entidade User estão implementadas e podem servir como guia para a resolução das questões.

Warning

Não se preocupe com a interface visual, a interação será feita por meio de API.

Questão 1 - Cadastro de Cursos

Na Alura, grande parte das funcionalidades gira em torno dos cursos. Sua primeira tarefa é implementar o cadastro de cursos, obedecendo às regras definidas abaixo.

Atributos

• Nome
• Código (entre 4 e 10 caracteres)
• Instrutor
• Descrição
• Status (ACTIVE, INACTIVE)
• Data de inativação

Regras

• O código do curso deve ser único, textual, sem espaços, números ou caracteres especiais, podendo ser separado por hífen (ex.: spring-boot-avancado).
• Apenas usuários instrutores podem ser autores de cursos.
• Os novos cursos devem ser automaticamente definidos como ACTIVE.
• O campo "data de inativação" só deve ser preenchido quando o curso for inativado.

Tip

Há um ponto de partida no CourseController com a rota /course/new.

Questão 2 - Inativação de Cursos

Cursos podem ser inativados por diversos motivos, como atualizações ou descontinuação. Você será responsável por implementar essa funcionalidade, seguindo as regras a seguir.

Regras

• Acesse a rota /course/{code}/inactive para inativar o curso com o código fornecido.
• Ao inativar, o campo "status" deve ser alterado para INACTIVE e o campo "data de inativação" deve ser registrado com a data e hora atuais.

Questão 3 - Matrícula de Alunos

Com os cursos criados, o próximo passo é permitir que os alunos se matriculem nos cursos disponíveis.

Atributos

• Usuário
• Curso
• Data de matrícula

Regras

• Um usuário não pode se matricular mais de uma vez no mesmo curso.
• Só é permitido matrícula em cursos ativos.

Tip

Já existe um ponto de partida no RegistrationController.

Questão 4 - Relatório de Cursos Mais Acessados

Agora que temos usuários e matrículas, queremos gerar um relatório para identificar os cursos mais acessados. Implemente a lógica na rota /registration/report para listar os cursos com mais matrículas, ordenados pelo número de inscrições.

Important

A Alura possui um grande volume de dados. Portanto, priorize o uso de SQL nativo na construção do relatório e evite o anti-pattern N+1.

Considerações Finais

• A avaliação será baseada na implementação dos requisitos e na forma como você aplica conceitos de lógica e orientação a objetos.
• Qualquer tecnologia fora do escopo mencionado (como Swagger, Docker ou front-end) não será considerada.
• Caso tenha dúvidas durante o desenvolvimento, faça anotações no código e implemente o que considerar mais adequado.
• Testes são altamente valorizados, e candidatos que implementarem testes automatizados ganharão pontos extras.
• Códigos muito semelhantes aos de outros candidatos podem resultar na anulação do teste.
• O uso de ferramentas de IA é permitido, mas o código gerado deve ser revisado. Caso avance para a próxima etapa, a entrevista técnica será baseada no código que você produziu.

Tip

Para uma melhor organização dos commits, considere seguir as convenções de commits. Isso ajuda a manter um histórico claro e compreensível do projeto.

Projeto_Alura