Estação Rádio-Base: Visita Virtual 3D
Simulação interativa de infraestrutura de telecomunicações: uma visita virtual em primeira pessoa a uma estação rádio-base (ERB) de telefonia celular, com modo de inspeção técnica e apresentação guiada. Feita em Three.js e TypeScript, 100% procedural e offline (sem modelos 3D, texturas nem CDNs externos).
Aviso: é uma simulação visual a partir de uma imagem de referência. Posições e dimensões são estimativas, exceto a altura indicada de 30 m da torre. Não é projeto executivo de engenharia: não afirma cargas, tensões, potências, azimutes, capacidades nem conformidade normativa.
Demonstração publicada: https://erb-visita-virtual.vercel.app/
Versão: 0.7.0
O que tem
- Cenário: terreno cercado com concertina e portão, brita em 3D, lajes de concreto, abrigo de equipamentos, três armários externos com climatização, esteira de cabos coberta, medição de energia, transformador, grupo gerador e torre treliçada de 30 m com escada, plataformas, antenas setoriais, parábolas de micro-ondas, sinalizador e para-raios.
- Interior do abrigo (genérico): racks de telecomunicações, banco de baterias, quadro de distribuição elétrica, climatização, esteira de cabos no teto e aterramento. Representação ilustrativa, sem fabricante, modelo, tensão, capacidade ou autonomia.
- Três modos:
- Visita imersiva: primeira pessoa com colisões; abre o portão e a porta do abrigo com E.
- Inspeção técnica: câmera orbital, seleção de componentes e corte do abrigo para ver o interior de cima.
- Apresentação guiada: 12 pontos de observação, com pausa, avanço, retorno e reinício.
- Interface: painéis informativos por equipamento (com ressalva do que é estimativa), ajuda, tela cheia, ocultar interface, qualidade baixa/média/alta, sol ajustável e modo noturno.
Como rodar
Requisitos: Node.js atual e um navegador com WebGL 2.
npm install
npm run dev # http://127.0.0.1:5173/
No Windows, o atalho Iniciar-ERB-Visita-Virtual.bat instala as dependências na primeira vez, sobe o servidor e abre o navegador.
Outros comandos:
| Comando | Função |
|---|
npm run typecheck | verificação de tipos |
npm run build | typecheck e build de produção em dist/ |
npm run preview | serve o build localmente |
Controles
| Ação | Tecla |
|---|
| Andar | W A S D ou setas |
| Olhar | mouse (clique na cena para capturar; Esc libera) |
| Correr | Shift |
| Interagir, abrir portão ou porta | E |
| Reiniciar a vista do modo atual | R |
| Voltar à tela inicial | M |
| Tela cheia | F |
| Ocultar interface | H |
| Ajuda | ? |
| Modos | 1 visita, 2 inspeção, 3 apresentação |
| Apresentação | Espaço pausa; ← e → voltam e avançam |
No celular ou tablet
Detectado por (pointer: coarse); a qualidade gráfica começa em "Baixa". Melhor com o aparelho na horizontal.
| Ação | Gesto |
|---|
| Andar | joystick flutuante: encoste o dedo na metade esquerda da tela e arraste |
| Olhar | arraste o dedo na metade direita (dá para andar e olhar ao mesmo tempo) |
| Interagir, abrir portão ou porta | botão Interagir (canto inferior direito; mostra a ação disponível) |
| Reiniciar vista, ajustes, tela cheia, ajuda, ocultar | botão Mais da barra superior |
| Inspeção técnica | um dedo gira, pinça dá zoom, dois dedos deslocam, toque seleciona |
| Apresentação | botões da barra inferior |
Tecnologia
Vite, TypeScript e Three.js (three, @types/three, vite, typescript). Sem React nem bibliotecas de física: colisões 2D com limites verticais, escritas no projeto. Oclusão ambiental (GTAO) opcional, só na qualidade Alta.
Estrutura
src/
main.ts inicialização, modos, interações e laço de render
config.ts layout e dimensões estimadas (um único lugar para corrigir)
scene/ geometria e materiais (site, torre, abrigo, interior, armários, energia, esteira, luz, pós-processamento)
controls/ primeira pessoa, toque (joystick), câmera orbital, apresentação guiada e colisão
ui/ HUD e estilos
data/ textos dos painéis dos equipamentos
Documentação
- PRD.md: escopo, decisões, dimensões estimadas, pendências e registro de testes.
- DESIGN.md: direção visual, materiais, iluminação, controles, acessibilidade e modos.
- CLAUDE.md: regras de trabalho do projeto e comandos.
Limitações conhecidas
- Dimensões e posições são estimativas visuais a partir de uma imagem de referência.
- O interior do abrigo é genérico; o anexo do abrigo é maciço, sem acesso.
- Os testes foram feitos em navegador automatizado: faltam validações com mouse real, tela cheia, outras resoluções e GPU real (detalhes na seção 10 do PRD).
- A qualidade Alta (com oclusão ambiental) pode ser pesada em GPUs modestas.
Publicação
Publicado no Vercel em https://erb-visita-virtual.vercel.app/. O projeto Vite é detectado sozinho (comando npm run build, saída dist). Não há variáveis de ambiente nem backend, e cada push em main gera uma nova implantação.
Licença
Nenhuma licença foi definida até o momento.
