Este manual explica como o sistema de orçamentos da Makers funciona, do ponto de vista de quem opera a fábrica e não de quem programa. Ele serve para consulta: cada página trata de um assunto, e você lê só o que precisa.

Por onde começar

O sistema em uma página

O sistema Makers é formado por três programas que conversam entre si, mais alguns serviços externos.

O caminho de um pedido

1. O cliente envia o desenho.O site manda o arquivo DXF para o servidor, que o guarda no AWS S3 e o lê: contornos, tamanho, furos, cores.
2. O servidor calcula o orçamento.Usa os parâmetros que você cadastrou no painel (velocidades, preço da hora, chapas, margens). O detalhe está na seção Cálculo do orçamento.
3. O cliente paga.No checkout, o PagBank cobra o valor recalculado pelo servidor, nunca um valor enviado pelo navegador. O material fica reservado por alguns minutos.
4. O pedido vira produção.O servidor cria o cartão no Trello (um por máquina), o pedido de venda e a nota fiscal no Bling, e uma linha na planilha Google.
5. A produção corta e dá baixa no estoque.O estoque é descontado, e as sobras viram retalhos reaproveitáveis em orçamentos futuros.

Os termos que aparecem no painel e neste manual, sem jargão.

Termos da fábrica e do orçamento

Termos de computação

Este é o caminho completo de um pedido: o que o cliente clica, o que o servidor faz em seguida, com quais serviços ele conversa e o que fica gravado. Clique em qualquer número do diagrama, ou use Percorrer para acompanhar do início ao fim.

Em três tempos

Quem faz o quê

E-mails que o cliente recebe

O status do pedido muda por três motivos: o aviso do PagBank, o movimento dos cartões no Trello e tarefas automáticas do servidor. Este mapa mostra o caminho normal e os desvios.

O que muda cada status

O sistema foi feito para que um problema em um serviço externo não desfaça um pagamento. Esta página lista cada falha possível, o efeito e como a recuperação acontece, sozinha ou com a equipe.

Onde enxergar o que deu errado

• No painel: em Pedidos, o detalhe de cada pedido mostra o status de cada integração (sucesso, erro, em processamento ou desativada) e quantas tentativas já foram feitas.
• Ligar e desligar: em Integrações. Uma integração desligada não roda e não gera "erro".
• Nos bastidores: o servidor registra cada passo em log (hospedagem do backend, Serviços e acessos). Quem dá manutenção usa esse log para investigar.

O sistema depende de vários serviços externos. Esta página lista cada um, para que serve, o que deixa de funcionar se ele sair do ar e como acessar.

Serviços

Variáveis do servidor (só os nomes)

Estas são as configurações secretas que o servidor lê ao ligar. Os valores ficam no AWS Secrets Manager, na conta AWS da Makers, nunca no código.

Como ver ou alterar uma variável

1. Entre no console da AWScom a conta da Makers e abra console.aws.amazon.com/secretsmanager. Confira no canto superior direito se a região é a mesma do servidor.
2. Abra o segredo envMakers.Ele guarda todas as variáveis da tabela abaixo.
3. Clique em "Retrieve secret value" (Recuperar valor do segredo) para ver os valores. Para mudar, clique em "Edit", altere o valor da variável e salve. Os nomes devem ficar exatamente como estão na tabela.
4. Aplique no servidor.O servidor só lê o segredo quando liga, então a mudança não vale até reiniciar. No GitHub, abra o repositório Makers-backend › aba Actions › Redeploy (env vars only) › Run workflow. Leva alguns segundos e não precisa publicar código novo.

Tarefas automáticas do servidor

O servidor executa sozinho, sem ninguém clicar:

Cada pedido pago vira uma linha na planilha de controle da Makers, com uma coluna para cada parcela do preço (corte, material, fator K, imposto etc.). Existe um arquivo por ano ("ORÇAMENTOS 2026", "ORÇAMENTOS 2027"...), criado sozinho no primeiro pedido do ano. A conexão é feita por um pequeno programa (Google Apps Script) que fica dentro da planilha e recebe os dados do servidor.

Como a conexão funciona

1. O cliente paga.Quando o pagamento é confirmado, o servidor cria o pedido no Trello e no Bling e, em seguida, chama o Sheets.
2. O servidor envia um POST.Um pedido HTTP com os dados em JSON para o endereço cadastrado em Configurações › Integrações › URL do Google Sheets.
3. O Apps Script escolhe o arquivo do ano.Pela data do pedido: pedido de 2027 vai para "ORÇAMENTOS 2027". Se o arquivo não existir, ele é criado (ver "Um arquivo por ano").
4. O Apps Script grava.A função doPost acrescenta uma linha no fim da aba, colocando cada valor na coluna de mesmo título.
5. O resultado fica registrado.O pedido guarda o status da integração "Google Sheets" (sucesso ou erro), visível em Integrações e nos dados do pedido.

• Só roda se duas coisas estiverem ligadas: a integração "Google Sheets" em Integrações e o campo de URL preenchido. Com a integração ligada e a URL vazia, nada é enviado e o pedido fica com status de erro nesta integração.
• Não há reenvio automático. Ao contrário do Bling e do Trello, o Sheets não é tentado de novo sozinho. Se falhar, a linha precisa ser lançada à mão (ou o pedido reenviado por um desenvolvedor).
• Se o Sheets falhar, o pedido não é afetado: pagamento, Trello e Bling seguem normalmente.

Um arquivo por ano

• Nome: o prefixo (PREFIXO_ARQUIVO, "ORÇAMENTOS ") seguido do ano de quatro dígitos. O ano vem da data do pedido, no horário de Brasília.
• Como o script acha o arquivo do ano, nesta ordem: (1) o identificador que ele guardou na primeira vez que usou aquele ano; (2) um arquivo no Drive com o nome exato "ORÇAMENTOS 2027"; (3) se nenhum dos dois existe, cria. Por isso o arquivo de 2026 precisa se chamar exatamente "ORÇAMENTOS 2026" antes de ligar: é o nome que ele procura na primeira gravação.
• Criação automática: no primeiro pedido de um ano novo, o script copia o arquivo do ano anterior (na mesma pasta do Drive; na primeira vez, o modelo é o próprio arquivo onde o script está instalado), apaga todos os pedidos e deixa só o cabeçalho e uma linha vazia já formatada, com as caixas de seleção. Nada precisa ser feito à mão na virada.
• Arquivos de anos anteriores não são alterados. Se o arquivo de um ano for mandado para a lixeira, o próximo pedido daquele ano cria outro do zero.
• Outras abas: a cópia leva todas as abas do arquivo. Só a aba de pedidos é esvaziada; resumos e gráficos em outras abas precisam ser conferidos no arquivo novo. A cópia também leva um duplicado do script, que pode ser ignorado: quem recebe os pedidos é sempre o script publicado no arquivo original.
• Fórmulas entre anos (por exemplo, somar 2026 e 2027) precisam ser feitas à mão, referenciando os dois arquivos.

A planilha de controle e o que o sistema preenche

O script grava pelo título da coluna (linha 1 da aba), não pela posição. A equipe pode reordenar, esconder ou apagar colunas à vontade. Se o sistema enviar um valor para uma coluna que não existe, ela é criada no fim da tabela. Colunas vazias de dados que a equipe lança à mão continuam funcionando. Para usar o modelo, faça uma cópia dele no Google Drive da Makers (Arquivo › Fazer uma cópia) com o nome "ORÇAMENTOS 2026" e siga o passo a passo.

Como conferir: somando todas as colunas de preço (Corte, Gravação, Setup de gravação, Desconto no corte, Manuseio, Complemento do mínimo, Material usado, Completar com fator K, Markup do material, Desconto no material, Imposto e Taxa regional) dá o valor dos itens do pedido. O Valor inclui ainda o adicional que o administrador tenha lançado no pedido, quando houver. As colunas de preço ficam vazias em pedidos com preço manual, em pedidos anteriores a esta versão e quando o pedido foi editado depois do pagamento (aí a coluna Obs avisa). O motivo: o sistema não grava números que não fecham.

Pontos a decidir ao instalar

• "Pago?" e "Inserido no Bling" aparecem como FALSE nas linhas do "Sistema" do modelo de exemplo, mas o código atual envia pago = true. Ou o script antigo ignora esses dois campos para a equipe conferir à mão, ou as linhas da amostra são de uma versão anterior. O script abaixo tem uma chave para escolher (MARCAR_PAGO_E_BLING).
• Confira os títulos da linha 1. O script compara o título sem diferenciar maiúsculas, acentos e espaços repetidos ("Tempo de Corte" vale como "Tempo de corte"), mas um título com outra redação cria uma coluna nova. Se a planilha usa "Mat." em vez de "Materiais", ajuste o texto correspondente na lista COLUNAS do script.
• Várias colunas são caixas de seleção (Pago?, Inserido no Bling, Trello e a coluna de validação). Para que a linha nova também tenha a caixa, o script copia o formato e a validação da linha de cima. Por isso a última linha da planilha precisa ser uma linha de dados, e não uma linha de totais.
• A data aparece como "6-jan.". O servidor envia dd/mm/aaaa como texto; o script converte para data de verdade, e a coluna mostra no formato que a planilha já usa.
• Um "FALSO" em português aparece numa das linhas: é a planilha mostrando o valor falso no idioma dela, e não é um problema do sistema.

O que o servidor envia (formato exato)

Método POST, cabeçalho Content-Type: application/json, com um objeto por pedido. Campos de preço vazios ("") significam "zero ou indisponível":

{
  "data": "20/10/2026",
  "responsavel": "Sistema",
  "clienteTrabalho": "Diogo - Suporte Ferro",
  "pago": true,
  "valor": 851.31,
  "inseridoBling": true,
  "trello": true,
  "tempoCorte": "1h23",
  "corte": 120.50, "gravacao": "", "tempoGravacao": "", "setupGravacao": "",
  "descontoCorte": -12.05, "manuseio": 15.20, "complementoMinimo": "",
  "materialUsado": 450.00, "completarFatorK": 90.00, "fatorK": "20%",
  "markupMaterial": 67.50, "descontoMaterial": "",
  "materiais": 607.50,
  "imposto": 56.17, "taxaRegional": "",
  "frete": 0,
  "terceirizados": "", "overprice": "", "criacao": "", "montagem": "",
  "val": "", "pagamento": "", "nfOs": "", "obs": ""
}

Passo a passo: instalar o script

1. Abra a planilha de controle com a conta Google da Makers. Em Arquivo › Configurações, confira que a localidade é "Brasil" e o fuso horário é "Brasília".
2. Renomeie o arquivo para "ORÇAMENTOS 2026" (prefixo + ano, nesta forma). É assim que o script o reconhece e o usa como modelo do ano seguinte. Se a aba de pedidos não for a primeira, escreva o nome exato dela na constante ABA.
3. Abra o editor de scripts.Na planilha: Extensões › Apps Script. Se já houver código, copie-o para um arquivo seguro antes de substituir.
4. Cole o script de referência (abaixo) e clique no disquete (Salvar).
5. Publique como aplicativo da Web.Botão Implantar › Nova implantação. Clique na engrenagem ao lado de "Selecionar tipo" e escolha App da Web. Preencha: Executar como: Eu (a conta da Makers) e Quem pode acessar: Qualquer pessoa. Clique em Implantar.
6. Autorize.O Google pede permissão para o script editar planilhas e acessar o Google Drive (necessário para criar o arquivo do ano novo). Escolha a conta, clique em Avançado › Acessar (nome do projeto) › Permitir. O aviso de "app não verificado" é esperado, pois o script é seu.
7. Copie a URL do app da Web.Ela termina em /exec e tem o formato https://script.google.com/macros/s/…/exec.
8. Cole a URL no painel.Em Configurações › Integrações › URL do Google Sheets (Apps Script), cole e salve.
9. Ligue a integração.Em Integrações, ative o cartão "Google Sheets".
10. Teste (próxima seção).

Se a planilha já estava ligada ao sistema, a URL já está cadastrada: basta atualizar o script e publicar uma nova versão (ver "Cuidados"), sem mexer em Configurações. Atualizando de uma versão antiga (uma planilha só, sem ano no nome): renomeie o arquivo para "ORÇAMENTOS 2026" antes de publicar; sem isso o script cria um arquivo vazio com esse nome na primeira gravação.

Script de referência (Apps Script)

Acrescenta uma linha no fim da aba, na coluna de mesmo título, copiando o formato e as caixas de seleção da linha de cima. Cria o arquivo do ano quando ele ainda não existe.

// Webhook de pedidos da Makers -> planilha de controle (um arquivo por ano).
// Cole em Extensões > Apps Script e publique como App da Web.

// Cada ano tem o seu arquivo: "ORÇAMENTOS 2026", "ORÇAMENTOS 2027"... O pedido vai para o
// arquivo do ano da data dele. Se ele ainda não existe, o script o cria sozinho, copiando o
// arquivo do ano anterior (cabeçalho, formato e caixas de seleção) e apagando os pedidos.
const PREFIXO_ARQUIVO = 'ORÇAMENTOS ';

// Aba onde as linhas são lançadas. Deixe '' para usar a primeira aba do arquivo.
const ABA = '';

// Deixe true para gravar Pago? e Inserido no Bling como o sistema informa.
// Deixe false se a equipe prefere conferir e marcar essas duas caixas à mão.
const MARCAR_PAGO_E_BLING = true;

// Campo que o servidor envia -> título EXATO da coluna, na linha 1 da aba.
// A gravação é pelo TÍTULO, não pela posição: a equipe pode reordenar, esconder ou apagar
// colunas. Se um título não existir e o servidor mandar valor, a coluna é criada no fim.
const COLUNAS = {
  data: 'Data',
  responsavel: 'Responsável',
  clienteTrabalho: 'Cliente / Trabalho',
  pago: 'Pago?',
  valor: 'Valor',
  inseridoBling: 'Inserido no Bling',
  tempoCorte: 'Tempo de corte',
  trello: 'Trello',
  corte: 'Corte',
  materiais: 'Materiais',
  gravacao: 'Gravação',
  terceirizados: 'Terceirizados',
  overprice: 'Overprice',
  criacao: 'Criação',
  montagem: 'Montagem',
  frete: 'Frete',
  val: 'Val',
  pagamento: 'Pagamento',
  nfOs: 'NF / OS',
  obs: 'Obs',
  // Como o preço foi formado (vazias em pedidos sem composição, ex.: preço manual).
  tempoGravacao: 'Tempo de gravação',
  setupGravacao: 'Setup de gravação',
  descontoCorte: 'Desconto no corte',
  manuseio: 'Manuseio',
  complementoMinimo: 'Complemento do mínimo',
  materialUsado: 'Material usado',
  completarFatorK: 'Completar com fator K',
  fatorK: 'Fator K',
  markupMaterial: 'Markup do material',
  descontoMaterial: 'Desconto no material',
  imposto: 'Imposto',
  taxaRegional: 'Taxa regional'
};

function doPost(e) {
  const trava = LockService.getScriptLock();
  trava.waitLock(20000); // evita duas linhas gravadas em cima uma da outra
  try {
    const dados = JSON.parse(e.postData.contents);
    dados.data = paraData(dados.data);
    if (!MARCAR_PAGO_E_BLING) { dados.pago = false; dados.inseridoBling = false; }

    const ano = dados.data instanceof Date ? dados.data.getFullYear() : new Date().getFullYear();
    const aba = abaDoAno(String(ano));
    const colunas = mapearColunas(aba, dados);

    const largura = aba.getLastColumn();
    const ultima = ultimaLinhaComCliente(aba, colunas.clienteTrabalho);
    const nova = ultima + 1;
    if (aba.getMaxRows() < nova) aba.insertRowAfter(ultima);

    // Herda formato (R$, data) e caixas de seleção da linha de cima.
    if (ultima > 1) {
      const modelo = aba.getRange(ultima, 1, 1, largura);
      const destino = aba.getRange(nova, 1, 1, largura);
      modelo.copyTo(destino, SpreadsheetApp.CopyPasteType.PASTE_FORMAT, false);
      modelo.copyTo(destino, SpreadsheetApp.CopyPasteType.PASTE_DATA_VALIDATION, false);
    }

    const linha = [];
    for (let i = 0; i < largura; i++) linha.push('');
    Object.keys(colunas).forEach(function (campo) {
      if (dados[campo] !== undefined) linha[colunas[campo] - 1] = dados[campo];
    });
    aba.getRange(nova, 1, 1, largura).setValues([linha]);

    return resposta({ ok: true, arquivo: aba.getParent().getName(), linha: nova });
  } catch (erro) {
    return resposta({ ok: false, erro: String(erro) });
  } finally {
    trava.releaseLock();
  }
}

// ---- Um arquivo por ano -----------------------------------------------------------------

// Devolve a aba do ano; cria o arquivo do ano se ele ainda não existe.
function abaDoAno(ano) {
  const propriedades = PropertiesService.getScriptProperties();
  let planilha = abrirNaoExcluida(propriedades.getProperty('arquivo_' + ano));
  if (!planilha) {
    planilha = procurarPorNome(PREFIXO_ARQUIVO + ano) || criarArquivoDoAno(ano);
    propriedades.setProperty('arquivo_' + ano, planilha.getId());
  }
  const aba = ABA ? planilha.getSheetByName(ABA) : planilha.getSheets()[0];
  if (!aba) throw new Error('Aba não encontrada: ' + ABA);
  return aba;
}

function abrirNaoExcluida(id) {
  if (!id) return null;
  try {
    return DriveApp.getFileById(id).isTrashed() ? null : SpreadsheetApp.openById(id);
  } catch (erro) {
    return null;
  }
}

function procurarPorNome(nome) {
  const achados = DriveApp.getFilesByName(nome);
  while (achados.hasNext()) {
    const arquivo = achados.next();
    if (!arquivo.isTrashed()) return SpreadsheetApp.open(arquivo);
  }
  return null;
}

// Copia o arquivo de ano mais recente que já existe (ou, na primeira vez, o arquivo onde este
// script está) e deixa só o cabeçalho + 1 linha vazia já formatada para o primeiro pedido.
function criarArquivoDoAno(ano) {
  const propriedades = PropertiesService.getScriptProperties();
  const anos = Object.keys(propriedades.getProperties())
    .filter(function (chave) { return /^arquivo_\d{4}$/.test(chave); })
    .map(function (chave) { return chave.slice(8); })
    .sort();
  let modelo = null;
  for (let i = anos.length - 1; i >= 0 && !modelo; i--) {
    modelo = abrirNaoExcluida(propriedades.getProperty('arquivo_' + anos[i]));
  }
  modelo = modelo || SpreadsheetApp.getActiveSpreadsheet();

  const copia = modelo.copy(PREFIXO_ARQUIVO + ano);
  const pastas = DriveApp.getFileById(modelo.getId()).getParents();
  if (pastas.hasNext()) DriveApp.getFileById(copia.getId()).moveTo(pastas.next());

  const aba = ABA ? copia.getSheetByName(ABA) : copia.getSheets()[0];
  if (aba.getMaxRows() > 2) aba.deleteRows(3, aba.getMaxRows() - 2);
  aba.getRange(2, 1, 1, aba.getMaxColumns()).clearContent();
  return copia;
}

// ---- Colunas pelo título ----------------------------------------------------------------

function normalizar(texto) {
  return String(texto).toLowerCase().normalize('NFD').replace(/[̀-ͯ]/g, '')
    .replace(/\s+/g, ' ').trim();
}

// campo -> nº da coluna (1, 2, 3...). Só cria coluna nova para campo que veio com valor.
function mapearColunas(aba, dados) {
  let largura = Math.max(aba.getLastColumn(), 1);
  const titulos = aba.getRange(1, 1, 1, largura).getValues()[0].map(normalizar);
  const mapa = {};
  Object.keys(COLUNAS).forEach(function (campo) {
    const indice = titulos.indexOf(normalizar(COLUNAS[campo]));
    if (indice >= 0) {
      mapa[campo] = indice + 1;
    } else if (dados[campo] !== undefined && dados[campo] !== '') {
      largura += 1;
      aba.getRange(1, largura - 1).copyTo(aba.getRange(1, largura), SpreadsheetApp.CopyPasteType.PASTE_FORMAT, false);
      aba.getRange(1, largura).setValue(COLUNAS[campo]);
      mapa[campo] = largura;
    }
  });
  return mapa;
}

// Última linha com "Cliente / Trabalho" preenchido. Não usa getLastRow() porque caixas de
// seleção desmarcadas (FALSE) contam como conteúdo e esconderiam a linha vazia do arquivo novo.
function ultimaLinhaComCliente(aba, colunaCliente) {
  if (!colunaCliente) return aba.getLastRow();
  const valores = aba.getRange(1, colunaCliente, aba.getMaxRows(), 1).getValues();
  for (let i = valores.length - 1; i >= 0; i--) {
    if (valores[i][0] !== '') return i + 1;
  }
  return 1;
}

// "20/10/2026" -> data de verdade (a coluna mostra no formato que a planilha já usa).
function paraData(texto) {
  const m = /^(\d{1,2})\/(\d{1,2})\/(\d{4})$/.exec(String(texto));
  return m ? new Date(Number(m[3]), Number(m[2]) - 1, Number(m[1])) : texto;
}

// Abrir a URL no navegador mostra esta mensagem: serve para conferir se a publicação está no ar.
function doGet() {
  return ContentService.createTextOutput('Webhook de pedidos da Makers ativo.');
}

function resposta(objeto) {
  return ContentService.createTextOutput(JSON.stringify(objeto))
    .setMimeType(ContentService.MimeType.JSON);
}

// Teste dentro do editor: escolha "testar" no seletor de funções e clique em Executar.
function testar() {
  const r = doPost({ postData: { contents: JSON.stringify({
    data: Utilities.formatDate(new Date(), 'America/Sao_Paulo', 'dd/MM/yyyy'),
    responsavel: 'Sistema', clienteTrabalho: 'TESTE - pode apagar',
    pago: true, valor: 100, inseridoBling: true, trello: true,
    corte: 60, materiais: 40, frete: 0, fatorK: '20%'
  }) } });
  Logger.log(r.getContent());
}

// Teste da virada de ano: cria o ARQUIVO do ano que vem com 1 linha de teste.
// Depois de conferir, mande esse arquivo para a lixeira do Drive (senão ele vira o de verdade
// quando o ano virar) e rode "limparTesteDaVirada".
function testarVirada() {
  const ano = new Date().getFullYear() + 1;
  const r = doPost({ postData: { contents: JSON.stringify({
    data: '02/01/' + ano, responsavel: 'Sistema', clienteTrabalho: 'TESTE VIRADA - pode apagar',
    pago: true, valor: 100, inseridoBling: true, trello: true, corte: 60, materiais: 40, frete: 0
  }) } });
  Logger.log(r.getContent());
}

// Esquece o arquivo do ano que vem registrado pelo teste (depois de mandá-lo para a lixeira).
function limparTesteDaVirada() {
  PropertiesService.getScriptProperties()
    .deleteProperty('arquivo_' + (new Date().getFullYear() + 1));
}

Como testar

1. Pela URL.Abra a URL /exec no navegador. Deve aparecer "Webhook de pedidos da Makers ativo."
2. Pelo editor.No Apps Script, escolha a função testar e clique em Executar. Uma linha "TESTE - pode apagar" aparece no fim da aba do ano, com o formato das outras, e a coluna "Fator K" é criada se ainda não existir. Apague a linha depois.
3. Virada de ano.Ainda no editor, execute testarVirada. Deve surgir, na mesma pasta do Drive, o arquivo "ORÇAMENTOS" do ano que vem, só com o cabeçalho e a linha de teste formatada (caixas de seleção incluídas). Confira e mande esse arquivo para a lixeira; depois execute limparTesteDaVirada. Se esquecer, ele passa a ser o arquivo de verdade do ano seguinte, com a linha de teste dentro.
4. Como o servidor faria.Em um terminal, rode (troque a URL pela sua):
   curl -L -X POST -H "Content-Type: application/json" -d "{\"clienteTrabalho\":\"TESTE\",\"valor\":1}" "https://script.google.com/macros/s/.../exec"
   O -L é importante: o Google responde com um redirecionamento, e o servidor da Makers também o segue.
5. Pedido real.Depois de um pedido pago, confira a linha na planilha e o status "Google Sheets" do pedido no painel. A soma das colunas de preço deve bater com o total dos itens (ver "Como conferir").

Cuidados

• A URL é a "senha" da integração. Quem a tiver consegue escrever linhas na planilha. Não a coloque em e-mails, prints ou neste manual. O servidor não envia chave de segurança; a proteção é a URL ser secreta.
• Mudou o script? Publique uma nova versão. Alterações só valem depois de Implantar › Gerenciar implantações › (lápis) › Versão: Nova versão › Implantar. Assim a URL continua a mesma. Criar uma "nova implantação" gera outra URL, que teria de ser colada de novo em Configurações.
• Erros dentro do script não aparecem no painel. O Google responde "ok" ao servidor mesmo quando o script falha por dentro, e o pedido fica com status de sucesso. Se uma linha não aparecer, veja Apps Script › Execuções.
• Dono da planilha. O script roda com as permissões de quem o implantou, e os arquivos novos nascem no Drive dessa conta. Se essa pessoa sair da empresa ou perder o acesso, a integração para: registre a conta dona em Serviços e acessos e, ao trocá-la, transfira a propriedade dos arquivos "ORÇAMENTOS".
• Mexer na planilha. Pode reordenar e apagar colunas; não renomeie o título de uma coluna que o sistema preenche (o script criaria outra). Se inserir uma linha de totais embaixo dos dados, as linhas novas passam a ir para depois dela.
• Mudar o nome do arquivo ou a pasta não perde o vínculo: o script guarda o identificador de cada ano. Só o arquivo apagado ou na lixeira é recriado vazio no próximo pedido.

O que a Makers preenche ao instalar

Três repositórios no GitHub, um para cada programa. Todos pertencem à organização cce-fluxo.

Como os repositórios se relacionam

Os dois sites não acessam o banco diretamente. Tudo passa pelo servidor: o site pede, o servidor consulta o banco, calcula e responde. É por isso que as regras de preço existem em um só lugar, o servidor, e o site do cliente e o painel sempre mostram o mesmo valor.

Ramificações (branches)

O código tem duas ramificações principais: develop, onde as mudanças são feitas e testadas, e main, a versão que vai ao ar. O script git-deploy.ps1 (na pasta que contém os três repositórios) faz o caminho padrão para os três de uma vez: salva as mudanças em develop, junta em main e envia ao GitHub. A publicação final depende do serviço de hospedagem de cada programa (ver Serviços e acessos).

Roteiro técnico para um desenvolvedor colocar o sistema para funcionar em um computador novo. Quem só opera o painel pode pular esta página.

Requisitos

• Node.js 22 ou mais novo, e Git.
• Acesso aos três repositórios no GitHub.
• Um arquivo .env no backend com as variáveis da página Serviços e acessos (os valores estão no segredo envMakers do AWS Secrets Manager, veja Serviços e acessos).

Servidor (Makers-backend)

Outros comandos úteis: npm run build (gera a versão de produção), npm test (roda os testes automáticos, incluindo os do motor de preço) e npm run lint.

Painel e site do cliente

Por padrão, os dois sites falam com o servidor de produção (https://newapi.makers.com.br). Para apontar para o seu servidor local: no painel, defina NEXT_PUBLIC_API_URL=http://localhost:3001 em .env.local; no site do cliente, o endereço fica fixo em src/app/service/axios.tsx (há uma linha comentada para o endereço local).

Banco de dados: alterações de estrutura

O desenho do banco está em Makers-backend/prisma/schema.prisma e cada mudança vira uma migration na pasta prisma/migrations (hoje, 65). Regras importantes:

• Para criar uma migration: env -u DIRECT_URL npx prisma migrate dev. O prefixo env -u DIRECT_URL é obrigatório, porque a conexão direta (porta 5432) não é acessível de fora; o pooler (porta 6543) funciona.
• Para aplicar em produção: env -u DIRECT_URL npx prisma migrate deploy.

Publicar uma versão

1. Testar localmente.No backend, npm test deve passar.
2. Rodar o script de deploy.pwsh .\git-deploy.ps1 -Message "descrição da mudança". Use -DryRun para só ver o que seria feito.
3. Aplicar migrations em produção, se houve mudança de estrutura (comando acima).
4. Conferir a publicação no GitHub (aba Actions do Makers-backend): o fluxo publica a imagem e reinicia o servidor no EC2.

O servidor é dividido em módulos, um por assunto. Clique nas pastas para abrir.

O painel é um site Next.js. Em Next.js, cada pasta dentro de app/ vira uma tela do menu.

O site do cliente segue a mesma organização do painel: cada pasta de src/app/(pages) é uma tela.

O painel é onde a equipe da Makers cadastra tudo o que alimenta o preço e acompanha os pedidos. Quase nada do que você precisa mudar no dia a dia exige mexer em código.

O menu lateral

Padrões que se repetem em quase todas as telas

• Tabela com busca e filtros. A caixa "Pesquisar…" filtra na hora; o botão Filtros abre opções avançadas.
• Barra de botões: Atualizar (recarrega do servidor), Adicionar, Excluir (pede confirmação), Exportar e, em algumas, Importar planilha.
• Painel lateral de detalhes. Clicar numa linha abre um painel à direita com todos os campos, onde se edita.
• Salvar / Cancelar mudanças. Em telas de edição em tabela, as mudanças só valem depois de Salvar mudanças.

O acesso ao painel é por e-mail e senha de administrador.

Entrar

Na tela de login, informe o e-mail e a senha do administrador. A sessão fica aberta até você clicar em Sair no menu.

Esqueci a senha

1. Peça o código.Em "Esqueci a senha", informe o e-mail do administrador.
2. Digite o código que chegou por e-mail.
3. Defina a nova senha.

Se o e-mail de recuperação não chegar, confira a conta de e-mail do sistema em Serviços e acessos.

Criar ou remover um administrador

Os administradores ficam na tabela Admin do banco (ver MER). O painel não tem uma tela para criar novos administradores. O servidor tem a operação pronta (POST /admin, que só funciona com um administrador já logado), e um desenvolvedor a executa quando for preciso.

A tela mais usada no dia a dia: todos os pedidos, com situação, valor e prazo.

A lista

Status do pedido

1. Aguardando pagamento.O cliente iniciou o checkout. O material fica reservado pelo tempo definido em Configurações ("Reserva de material"). Se não pagar, a reserva é devolvida ao estoque, e depois de 48 horas o pedido é cancelado automaticamente.
2. Em aberto.Pagamento confirmado: os cartões foram criados no Trello e o pedido foi enviado ao Bling.
3. Em produção.Algum cartão foi movido para uma coluna de máquina no Trello. (O painel também tem a opção Aguardando produção, para uso manual.)
4. Concluído.Os cartões chegaram à expedição. Passados 3 minutos, o sistema emite a nota fiscal no Bling e avisa o cliente por e-mail.
5. Cancelado.Cancelar um pedido devolve ao estoque o material que ele segurava.

O caminho completo, com os desvios, está em Estados do pedido.

Filtros e relatórios

• Filtros: status, data inicial e final, valor mínimo e máximo.
• Exportar: baixa a lista filtrada.
• Relatório Valor/Min: mostra quanto cada pedido pagou por minuto de máquina, comparando o tempo estimado com o real. Serve para saber quais pedidos rendem mais por hora de máquina.

Detalhe do pedido

Ao clicar num pedido abre o painel lateral com:

• Dados do cliente (com atalho "Ver cliente") e nota fiscal.
• Os arquivos, material e máquina de cada grupo, e a prévia do desenho.
• Resumo do orçamento: total do corte, total do material, frete, descontos de corte/material/frete e taxa regional. É a mesma composição explicada em Fechamento do preço.
• Tempo de máquina estimado, tempo real e custo por minuto.

O Simulador é a ferramenta para testar arquivos, comparar cenários e auditar preços. Usa exatamente o mesmo motor que o site do cliente.

Para que serve

• Montar um orçamento para um cliente (por exemplo, por telefone) e gerar o PDF.
• Entender por que um arquivo ficou com determinado preço.
• Testar uma mudança de parâmetro (velocidade, fator K, preço da hora) sem alterá-la no cadastro.

Como usar

1. Dados gerais.Escolha a unidade do desenho (mm ou cm), o grupo de desconto e a taxa regional do pedido, e dê um nome ao orçamento (ex.: "Diogo — Suporte Ferro"). Se quiser cobrar algo à parte, informe um valor extra com uma observação, e marque se ele aparece como linha separada para o cliente.
2. Escolha o material de cada grupo. Marque "Cliente traz o próprio material" quando for o caso.
3. Arraste os arquivos DXF. O sistema lê as camadas por cor; para cada cor, escolha a ação (cortar, gravar riscado, gravar preenchido ou ignorar).
4. Veja o resultado por arquivo: dimensões, perímetro, número de furos (piercings), tempo de máquina, valor de máquina e de material por unidade, e as chapas e retalhos escolhidos.
5. Abra o resumão para ver o pedido todo dividido por máquina, material e arquivo.

O bench (bancada de calibração)

Dentro de cada grupo existe um painel de calibração com três blocos. Mudar qualquer campo recalcula o preço na hora, mas só vale para aquela simulação:

Resumão

É o painel que fecha as contas do pedido: para cada máquina mostra o tempo, o preço da hora efetivo, o corte, a gravação, a taxa de manuseio e o "valor para completar o mínimo"; para cada material, a parte usada, o fator K, o markup e as chapas; e por arquivo, quanto de máquina e de material cabe a cada um. A soma sempre fecha com o total do pedido, ao centavo.

O catálogo de materiais. Um material é uma família (Acrílico, MDF, Inox 304); cada espessura/cor dele é uma variante, cadastrada em Parâmetros.

A lista de materiais

Cada linha é uma família. Os campos editáveis são:

Visão em grade

Uma versão em planilha, com os materiais em estoque, botão para criar um novo material e atalho para ver todas as chapas. Boa para uma conferência rápida.

Criar um material novo (passo a passo)

1. Adicione a família em Materiais, com nome, fornecedor e as máquinas de corte (e de gravação, se houver).
2. Crie as variantes em Parâmetros: espessura e parâmetros de corte.
3. Cadastre as chapas de cada variante em Condições gerais ou em Estoque, com tamanho, preço e quantidade.
4. Teste no Simulador com um DXF conhecido antes de liberar para clientes.

Aqui ficam os parâmetros de corte de cada variante de material. São os campos que mais pesam no tempo, e portanto no preço.

Cada linha é uma variante (por exemplo, "Acrílico 4 mm Preto"). Você pode editar direto na tabela e usar Salvar mudanças, ou abrir o painel lateral. O botão Criar novo com as mesmas características duplica a variante (útil para outra espessura).

Identificação

Regras do material

Parâmetros de tempo (afetam o preço da máquina)

Parâmetros de material (afetam o preço do material)

Como testar uma mudança

Abra o Simulador com um arquivo conhecido, mude o campo no bench e veja o preço. Quando estiver satisfeito, grave o novo valor aqui.

A visão das variantes junto com as chapas e retalhos cadastrados em cada uma: tamanhos, preços e quantidades.

O que se faz aqui

• Ver, para cada variante, quais tamanhos de chapa existem (ex.: 2000 × 1000 mm).
• Filtrar por tipo: Chapa inteira ou Retalho.
• Adicionar uma variante, Duplicar uma existente (para outra espessura) ou abrir o Estoque dos materiais que têm chapas.
• Editar os mesmos parâmetros da tela Parâmetros, mais o campo "Catar peças + Troca de chapa".

Detalhe da chapa

Ao abrir uma chapa você vê o material, o ID único da variante, os parâmetros e o tipo (chapa inteira ou retalho), além das medidas, do preço e da quantidade.

Preço de chapa inteira e de retalho

Chapa inteira: o preço é cadastrado por você (o valor que a Makers paga ao fornecedor). Retalho: o preço é calculado automaticamente. O sistema acha a menor chapa inteira em que o retalho caberia e cobra a fatia proporcional da área; o "preço real" soma a parte da sobra (fator K). Quando o preço da chapa muda, os retalhos são recalculados.

Cadastro simples dos fornecedores de chapa.

O fornecedor é escolhido no cadastro do material. Hoje ele é informativo para a equipe: o prazo que entra no orçamento vem do campo Prazo de compra do material ou da variante.

O estoque físico da fábrica: o que existe, quanto, e tudo o que aconteceu com cada chapa.

Chapas e retalhos

Cada linha é um tamanho de chapa (ou retalho) de uma variante de material, com quantidade e preço. Ao receber chapas do fornecedor, dê entrada informando a quantidade; o sistema soma ao estoque e registra no histórico.

• Código interno: a etiqueta da chapa ou do retalho (ex.: 000354). Quando não informada, o sistema gera uma.
• Retalhos derivados: um retalho cortado de uma chapa herda a etiqueta de origem com um sufixo, para saber de onde veio.
• Estoque zerado não bloqueia: uma chapa inteira (tipo "chapa") com quantidade 0 ainda pode ser orçada, porque pode ser comprada sob demanda, e isso entra no prazo. Retalho com quantidade 0 não é usado, pois já foi consumido.

Como o estoque é consumido

1. No checkout (cliente clica em pagar), o sistema reserva o material: dá baixa nas chapas que o pedido usa, por área, usando retalhos antes de chapas novas.
2. Se o pagamento não acontece dentro do prazo de reserva, o material volta ao estoque sozinho.
3. Se o pedido é cancelado, o material também volta (estorno).
4. Depois do corte, a produção pode lançar os retalhos que sobraram, vinculados à chapa de origem.

Histórico do estoque

Registra toda mudança de quantidade: quando, qual chapa, quanto entrou ou saiu, o saldo depois do movimento, de onde veio (entrada rápida, contagem, edição, exclusão, pedido, devolução de retalho) e quem fez (nome digitado na tela de contagem ou "admin"). Dá para buscar por código (ex.: CH-000023) ou por medida (ex.: 1000x1000) e filtrar por tipo de movimento.

Uma tela separada, sem login de administrador, feita para o chão de fábrica contar e ajustar o estoque.

1. Abra a tela "Estoque da Produção".O endereço é /contagem no painel.
2. Informe seu nome e o PIN de contagem. O PIN é definido em Configurações (campo "PIN da contagem de estoque").
3. Conte e ajuste.Dê entrada, saída ou corrija a quantidade de chapas e retalhos. Cada movimento fica no histórico com o nome que você digitou.

O cadastro das máquinas de corte e gravação. É onde está o preço da hora.

Dados da máquina

Preço da hora

Máquina sem valor próprio usa o do grupo. Valor da máquina vale mais que o do grupo. A máquina precisa ter ao menos um valor (próprio ou de grupo) em Preço da hora ou Fator de escala; senão, não entra nos orçamentos.

Gravação

Materiais ligados

No painel lateral da máquina aparece a lista de materiais vinculados e o botão para vincular outros. A ligação é a mesma configurada em Materiais, vista do outro lado.

Um grupo reúne máquinas parecidas que compartilham o mesmo preço da hora. Mudar o grupo muda todas as máquinas dele de uma vez.

Cada grupo mostra as máquinas que pertencem a ele. Uma máquina com valores próprios aparece sinalizada ("esta máquina tem coeficientes próprios"). A fórmula completa, com exemplos, está em Custo de máquina.

A lista de quem se cadastrou no site, sejam pessoas físicas ou empresas.

• Dados: nome, e-mail, telefone, CPF/CNPJ, razão social, inscrição estadual e municipal, cidade, estado, endereço completo e data de cadastro.
• Valor total gasto e a lista de pedidos de cada cliente.
• Filtros: tipo de cadastro (pessoa física/jurídica), estado, possui pedidos, período e faixa de valor gasto.
• Grupo de desconto: é o que aplica o desconto de corte/material/frete do cliente. Os grupos são criados em Configurações.

As regras gerais do orçamento e do sistema. O menu da página tem sete seções.

Grupos de desconto

Cada grupo tem um nome e três percentuais: corte, material e frete. Para dar o desconto a um cliente, associe-o ao grupo (ou aplique no simulador ao orçar). Desconto de corte reduz só o valor de máquina; desconto de material reduz só o valor do material.

Sistema

• Desabilitar o sistema de orçamentos: liga uma tela de manutenção no site do cliente, com a mensagem que você escrever.
• Banner na tela de pagamento: aviso opcional (título e texto) mostrado antes de pagar. Serve também para comunicar instabilidades.
• Aviso para quem traz o próprio material: texto geral mostrado a todo cliente que escolher essa opção.
• Termos de serviço: o texto exibido no site e no cadastro. Linhas que começam com "1. ", "2. " viram títulos.
• Foto da home e ocultar materiais na home, link do vídeo de login e links extras do menu.

Precificação

Produção e prazos

Prazo do pedido = dias de fila + (tempo total de produção ÷ jornada diária, arredondado para cima) + dias de compra de chapa, se faltar estoque.

Integrações

• PagBank: liga o pagamento online.
• Pagamento posterior: permite fechar o pedido e combinar o pagamento depois.
• Preferência para TotalExpress e Jadlog nas opções de frete.
• Gerar nota fiscal automaticamente e sincronizar retalhos com o Bling.
• URL do Google Sheets que recebe os pedidos.

Insights de aproveitamento

Avisos que o sistema mostra ao cliente quando uma pequena mudança melhora o preço (por exemplo, "pedindo mais 2 peças, o custo por peça cai"). Cada aviso pode ser ligado ou desligado, e tem limiares ajustáveis.

Taxas regionais

Uma lista de estados com um percentual cada. A taxa do estado do cliente é somada ao total do pedido (não subtraída do corte), junto com o imposto geral.

Uma chave liga/desliga para cada serviço externo conectado.

Cada cartão representa uma integração (por exemplo, "Trello" e "Bling ERP"). Desligar uma integração suspende o envio de novos pedidos para ela e as tentativas automáticas de reenvio. Os pedidos continuam sendo criados normalmente.

Quando desligar

• O serviço externo está fora do ar por muito tempo e você não quer acumular erros.
• Está em teste e não quer gerar cartões ou notas de verdade.

E os envios que falharam?

Cada tentativa fica registrada por pedido (tabela PedidoIntegracao): status, mensagem, número de tentativas e o que foi enviado e respondido. O sistema tenta de novo sozinho, até 5 vezes. Depois disso é preciso reenviar manualmente ou acionar a equipe técnica.

Edite o texto de cada e-mail que o sistema envia, ligue ou desligue qualquer um deles e crie novos e-mails que saem quando um card chega numa coluna do Trello. Tudo pelo painel, sem precisar da equipe técnica.

Os e-mails do sistema

Cada um tem um interruptor Ligado / Desligado. Desligado, o e-mail simplesmente não sai; o resto do pedido segue normalmente. Esses seis não podem ser apagados, só desligados.

Editar o texto

1. Abra E-mails no menu lateral e clique no lápis do e-mail desejado.
2. Altere o assunto e o texto. Linha em branco separa parágrafos. Uma linha que começa com # vira o título verde ("# Olá, {primeiro_nome}!").
3. Insira chaves clicando nos botões coloridos ou digitando entre chaves. Cada uma é trocada pelo dado do pedido na hora do envio.
4. Confira a pré-visualização ao lado (com dados de exemplo) e clique em Salvar. Vale para os próximos envios.

Chaves disponíveis

• Chave digitada errada (por exemplo {nme}) aparece no e-mail do jeito que foi escrita, sem travar o envio. Confira na pré-visualização.
• Nem todo e-mail conhece todas as chaves; as que não têm valor ficam como escritas. {nome} e {pedido} existem em todos, menos em "Conta criada" (só tem {nome} e {link}). {valor} não existe em "Conta criada". {prazo} só existe no aviso de novo pedido e nos e-mails por coluna do Trello. {link} só em "Orçamento pronto para pagamento" e "Conta criada". {endereco_retirada} e {horario_retirada} existem em todos.
• Nome e outros dados vindos do cliente são sempre tratados como texto: não conseguem inserir código no e-mail.

E-mail por coluna do Trello

Em Novo e-mail por coluna do Trello, escolha uma coluna do quadro (a lista vem direto do Trello) e ajuste o texto. Quando o card de um pedido chegar nessa coluna, o cliente recebe o e-mail.

• Um e-mail por pedido e coluna, mesmo que o Trello avise duas vezes ou que o pedido tenha um card por máquina.
• Se o pedido voltar e passar de novo pela mesma coluna, não sai de novo.
• O e-mail só sai com o interruptor ligado. Dá para criá-lo desligado, escrever com calma e ligar depois.
• Pedidos cujo cliente não tem e-mail cadastrado não recebem nada (fica no registro do servidor).
• Apagar o e-mail da coluna não afeta os que já foram enviados.

O aviso de novo pedido (para a equipe)

A cada pedido pago a equipe recebe um e-mail com tudo para começar a produzir, sem abrir o painel:

• Cliente: nome ou razão social, CPF/CNPJ, e-mail, telefone, serviço, método de envio, endereço, prazo e observações.
• Como o preço foi feito: corte (e tempo de máquina), gravação, desconto, manuseio, complemento do mínimo, material usado, fator K, markup, desconto do material, imposto, taxa regional, subtotal, frete e valor do pedido. É a mesma composição que vai para a planilha. Quando não está disponível (preço manual ou pedido editado depois do checkout), o e-mail diz isso em vez de mostrar números que não fecham.
• Arquivos: uma linha por arquivo, com miniatura, nome, quantidade, material e espessura (ou "Material próprio"), máquina, preço e o link Baixar DXF.
• Anexos: os DXFs seguem anexados quando somam até 10 MB. Acima disso vão só os links (o e-mail avisa).

Quem recebe: em Configurações, campo "Quem recebe o aviso de novo pedido", com um ou mais e-mails separados por vírgula. Vazio, vai para o e-mail de suporte do servidor. Assunto e texto de abertura se editam aqui, como nos outros; os blocos de dados abaixo do texto são sempre incluídos.

O mesmo pedido nunca gera dois avisos, mesmo que o PagBank confirme o pagamento mais de uma vez.

Cuidados

• O envio sai da conta de e-mail do servidor (variáveis TRANSPORTER_EMAIL e TRANSPORTER_SENHA, ver Serviços e acessos). Se a senha dela mudar, nenhum e-mail sai e o painel não avisa; o erro aparece só no registro do servidor.
• Mudar o texto não altera e-mails já enviados.
• Visual: todos os e-mails saem com a mesma moldura da marca (faixa escura com "MAKERS" e linha verde no topo, rodapé "Equipe Makers Manufatura"). Um parágrafo em que toda linha é no formato Rótulo: valor (por exemplo "Pedido: #{pedido}" e "Valor: {valor}") vira uma caixa verde-clara com o rótulo em negrito; o título "# ..." fica em verde. Isso é automático, não precisa de código.
• Para testar um e-mail sem incomodar clientes, coloque o seu endereço em "Quem recebe o aviso de novo pedido" e faça um pedido de teste.

O site do cliente é o "balcão" da Makers: o cliente cria a conta, envia o desenho, vê o preço na hora e paga. Esta página mostra o caminho completo, para você saber o que o cliente enxerga quando conversa com ele.

O caminho do cliente

1. Cadastro e login.O cliente se cadastra como pessoa física (CPF) ou empresa (CNPJ), completa o endereço e entra com e-mail e senha. Há recuperação de senha em três passos: e-mail, código e nova senha. Os dados ficam em Cliente (pessoa física) e Cliente (empresa).
2. Orçamento.É a tela principal. O cliente arrasta um ou vários arquivos DXF, escolhe o material e a espessura (cartões com foto) e informa a quantidade de cada arquivo.
3. Conferência do desenho.O site mostra a prévia, as medidas e o que cada cor do desenho significa (cortar, gravar, ignorar), e o cliente confirma. Avisa sobre problemas: contornos abertos, furos muito pequenos, desenho maior que a chapa.
4. Preço na hora.O resumo mostra o valor por arquivo e o total, a quantidade de chapas, o prazo e avisos de aproveitamento ("pedindo mais 2 peças, o custo por peça cai").
5. Material próprio.O cliente pode marcar que traz o próprio material. O preço é recalculado sem o custo da chapa, e aparece o aviso configurado em Configurações.
6. Pagamento.O cliente informa o endereço de entrega, escolhe o frete (calculado pela Frenet pelo CEP) ou retirada e paga pelo PagBank. Aceita os Termos de Serviço, editáveis no painel. O valor é recalculado pelo servidor no momento da cobrança.
7. Meus pedidos.O cliente acompanha o status de cada pedido, vê o detalhe de cada um, com a prévia dos arquivos.

O que o cliente não vê

• Preço da hora, coeficientes, fator K e margens: ele vê apenas o total por arquivo e o total do pedido, já com imposto e taxa regional.
• Os parâmetros internos de cada material. Ele vê nome, espessura, foto e a observação que você escrever.

O que você controla pelo painel

O banco de dados é o arquivo organizado do sistema: tudo o que você cadastra e tudo o que o cliente faz fica gravado nele, em tabelas. Esta página explica a lógica; o mapa completo está na próxima.

Como pensar nas tabelas

Cada tabela é como uma planilha especializada (uma para clientes, uma para pedidos, uma para máquinas). Em vez de repetir informações, as tabelas se ligam: um pedido não guarda o nome do cliente, guarda o número do cliente, e o sistema vai buscá-lo na tabela de clientes. É isso que evita dados desencontrados.

As cadeias mais importantes

1. De onde vem um pedido

Um pedido tem vários grupos; um grupo tem vários itens; cada item aponta para um DXF e para a máquina escolhida.

2. O catálogo de materiais

3. Máquinas e preço

4. Quem compra

Por que o pedido guarda cópias

O pedido guarda uma cópia do endereço de entrega, dos percentuais de desconto e do valor total no momento da compra. Se amanhã o cliente mudar de endereço ou a Makers alterar um desconto, os pedidos antigos continuam mostrando o que valia naquele dia.

Como ler o mapa

• As tabelas estão agrupadas por assunto (Pessoas, Materiais, Estoque, Máquinas, Pedidos, Integrações, Configuração).
• Clique numa tabela para ver os campos e as ligações. O desenho "Mapa de ligações" mostra, à esquerda, a que a tabela se liga e, à direita, quem se liga a ela. Clique nas tabelas vizinhas para navegar.
• Os termos usados: chave = número que identifica cada linha; único = não pode se repetir; ligação = campo que aponta para outra tabela; opcional = pode ficar vazio.

Modelo Entidade-Relacionamento do sistema Makers. Clique em qualquer tabela para ver seus campos, para que serve cada um e a que outras tabelas ela se liga.

Para ler o mapa: "N:1" significa "muitos para um" (muitos pedidos para um cliente); "1:1" é "um para um"; "N:N" é "muitos para muitos" (um material tem várias máquinas, e uma máquina trabalha vários materiais). Os valores possíveis de campos de lista fixa aparecem dentro da descrição do campo.

O preço de um pedido é a soma de três coisas: o que custa usar a máquina, o que custa o material e os tributos. Cada uma tem regras próprias, explicadas nas páginas seguintes, na ordem em que o sistema as calcula.

O caminho em 12 etapas

A fórmula em uma linha

E cada parte, em resumo:

Depois entram o valor mínimo (que pode elevar o corte) e, no pagamento, o frete (com desconto próprio) e qualquer valor extra lançado pela Makers.

Veja o preço sendo montado

Use os botões para avançar uma peça por vez, ou reproduza a sequência inteira. O exemplo é o pedido de 30 peças explicado em detalhe mais adiante.

Os três grandes blocos

Para ver tudo funcionando com números, vá direto ao exemplo completo ou experimente a calculadora interativa.

Antes de calcular qualquer coisa, o servidor precisa entender o desenho: onde estão os contornos, que tamanho tem a peça e o que a máquina deve fazer com cada cor.

O que é lido

• Contornos (caminhos). Linhas, arcos, círculos, polilinhas e curvas do DXF são transformados em sequências de pequenos segmentos retos, que é como a máquina realmente se move. Cada contorno vira um caminho.
• Tamanho da peça. A caixa que envolve o desenho (largura × altura), usada para escolher chapa e máquina.
• Perímetro. Soma do comprimento de todos os caminhos que serão cortados.
• Peças físicas. Quantas peças separadas o desenho realmente contém. Um arquivo com 140 peças encaixadas conta 140 na hora de "catar peças".
• Unidade. O cliente informa se o desenho está em mm ou cm. Um desenho em cm é multiplicado por 10 antes de qualquer conta.

As cores decidem a ação

Cada cor do desenho recebe uma ação. O cliente (ou você, no simulador) pode escolher; sem escolha, o sistema sugere pela cor:

Avisos que o sistema dá

• Furos pequenos: furos fechados menores que o limite "small holes" do material geram aviso de risco de falha no corte.
• Contornos abertos, texto no desenho e linhas duplicadas: ficam registrados no arquivo para a equipe avaliar. O sistema corrige o que é seguro corrigir e sempre calcula a partir do arquivo original.
• Tamanho do arquivo: há um limite de MB definido em Configurações.

O tempo de corte não é simplesmente "perímetro dividido pela velocidade". O sistema simula o movimento do cabeçote como a máquina faria, com aceleração, curvas e deslocamentos.

O que entra no tempo de uma peça

Como o movimento é simulado

1. Cada contorno começa e termina parado.O cabeçote precisa frear ao fim de um contorno e arrancar no seguinte.
2. Nos cantos, a velocidade cai.Quanto mais fechado o canto, mais a máquina reduz. É o mesmo comportamento de uma máquina real (método chamado junction deviation). Uma curva suave quase não reduz; uma volta de 180° quase para.
3. A aceleração limita o ganho de velocidade.Em um segmento curto, a máquina nem chega a atingir a velocidade máxima. Por isso peças pequenas e com muitos detalhes são mais lentas do que o perímetro sugere.
4. Entre contornos, o cabeçote desloca na velocidade rápida.O sistema conta a distância real entre o fim de um contorno e o início do próximo.
5. Cada contorno tem um furo (piercing) e uma entrada (inlet).Uma peça com 40 furos pequenos paga 40 piercings.

Veja o cabeçote trabalhando

A animação abaixo executa a mesma simulação do servidor. Escolha uma peça, aperte Reproduzir e mexa nos controles: o tempo por peça e o impacto no preço do pedido de 30 peças são recalculados na hora.

O que observar

• Furar custa tempo fixo. Na placa de 12 furos a cabeça fura 13 vezes. Suba o piercing de 0,5 para 2 s: o tempo por peça passa de 91,7 s para 111,2 s, sem mudar o desenho.
• Cantos pedem freio, mas por pouco tempo. A máquina reduz e recupera a velocidade em frações de milímetro, então os "vales" são finos demais para aparecer no gráfico. O efeito está na soma: com corte rápido (6.000 mm/min) e aceleração baixa (300 mm/s²), a estrela leva 10,6 s contra 7,2 s do "ideal" (+47%), enquanto o disco, sem cantos agudos, leva 7,1 s contra 6,3 s (+14%).
• Aceleração baixa pune o corte rápido. Com 1.500 mm/min o efeito é pequeno (a peça de exemplo vai de 48,3 s para 49,4 s com aceleração 300). Suba a velocidade para 6.000 mm/min e a mesma peça leva 16,4 s contra 11,6 s do "ideal".
• Deslocamento rápido ainda custa. Os traços tracejados levam bem menos tempo que cortar, mas somam em peças com muitos furos espalhados.

Por dentro da conta: a velocidade e a integral

A física por trás do tempo é a de um carro andando em linha reta: acelera, mantém velocidade e freia. A distância percorrida é a área sob o gráfico de velocidade. Em linguagem de cálculo, d = ∫ v(t) dt. O sistema faz a conta inversa: conhece a distância (o comprimento do segmento) e descobre o tempo que a área exige.

Repare no que o controle Comprimento mostra: segmentos longos têm um trecho em cruzeiro, onde a conta é quase "distância ÷ velocidade". Segmentos curtos nem chegam à velocidade máxima, e o tempo por milímetro fica muito maior. Por isso uma peça cheia de detalhes pequenos custa mais que o perímetro sugere.

Cantos: a velocidade em cada vértice

Entre um segmento e o seguinte o cabeçote precisa dobrar a direção. Quanto mais fechada a curva, menor a velocidade que a máquina aguenta sem "derrapar" o contorno. O sistema usa o método junction deviation, o mesmo de controladores de CNC e impressoras 3D: a velocidade no canto é a maior que mantém o desvio do traçado abaixo de 0,1 mm.

Depois de definidas as velocidades máximas nos cantos, o sistema faz duas passadas, uma para frente e outra para trás, para garantir que a aceleração e a frenagem realmente permitem chegar a cada canto na velocidade prevista. Com as velocidades de entrada e saída de cada segmento, aplica-se a conta do trapézio ou do triângulo acima e soma-se o tempo.

Exemplo: uma peça de 300 × 200 mm com um furo quadrado de 40 mm

Velocidade de corte 1.500 mm/min, deslocamento 20.000 mm/min, aceleração 1.500 mm/s², piercing 0,5 s, inlet 2 mm. Perímetro total: 1.000 + 160 = 1.160 mm.

Esse tempo por peça é multiplicado pela quantidade. Para 30 peças: 30 × 48,28 s = 1.448,4 s (24,1 min) de corte. O tempo total do pedido, que inclui setup e trocas, é calculado na etapa 4.

Gravação riscada e gravação preenchida

• Riscado: mesma simulação do corte, mas na velocidade de gravação, sem piercing e sem inlet. O tempo é somado ao corte e cobrado pela máquina de corte.
• Preenchido: o sistema simula a varredura linha a linha (passo de 0,1 mm). O tempo conta para o prazo, mas o preço é por área (ver Gravação preenchida).
• A velocidade de gravação vem do material; se faltar, da máquina; se também faltar, o sistema usa um terço da velocidade de corte.

Parâmetros que você controla

Para saber o custo do material, o sistema precisa decidir em que chapa a peça cabe e quantas chapas o pedido consome. Isso é o nesting: um "Tetris" de peças dentro das chapas.

O que o sistema considera

• As chapas cadastradas para a variante de material: tamanhos, preços e estoque (inclusive retalhos). Veja Condições gerais.
• O espaço entre peças (nesting gap, em mm).
• A rotação. Materiais sem veio podem ter a peça girada 90° para aproveitar melhor. Materiais com veio ("Pode rotacionar" desmarcado) mantêm a orientação, e o cliente indica se o veio corre na largura ou na altura da peça.
• A mesa da máquina. O encaixe nunca excede a mesa: uma chapa de 2,20 × 1,60 m numa mesa de 2,00 × 1,50 m só pode ser cortada na parte que cabe na mesa.

Como a chapa é escolhida

1. Testa as chapas da menor para a maior.Cada peça vai para a menor chapa em que cabe, para uma peça pequena não ocupar uma chapa grande só porque está no mesmo pedido de uma peça grande.
2. Encaixa as peças em cada chapa (algoritmo de empacotamento retangular, com as peças maiores primeiro) e conta quantas chapas foram necessárias.
3. Compara com a alternativa de uma chapa só.Se todo o pedido couber em um único tamanho de chapa por um custo total menor (ou com menos chapas, em caso de empate), esse tamanho vence.
4. Resultado: uma lista de "N chapas de L × A mm", mostrada no resumão e no card do orçamento.

Casos especiais

Em que ordem as peças são posicionadas

Depois de decidir quantas peças vão em cada chapa, o sistema as posiciona sem deixar buracos no meio: ordena da peça mais alta para a mais baixa e vai enchendo primeiro o lado menor da chapa (uma fileira ao longo da menor dimensão); quando a fileira fecha, avança pelo lado maior. Numa chapa de 2.000 × 1.000 mm, as fileiras correm ao longo dos 1.000 mm e vão se somando ao longo dos 2.000 mm. Assim a sobra fica concentrada em uma ponta da chapa, em forma de retângulo aproveitável como retalho, e não espalhada em pedaços. Essa ordem só organiza o desenho: não muda quantas peças cabem nem o preço.

No exemplo

30 peças de 300 × 200 mm em chapas de 2.000 × 1.000 mm, com espaço de 3 mm. Sem girar a peça, cabem 6 ao longo do comprimento e 4 na largura: 24 peças por chapa. Para 30 peças são necessárias 2 chapas (a segunda leva só 6). Se o material permitisse girar 90°, caberiam 27 por chapa (9 × 3): o exemplo trata o material como se não pudesse girar.

Experimente

Mude o tamanho da peça, o espaço entre elas e a quantidade. Marque "pode girar" para ver o ganho de um material sem veio. Repare em como o aproveitamento (p) oscila: uma peça pouco menor pode caber duas vezes mais, ou nenhuma a mais.

Cortar não é só o laser funcionando. O pedido também gasta tempo com setup, troca de chapa e catar peças. Tudo isso é tempo de máquina ocupada e entra no preço.

As três parcelas

Como troca e catar se combinam

Enquanto alguém cata as peças de uma chapa, também precisa trocar para a próxima. Então, em cada chapa, o sistema cobra o maior dos dois (o que tomar mais tempo), em vez de somá-los. A última chapa não tem troca depois dela, mas suas peças ainda precisam ser catadas.

No exemplo

30 peças, 24 por chapa, 2 chapas; catar = 3 s por peça; troca = 2 min; setup = 5 min.

Brinque com a linha do tempo

Prazo do pedido

O mesmo tempo gera o prazo informado ao cliente:

Dias de fila e jornada vêm de Configurações. Os dias de compra de chapa só entram quando falta chapa em estoque e o cliente não trouxe o material. No exemplo, com fila de 3 dias e jornada de 8 h: 3 + ⌈31,44 ÷ 480⌉ = 4 dias, mais o prazo de compra se não houver chapas em estoque.

Aqui o tempo vira dinheiro. Primeiro o sistema escolhe a máquina; depois aplica o preço da hora dela, que não é fixo: começa mais alto e baixa conforme o trabalho fica mais longo.

Escolha automática da máquina

1. Filtra as máquinas do material.Só as que estão ligadas ao material em Materiais e ativas.
2. Mantém as que comportam a peça.A peça precisa caber na mesa (área X × Y), girando 90° se o material permitir.
3. Escolhe a mais barata.Menor soma de fator de escala + preço da hora base.

Se nenhuma máquina comportar a peça, o cliente recebe um erro claro ("nenhuma máquina vinculada ao material comporta o tamanho desta peça"). Máquinas sem coeficiente de preço cadastrado nunca são escolhidas, para não "vencer" por parecer grátis.

O preço da hora (Vh)

A regra combinada com a Makers: cobrar mais caro pelos primeiros minutos (que cobrem o custo de preparar a máquina) e ir barateando a hora à medida que o tempo passa, de forma suave, sem degraus. Matematicamente é uma curva de decaimento exponencial:

Como a hora varia (B = R$ 100, A = R$ 100, estabiliza em ≈ 9,2 h)

Explore a curva

O retângulo verde é o custo (preço da hora × tempo). Deslize o tempo cobrado e veja a hora cair, mas o retângulo crescer.

No exemplo

Tempo total 0,524 h; B = 100; A = 100; F = −0,5:

De onde vêm A, B e F

De cada grupo de preço, para todas as máquinas dele. Uma máquina pode ter valor próprio, que vence o do grupo. A regra é aplicada campo a campo: valor da máquina; se vazio, do grupo; se vazio, zero.

Multiplicador de hora por material (opcional)

Alguns materiais (por exemplo, metais grossos) exigem uma hora mais cara que outros na mesma máquina. Em Parâmetros há os campos de multiplicador de hora, que escalam a hora de acordo com a duração do trabalho:

Sem esses campos preenchidos, M = 1 e não há efeito. Aplica-se somente ao corte, nunca à gravação.

O valor usado é a média do multiplicador ao longo de todo o trabalho, ou seja, uma integral dividida pelo tempo. Veja como ela se comporta:

Gravação preenchida (um logotipo, uma foto, uma área rasterizada) é cobrada pela área gravada, não pelo tempo, porque o tempo depende de detalhes que o cliente não controla.

A conta

• Taxa de gravação por área e taxa de setup: cadastradas na máquina de gravação.
• Multiplicador de gravação: cadastrado no material (vazio = 1). Para materiais mais difíceis, 1,5 cobra 50% a mais.
• A área vem da soma dos contornos fechados da camada, multiplicada pela quantidade do arquivo.

O que acontece com o resto do tempo

Num pedido com corte e gravação preenchida por área, os tempos de setup, troca de chapa e catar peças ficam inteiros no corte. A gravação é paga só pela área; o overhead não é dividido entre as duas, para nada deixar de ser cobrado.

Exemplo

Uma logo de 60 cm² numa máquina com taxa de R$ 0,80/cm², setup de R$ 15 e multiplicador 1,0: 60 × 0,80 + 15 = R$ 63,00, somados ao corte da peça.

O material é cobrado em duas partes: a parte usada da chapa e uma parcela da sobra, controlada pelo fator K. A margem da Makers (markup) incide apenas sobre a parte usada.

Passo a passo

1. Custo das chapas.Número de chapas × preço da chapa. É o que a Makers paga ao fornecedor.
2. Aproveitamento (p).Que fração da área das chapas é ocupada pelas peças: p = (quantidade × área da peça) ÷ área total das chapas, no máximo 100%.
3. Parte usada.custo das chapas × p: o material que de fato virou peça.
4. Sobra.custo das chapas × (1 − p): o que sobra na chapa.
5. Fator K.Percentual da sobra que o cliente paga: sobra × K. É o risco de a sobra não ser reaproveitada.
6. Markup.Margem da Makers sobre a parte usada: usada × (1 + markup). A sobra entra sem margem.
7. Desconto de material do grupo do cliente, se houver (ver Descontos).

O fator K

• Cadastrado por variante, em percentual (20 = 20%), em dois campos: com estoque (a chapa já está na fábrica, a sobra vira retalho útil) e sem estoque (chapa nova a comprar).
• Quando o pedido mistura chapas de estoque e chapas novas, o K é a média ponderada pelo número de chapas de cada tipo.
• K vazio vale 0: não cobra nada da sobra.
• Quanto pior o aproveitamento, maior a sobra e maior a parcela de K na conta. Isso explica por que um pedido de uma peça só pode custar mais que 1/30 de um pedido de 30 peças.

Material próprio

Quando o cliente traz o material (ou a variante tem "Fornecemos = não"), a Makers não cobra a chapa: material, markup e K zeram. Continuam sendo cobrados o corte e a taxa de manuseio. Num pedido com vários arquivos, a fração de material própria é proporcional à área de cada arquivo.

No exemplo

2 chapas de R$ 480,00; 30 peças de 300 × 200 mm (60.000 mm² cada); K = 20%; markup = 30%.

Brinque com a chapa

A barra representa o custo das chapas. Veja como o aproveitamento e o fator K decidem quanto dela chega ao cliente:

Retalhos e estoque

Retalhos entram na conta como chapas menores, com preço proporcional ao tamanho (ver Condições gerais). Por isso o orçamento tende a ficar mais barato quando existe um retalho adequado.

A taxa de manuseio cobre o trabalho de separar, movimentar e armazenar a chapa. É um percentual do material usado, somado ao corte.

Regras importantes

• A base é só a parte usada: não inclui a sobra (fator K) nem o markup.
• A base não muda se o cliente traz o material. A taxa é a mesma, porque o trabalho de manuseio existe de qualquer jeito. Por isso, no material próprio, o único valor de "material" que sobra no preço é essa taxa, dentro do corte.
• Vai para o corte, não para o material. É uma taxa, não um custo: não recebe desconto de corte nem de material.
• O percentual é único, definido em Configurações › Precificação.
• Conta para o valor mínimo: o piso da máquina vale para corte + manuseio juntos.

No exemplo

Parte usada R$ 432,00 × 10% = R$ 43,20. Corte efetivo: 92,72 + 43,20 = R$ 135,92.

Clientes de grupos de desconto pagam menos no corte, no material e/ou no frete. Cada desconto incide só sobre a sua parte.

Como o cliente recebe o desconto

1. Crie o grupo em Configurações › Grupos de desconto, com os três percentuais.
2. Associe o cliente ao grupo. Dali em diante todo orçamento dele já sai com o desconto.
3. No simulador também é possível escolher o grupo "do pedido" para orçar por telefone.

O desconto fica gravado no pedido (percentuais de corte, material e frete), então alterar o grupo depois não muda pedidos antigos.

No exemplo

Com 10% de desconto no corte e 5% no material: corte 92,72 × 0,90 = 83,45 (+ manuseio 43,20 = 126,65); material 667,20 × 0,95 = 633,84. Base: 760,49. Com imposto de 6%: R$ 806,12 (contra R$ 851,31 sem desconto).

Pedidos muito pequenos custam, em tempo e esforço, mais do que o cálculo "puro" sugere. O valor mínimo garante que a Makers nunca cobre menos que um piso.

Os dois pisos

Como funciona o piso da máquina

• O piso vale para corte e manuseio juntos: um pedido pequeno em chapa grossa, que gera muito manuseio, já "ocupa" parte do mínimo.
• O ajuste é lançado no corte (aparece no resumão como valor para completar o mínimo) e também é tributado, como qualquer corte.
• O material não conta para o piso: o cliente paga o material por cima do mínimo.

Veja acontecendo

O mínimo vale para o pedido, não para cada grupo

Quando um pedido tem vários grupos (vários materiais), o piso é aplicado uma única vez sobre o corte somado de todos eles, usando o maior valor mínimo entre as máquinas envolvidas. Isso evita cobrar "um mínimo por material" de quem enviou um pedido com 3 materiais.

O piso global

É a última barreira: se, depois de tudo (imposto e taxa regional incluídos), o total ficar abaixo do "Preço mínimo de pedido", o total vira esse valor.

Exemplo: um pedido de 1 peça

Repare que, mesmo com o mínimo aplicado, quase metade do preço é material: com uma única peça, a chapa quase inteira "sobra" e o fator K pesa.

Somadas as partes, entram os tributos e, no pagamento, o frete. Este é o caminho final até o valor que o cliente vê.

A escada do preço

O resumo do pedido (no painel e no site) mostra o preço como uma escada, de cima para baixo:

No exemplo

Base = 135,92 + 667,20 = R$ 803,12. Imposto de 6% = R$ 48,19. Total = R$ 851,31.

A escada completa

O que é somado no pagamento

Arredondamento

Todas as contas intermediárias usam precisão total; o arredondamento a centavos acontece só no total final, e as divisões por máquina, material e arquivo do resumão são ajustadas para sempre somar exatamente o total.

Quando um pedido tem mais de um grupo (mais de um material) cortado na mesma máquina, o preço da hora é calculado pelo tempo total dessa máquina no pedido, e não por grupo.

A ideia

Como vimos, o preço da hora cai conforme o trabalho fica mais longo. Se alguém pede acrílico e MDF no mesmo pedido, e ambos passam pela mesma máquina de CO₂, faz sentido tratar como um trabalho só: a hora é tão barata quanto seria para o tempo somado. Cada grupo continua pagando apenas o seu próprio tempo; o que muda é a tarifa.

Exemplo

Dois grupos de 1 hora cada, na mesma máquina (B = 100, A = 100, F = −0,5):

Detalhes

• Vale por máquina: grupos em máquinas diferentes não se somam.
• Vale para o corte; a gravação por área não depende de tempo.
• O resumão e o painel do pedido mostram, para cada máquina compartilhada, o tempo somado, o preço da hora efetivo e quanto o desconto por volume economizou no total.
• Se o valor mínimo do pedido estiver ativo, o desconto por volume pode não alterar o total pago (a economia fica "absorvida" pelo piso).

Um pedido real de ponta a ponta, usando as regras das páginas anteriores. Todos os valores abaixo foram calculados pelo mesmo código que roda no servidor.

Dados do exemplo

Cálculo

Prazo: 3 dias de fila + ⌈31,44 ÷ 480⌉ = 4 dias (mais o prazo de compra de chapa, se não houver estoque).

O preço sendo montado

O mesmo pedido, em quatro situações

Mude os números e acompanhe o preço se formar. A calculadora segue as mesmas fórmulas do servidor (corte, material, manuseio, mínimo da máquina e imposto), e vem preenchida com o exemplo completo.

Quando o preço ou o tempo do sistema não bate com a realidade da fábrica, este guia aponta qual parâmetro olhar primeiro.

Sintomas e causas mais comuns

Quais parâmetros mais pesam

Antes de calibrar, vale saber onde está o dinheiro. O gráfico recalcula o pedido inteiro variando um parâmetro de cada vez.

No pedido de 30 peças, o material domina e os parâmetros de máquina quase não aparecem. Troque para "cliente traz o material" e a lista se inverte: aí a velocidade de corte, o preço da hora e o setup passam a decidir o preço. Em uma peça só, o preço da chapa, o valor mínimo da máquina e o fator K lideram, e a velocidade de corte nem aparece.

Roteiro de calibração

1. Escolha um arquivo de referência e corte de verdade, cronometrando o tempo total (inclusive posicionamento).
2. Simule no Simulador com o mesmo material e anote o tempo por peça.
3. No bench, ajuste velocidade de corte, aceleração e piercing até o tempo bater com o real (não grava no cadastro).
4. Grave os valores definitivos em Materiais › Parâmetros e em Máquinas.
5. Repita com 2 ou 3 arquivos diferentes (um de poucas peças grandes, um de muitas peças pequenas) para não calibrar para um único caso.

As perguntas que mais aparecem quando um cliente ou alguém da equipe olha um orçamento.

"Por que este arquivo ficou tão caro?"

Abra o Simulador com o arquivo e olhe o resumão. Quase sempre é um destes: (1) muitos furos pequenos (cada contorno paga piercing e inlet); (2) material de velocidade de corte baixa (inox grosso, por exemplo); (3) o valor mínimo foi acionado; (4) aproveitamento ruim da chapa (fator K pesando); (5) material com veio, que impede girar as peças.

"Se eu subir a velocidade de corte, o que muda?"

O tempo de corte cai e, com ele, o custo de máquina. O efeito é menor do que proporcional, porque o tempo de piercing, de deslocamento e de setup não dependem da velocidade de corte. Material não muda.

"Por que o valor mínimo foi aplicado?"

Porque corte + manuseio deram menos que o valor mínimo da máquina. Está no resumão como "valor para completar o mínimo". Veja Valor mínimo.

"Uma peça custa mais que 1/30 de um pedido de 30. Por quê?"

Três motivos: o setup é cobrado uma vez por pedido (pesa mais em poucas peças); o preço da hora é maior em trabalhos curtos; e, com uma peça só, quase toda a chapa é sobra e o fator K a cobra. Pedir mais peças dilui tudo isso.

"O cliente trouxe o material. O que muda no preço?"

Material, markup e fator K zeram. Continuam: corte e taxa de manuseio. No exemplo, o pedido cai de R$ 851,31 para R$ 144,08.

"Por que o preço da hora é diferente de um pedido para outro?"

Porque ele depende da duração do trabalho (curva de decaimento) e, em pedidos com vários materiais na mesma máquina, do tempo somado dessa máquina. Veja Escolha da máquina e preço da hora e Desconto por volume.

"Por que o prazo ficou maior?"

O prazo soma dias de fila, dias de máquina e, se faltar chapa em estoque, o prazo de compra do material. Em pedidos de material próprio, o prazo de compra é descontado.

"O site mostra um valor e o simulador outro."

Os dois usam o mesmo motor. A diferença quase sempre vem de: parâmetro alterado entre uma simulação e outra; grupo de desconto ou taxa regional diferentes; ou ações das cores diferentes. O simulador avisa quando o cadastro do material mudou desde a simulação.

"A peça não cabe em nenhuma máquina."

A peça é maior que a mesa de todas as máquinas ligadas ao material (ou só cabe se girada, e o material tem veio). Confira as áreas das máquinas e o campo "Pode rotacionar" do material.

"Gravei uma logo e não foi cobrada."

Provavelmente a máquina de gravação está sem "Taxa de gravação por área", ou a logo tem contornos abertos (área zero). O sistema avisa nos dois casos. Veja Gravação preenchida.

Os três documentos de projeto que acompanham o sistema.

Documentos de apoio da Makers

Estes arquivos fazem parte do histórico do projeto e registram regras combinadas com o cliente:

Logins dos serviços. O conteúdo está cifrado: só aparece com a senha do manual.