Calculadora de tábuas de deck: quantidade, vão e perda

A mesma função pura alimenta a ferramenta gratuita do navegador e a API paga, de modo que um orçamento gerado no celular bate com a linha que um script envia depois. Dimensões de tábua nulas ou negativas são rejeitadas com invalid_input em vez de uma divisão por zero silenciosa.

Como funciona a fórmula de contagem de tábuas de deck

Parta de uma identidade de cobertura que reflete como as tábuas realmente preenchem um deck: cada tábua ocupa seu comprimento de face completo ao longo do lançamento e um passo de board_width mais gap entre as vigas. Escreva effective_board_area igual a board_length vezes (board_width mais gap), usando a mesma unidade linear que sustenta seu deck_area em unidades quadradas, de modo que metros combinem com metros quadrados e pés com pés quadrados. O produto só de face board_length vezes board_width é informado como board_face_area para auditoria, mas o cálculo de compra usa a pegada efetiva maior para que os vãos de drenagem não sumam do plano. Em seguida aplique a perda como fator multiplicativo: waste_factor é um mais waste_percent dividido por cem, de modo que dez por cento de perda significa planejar cento e dez por cento do deck nu. Multiplique deck_area por esse fator para obter area_with_waste — o alvo de cobertura efetiva após cortes, molduras perimetrais aproximadas com estoque extra, peças quebradas e sobras de lote. Divida area_with_waste por effective_board_area para produzir boards_exact, um número real que pode ter parte fracionária. A quantidade de compra boards_needed é o teto de boards_exact. A resposta também devolve intermediários (board_face_area, effective_pitch, effective_board_area, waste_factor, waste_area, area_with_waste, boards_exact, coverage_area) e spare_area_vs_deck para auditar a conta à mão na nota de remessa. O pipeline é aritmética de ponto flutuante determinística, sem sementes aleatórias, sem relógio de parede e sem chamadas de rede, de modo que entradas idênticas sempre produzem o mesmo JSON. Largura e comprimento da tábua devem ser estritamente positivos: tamanho zero ou negativo é rejeitado com invalid_input porque uma pegada nula tornaria a razão indefinida e uma negativa é não física. A área do deck também deve ser positiva; gap e waste_percent devem ser não negativos para que um lançamento justaposto com vão zero e um retângulo perfeito sem perda continuem expressáveis.

O que você envia e o que recebe de volta

Os cinco campos são obrigatórios. Envie cinco números finitos: deck_area para a cobertura do plano do deck em unidades quadradas, board_width e board_length para o par de face de uma tábua em unidades lineares coincidentes, gap para o espaçamento entre tábuas adjacentes nessas mesmas unidades lineares, e waste_percent como o percentual de material extra (por exemplo dez para uma folga de dez por cento). Campos ausentes, strings não numéricas, NaN e Infinity falham com invalid_input e não são cobrados. Quando board_width ou board_length é zero ou negativo, a requisição falha com mensagem de que as dimensões da tábua devem ser positivas, para que o cliente corrija antes de tentar de novo em vez de receber Infinity tábuas. Em caso de sucesso a resposta ecoa as entradas limpas, board_face_area, effective_pitch, effective_board_area, waste_factor, waste_area, area_with_waste, boards_exact, o inteiro boards_needed, coverage_area, spare_area_vs_deck (quanto de área o conjunto comprado cobre além do deck nu contando cada tábua no passo completo), um lembrete unit_note para manter um único sistema de unidades, e uma string formula curta para documentação. Verificações clássicas incluem um deck de vinte e quatro metros quadrados com tábuas de zero vírgula quatorze por três vírgula seis metros, vão de cinco milímetros e dez por cento de perda: a área efetiva da tábua é comprimento vezes largura mais vão, a área com perda é vinte e seis vírgula quatro, e boards_needed é o teto dessa razão. O preço das chamadas API bem-sucedidas é a base publicada de US$ 0,002 por item; falhas de validação não consomem saldo pré-pago.

Onde calculadoras de tábuas de deck aparecem no trabalho real

Proprietários que montam um deck no quintal precisam de uma contagem confiável de tábuas antes de pedir compósito ou madeira tratada, sobretudo quando tábuas longas têm preço unitário alto e prazo de várias semanas. Se depois precisar de vigas e barrotes, clips de fixação oculta, balaústres ou longarinas de escada, trate-os como intenções de busca e páginas à parte, sem sobrecarregar esta calculadora de tábuas de deck. Construtores de deck e carpinteiros montam levantamentos a partir de áreas medidas e tamanhos do fabricante; um único endpoint determinístico que arredonda para cima após vão e perda reduz o desvio de planilha entre o orçamentista e o comprador. Paisagistas que comparam três referências de tábua para o mesmo plano podem trocar só board_width, board_length e gap mantendo deck_area e waste_percent fixos, e ordenar por total de tábuas e cobertura sobrante sem rederivar a matemática do passo a cada vez. Gestores de imóveis que planejam reformas de varandas multiunidade enviam um lote de áreas pela API e anexam boards_needed às ordens de compra para que o excesso de estoque seja intencional e não acidental. Como esta capacidade é um motor de parse puro, o preço de API é a base publicada de US$ 0,002 por item bem-sucedido e a validação falha não consome saldo.