Skip to main content

Mongo Express

🧠 Descrição Técnica: Interface Mongo Express

Além da API documentada via Swagger, o backend também conta com uma interface web para gerenciamento direto do banco de dados MongoDB utilizando o Mongo Express — uma ferramenta leve e funcional para visualização e execução de comandos no banco de forma gráfica.

🗂️ Acesso à Interface Mongo Express

A interface está disponível no seguinte endereço (ajustável conforme o ambiente de execução):

🔗 http://localhost:8081

Lembre-se de ter o projeto rodando no docker para funcionar!

Através dela é possível:

  • Visualizar todas as coleções disponíveis no banco

  • Buscar documentos por filtros (queries MongoDB)

  • Editar registros diretamente

  • Remover dados manualmente (quando necessário para testes ou administração)

  • Inserir novos documentos via interface visual

  • Exportar dados para backup ou inspeção

📚 Utilização no Contexto do Projeto

A interface do Mongo Express é extremamente útil para:

  • Testes de integração e debug durante o desenvolvimento

  • Administração rápida de dados, sem a necessidade de linha de comando

  • Verificação de dados persistidos via requisições realizadas na API

  • Criação manual de documentos, útil durante o desenvolvimento de novas rotas

🔐 Segurança

⚠️ Em ambiente de produção, o Mongo Express não deve ser exposto publicamente sem autenticação e/ou encapsulamento por VPN, proxy ou firewall.
No projeto atual, ele é ativado apenas em ambientes de desenvolvimento, sem acesso externo.

🛠️ Integração com a API

Durante o desenvolvimento, a interface Mongo Express serve como um complemento ao Swagger:

  • Você faz uma requisição no Swagger UI (como POST /api/avaliador/pecas/avaliar)

  • E pode ver o resultado diretamente no Mongo Express, conferindo como o documento foi persistido em coleção: Avaliacao

Exemplos de coleções visualizáveis:

  • Usuarios

  • Triagem

  • Peca

  • Avaliacao

  • Recurso
  • Otps

🔧 Passo a Passo de Uso

  • Facilidade de inspeção de dados sem ferramentas externas

  • Suporte a comandos Mongo nativos para usuários avançados

  • Boa integração com fluxo de desenvolvimento baseado em testes via Swagger


Back to top