Evolução de Arquitetura: Integrando MongoDB Atlas e API
Por Flaviana Pina | QA Architect & Business Analyst
A evolução natural de uma API RESTful é deixar de ser apenas um "mensageiro" (Stateless) e passar a ter memória. Neste artigo de estudo de caso, documento como transformei a arquitetura do meu portfólio integrando um Banco de Dados NoSQL em nuvem (MongoDB Atlas), aplicando conceitos de Moderação de Dados e Soft Delete.
1. Por que o MongoDB Atlas? (Cloud-Native)
Como Arquiteta e Engenheira de Qualidade, a escolha da tecnologia deve focar em eficiência. Bancos de dados locais exigem muita infraestrutura (memória, CPU). Utilizando o MongoDB Atlas (Database as a Service), o banco mora na nuvem. A minha API (hospedada no Render) se comunica com ele em milissegundos. Além disso, por ser NoSQL, ele salva as informações no exato formato JSON que nós (QAs) já utilizamos em automações via Rest-Assured e Postman.
2. Moderação de Dados (A Regra de Negócio)
Sistemas expostos na internet sofrem ataques e spam. Para proteger a interface do usuário, implementei uma regra de negócios no Back-end:
- Todo dado enviado pelo usuário nasce no banco com o
"status": "Pendente". - O Front-end só consome a rota GET para exibir dados que contenham o
"status": "Aprovado".
Essa arquitetura permite que eu tenha total controle editorial sobre o que é publicado (Data Governance).
3. Hard Delete vs Soft Delete
Uma boa arquitetura de dados não exclui informações levianamente. Quando clicamos no ícone da lixeira no banco de dados, realizamos um Hard Delete (o dado é vaporizado). Para ter um histórico de auditoria (Auditing), o ideal é usar o Soft Delete (Exclusão Lógica): basta alterar o status do documento para "Deletado" ou "Oculto". O dado some do site do usuário, mas fica preservado no banco para análises de segurança (DevSecOps).
Guia de Referência: Comandos Úteis do MongoDB Atlas
Este é o meu guia de bolso operacional para administrar o banco de dados diretamente via painel da nuvem (Data Seeding / Data Cleansing):
👉 Como Inserir Dados Diretamente (Bypass de API)
Inserir dados diretamente no banco poupa consumo da API e não esgota limites (Rate Limiting). Para inserir um depoimento pré-aprovado:
- Acesse o painel do MongoDB Atlas e clique em Database > Browse Collections.
- Selecione a collection
testimonials. - Clique no botão verde ADD DATA > Insert Document.
- Clique no ícone de chaves
{ }no topo para ativar a visualização de código (JSON). - Cole a estrutura abaixo e clique em Insert:
"name": "Nome do Profissional",
"role": "Cargo e Empresa",
"message": "Mensagem do depoimento aqui.",
"status": "Aprovado"
}
👉 Como Moderar (Aprovar / Ocultar)
Localize o documento na lista (dentro de Browse Collections). Clique duas vezes sobre o valor do campo status. Troque "Pendente" por "Aprovado" ou "Oculto" e clique em Update.
👉 Como Deletar Permanentemente (Hard Delete)
Passe o mouse sobre o documento indesejado na lista. No canto superior direito do bloco, clique no ícone da Lixeira (🗑️) e confirme a exclusão.