Portas e acessos 3D — referência funcional
Consulte modelos, suportes, posicionamento, sugestões e vínculos de navegação.
Os controles e fluxos descritos foram identificados no código local; esta etapa não ensaiou edição na interface. Sugestões em lote e outras ações podem gravar imediatamente. O treinamento de vias e passeios não foi validado para Portas. Use fixture com armazenamento isolado.
Porta, recorte e navegação
O proprietário é o elemento estrutural ao qual a porta pertence, como um POI poligonal, o perímetro do piso, uma parede de Forma ou um espaço decorativo.
O painel Portas / Acessos trabalha com registros de porta associados a POI poligonal, perímetro de piso, parede de Forma ou espaço decorativo compatível. Uma porta pode gerar recorte e um modelo visual; Vão livre usa o registro de porta com recorte sem modelo. Uma abertura arquitetônica é outro registro, embora também possa representar um vão livre.
A porta não é por si só um POI de busca. O código prevê vínculo de uma porta à âncora de navegação do espaço; a interface informa que apenas uma ancora o marcador de rota. A existência de geometria, POI de entrada ou âncora não comprova, por si, rota funcional ou transição Outdoor/Indoor. Confira separadamente POIs, rotas e composição dos mapas.
Tipos e modelos
O seletor Tipo de acesso apresenta Porta e Vão livre; Sem porta é uma decisão/estado específico oferecido por ação própria. Ao criar ou sugerir, o código usa Vão livre como tipo inicial; o modelo procedural padrão quando selecionado é Simples. Os modelos abaixo são opções do catálogo conectado ao seletor ativo no código local; a disponibilidade na versão implantada e por perfil não foi observada.
| Modelo | Identificador | Representação |
|---|---|---|
| Simples | simple | uma folha, acabamento simples |
| Simples vidro | simple-glass | uma folha translúcida |
| Simples madeira | simple-wood | uma folha com acabamento madeira |
| Simples metal | simple-metal | uma folha com acabamento metal |
| Dupla vidro | double-glass | duas folhas translúcidas |
| Dupla madeira | double-wood | duas folhas com acabamento madeira |
| Dupla metal | double-metal | duas folhas com acabamento metal |
| Dupla grade | double-grate | duas folhas com barras visíveis |
| Giratória | rotating | conjunto visual giratório envidraçado |
| Sanfonada dupla | accordion-double | painéis dobrados em ambos os lados |
| Sanfonada simples | accordion-single | painéis dobrados para um lado |
Por exemplo, uma Simples pode representar consultório, Dupla vidro uma entrada e Sanfonada um fechamento de ambiente. Esses são usos sugeridos, não regras de projeto. A escolha de modelo é visual e não define automaticamente controle de acesso, função de emergência ou navegação. O código descreve a geometria, mas não comprova animação funcional ou abertura física.
A família Modelos GLB consulta o catálogo por capacidade door; a referência salva modelo, versão e dimensões disponíveis. Se o GLB não carregar, o painel informa uso de um modelo procedural de fallback. A capacidade, disponibilidade e aparência precisam de ensaio; veja Objetos 3D. O tipo Vão livre não usa folha nem modelo.
Campos e controles
Rótulos e opções abaixo constam do componente e traduções; sua presença efetiva varia por alvo e contexto. Campos individuais alimentam prévia local e o botão Salvar solicita gravação. Confira resposta e releitura.
| Controle | Valores e efeito | Condições |
|---|---|---|
| Tipo de acesso | Porta ou Vão livre; inicial técnico Vão livre. | Porta habilita escolha de modelo; Sem porta é estado acionado separadamente. |
| Modelo da porta | Seletor procedural ou GLB com capacidade Porta; padrão procedural Simples. | Somente para Porta; GLB indisponível tem fallback procedural. |
| Inverter lado | Botão inverte a face de acesso visual do GLB. | Condicional a GLB; não gira parede nem altera navegação. |
| Largura (m) | Número; padrão técnico 1 m; controle mínimo 0,3 m e, em geral, máximo 6 m, passo 0,1 m. | Vão livre em modo perímetro não possui esse máximo no controle; limites geométricos ainda se aplicam. Dados existentes podem diferir. |
| Altura (m) | Número; padrão 2,1 m; controle 0,5–4 m, passo 0,1 m. | Altura inicial pode ser limitada pela altura conhecida da parede; não confundir restrições de interface com validação integral da API. |
| Parede / Posição na parede (m) | Seletor de aresta numerada e deslocamento numérico a partir do início, mínimo 0, passo 0,1 m. | O código guarda índice, deslocamento e ponto projetado; posicionamento depende do proprietário e pode mudar após edição geométrica. |
| Usar esta porta como âncora de navegação do espaço | Seletor de marcador ou Nenhum. | Disponibilidade depende do proprietário; uma porta ancora o marcador, e outras podem ser apenas visuais. Verifique rota separadamente. |
| Confirmar porta / Salvar / Remover porta | Confirmar sugestão, salvar edição ou remover; chamam persistência. | Remoção da última porta pode marcar o alvo como sem porta. Erros ou resposta sem confirmação exigem revisão. |
| Marcar sem porta / Reverter sem porta | Registra ou desfaz a decisão de ausência de porta. | Ambas as ações podem gravar; ausência de porta não prova ausência do marcador de navegação. |
| Salvar seleção | Grupo de portas selecionadas com Ctrl+clique, com campos comuns. | Grava vários registros; sucesso parcial e itens diferentes exigem conferência. |
Não foram identificados, neste painel, campos independentes para nome da porta, elevação da base, profundidade, cor livre, textura, transparência, escala, número de folhas ou sentido de abertura procedural. Parte da aparência vem do modelo escolhido; a orientação segue a parede, com inversão específica para GLB. Isso não prova que outros fluxos do produto não os tenham.
Suportes, sugestão e posicionamento
O painel oferece contexto de Perímetro do piso, listas de Entradas, Paredes (Formas) e Espaços decorativos, além de seleção de POI. O clique ou arraste é projetado na geometria correspondente. Uma parede Forma ou espaço decorativo próximo pode ser preferido na escolha do alvo; confirme o proprietário exibido antes de salvar.
Ao selecionar POI, o código pode produzir sugestões locais para entradas ainda sem porta, usando marcador de entrada e projeção na aresta próxima. A sugestão comum exige polígono, marcador e altura de parede efetiva de pelo menos 2 m; usa largura 1 m e altura 2,1 m sujeita à parede. Sugestões por entrada e estado anterior alteram o resultado. Isso não garante encaixe adequado nem validação de todos os conflitos.
Sugerir portas de todos os espaços atualiza dados do rascunho, calcula sugestões e chama gravações para os alvos; relata itens salvos e falhas, podendo haver resultado parcial. Sugerir porta do perímetro usa sugestão em memória e seleciona a entrada; sem entrada elegível pode abrir posicionamento manual. Não trate nenhum desses botões como seguro em produção para fins de documentação.
O fluxo de posicionamento manual examinado cria uma prévia e edições/arraste atualizam memória; Salvar solicita persistência. Confirmar sugestão, remover e marcar/reverter sem porta também chamam serviços. Cancelar posicionamento interrompe esse modo, mas não é desfazer geral de algo já gravado.
Geometria, segmentos e conflitos
O vínculo usa índice da aresta, distância ao longo dela e ponto projetado; um vão livre no perímetro pode acompanhar seu contorno. Mudanças no polígono, perímetro ou divisão de segmentos podem alterar índices e exigir remapeamento de porta. O código possui rotinas de remapeamento e validação de spans em cenários específicos, mas não comprova recuperação sem perda para todo corte, porta que cruza divisão ou salvamento parcial. Confira após recarga e revise Paredes e segmentos.
O fluxo de Aberturas verifica certas sobreposições com portas ao criar janelas; não se identificou no painel de Portas uma garantia geral e simétrica de detecção de todas as sobreposições. Confira portas, janelas e vãos próximos e teste encontros, cantos, altura e espessura em perspectiva e vista superior. Consulte Aberturas.
Gravação e evidência
Serviços diferentes salvam portas de POI, perímetro, Forma e espaço decorativo; o código verifica respostas em caminhos específicos. Status incluem sugerida, confirmada, sem porta e removida. Seleção pode produzir sugestão em memória; lote, confirmação, exclusão e decisões sem porta podem gravar. Não há garantia de desfazer global depois de persistido. Alterações de suporte, concorrência, migração ou dados antigos devem ser ensaiados isoladamente.
Fontes: FieldAdminDoorsPanel.tsx, DoorModelPicker.tsx, doorModels.ts, doorSuggestion.ts, doorPlacement.ts, doorPersistence.ts, door.d.ts e serviços de perímetro, Forma e espaço decorativo. São evidências de implementação local; o comportamento implantado e os acessos VA reais permanecem por validar.
Jornada de portas e acessos · Formas · Andares · Texturas e fachadas · Revisão e publicação.