Possibilitar que bibliotecas possam apresentar aos seus leitores um sistema para a avalição dos livros que existem naquela biblioteca. Dessa forma os leitores que participam daquela comunidade possam consultar as avaliações de outros leitores e opinar sobre as suas leituras fortalecendo a comunidade local.

• Entregar um sistema de avalição.

• Um sistema de avalições para a biblioteca do IFSC e de São José.

O indice de leitura do Brasil é baixo, então é importante o desenvolvimento de ferramentas que incentivem a leitura.

Auxiliar as pessoas a selecionar próximas leituras por meio de avalições de outros usuários, e ao mesmo tempo fortalecendo a comunidade leitora do local onde o sistema for implementado.

• Kauan Oliveira Freitas
• Thays da Silva Mariano

Este projeto é dividido em dois módulos:

• Backend: API REST em Spring Boot, executada via Docker Compose.
• Frontend: Aplicação React (Vite) executada separadamente em ambiente local.

/projeto-tohth
│
├── tohth-api           # Backend Spring Boot
├── tohth               # Frontend React (Vite)
└── docker-compose.yml

Você precisa ter instalado na sua máquina:

• Docker
• Docker Compose
• Node.js (versão 18 ou superior recomendada)
• npm

Onde está localizado o arquivo:

docker-compose.yml

docker compose up --build

Isso vai:

• Buildar a imagem do Spring Boot
• Subir o container da API

Por padrão, a API estará em:

http://localhost:8080

Para visualizar o Swagger, após executar o docker acesse:

http://localhost:8080/swagger-ui.html

A implementação da autenticação está sendo desenvolvida em uma branch separada, chamada feat/autenticacao. Essa funcionalidade não foi concluida a tempo da entrega mas o diagrama de arquitetura já demonstra a estrutura e o fluxo de dados previstos para a implementação.

Abra outro terminal separado.

cd tohth

npm ci

npm run dev

O frontend estará disponível em:

http://localhost:5173

Para acessar a página de um livro (mockado) acesse:

http://localhost:5173/bookPage

O frontend já implementa os endpoints /tag, /biblioteca, e /avaliacao. Sendo assim, permite a criação de uma avaliação completa no banco de dados.

Para acessar diretamente o Banco de Dados rode os comandos em outro terminal:

# Entra no banco
docker exec -it postgres-db psql -U user -d mydb    

# Exibe as tabelas
\dt                                                 

# Exibe os dados
select * from <tabela>;                              

• 18/08/2025: Primeira versão.
• 19/08/2025: Segunda versão.
• 25/11/2025: Terceira versão.