Be interno
E-mail @be180.com.br ou empresa_pk nula
Criar RoteiroBanco de AtivosMapaResultadosAdmin
Acesso total à plataforma
Be180 OOH · Documentação de produto
Manual do Produto · Colmeia
Colmeia · Meus Roteiros é a plataforma da Be180 para planejar, simular, analisar e operar campanhas OOH. Este manual explica o que o sistema faz, como cada módulo funciona e como o Banco de Ativos sustenta o ecossistema. Atualizado em 10/06/2026.
O que éArquiteturaPersonas & acessoFluxosPipelineBanco de AtivosMódulosMétricas OOHRotas & APIsFonte no Notion
SaaS
Multi-tenant — Be, agências e exibidores
9
Módulos de produto em operação
2
Camadas de dados no Banco de Ativos
OOH
Cobertura, frequência, TRP, CPM e IPV
O que é o Colmeia
Planejamento OOH ponta a ponta, em modelo SaaS multi-tenant
Colmeia · Meus Roteiros permite simular e comparar planos de mídia com base em localização, período, tipo de mídia e alvo demográfico — gerando cobertura, frequência, impactos, TRP e CPM. A Be180 opera internamente, agências acessam roteiros liberados e exibidores mantêm o inventário pelo portal próprio.
Be180
Planeja, simula e opera campanhas internamente.
Agências
Consultam e comparam roteiros liberados.
Exibidores
Atualizam inventário OOH pelo portal.
Arquitetura em camadas
Do usuário ao dado — o que sustenta cada tela
Frontend
React 18 · TypeScript · Vite · Tailwind · Leaflet
SPA com wizard de roteiro, mapa geográfico e dashboards.
Backend
Node.js serverless (Vercel) · 13 routers · ~70 handlers
APIs REST por domínio: roteiros, inventário, banco de ativos, admin.
Dados core
SQL Server
Roteiros, usuários e inventário operacional.
Banco de Ativos (busca)
PostgreSQL · media_points
Pontos georreferenciados e passantes geoespaciais.
Processamento
Databricks
sampleMaxAll → sampleFromMax → product_model.
Autenticação
Auth0 · JWT + usuario_dm
Login federado e cadastro de usuários.
Personas & controle de acesso
Quem entra, o que vê e o modelo multi-tenant
Agência parceira
empresa_pk = agência vinculada
HomeMeus RoteirosMapaResultadosRelatório P1A
Só roteiros liberados da própria agência
Exibidor
Perfil Exibidor + exibidor_fk
Portal do ExibidorImportar inventárioSolicitações
Redirecionado do Home; sem acesso ao restante
Admin Be
Perfil Admin + isAdmin
UsuáriosPerfisInventários de exibidor
Só usuários internos
Autenticação — do login ao contexto de acesso
1
Login Auth0
loginWithRedirect retorna token JWT.
2
Identidade
API resolve usuario_pk, empresa_pk e perfil em usuario_dm.
3
Roteamento
@be180.com.br → Be; outro domínio → busca cadastro.
4
Contexto de acesso
AuthContext define telas e permissões (ler/escrever).
Fluxos ponta a ponta
Os três caminhos principais, do ponto de vista de cada persona
Fluxo A
Criar roteiro simulado ou completo
Be interno01
Configuração — nome, agência, marca, categoria
02
Target — gênero, classe, idade
03
Praças — seleção de cidades
04
Vias públicas / inventário — manual ou import Excel OOH
05
Envio para processamento (Databricks)
06
Resultados — cobertura, frequência, impactos
Dois caminhos de import: direto (sp_planoMidiaOohInsert) ou manual por cidade (roteiro-simulado).
Fluxo B
Agência consulta roteiro liberado
Agência parceira01
Login Auth0 com empresa_pk
02
Meus Roteiros — lista filtrada por agência + liberado
03
Mapa — visualização geográfica
04
Visualizar Resultados — indicadores pós-Databricks
05
Relatório P1A — análise comparativa (opcional)
Não acessa Criar Roteiro, Banco de Ativos, Consulta Endereço nem Admin.
Fluxo C
Exibidor atualiza inventário
Exibidor01
Login → redirect para /exibidor/dashboard
02
Importar nova base — upload Excel vira lote
03
Itens gravados com status EM_ANALISE
04
Solicitações — acompanhamento dos lotes
05
Admin Be analisa em /admin/inventarios-exibidor
Roadmap: fila Google Places para enriquecimento (foundation pronta, worker pendente).
Pipeline do roteiro
Do upload aos resultados — com o processamento Databricks no centro
Upload Excel OOH
Plano de mídia importado ou montado por cidade
parsePlanoOohExcel
Parsing e validação da planilha
Stored Procedure
SQL Server grava plano e roteiro
Databricks Jobs
sampleMaxAll → sampleFromMax → product_model
Visualizar Resultados
Cobertura, frequência, hexágonos H3 e mapas
Dentro do Databricks
sampleMaxAll
Amostragem estatística e espacial da base.
sampleFromMax
Filtro por planoMidia_pk do roteiro.
product_model
Clustering, hexágonos H3 e geração de mapas.
Banco de Ativos
O inventário OOH sobre duas camadas de dados
Consulta
Dashboard, mapa e busca de pontos
Relatórios
Agregações por praça e por exibidor
Enriquecimento
Lookup de passantes no Criar Roteiro
Atualização
Portal exibidor + análise admin
UI Banco de Ativos consome duas camadas
SQL Server · bancoAtivosJoin_ft
Dashboard, mapa, relatório praça/exibidor, gestão de exibidores.
banco-ativos-dashboard.jsbanco-ativos-mapa.jsexibidor-gestao.js
PostgreSQL · media_points
Filtros encadeados e passantes por coordenada.
busca-pontos-midia.jsbanco-ativos-passantes.js
Filtros de busca
PraçaExibidorBairroRatingAmbienteGrupo de mídiaVias públicas / IndoorFormato
KPIs do dashboard
- Total de pontos, praças e exibidores
- % Vias Públicas vs Indoor
- Passantes médios
- Impactos IPV
Módulos do produto
Nove áreas em operação e suas rotas
Meus Roteiros
Lista e status dos roteiros por agência.
/meus-roteirosProdução
Criar Roteiro
Wizard em abas para simular ou importar plano OOH.
/criar-roteiroProdução
Mapa
Visualização geográfica de pontos e roteiro.
/mapaProdução
Visualizar Resultados
Indicadores pós-Databricks e comparação de planos.
/resultadosProdução
Relatório P1A
Análise comparativa avançada de planos.
/relatorio-p1aProdução
Banco de Ativos
Inventário OOH: dashboard, mapa, busca e relatórios.
/banco-de-ativosProdução
Portal do Exibidor
Upload e acompanhamento de inventário.
/exibidor/dashboardProdução
Consulta Endereço
Geocoding em lote para enriquecer coordenadas.
/consulta-enderecoProdução
Administração
Usuários, perfis e análise de inventários.
/adminProdução
Métricas OOH
O glossário que sustenta os resultados do planejamento
Cobertura
Percentual do público-alvo exposto ao menos uma vez à campanha.
Frequência
Número médio de vezes que o público impactado vê a campanha.
Impactos
Total de exposições geradas pelo conjunto de pontos.
TRP
Target Rating Point — audiência sobre o público-alvo específico.
CPM
Custo por mil impactos — eficiência de investimento.
IPV
Índice de passantes/visibilidade que qualifica cada ponto de mídia.
Rotas & APIs
Referência rápida de onde cada fluxo acontece
ÁreaRotaAPI / procedure
Roteiros/criar-roteiro · /meus-roteirossp_planoColmeiaSimuladoInsert · roteiro-simulado
Import OOHAba 4 do wizardPOST /sp-plano-midia-ooh-insert
Inventário por cidadeAba 3/4GET /inventario-cidade
EnriquecimentoCriar Roteiro (Aba 4)upload-pontos-unicos → uploadInventario_ft
Banco de Ativos/banco-de-ativosbanco-ativos-dashboard · busca-pontos-midia
Exibidor/exibidor/dashboardexibidor_inventario_upload_lote_dm
AutenticaçãoAuth0GET /usuarios · usuario_completo_vw
Manual vivo do Colmeia
Evolui junto com o produto — sincronizado com o Banco de Ativos e a Adaptive Layer™.