Andares, altimetria e composição 3D — referência funcional
Entenda a estrutura, as cotas, o empilhamento e os topos antes de ajustar um edifício.
As regras do painel foram identificadas no código local e em observações anteriores da preparação. Os fluxos de edição, criação e sincronização não foram ensaiados nesta etapa. Use fixture com armazenamento isolado; o treinamento de vias e passeios não foi validado para Andares ou Topos.
Estrutura lógica, física e acabamento
Local reúne o contexto do empreendimento. Uma unidade estrutural organiza parte da composição e pode representar um edifício ou outro tipo de unidade; não presuma que toda unidade seja um prédio físico. Um edifício pode ter POI, contorno e pisos associados. Um mapa contém dados do contexto; um piso/andar identifica um nível associado ao edifício e ao mapa. Número do andar, identificador e posição na lista não são a mesma coisa.
A composição lógica descreve unidades, vínculos, mapas e pisos; a representação física inclui contornos, elevações, paredes e volumes externos; o acabamento acrescenta materiais, fachadas e coberturas. Plataforma ou área elevada é uma Forma, não um andar. Planta é referência de imagem para o mapa, não cria sozinha piso ou cota. Uma altura total de volume não define automaticamente a sequência de níveis.
Core, Portal e Field Admin
No Core, conforme perfil, a estrutura e plantas permitem acompanhar unidades, escopo e pavimentos. O Portal expõe composição, mapas, pisos e vínculos com POIs e plantas. O Field Admin usa o contexto existente para ajustar apresentação e métricas 3D. Confira antes Preparação no Portal e a referência de Mapas.
A sincronização estrutural do Core usa relações de mapas e pode criar pisos ou associações; em sessão com escrita pode ser acionada até na entrada em condições específicas. Não é preview. Confira permissões, divergências e resultado parcial em ambiente apropriado. Adicionar nível 3D no Field Admin não comprova cadastro estrutural completo nem substitui a preparação em Core/Portal.
Painel Andares / Levels
O código apresenta lista plana ou grupos por edifício conforme a composição. Em campus agrupado, o Outdoor é omitido da pilha Indoor e pisos sem prédio podem aparecer em Sem prédio definido. Expanda/recolha, use Focar prédio ou Focar no piso para mudar foco; não se identificou gravação de cota por esses botões no caminho analisado.
| Controle | Valor, efeito e gravação |
|---|---|
| Nome e número na lista | Identificam o piso existente; a classificação visual da pilha é calculada pela elevação. Não há edição do nome existente neste painel analisado. |
| Elev. (m) | Campo numérico em metros, admite cota negativa; valor vazio ou inválido impede salvar aquele piso. Alterar confirma uma estimativa e produz alteração pendente. |
| Pé-direito (m) | Campo em metros; valor positivo ou vazio no tratamento local. O código usa perimeterExtrusionHeight; alterar não move a cota do próximo piso. |
| Estimado — não salvo / Confirmar cota | Cota derivada ainda não gravada; confirmar marca-a como pendente para posterior salvamento. Uma estimativa intocada não é gravada só por salvar outro campo. |
| Alterações não salvas / Salvar edifício | Marca pendências e grava pisos válidos alterados ou confirmados do grupo; na lista plana o botão pode ser Salvar andares. Os resultados são verificados por resposta ou releitura. |
| Preview do empilhamento | Alternador de visualização; em campus o texto indica prédio atual. Salva preferência local e recarrega o mapa. Não equivale a salvar as cotas ou publicar. |
| Adicionar andar (map3d, sem imagem) | Nome obrigatório e Número; Criar grava novo registro de piso e metadados de mapa 3D sem imagem. Exige revisão estrutural e ensaio isolado. |
Os avisos comparam pé-direito e diferença para o próximo piso do mesmo grupo; discrepâncias acima de 0,05 m e cotas iguais aparecem como alertas consultivos, não como bloqueio de salvamento no código. Não se comprovou validação integral de colisões, subsolos ou sobreposição física.
Elevação, estimativa e pé-direito
Elevação é a cota vertical do plano do piso em metros na referência usada pela cena; pé-direito é altura relativa ao nível. Objetos e outras geometrias podem usar alturas relativas ao plano. A referência vertical e o comportamento concreto de cada elemento devem ser confirmados para o local; uma cota da cena não deve ser automaticamente interpretada como altitude geodésica.
O painel lê primeiro a cota dos metadados do mapa e depois a cota existente no registro do piso; sem valor válido, mostra uma estimativa número do piso × 3 m. O número pode ser negativo, permitindo estimativas de subsolos. É apenas fallback de exibição, não medição nem regra construtiva. Editar ou confirmar a cota a torna candidata a gravação; salvar só o pé-direito de piso com estimativa intocada não grava a cota estimada.
O renderizador tem caminhos adicionais para bases de edifício em campus e cotas explícitas, com tratamento para evitar somas indevidas em contextos específicos. Não some automaticamente uma cota explícita à base do volume sem verificar o contexto. Exemplo ilustrativo: térreo a 20 m, pé-direito 3 m e piso seguinte a 23 m são dados de projeto possíveis, não cálculo automático ao alterar o pé-direito.
O código pode aplicar deslocamentos relativos na renderização e, em certos caminhos de empilhamento, limitar extrusões abaixo da laje seguinte. Não se verificou como cada objeto, parede, porta, abertura ou volume reage em todos os cenários. Confira componentes e conexões após qualquer alteração autorizada.
Preview de empilhamento
Na configuração padrão indicada pelo painel, o mapa aparece plano com piso ativo; o alternador habilita visualização empilhada e recarrega o mapa. Em campus agrupado, o código limita a pilha ao prédio de preview selecionado/expandido e exclui Outdoor e pisos sem vínculo nessa visualização. Essa é uma condição de implementação, não garantia de que toda tela ou mapa publicado se comporte assim.
A preferência é armazenada localmente e o preview não é publicação. Como recarrega a página, trate alterações não salvas como vulneráveis à perda: salve ou descarte por processo autorizado antes de alternar. O resultado depende de cotas, composição e conteúdo carregado; não prova gravação ou rota.
Adicionar andar sem imagem
O formulário usa nome obrigatório e número; o código inicializa o número em 1. Em modo agrupado usa o prédio expandido quando disponível. A criação atribui identificador de piso, associa um mapa map3d sem tiles/imagem e inicia a cota como número × 3 m. Essa cota inicial é gravada, não deve ser tratada como medida de projeto.
O serviço grava primeiro a lista de pisos do local e depois os metadados do mapa; uma falha intermediária pode deixar resultado parcial. O mecanismo não comprova cadastro completo no Core, planta associada, rotas ou resolução de conflitos com sincronização estrutural. Confira estado e vínculos antes de repetir.
Volumes, fachadas e topos
O edifício pode ter um invólucro ou volumes externos com faixas verticais; cotas de pisos, base e altura dessas massas são informações relacionadas, mas distintas. Fachadas aplicam acabamento a alvos compatíveis; não presuma que cada alteração de andar reconfigure volumes ou fachadas. Consulte superfícies e volumes e Texturas.
Topo do andar é fechamento estrutural removível na vista externa, separado do topo de um ambiente, laje e Coberturas de edifício. O catálogo local habilita Topos em mapa map3d para perfil VA e o desabilita em campus de múltiplos edifícios segundo os dados de composição. Verifique perfil, mapa e versão em uso.
No painel de Topos, o código prevê ativar, visualizar preview, escolher geometria do perímetro ou áreas personalizadas, altura relativa ao plano do andar, respeitar aberturas da laje e desenhar áreas/recortes com pelo menos três vértices. Recorte apenas do topo não muda o chão. Em altura automática, usa altura do perímetro ou fallback 3 m. O modelo prevê cor, opacidade e espessura padrão 0,08 m, mas não se identificou controle correspondente para todos esses atributos no painel examinado. Alterações são aplicadas em memória e Salvar grava metadados do piso; comportamento visual e descarte precisam de ensaio.
Gravação e fontes
O salvamento de edifício processa pisos pendentes e pode ter falhas parciais; os itens malsucedidos permanecem pendentes no painel. Um campo inválido não é salvo. Erros, concorrência, expiração, perda por recarga e efeitos nos componentes exigem ensaio. Gravar métricas, sincronizar estrutura e publicar são operações distintas; confira resposta e releitura em ambiente autorizado.
Fontes: FieldAdminLevelsPanel.tsx, levelElevationSaveService.ts, levelBuildingGroups.ts, levelElevation.ts, FieldAdminLevelTopsPanel.tsx, fieldAdminFeatures.ts e levelTop.d.ts. O código local não comprova o estado do deploy.
Jornada de pisos e elevações · Paredes · Aberturas · Portas · Escadas e rampas · Publicação.