Calculadora de espaçamento em sala

Espaçamento, comprimento ou largura zero ou negativos são recusados com invalid_input em vez de inventar carteiras infinitas. Diretores, arquitetos e plugins LMS obtêm o mesmo JSON determinístico no executor gratuito do navegador e na API pré-paga, sem rede, sem relógios e sem empacotamento aleatório.

Como a capacidade de alunos é obtida do tamanho da sala e do espaçamento

O espaçamento exigido por estudante é o lado da célula quadrada que cada aluno reivindica nessa planta — a mesma ideia do passo de carteira de centro a centro ou de um círculo de distanciamento inscrito em um quadrado. A calculadora nunca converte unidades; só precisa das razões adimensionais de cada lado da sala em relação ao espaçamento. Quando o recinto é menor do que uma célula em qualquer eixo a capacidade é zero em vez de um erro, o que é fisicamente honesto. A resposta não consulta cargas de ocupação do código de incêndio, catálogos de mobiliário, fileiras escalonadas nem empacotamento hexagonal — essas são decisões de projeto que você aplica ao mudar o spacing enviado ou ao subtrair corredores das cotas antes de chamar. Uma sala retangular é modelada por duas dimensões lineares estritamente positivas: length é o eixo ao longo do qual as fileiras de layout se empilham, em geral da parede de ensino até o fundo, e width é o eixo de uma única fileira de assentos, em geral de uma parede lateral à outra. Ao longo do comprimento cabem floor de length dividido por spacing fileiras inteiras; ao longo da largura cabem floor de width dividido por spacing assentos inteiros; a capacidade máxima é o produto desses dois inteiros. Faixas restantes mais curtas do que um spacing completo viram unused_length e unused_width em vez de um aluno parcial, o que combina com a geometria de uma célula completa que não cabe. A área é length vezes width e a área da célula é spacing ao quadrado, de modo que a área usada é a capacidade vezes a área da célula e a área não usada é o resto do retângulo que a grade não preencheu. length, width e spacing devem usar uma única unidade coerente: metros com metros, pés com pés, polegadas com polegadas. O spacing deve ser estritamente positivo porque espaçamento zero implicaria infinitos alunos e espaçamento negativo não tem sentido em uma grade. length e width também devem ser positivos; uma sala de área zero não é uma sala de aula. Em caso de sucesso a ferramenta ecoa length, width e spacing arredondados e publica layout_rows, seats_per_row, max_capacity, uma cadeia compacta layout, as faixas restantes, formula, message e os passos de substituição ordenados que você pode auditar à mão.

Como chamar a API e o que volta

Formas em string de números são aceitas quando coincidem com um padrão numérico finito estrito; sufixos de unidade, separadores de milhar ou texto livre falham na validação. Prefira enviar números em vez de strings pré-formatadas quando controlar o cliente; se precisar enviar strings, evite rótulos de unidade que quebrem o padrão de número finito. Envie um corpo JSON com três campos obrigatórios: length (alias room_length, classroom_length, depth, L), width (alias room_width, classroom_width, W) e spacing (alias student_spacing, seat_spacing, distance, gap, S). Os três devem ser números finitos positivos dentro da faixa absoluta publicada para que produtos, razões e faixas restantes permaneçam finitos em precisão dupla IEEE no Worker e no navegador. Em caso de sucesso a resposta ecoa length, width e spacing arredondados, define area como length vezes width, cell_area como spacing ao quadrado, layout_rows como o inteiro não negativo floor de length sobre spacing, seats_per_row como o inteiro não negativo floor de width sobre spacing, max_capacity como o produto, layout como uma cadeia compacta de fileiras por assentos, unused_length e unused_width como as faixas restantes, used_area e unused_area como o piso ocupado e o resto, formula como as identidades publicadas, message como um resumo breve em inglês e steps como um registro de substituição ordenado. Validação falha — campos ausentes, números não finitos, spacing zero ou negativo, dimensões da sala não positivas ou valores fora dos limites absolutos — devolve invalid_input e nunca é cobrada. O preço é um valor fixo US$ 0,002 por pedido bem-sucedido com unidade item. Checagens de ida e volta são simples: recalcule o floor de length sobre spacing, o floor de width sobre spacing, multiplique e confirme que a capacidade e as faixas restantes publicadas coincidem. Troque length e width se quiser a orientação oposta; o produto permanece enquanto layout_rows e seats_per_row trocam de lugar.

Dicas práticas, limites e buscas relacionadas

Se unused_length ou unused_width for grande, reduza um pouco o spacing para caber mais células inteiras, amplie a sala, gire a grade trocando length e width para outro número de fileiras, ou aceite o resto como faixa de circulação; esta calculadora nunca acrescenta um aluno parcial. Ao ensinar ou escrever testes, combine um múltiplo exato (length dez, width oito, spacing dois → cinco fileiras de layout, quatro assentos por fileira, vinte alunos) com um caso de resto que deixe faixas sobrando, e inclua um spacing zero ou negativo de propósito para provar o caminho invalid_input. Tarefas que devolvem invalid_input não consomem saldo pré-pago, o que deixa baratos os scripts exploratórios quando você envia de propósito spacing zero para verificar o tratamento de erros. Gestores escolares, planejadores de campus e ferramentas SaaS de instalações podem chamar o mesmo endpoint para medições reproduzíveis sem compartilhar uma fórmula de planilha que muda entre navegadores.