etiquetas.js 1.0.0-alpha.1 → 1.0.0-alpha.11

package/README.git.md

@@ -1,486 +0,0 @@
-# 🏷️ Sistema de Etiquetas - Etiquetas.js
-
-Sistema completo para geração de etiquetas de peças, tamponamentos, insumos, retalhos e volumes com suporte a impressão e download de PDFs.
-
-## 📋 Índice
-
-- [Instalação](#instalação)
-- [Configuração Inicial](#configuração-inicial)
-- [API Principal](#api-principal)
-- [Tipos de Etiquetas](#tipos-de-etiquetas)
-- [Exemplos de Uso](#exemplos-de-uso)
-- [Templates](#templates)
-- [Testes](#testes)
-- [Estrutura do Projeto](#estrutura-do-projeto)
-- [Sistema Legacy](#sistema-legacy)
-
-## 🚀 Instalação
-
-```bash
-npm install etiquetas-js
-```
-
-## ⚙️ Configuração Inicial
-
-```javascript
-import etiquetas from 'etiquetas-js';
-
-// Inicializar o sistema
-etiquetas.init({
-  printerName: 'Zebra ZT230',
-  paperSize: 'A4',
-  orientation: 'portrait',
-  defaultTemplate: 'template-padrao'
-});
-```
-
-## 📚 API Principal
-
-### Inicialização e Configuração
-
-```javascript
-// Inicializar sistema
-etiquetas.init(config);
-
-// Configurar impressora
-etiquetas.configurePrinter({
-  printerName: 'HP LaserJet Pro',
-  paperSize: 'A4',
-  orientation: 'landscape'
-});
-
-// Verificar status da impressora
-const status = await etiquetas.getPrinterStatus();
-```
-
-### Geração de Etiquetas
-
-```javascript
-// Gerar etiqueta de peça
-const pdfPeca = await etiquetas.makePartLabel(dadosPeca, 'template-peca-padrao');
-
-// Gerar etiqueta de tamponamento
-const pdfTamp = await etiquetas.makeTamponamentoLabel(dadosTamp, 'template-tamponamento-padrao');
-
-// Gerar etiqueta de insumo
-const pdfInsumo = await etiquetas.makeInsumoLabel(dadosInsumo, 'template-insumo-padrao');
-
-// Gerar etiqueta de retalho
-const pdfRetalho = await etiquetas.makeRetalhoLabel(dadosRetalho, 'template-retalho-padrao');
-
-// Gerar etiqueta de volume
-const pdfVolume = await etiquetas.makeVolumeLabel(dadosVolume, 'template-volume-padrao');
-```
-
-### Saída e Impressão
-
-```javascript
-// Download de PDF
-await etiquetas.downloadPDF(pdfBuffer, 'etiqueta.pdf');
-
-// Enviar para impressora
-await etiquetas.sendToPrinter(pdfBuffer);
-
-// Envio inteligente (imprime se conectado, senão faz download)
-await etiquetas.sendPartLabel(dadosPeca, 'template-peca-padrao');
-await etiquetas.sendTamponamentoLabel(dadosTamp, 'template-tamponamento-padrao');
-await etiquetas.sendInsumoLabel(dadosInsumo, 'template-insumo-padrao');
-await etiquetas.sendRetalhoLabel(dadosRetalho, 'template-retalho-padrao');
-await etiquetas.sendVolumeLabel(dadosVolume, 'template-volume-padrao');
-```
-
-### Geração em Lote
-
-```javascript
-// Gerar múltiplas etiquetas
-const pdfs = await etiquetas.makeBatchLabels(
-  [peca1, peca2, peca3], 
-  'template-peca-padrao', 
-  'parts'
-);
-```
-
-## 🏷️ Tipos de Etiquetas
-
-### 1. Etiquetas de Peças (`parts`)
-
-```javascript
-const dadosPeca = {
-  id: "P001",
-  codigo: "PID123",
-  nome: "Lateral Esquerda",
-  tipo: "cabinet",
-  largura: 600,
-  altura: 800,
-  espessura: 15,
-  material: {
-    nome: "MDF Branco",
-    altura: 2750,
-    largura: 1830
-  },
-  bordas: {
-    esquerda: "Branco 0.4",
-    direita: "Branco 0.4",
-    superior: "Branco 0.4",
-    inferior: "Sem borda"
-  },
-  furacao: {
-    codigoA: "A001",
-    codigoB: "B002",
-    ladoUsinagem: "face"
-  },
-  projeto: {
-    id: "PROJ001",
-    nome: "Cozinha Moderna",
-    cliente: "João Silva"
-  }
-};
-```
-
-### 2. Etiquetas de Tamponamentos (`woodwork`)
-
-```javascript
-const dadosTamponamento = {
-  id: "TAMP-001",
-  name: "Tamponamento Lateral",
-  ref: "T001",
-  qt: 2,
-  weight: 1.5,
-  material: "MDF 15mm",
-  project_id: "PROJ001",
-  project_description: "Cozinha Moderna",
-  project_customer_name: "João Silva"
-};
-```
-
-### 3. Etiquetas de Insumos (`inputs`)
-
-```javascript
-const dadosInsumo = {
-  id: "INS-001",
-  name: "Parafuso Phillips 4x30",
-  dimensions: "4x30mm",
-  qt: 50,
-  weight: 0.1,
-  ref: "PAR-001",
-  manufacturer: "Fixadores SA",
-  project_id: "PROJ001",
-  project_description: "Cozinha Moderna",
-  project_customer_name: "João Silva"
-};
-```
-
-### 4. Etiquetas de Retalhos (`scraps`)
-
-```javascript
-const dadosRetalho = {
-  scrapId: "RET-001",
-  id: "RET-001",
-  name: "Retalho MDF Branco",
-  ref: "R001",
-  qt: 1,
-  weight: 2.3,
-  date: "2024-01-15T10:30:00Z",
-  material: "MDF Branco 15mm",
-  project_id: "PROJ001",
-  project_description: "Cozinha Moderna",
-  project_customer_name: "João Silva"
-};
-```
-
-### 5. Etiquetas de Volumes (`volumes`)
-
-```javascript
-const dadosVolume = {
-  volume_id: "VOL-001",
-  volume_name: "Volume Cozinha - Módulo 1",
-  volume_weight: 45.8,
-  volume_date: "2024-01-15T10:30:00Z",
-  project_id: "PROJ001",
-  project_description: "Cozinha Moderna",
-  project_customer_name: "João Silva"
-};
-```
-
-## 🎨 Templates
-
-### Templates Disponíveis
-
-- **Peças**: `template-peca-padrao`, `template-peca-compacto`
-- **Tamponamentos**: `template-tamponamento-padrao`
-- **Insumos**: `template-insumo-padrao`
-- **Retalhos**: `template-retalho-padrao`
-- **Volumes**: `template-volume-padrao`
-
-### Variáveis de Template
-
-O sistema suporta 44+ variáveis organizadas por categoria:
-
-#### Projeto (5 variáveis)
-- `{{PROJETO_ID}}`, `{{PROJETO_NOME}}`, `{{PROJETO_OBS}}`
-- `{{CLIENTE_ID}}`, `{{CLIENTE_NOME}}`
-
-#### Peça (7 variáveis)
-- `{{PECA_ID}}`, `{{PECA_CODIGO}}`, `{{PECA_NOME}}`, `{{PECA_TIPO}}`
-- `{{LARGURA}}`, `{{ALTURA}}`, `{{ESPESSURA}}`
-
-#### Material (3 variáveis)
-- `{{MN}}` (Nome), `{{MA}}` (Altura), `{{ML}}` (Largura)
-
-#### Bordas (4 variáveis)
-- `{{FE}}` (Esquerda), `{{FD}}` (Direita), `{{FS}}` (Superior), `{{FI}}` (Inferior)
-
-#### Furação (3 variáveis)
-- `{{FURO_A}}`, `{{FURO_B}}`, `{{LADO_USINAGEM}}`
-
-#### Volume (4 variáveis)
-- `{{VOLUME_ID}}`, `{{VOLUME_NOME}}`, `{{VOLUME_PESO}}`, `{{VOLUME_DATA}}`
-
-#### Insumo (7 variáveis)
-- `{{INSUMO_NOME}}`, `{{INSUMO_ID}}`, `{{INSUMO_DIMENSOES}}`
-- `{{INSUMO_QTD}}`, `{{INSUMO_PESO}}`, `{{INSUMO_REF}}`, `{{INSUMO_MARCA}}`
-
-#### Tamponamento (5 variáveis)
-- `{{TAMPONAMENTO_ID}}`, `{{TAMPONAMENTO_REF}}`, `{{TAMPONAMENTO_QT}}`
-- `{{TAMPONAMENTO_PESO}}`, `{{TAMPONAMENTO_NOME}}`
-
-#### Retalho (3 variáveis)
-- `{{RETALHO_ID}}`, `{{DATA_CRIACAO}}`, `{{RETALHO_INDICE}}`
-
-## 🧪 Testes
-
-Execute os testes do sistema:
-
-```bash
-# Executar testes completos
-node mock/testes.js
-
-# Teste rápido - apenas geração de todos os tipos
-node mock/executar-teste-completo.js
-
-# Teste específico de todos os tipos
-node mock/teste-todos-tipos.js
-
-# Teste otimizado (recomendado para evitar problemas de memória)
-node mock/executar-teste-otimizado.js
-
-# Ou importar funções específicas
-import { executarTodosTestes, gerarEtiquetasDeTodosOsTipos } from './mock/testes.js';
-import { gerarEtiquetasOtimizado } from './mock/teste-todos-tipos-otimizado.js';
-
-await executarTodosTestes();
-await gerarEtiquetasDeTodosOsTipos();
-await gerarEtiquetasOtimizado(); // Versão otimizada
-```
-
-### Testes Incluídos
-
-- ✅ Status da Impressora
-- ✅ Configuração de Impressora  
-- ✅ Geração de Etiquetas (todos os 5 tipos)
-- ✅ Download de PDF
-- ✅ Envio Inteligente
-- ✅ Geração em Lote
-- 🆕 **Teste Completo - Todos os Tipos** (novo!)
-
-### Novo Teste: Todos os Tipos de Etiquetas
-
-O novo teste `gerarEtiquetasDeTodosOsTipos()` gera uma etiqueta de cada tipo disponível:
-
-```javascript
-import { gerarEtiquetasDeTodosOsTipos } from './mock/teste-todos-tipos.js';
-
-const resultados = await gerarEtiquetasDeTodosOsTipos();
-console.log(`Sucessos: ${resultados.sucessos}/5`);
-```
-
-### 🚀 Teste Otimizado (Recomendado)
-
-Para evitar problemas de memória e heap overflow, use a versão otimizada:
-
-```bash
-# Execução rápida
-node mock/executar-teste-otimizado.js
-
-# Com mais memória (se necessário)
-node --max-old-space-size=4096 mock/executar-teste-otimizado.js
-
-# Com garbage collection
-node --expose-gc mock/executar-teste-otimizado.js
-```
-
-**Melhorias da versão otimizada:**
-- ⚡ Timeouts para evitar travamentos
-- 🧹 Limpeza automática de memória
-- 🔄 Processamento sequencial com pausas
-- 📊 Dados simplificados para melhor performance
-- ❌ Tratamento robusto de erros
-
-**Tipos testados:**
-- 📋 Etiqueta de Peça
-- 🔧 Etiqueta de Tamponamento  
-- 🔩 Etiqueta de Insumo
-- ♻️ Etiqueta de Retalho
-- 📦 Etiqueta de Volume
-
-**Recursos do teste:**
-- ⏱️ Medição de tempo de geração
-- 📊 Relatório detalhado de resultados
-- 💾 Salvamento automático dos PDFs em `mock/output/`
-- 📈 Estatísticas de performance
-
-## 📁 Estrutura do Projeto
-
-```
-etiquetas.js/
-├── src/
-│   ├── etiquetas.js          # API principal reorganizada
-│   ├── index.js              # Exportações principais
-│   ├── constants.js          # Constantes e configurações
-│   ├── templates.js          # Templates de etiquetas
-│   ├── types.ts              # Definições TypeScript
-│   ├── formatData.js         # Formatação de dados
-│   ├── labelWorker.js        # Worker para geração
-│   └── createLabel.jsx       # Geração de PDFs
-├── mock/
-│   ├── testes.js             # Testes completos
-│   └── exemplo de dados...   # Dados de exemplo
-└── GITHUB_ISSUE.md           # Documentação técnica
-```
-
-## 🔧 Configurações Avançadas
-
-### Configuração Personalizada
-
-```javascript
-etiquetas.init({
-  printerName: 'Zebra ZT230',
-  paperSize: 'A4',
-  orientation: 'portrait',
-  defaultTemplate: 'template-personalizado',
-  autoDownloadOnPrinterError: true,
-  maxBatchSize: 100,
-  cacheEnabled: true,
-  debugMode: false
-});
-```
-
-### Tratamento de Erros
-
-```javascript
-try {
-  const pdf = await etiquetas.makePartLabel(dados, template);
-  await etiquetas.sendToPrinter(pdf);
-} catch (error) {
-  console.error('Erro:', error.message);
-  // Fallback para download
-  await etiquetas.downloadPDF(pdf, 'etiqueta-backup.pdf');
-}
-```
-
-## 📊 Status e Monitoramento
-
-```javascript
-// Verificar status completo
-const status = await etiquetas.getPrinterStatus();
-console.log('Impressora:', status.connected ? 'Conectada' : 'Desconectada');
-console.log('Nome:', status.printerName);
-console.log('Papel:', status.paperSize);
-```
-
----
-
-## 🔄 Sistema Legacy
-
-### Label Viewer Without UI (Sistema Anterior)
-
-Este projeto evoluiu de um fork do `labelViewer` que removia componentes de UI. O sistema legacy ainda está disponível para compatibilidade:
-
-#### Exemplo básico com hook e worker (Legacy)
-
-```javascript
-import { useLabelData, createLabelWorker } from './src';
-
-function MyComponent() {
-  const { getLabelData, config, userPrefs } = useLabelData();
-  
-  const generateLabels = async () => {
-    const labelData = getLabelData('parts');
-    const worker = createLabelWorker();
-    
-    const params = {
-      dataSource: labelData.data,
-      labels: labelData.label,
-      userPrefs: labelData.userPrefs,
-      cacheKey: labelData.cacheKey,
-    };
-    
-    try {
-      const result = await worker.generateLabels(params, (progress) => {
-        console.log(`Progresso: ${progress.percentage}%`);
-      });
-      
-      console.log('Labels gerados:', result);
-    } catch (error) {
-      console.error('Erro ao gerar labels:', error);
-    }
-  };
-  
-  return (
-    <button onClick={generateLabels}>
-      Gerar Labels
-    </button>
-  );
-}
-```
-
-#### Usando o store (Legacy)
-
-```javascript
-import { useLabelStore } from './src';
-
-function MyComponent() {
-  const { 
-    pdfInstance, 
-    isGenerating, 
-    progress, 
-    setPDFInstance, 
-    setGenerating 
-  } = useLabelStore();
-  
-  // Use o store para gerenciar estado...
-}
-```
-
-### Migração do Sistema Legacy
-
-Para migrar do sistema legacy para a nova API:
-
-```javascript
-// Antes (Legacy)
-import { useLabelData, createLabelWorker } from './src';
-const labelData = getLabelData('parts');
-const worker = createLabelWorker();
-const result = await worker.generateLabels(params);
-
-// Depois (Nova API)
-import etiquetas from './src/etiquetas.js';
-etiquetas.init(config);
-const pdf = await etiquetas.makePartLabel(dadosPeca, template);
-```
-
-## 🤝 Contribuição
-
-1. Fork o projeto
-2. Crie uma branch para sua feature (`git checkout -b feature/nova-feature`)
-3. Commit suas mudanças (`git commit -am 'Adiciona nova feature'`)
-4. Push para a branch (`git push origin feature/nova-feature`)
-5. Abra um Pull Request
-
-## 📄 Licença
-
-Este projeto está sob a licença MIT. Veja o arquivo [LICENSE](LICENSE) para mais detalhes.
-
----
-
-**Desenvolvido com ❤️ para facilitar a geração de etiquetas industriais**

package/api/api-labels.json

@@ -1,114 +0,0 @@
-{
-   "namespace":"v1",
-   "routes":{
-      "\/v1\/labels":{
-         "namespace":"v1",
-         "methods":[
-            "GET"
-         ],
-         "endpoints":[
-            {
-               "methods":[
-                  "GET"
-               ],
-               "args":{
-                  "p":{
-                     "description":"Page",
-                     "type":"integer",
-                     "required":false
-                  },
-                  "s":{
-                     "description":"Search",
-                     "type":"string",
-                     "required":false
-                  },
-                  "label_id":{
-                     "description":"ID",
-                     "type":"integer",
-                     "required":false
-                  },
-                  "label_type":{
-                     "description":"Tipo",
-                     "type":"string",
-                     "enum":[
-                        "part",
-                        "scrap",
-                        "thickened",
-                        "input",
-                        "volume"
-                     ],
-                     "required":false
-                  }
-               }
-            }
-         ],
-         "_links":{
-            "self":[
-               {
-                  "href":"https:\/\/www.dinabox.app\/api\/v1\/labels"
-               }
-            ]
-         }
-      },
-      "\/v1\/label":{
-         "namespace":"v1",
-         "methods":[
-            "GET",
-            "POST",
-            "DELETE"
-         ],
-         "endpoints":[
-            {
-               "methods":[
-                  "GET",
-                  "POST",
-                  "DELETE"
-               ],
-               "args":{
-                  "label_id":{
-                     "description":"ID",
-                     "type":"integer",
-                     "required":false
-                  },
-                  "label_type":{
-                     "description":"Tipo",
-                     "type":"string",
-                     "enum":[
-                        "part",
-                        "scrap",
-                        "thickened",
-                        "input",
-                        "volume"
-                     ],
-                     "required":false
-                  },
-                  "label_name":{
-                     "description":"Nome",
-                     "type":"string",
-                     "required":false
-                  },
-                  "label_content":{
-                     "description":"Conte\u00fado",
-                     "type":"textarea",
-                     "required":false
-                  }
-               }
-            }
-         ],
-         "_links":{
-            "self":[
-               {
-                  "href":"https:\/\/www.dinabox.app\/api\/v1\/label"
-               }
-            ]
-         }
-      }
-   },
-   "_links":{
-      "up":[
-         {
-            "href":"https:\/\/www.dinabox.app\/api\/"
-         }
-      ]
-   }
-}