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.
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.
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.
-
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: '[email protected]', 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
elast_name
e retornar um usuário que possua os mesmosfirst_name
elast_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 olast_name
éVieira
. O método deve retornar o usuário mesmo que os argumentos passados sejamdaNiLo
parafirst_name
evIeiRA
paralast_name
. Essa consulta deve ser realizada utilizando raw query e você pode buscar pelo uso do LOWER no Postgres para resolver esse problema.
-
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 doId
informado.Exemplo de retorno:
[ { id: '81482ac4-29bd-497f-b71a-8ae3b20eca9b', first_name: 'John', last_name: 'Doe', email: '[email protected]', 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: '[email protected]', created_at: '2021-03-19 19:35:09.877037', updated_at: '2021-03-19 19:35:09.877037' } ]
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.
- Clone este repositório
> git clone https://github.com/Valerianofilipec/DB_Queries.git
- Navegue até o diretório principal do projeto
> cd DB_Queries
- Instale as dependências com o Yarn ou NPM
yarn
npm install
- Inicie um container docker com postgres utilizando o docker-compose
docker-compose up -d
- Rode a suite de testes
yarn test
npm test
- Pare e remova o container docker
docker-compose down