Tutorial - Corte Fácil Pro Edition

1. Introdução

Bem-vindo ao Corte Fácil Pro Edition! Esta ferramenta foi projetada para ajudar você a otimizar o corte de chapas retangulares (como MDF, compensado, acrílico, etc.), minimizando o desperdício de material.

Este tutorial guiará você através dos principais recursos do sistema, desde a inserção de informações básicas até a geração de planos de corte otimizados e saídas para impressão.

Use o Índice Rápido acima para navegar diretamente para a seção desejada.

2. Informações do Projeto

No card "Informações do Projeto", você pode inserir detalhes sobre o trabalho que está realizando.

Os campos disponíveis são:

Nome do Cliente: Identificação do cliente para quem o trabalho está sendo feito.
Nome do Projeto: Um nome descritivo para o projeto (ex: "Cozinha Sra. Maria", "Armário Escritório").

Estes campos são opcionais, mas recomendados para organização e para aparecerem nos relatórios impressos (Plano de Corte, Lista de Peças, Etiquetas).

3. Configuração da Chapa e Margem

Aqui você define as dimensões da chapa que será cortada e outras configurações importantes no card "Chapa & Margem (mm)".

Os campos são:

Largura Chapa (mm): A dimensão maior da sua chapa padrão em milímetros.
Altura Chapa (mm): A dimensão menor da sua chapa padrão em milímetros.
Margem Corte (Serra) (mm): Muito importante! É a espessura do material que a lâmina da serra remove a cada corte. Um valor típico é entre 3mm e 5mm, mas depende da sua serra. Se for 0, a otimização considerará que os cortes não consomem material (menos realista).
Permitir Rotação de Peças: Se marcado, o otimizador pode girar as peças em 90 graus para tentar encontrar um encaixe melhor. Desmarque se o veio do material ou o acabamento impedir a rotação.

Exemplo: Se você usa chapas de MDF de 2750mm x 1850mm e sua serra tem 4mm de espessura, você preencheria 2750 na largura, 1850 na altura e 4 na margem.

4. Adicionar Peças

Esta é a etapa principal onde você informa quais peças precisam ser cortadas. Você pode adicionar peças de três formas:

4.1. Entrada Única (Manual)

Use o card "Adicionar Peça (Entrada Única)" para inserir as peças uma a uma:

Informe a Largura da peça em milímetros.
Informe a Altura da peça em milímetros.
Informe a Qtde (quantidade) de peças com essas mesmas dimensões.
Clique no botão Adicionar.

Importante: O sistema verifica se a peça informada (mesmo que rotacionada, se a opção estiver ativa) cabe nas dimensões da chapa configurada. Se for maior que a chapa, um erro será exibido e a peça não será adicionada.

Após adicionar, a peça aparecerá na Lista de Peças abaixo.

4.2. Importar Projeto (JSON)

Se você salvou um projeto anteriormente usando a opção "Exportar", pode carregá-lo de volta utilizando o botão Importar na seção de Ações Secundárias.

Clique no botão Importar (que tem o ícone roxo de importar).
Selecione o arquivo .json que você exportou anteriormente.
Confirme a importação (ele avisará se houver dados não salvos).

Isso irá substituir todas as informações atuais (projeto, chapa e lista de peças) pelos dados contidos no arquivo JSON.

4.3. Importar Lista (Excel)

Você pode importar uma lista de peças diretamente de uma planilha Excel (.xlsx, .xls) ou arquivo CSV (.csv) usando o botão Importar Excel.

Formato Esperado na Planilha:

A planilha deve conter, em alguma linha (preferencialmente a primeira), um cabeçalho identificando as colunas.
São obrigatórias colunas com nomes que contenham: Largura, Altura e (Quantidade ou Qtde). A ordem das colunas não importa.
Opcionalmente, pode haver uma coluna para o nome/descrição da peça, contendo: Nome, Descricao, Item, Peca, etc.
Os dados das peças (números) devem começar imediatamente após a linha do cabeçalho.
Dimensões devem estar em milímetros.

Clique no botão Importar Excel.
Selecione o seu arquivo de planilha (.xlsx, .xls, .csv).

As peças lidas do arquivo serão adicionadas à lista de peças já existente na tela. O sistema tentará automaticamente identificar a linha de cabeçalho e as colunas correspondentes.

Verifique a mensagem de feedback após a importação para saber quantas peças foram importadas e se houve linhas ignoradas por dados inválidos.

4.4. Gerenciar Lista de Peças

Todas as peças adicionadas (manual ou via importação) são exibidas no card "Lista de Peças".

Contador: Mostra quantos grupos de peças (linhas) estão na lista.
Item da Lista: Cada linha mostra as dimensões (Largura x Altura), a Quantidade (Qtde) e o Nome (se houver).
Remover Individual (): Clique no 'X' vermelho ao lado de uma peça para removê-la da lista.
Limpar Tudo (): Remove TODAS as peças da lista. Uma confirmação será solicitada. Usar este botão também limpa qualquer resultado de otimização anterior.

Qualquer alteração na lista (adicionar, remover, limpar) marcará o projeto como Não salvo e limpará resultados de otimização existentes, exigindo um novo cálculo.

5. Otimizar o Plano de Corte

Após configurar a chapa e adicionar todas as peças desejadas, clique no botão principal Otimizar Corte, localizado no card de Ações.

Este botão só estará habilitado se houver pelo menos uma peça na lista.

O sistema então utilizará um algoritmo (baseado em Shelf Next Fit Decreasing Height com heurísticas) para calcular a disposição das peças nas chapas, considerando a margem de corte (serra) e a permissão de rotação.

Durante o cálculo (que pode levar alguns segundos dependendo da quantidade de peças), o botão exibirá um indicador de carregamento ( Otimizando...).

Ao final, os resultados serão exibidos na coluna da direita.

6. Visualizar Resultados

Após a otimização, a coluna da direita ("Resultado do Corte") será preenchida:

Estatísticas (Caixa de Informações):
- Número de chapas utilizadas.
- Percentual de Aproveitamento e Desperdício (com cores indicativas: verde=bom, laranja=médio, vermelho=ruim).
- Quantidade de peças alocadas em relação ao total solicitado.
- Tempo que o cálculo levou.
Avisos / Erros / Não Alocadas: Logo abaixo do card de Ações, mensagens podem aparecer:
- Erros: Problemas críticos encontrados.
- Avisos: Informações relevantes (ex: peças ignoradas por serem maiores que a chapa).
- Peças não alocadas: Lista das peças que não couberam em nenhuma das chapas geradas.
Plano de Corte Visual:
- Uma representação gráfica de cada chapa utilizada é exibida.
- Dentro de cada chapa, retângulos coloridos representam as peças cortadas.
- Passe o mouse sobre uma peça para ver suas dimensões originais, nome (se houver) e posição (X, Y).
- As dimensões (Largura x Altura) são exibidas dentro das peças maiores.
- Um símbolo ® (®) indica que a peça foi rotacionada em 90 graus.
Limpar Resultado (): Se quiser limpar a visualização dos resultados (sem apagar a lista de peças), use o botão Limpar Resultado na coluna de Ações.

7. Salvar e Carregar Projetos

Na seção "Importar / Exportar / Salvar Projeto" do card de Ações, existem formas de gerenciar seus dados:

Salvar Rápido ():
- Salva o estado atual (Informações do Projeto, Configuração da Chapa e Lista de Peças) diretamente no seu navegador (usando Local Storage).
- É rápido e útil para continuar um trabalho depois sem precisar exportar um arquivo.
- O indicador Salvo aparecerá no topo.
- Atenção: Estes dados ficam salvos apenas neste navegador e podem ser perdidos se você limpar o cache ou os dados do navegador.
Carregar Rápido ():
- Carrega o último estado salvo no navegador usando o "Salvar Rápido".
- Substitui os dados atuais (pede confirmação se houver alterações não salvas).
- Só estará habilitado se existir um salvamento rápido.
Exportar ():
- Gera um arquivo .json contendo os dados do projeto (informações, chapa, lista de peças) e o oferece para download.
- Ideal para backups, compartilhar com outros ou arquivar projetos.
- Não inclui o resultado da otimização, apenas os dados de entrada.
Importar (): (JSON)
- Permite carregar um projeto a partir de um arquivo .json exportado anteriormente.
- Substitui completamente os dados atuais na tela.
Importar Excel (): (Já explicado na Seção 4.3)
- Adiciona peças de uma planilha à lista atual.

O indicador de status ( Salvo / Não salvo) no topo da página informa se as últimas alterações foram salvas (via "Salvar Rápido" ou carregando um projeto).

8. Gerar Saídas

Na seção "Gerar Saídas" do card de Ações, você pode gerar documentos para impressão ou visualização após a otimização:

8.1. Lista de Peças (PDF)

Gera um documento PDF simples contendo uma tabela com todas as peças que estão atualmente na sua Lista de Peças (na coluna da esquerda).

Ideal para conferência ou para quem vai separar o material.
Clique no botão Lista Peças (PDF).
A janela de impressão do seu navegador será aberta. Configure a impressora e clique em Imprimir ou Salvar como PDF.
Este botão estará ativo assim que houver peças na lista, mesmo antes de otimizar.

8.2. Plano de Corte (PDF)

Gera um documento PDF visual mostrando o layout otimizado das peças em cada chapa utilizada, junto com as informações do projeto e estatísticas de aproveitamento.

Este é o principal relatório para quem vai realizar os cortes na máquina.
Clique no botão Plano Corte (PDF).
Este botão só estará habilitado após uma otimização bem-sucedida que gerou resultados.
A janela de impressão do navegador será aberta. Configure e imprima/salve.

8.3. Imprimir Etiquetas

Gera etiquetas individuais para cada peça cortada no plano otimizado, contendo informações úteis.

Ideal para identificar as peças após o corte.
Passo 1: Selecione a Chapa: Abaixo dos botões de saída, use o dropdown "Imprimir Etiquetas da Chapa:" para escolher se quer imprimir etiquetas de Todas as Chapas ou apenas de uma Chapa específica (ex: Chapa 1, Chapa 2...).
Passo 2: Imprima: Clique no botão Imprimir Etiquetas.
Este botão só estará habilitado após uma otimização bem-sucedida.

Conteúdo da Etiqueta:

Nome do Cliente e Projeto.
Dimensões da Peça (Largura x Altura em mm).
Símbolo ® se a peça foi rotacionada no plano.
Nome/Descrição da Peça (se fornecido).
ID único da peça no formato "Número Sequencial / Total de Peças (Chapa X)". Ex: ID: 5/23 (Ch:1)

Dicas para Impressão de Etiquetas:

Use a pré-visualização de impressão do seu navegador para ajustar as configurações.
Papel e Escala: Certifique-se de que o tamanho do papel nas configurações da impressora corresponde ao seu papel de etiquetas (ex: A4). A escala deve ser ajustada para "Padrão", "100%" ou "Real" (evite "Ajustar à página", que pode distorcer o tamanho).
Margens: Talvez precise ajustar as margens na impressão (para "Nenhuma" ou "Mínima") dependendo do layout do seu papel de etiqueta.
Teste Primeiro: Imprima uma única página em papel comum para verificar o alinhamento antes de usar seu papel de etiqueta.
O layout padrão organiza as etiquetas em uma coluna vertical.

9. Dicas e Solução de Problemas

Peças não cabem? Verifique se as dimensões da peça não são maiores que as da chapa (mesmo com rotação). Verifique também se a margem de corte (serra) não está muito alta.
Importação do Excel falha? Garanta que sua planilha tem cabeçalhos claros (Largura, Altura, Quantidade/Qtde) e que os dados numéricos estão corretos e começam logo após o cabeçalho. Evite células mescladas nas áreas de dados.
Impressão desalinhada? Confira as configurações de Papel, Escala e Margens na caixa de diálogo de impressão do seu navegador. Faça um teste em papel comum.
Resultados estranhos? O algoritmo busca uma boa otimização rapidamente, mas não garante a solução *matematicamente* perfeita (isso é computacionalmente muito complexo). Para resultados muito ruins, verifique os dados de entrada (dimensões, margem).
Salvo Rápido sumiu? O "Salvo Rápido" depende do armazenamento local do navegador. Limpar o cache ou usar modo anônimo pode apagar esses dados. Use "Exportar" para backups permanentes.
Desempenho: Projetos com centenas ou milhares de peças individuais podem levar mais tempo para otimizar e visualizar.

Esperamos que este tutorial ajude você a aproveitar ao máximo o Corte Fácil Pro Edition! Se encontrar problemas persistentes, entre em contato.