Quando você solicita um orçamento em um site e, poucos segundos depois, um PDF é gerado automaticamente para download, o que realmente acontece nos bastidores?

Muitas pessoas imaginam que existe alguma ferramenta mágica responsável por criar o documento. Na realidade, tudo acontece por meio da integração entre uma API, um banco de dados e uma biblioteca capaz de gerar arquivos PDF dinamicamente.

Neste artigo vamos construir exatamente esse fluxo utilizando Node.js, Express, MariaDB, MySQL2 e PDFKit, entendendo como aplicações reais armazenam informações e geram documentos automaticamente.

Se você deseja criar projetos que realmente agreguem valor ao seu portfólio, este é um excelente exemplo.

---

O problema que precisamos resolver

Imagine uma oficina mecânica.

O cliente solicita um orçamento e informa:

• Nome
• Veículo
• Serviço
• Valor

Essas informações precisam ser:

• validadas;
• armazenadas no banco de dados;
• utilizadas para criar um orçamento profissional em PDF;
• disponibilizadas imediatamente para download.

Esse é exatamente o fluxo que construiremos neste projeto.

---

Como o sistema funciona?

Nossa aplicação será composta por:

• Front-End
• API REST em Node.js
• Express
• MariaDB
• PDFKit

O fluxo de funcionamento será:

Usuário

↓

Preenche o formulário

↓

API Express recebe os dados

↓

Validação

↓

MariaDB salva as informações

↓

PDFKit gera o documento

↓

PDF disponível para download

Perceba que o PDF é apenas a etapa final.

Antes dele existe toda uma sequência de processamento responsável por garantir que os dados estejam corretos e armazenados com segurança.

---

Organizando a estrutura do projeto

Durante o desenvolvimento organizamos a aplicação separando responsabilidades.

Exemplo:

projeto/

├── routes/
├── controllers/
├── database/
├── public/
├── pdf/
└── app.js

Essa organização facilita bastante a manutenção conforme o projeto cresce.

É exatamente esse tipo de estrutura utilizada em aplicações profissionais.

---

Configurando o Express

A API será responsável por receber as informações enviadas pelo formulário.

Ela irá:

• receber as requisições;
• validar os dados;
• salvar no banco;
• gerar o PDF;
• responder ao navegador.

É assim que funcionam milhares de aplicações desenvolvidas com Node.js.

---

Conectando ao MariaDB

Depois criamos a conexão utilizando o pacote MySQL2.

É através dessa conexão que nossa aplicação consegue executar comandos SQL.

Sempre que um orçamento é enviado, ele é gravado no banco de dados antes da geração do PDF.

Esse processo é chamado de persistência de dados.

Sem ele, todas as informações seriam perdidas ao reiniciar o servidor.

---

Criando a tabela de orçamentos

O projeto utiliza uma tabela simples para armazenar cada orçamento criado.

Assim podemos:

• consultar orçamentos antigos;
• manter um histórico;
• reutilizar os dados posteriormente;
• gerar novos documentos sempre que necessário.

Esse é um conceito presente em praticamente qualquer sistema comercial.

---

Validando os dados recebidos

Antes de salvar qualquer informação é fundamental validar os dados enviados pelo usuário.

Durante o projeto verificamos se todos os campos obrigatórios foram preenchidos corretamente.

Essa etapa evita inconsistências no banco de dados e aumenta a segurança da aplicação.

---

Organizando as rotas com Express Router

Ao invés de colocar toda a lógica em um único arquivo, utilizamos o Express Router.

Essa abordagem torna o projeto muito mais organizado.

Separar responsabilidades facilita futuras manutenções e torna o código mais limpo.

---

Gerando nomes automáticos para os PDFs

Outro detalhe importante é evitar conflitos entre arquivos.

Para isso utilizamos expressões regulares (Regex) para gerar nomes válidos para cada documento criado.

Esse pequeno detalhe faz bastante diferença em aplicações reais.

---

Criando documentos automaticamente com PDFKit

Depois que os dados foram validados e armazenados no banco, chega a etapa mais interessante.

Utilizamos o PDFKit para montar o documento dinamicamente.

Cada PDF recebe informações como:

• Cliente;
• Veículo;
• Serviço;
• Valor;
• Data do orçamento.

Nenhum documento fica salvo previamente.

Cada PDF é criado automaticamente a partir das informações enviadas pelo usuário.

É exatamente esse comportamento encontrado em sistemas de emissão de orçamentos, pedidos, recibos e relatórios.

---

Testando a API

Após implementar a rota realizamos testes utilizando um cliente REST.

Esses testes permitem verificar:

• envio das requisições;
• validação dos dados;
• inserção no banco;
• geração correta do PDF.

Testar a API antes da integração com o Front-End facilita muito a identificação de problemas.

---

Integrando Front-End e Back-End

Na etapa final conectamos o formulário HTML à API criada em Node.js.

Quando o usuário envia os dados acontece toda a sequência:

1. O navegador envia as informações.
2. O Express recebe a requisição.
3. Os dados são validados.
4. O MariaDB salva as informações.
5. O PDFKit gera o documento.
6. O PDF fica disponível para download.

Perceba que diversas tecnologias trabalham juntas para entregar uma funcionalidade aparentemente simples.

Essa visão completa do processo é muito mais importante do que decorar comandos.

---

Tecnologias utilizadas

Neste projeto trabalhamos com:

• Node.js
• Express
• Express Router
• MariaDB
• MySQL2
• PDFKit
• API REST
• Banco de Dados
• Regex
• JavaScript
• Persistência de Dados

Além da programação em si, você aprenderá como organizar aplicações utilizando boas práticas de desenvolvimento.

---

O que você aprenderá

Ao concluir este projeto você será capaz de:

• criar APIs utilizando Express;
• conectar aplicações Node.js ao MariaDB;
• utilizar MySQL2;
• validar dados recebidos pelo servidor;
• organizar rotas utilizando Express Router;
• gerar documentos PDF automaticamente;
• integrar Front-End e Back-End;
• desenvolver um projeto completo para o portfólio.

Mais importante do que decorar bibliotecas, você entenderá como todas essas tecnologias trabalham juntas para resolver problemas reais.

---

Assista ao projeto completo

Se você prefere aprender acompanhando toda a implementação, gravei este projeto mostrando cada etapa do desenvolvimento, desde a criação da API até a geração automática dos documentos PDF.

No projeto você verá na prática como:

• criar uma API com Node.js e Express;
• conectar a aplicação ao MariaDB utilizando MySQL2;
• validar os dados enviados pelo usuário;
• armazenar informações no banco de dados;
• gerar PDFs automaticamente com PDFKit;
• integrar o Front-End com o Back-End.

🎥 Projeto completo (vídeo editado)

Como Criar um Sistema que Gera PDF Automaticamente | Node.js + MariaDB

Este é o conteúdo recomendado para quem deseja aprender de forma objetiva, focando apenas nas etapas importantes do desenvolvimento.

---

📺 Quer acompanhar toda a construção do projeto?

Se você gosta de assistir ao desenvolvimento completo, incluindo explicações extras, dúvidas respondidas durante a transmissão e todo o processo realizado ao vivo, confira também a live original.

Live Completa

---

Conclusão

Quando um sistema gera um orçamento automaticamente, ele não está apenas criando um arquivo PDF.

Existe todo um processo acontecendo nos bastidores:

• recebimento dos dados;
• validação das informações;
• comunicação com o banco de dados;
• persistência dos registros;
• geração dinâmica do documento PDF;
• entrega do arquivo ao usuário.

Compreender esse fluxo é muito mais valioso do que simplesmente aprender a utilizar uma biblioteca.

Essa é justamente a proposta do Desvendando o Código: revelar como as aplicações realmente funcionam, conectando diferentes tecnologias para resolver problemas do mundo real.

Ao entender esse processo, você deixa de apenas copiar código e passa a desenvolver sistemas com muito mais confiança e autonomia.