💻 Sobre o desafio

Nesse desafio, você realizará consultas no banco de dados com o TypeORM de três maneiras:

Usando o ORM
Usando Query Builder
Usando Raw Query

Isso irá te ajudar a entender e exercitar os diferentes tipos de consultas que podemos fazer.

No template, você irá encontrar uma aplicação já estruturada (apenas as entidades e repositórios) onde você deverá completar o que falta nas consultas dos dois repositórios.

A aplicação possui dois módulos: users e games. Um usuário pode ter vários jogos e um mesmo jogo pode estar associado a vários usuários.

Template da aplicação

Para realizar esse desafio, criamos para você esse modelo que você deve utilizar como um template do GitHub.

O template está disponível na seguinte URL:

rocketseat-education/ignite-template-database-queries

Dica: Caso não saiba utilizar repositórios do GitHub como template, temos um guia em nosso FAQ.

Preparando o ambiente para os testes

Para que os testes funcionem, é importante que você crie uma database no banco Postgres com o nome queries_challenge e substitua os dados de autenticação (caso os seus não sejam os mesmos) no arquivo ormconfig.json:

Se você não possui um container do Docker rodando o Postgres, é possível criá-lo com seguinte comando:

docker run --name ignite-challenge-database-queries -e POSTGRES_DB=queries_challenge -e POSTGRES_PASSWORD=docker -p 5432:5432 -d postgres

Com isso, o container com o banco Postgres será instalado e ficará rodando pronto para você começar implementar o desafio.

Quando o desafio estiver finalizado, você pode parar o container com o comando docker stop ignite-challenge-database-queries para que não fique consumindo recursos desnecessários da sua máquina. E caso você tenha parado o container ou reiniciou sua máquina mas ainda precisa do container rodando, é possível iniciá-lo novamente com o comando docker start ignite-challenge-database-queries.

⚠️ Atenção: Se você precisou mudar alguma informação no arquivo de configuração ormconfig.json para que fosse possível rodar os testes, é necessário que, antes de mandar na plataforma da Rocketseat, você volte esses dados ao padrão que veio do template. Caso contrário, os testes não irão rodar corretamente na plataforma.

Repositórios da aplicação

Com o repositório criado a partir do template e clonado na sua máquina, navegue até os arquivos src/modules/users/repositories/implementations/UsersRepository.ts e src/modules/games/repositories/implementations/GamesRepository.ts. Esses deverão ser completados para que os testes sejam satisfeitos.

💡 Observe que alguns métodos já possuem parte do código inserido para indicar que você deve usar ORM, query builder ou raw query nas consultas.

UsersRepository

Método findUserWithGamesById

Esse método deve receber o Id de um usuário e retornar os dados do usuário encontrado juntamente com os dados de todos os games que esse usuário possui.

Exemplo de retorno:

{
	id: '81482ac4-29bd-497f-b71a-8ae3b20eca9b',
	first_name: 'John',
	last_name: 'Doe',
	email: 'mail@example.com',
	created_at: '2021-03-19 19:35:09.877037',
	updated_at: '2021-03-19 19:35:09.877037',
	games: [
		{
			id: '63a6c35a-ac97-4773-9021-fb93973c8139',
			title: 'GTA V',
			created_at: '2021-03-19 19:35:09.877037',
			updated_at: '2021-03-19 19:35:09.877037',
		},
		{
			id: '74e4fc3b-434d-4452-94eb-27a85dce8d1a',
			title: 'Among Us',
			created_at: '2021-03-19 19:35:09.877037',
			updated_at: '2021-03-19 19:35:09.877037',
		}
	]
}

Método findAllUsersOrderedByFirstName

Esse método deve retornar a listagem de usuários cadastrados em ordem alfabética (ASC).

Lembre-se que aqui deve ser usado raw query para a consulta.
Método findUserByFullName

Esse método deve receber first_name e last_name e retornar um usuário que possua os mesmos first_name e last_name. Aqui você deve encontrar o usuário ignorando se o argumento passado está em caixa alta ou não.

Por exemplo, suponhamos que existe um usuário onde o first_name é Danilo e o last_name é Vieira. O método deve retornar o usuário mesmo que os argumentos passados sejam daNiLo para first_name e vIeiRA para last_name. Essa consulta deve ser realizada utilizando raw query e você pode buscar pelo uso do LOWER no Postgres para resolver esse problema.

GamesRepository

Método findByTitleContaining

Esse método deve receber parte do título de um jogo ou o título inteiro e retornar um ou mais jogos que derem match com a consulta.

Se o método for chamado com o argumento "or S" e existir algum jogo com essa sequência de letras no título, o retorno deve ser feito, como por exemplo o seguinte retorno:
```
[
	{
		id: '63a6c35a-ac97-4773-9021-fb93973c8139',
		title: 'Need F**or S**peed: Payback',
		created_at: '2021-03-19 19:35:09.877037',
		updated_at: '2021-03-19 19:35:09.877037',
	},
	{
		id: '74e4fc3b-434d-4452-94eb-27a85dce8d1a',
		title: 'Need F**or S**peed: Underground',
		created_at: '2021-03-19 19:35:09.877037',
		updated_at: '2021-03-19 19:35:09.877037',
	}
]
```
A consulta também deve ser feita de forma case insensitive, ignorando caixa alta onde no banco não existe. Para exemplo, considerando a busca exemplificada acima, o retorno deve ser o mesmo caso o parâmetro passado seja uma string "nEEd".

Você pode buscar pelo uso do ILIKE no Postgres para resolver esse problema. Lembre-se que aqui deve ser usado query builder para realizar a consulta.
Método countAllGames

Esse método deve retornar uma contagem do total de games existentes no banco. Deve ser usada raw query para essa consulta.

Método findUsersByGameId

Esse método deve receber o Id de um game e retornar uma lista de todos os usuários que possuem o game do Id informado.

Exemplo de retorno:

[
	{
		id: '81482ac4-29bd-497f-b71a-8ae3b20eca9b',
		first_name: 'John',
		last_name: 'Doe',
		email: 'mail@example.com',
		created_at: '2021-03-19 19:35:09.877037',
		updated_at: '2021-03-19 19:35:09.877037'
	},
	{
		id: '75920ac4-32ed-497f-b71a-8ae3c19eca9b',
		first_name: 'Usuário',
		last_name: 'Qualquer',
		email: 'usuarioqualquer@example.com',
		created_at: '2021-03-19 19:35:09.877037',
		updated_at: '2021-03-19 19:35:09.877037'
	}
]

Específicação dos testes

Para esse desafio, temos os seguintes testes:

[UsersRepository] should be able to find user with games list by user's ID

Para que esse teste passe, você deve satisfazer o código de acordo com o que é descrito aqui.
[UsersRepository] should be able to list users ordered by first name

Para que esse teste passe, você deve satisfazer o código de acordo com o que é descrito aqui.
[UsersRepository] should be able to find user by full name

Para que esse teste passe, você deve satisfazer o código de acordo com o que é descrito aqui.
[GamesRepository] should be able find a game by entire or partial given title

Para que esse teste passe, você deve satisfazer o código de acordo com o que é descrito aqui .
[GamesRepository] should be able to get the total count of games

Para que esse teste passe, você deve satisfazer o código de acordo com o que é descrito aqui.
[GamesRepository] should be able to list users who have given game id

Para que esse teste passe, você deve satisfazer o código de acordo com o que é descrito aqui.

📅 Entrega

Esse desafio deve ser entregue a partir da plataforma da Rocketseat. Envie o link do repositório que você fez suas alterações. Após concluir o desafio, além de ter mandado o código para o GitHub, fazer um post no LinkedIn é uma boa forma de demonstrar seus conhecimentos e esforços para evoluir na sua carreira para oportunidades futuras.

Feito com 💜 por Rocketseat 👋 Participe da nossa comunidade aberta!

CarlosViniMSouza/challenge05-nodejs