DOCUMENTO TÉCNICO — ArchTour AI
Visão Geral
Nome do projeto: ArchTour AI
Objetivo: Plataforma web para criação, visualização e compartilhamento de tours virtuais arquitetônicos com suporte a inteligência artificial.
Diferenciais:
• Avatar explicativo com IA
• Conteúdo adaptado ao perfil do visitante
• Geração automática de tours
• Estatísticas de navegação e engajamento
Público-alvo: Arquitetos, corretores, incorporadoras, estúdios de design e clientes finais.
Arquitetura Geral
Tipo de aplicação:
• Web app modular com micro frontends e microserviços
• spa com ssr via
next.js
Camadas e Tecnologias:
Camada Tecnologia
Frontend React,
Next.js,
Three.js, A-Frame, Zustand
Backend
Node.js, Express, rest api (graphql futuro)
banco de dados mongodb (nosql), redis (cache)
armazenamento aws s3 + cloudfront cdn
ia generativa openai gpt-4/gpt-5
ia visual google vision api, azure computer vision
narração google cloud text-to-speech
avatar 3d ready player me, unity webgl,
babylon.js
Autenticação Firebase Auth ou Auth0
Analytics Mixpanel, Google Analytics
Hospedagem Vercel (frontend), AWS EC2 (backend), Cloudflare (dns/cdn)
módulos funcionais
1. Autenticação e Perfis
• Login via e-mail, Google ou Apple
• Perfis: arquiteto, corretor, cliente
• Painel de controle adaptado por perfil
• JWT com refresh token e middleware de autorização
2. Upload e Gerenciamento de Projetos
• Upload de imagens 360º (.jpg, .png, .hdr, .exr)
• Proporção obrigatória: 2:1 (ex: 6000x3000 px)
• Tamanho máximo: 20MB
• IA classifica tipo de imagem e recomenda melhorias
• Armazenamento em AWS S3 com CDN
3. Editor Visual de Tours
• Interface drag-and-drop com preview WebGL
• Inserção de hotspots (texto, vídeo, áudio, link)
• Upload de planta baixa com mapeamento
• Posicionamento de avatar ia
• ia sugere hotspots e textos explicativos
4. Visualizador 360º
• Navegação por mouse, toque, giroscópio
• Transições suaves entre cenas
• Suporte a Webxr (vr)
• ia sugere foco com base no comportamento do visitante
5. Avatar com IA
• Personagem 3D explicativo com voz gerada por IA
• Chat interativo com ia (gpt-4/gpt-5)
• tradução automática de conteúdo
• respostas contextuais com base no projeto
6. Geração Automática de Tours
• IA analisa imagens e detecta cômodos
• Sugere hotspots e gera roteiro explicativo
• Arquiteto revisa e aprova
• IA aprende com feedbacks anteriores
7. Personalização por Perfil
• Cliente: foco estético
• Corretor: foco comercial
• Engenheiro: foco técnico
• IA adapta linguagem, avatar e conteúdo exibido
8. Estatísticas e Relatórios
• Visualizações por cena
• Tempo médio de navegação
• Interações com hotspots e avatar
• Relatórios exportáveis em pdf ou csv
• ia gera insights e recomenda melhorias
9. Compartilhamento e Incorporação
• Link direto, embed para sites e QR Code
• ia sugere canais de divulgação e gera descrições otimizadas para seo
10. Monetização
• Planos: Gratuito, Pro, Studio
• Pagamento via Stripe ou PayPal
• IA sugere plano ideal com base no uso
• Alertas automáticos sobre limites
Segurança e Boas Práticas
• https com tls 1.3
• Tokens JWT com expiração curta + refresh token
• Rate limiting por IP e usuário
• Validação de arquivos (tipo, tamanho, proporção)
• Sanitização de inputs (XSS, SQLi, NoSQLi)
• Logs com Sentry
• Backups automáticos diários
Escalabilidade e Performance
• CDN global (CloudFront)
• Lazy loading de cenas e hotspots
• Cache de IA com Redis
• Load balancing com NGINX
• Monitoramento com Datadog ou New Relic
Integrações com IA
Função Tecnologia Fluxo
Roteiro explicativo gpt-4/gpt-5 envia descrição + imagem → recebe texto
análise de imagem google vision api envia imagem → recebe objetos e sugestões
narração google tts envia texto → recebe áudio
chat com avatar gpt-4/gpt-5 + contexto recebe pergunta → responde com base no projeto.
Prazo de Entrega: Não estabelecido