Barcode Generator (Gerador de Etiquetas Interno)

📌 Visão Geral

Este projeto foi desenvolvido para atender a uma demanda operacional da empresa: a necessidade de gerar e imprimir etiquetas de códigos de barras para identificação e leitura ("bipagem") de produtos no estoque.

Inicialmente, a solicitação era para uma geração manual e simples. Contudo, ao analisar as ferramentas online disponíveis, identifiquei limitações críticas para o negócio: falta de importação em massa, restrições de layout e impossibilidade de customização visual.

Para resolver isso, desenvolvi uma solução proprietária via código, focada em automação, produtividade e escalabilidade, eliminando a dependência de serviços externos limitados.

🎯 Objetivo

Criar uma aplicação interna robusta que permita:

• Automatizar a criação de etiquetas a partir de planilhas existentes.
• Customizar o layout de impressão (linhas x colunas) para economizar papel.
• Gerenciar imagens de produtos de forma eficiente (URLs ou Upload Local).
• Exportar arquivos prontos para impressão em qualquer impressora padrão A4.

⚠️ Nota: O sistema é de uso exclusivamente interno para controle de estoque e não gera códigos GTIN/EAN oficiais para varejo externo.

🧩 Funcionalidades

1. Importação de Dados Inteligente

• Suporte a arquivos .CSV e .XLSX.
• Leitura automática das colunas codigo, nome e imagem.
• Validação de dados e feedback visual de status.

2. Gestão Avançada de Imagens

• Suporte a Múltiplos Formatos: JPG, PNG, WEBP, AVIF e conversão automática de HEIC/HEIF (Apple) para navegadores.
• Upload em Lote: O sistema associa automaticamente arquivos de imagem aos produtos baseando-se no nome do arquivo (ex: 1234.jpg vincula ao produto código 1234).
• Tratamento de CORS: O upload local resolve bloqueios comuns ao tentar renderizar imagens de URLs externas em PDFs.
• Ajuste Proporcional: Algoritmo de Object Fit Contain para garantir que imagens não fiquem distorcidas ou achatadas na etiqueta.

3. Personalização e Exportação

• Dashboard Interativo: Pré-visualização em tempo real das etiquetas.
• Grid Configurável: O usuário define quantas colunas e linhas deseja por página (ex: 3x8, 2x5).
• Geração de PDF: Utiliza jsPDF para gerar arquivos vetoriais de alta qualidade prontos para impressão.

🛠 Tecnologias Utilizadas

O projeto foi construído utilizando uma stack moderna e performática:

• Core: React + Vite
• Linguagem: JavaScript (ESM)
• Estilização: CSS Variables com tema Dark/Blue (design system customizado).
• Bibliotecas Principais:
  • jspdf: Geração do arquivo final.
  • papaparse / xlsx: Processamento de dados.
  • jsbarcode: Geração dos vetores de código de barras (Code 128).
  • heic2any: Conversão de imagens de alta eficiência no front-end.

🤖 Desenvolvimento Assistido por IA

Para acelerar o desenvolvimento e implementar lógicas complexas de manipulação de arquivos e geometria de PDF, foram utilizadas ferramentas de IA generativa como apoio técnico:

• Gemini 3.0
• ChatGPT 5.2

Essas ferramentas atuaram como "pair programmers", auxiliando na refatoração de código e otimização de algoritmos.

🧪 Como Executar

Certifique-se de ter o Node.js instalado.

# 1. Clone o repositório
git clone [https://github.com/seu-usuario/barcode-generator.git](https://github.com/seu-usuario/barcode-generator.git)

# 2. Instale as dependências
pnpm install

# 3. Rode o servidor de desenvolvimento
pnpm dev