feat: book rating and ratingsCount

[gustavo-atanazio]

• Adicionado 2 novos campos na entidade Book:

  • rating: campo desnormalizado que calcula a média de avaliação de um livro. Padrão: 0.
  • ratingsCount: campo desnormalizado que conta o total de avaliações de um livro. Padrão: 0.

• Os 2 novos campos são sempre atualizados após a criação, atualização ou deleção de uma Review

• Atualizados os DTOs e mappers para os 2 novos campos

• Atualizados os exemplos no seed do banco de dados

• Testes corrigidos para os novos campos

Outros:

• Adicionado 1 novo campo na entidade Book:

  • releaseYear: ano de lançamento do livro. Obrigatório.

• Retirado o prefixo "/api" e a URL "http://localhost:5173" do registro de CORS

• Movido a rota "/books/{id}/reviews" do controller de Book para o controller público

• Corrigido os testes do controller público para a alteração acima

[Mats057]

Acredito ser melhor armazenar o ratingSum em vez do rating. Além de evitar o uso de BigDecimal, também evitamos que, em um update de nota, precisemos recalcular a média de novo

[Mats057]

Deixaria a soma/count do rating atômica. Em vez de buscarmos o valor atual do db, alterarmos no backend e salvarmos novamente, deixar o próprio db cuidar da operação

Exemplo, em vez de:

product = getProductFromDb()
product.ratingCount += 1
product.submit()

Criaria uma operação no db parecida com a de SELECT, mas para UPDATE:

@Query("""
    UPDATE book
    SET rating_sum = rating_sum + :rating,
        rating_count = rating_count + 1
    WHERE id = :bookId
""")
addRating(bookId, rating);

Assim a operação fica atômica e conseguimos evitar possíveis problemas de concorrência

[Mats057]

Com a mudança de atomicidade, podemos evitar também essas duas recalculações em toda operação