Atualizado: 20/05/2026
Total Ocorrências
—
RA
—
SOS
—
Carros c/ Ocorrência
—
Oc/Dia (Média)
—
Oc/Carro (Média)
—
Evolução das Ocorrências
RA
SOS
Total
Por Tipo
Por Turno
Motivos (Top 10)
Por Garagem
Por Linha (Top 6)
Por Tecnologia
Detalhes
Selecione uma ocorrência na lista para ver os detalhes.
Frotas Rastreadas
—
KM 7 Dias
—
KM Período
—
Motoristas Ativos
—
Rotas com Dados
—
KM por Dia
Média por Dia da Semana
Por Tecnologia
Por Garagem
Top 10 Frotas (KM 30d)
Top 10 Rotas (KM Total)
📖 Manual do Usuário — Portal BI Sambaíba
1. Visão Geral
O Portal BI Sambaíba é uma ferramenta de inteligência de negócios para acompanhamento da frota de ônibus da Sambaíba Transportes. Ele consolida dados de dois sistemas:
- Maxtrack — telemetria de KM rodado por frota (dados de rastreamento GPS)
- Voll360 — registro de atendimentos/ocorrências (RA, SOS e demais tabulações)
O portal funciona localmente no navegador (protocolo file://) sem necessidade de servidor web.
2. Login e Permissões
O acesso é controlado por e-mail e senha. Cada nível tem visibilidade diferente:
| Nível | Ocorrências | KM Frota | Manual | Usuários | Filtro Garagem |
|---|---|---|---|---|---|
| TI | Todas | Todas | ✅ | ✅ | Livre |
| Gestor | Todas | Todas | ✅ | ❌ | Livre |
| Lider | Sua garagem | Sua garagem | ✅ | ❌ | Fixo na sua garagem |
Credenciais de Acesso
| Senha | Nível | Garagem | |
|---|---|---|---|
| ti@sambaiba.com.br | admin123 | TI | Todas |
| gestor@sambaiba.com.br | gestor123 | Gestor | Todas |
| lider1@sambaiba.com.br | lider123 | Lider | Garagem 1 |
| lider3@sambaiba.com.br | lider123 | Lider | Garagem 3 |
| lider4@sambaiba.com.br | lider123 | Lider | Garagem 4 |
3. Seção Ocorrências
KPIs Principais
- Total de Ocorrências — quantidade de atendimentos no período/filtro selecionado
- RA — Retorno à garagem Autorizado: ocorrências do tipo RA com percentual do total
- SOS — Chamadas de emergência/socorro com percentual do total
- Carros c/ Ocorrência — quantidade de veículos únicos que tiveram ocorrência
- Oc/Dia (Média) — total de ocorrências dividido pelos dias únicos no período
- Oc/Carro (Média) — total de ocorrências dividido pela quantidade de carros únicos
Gráficos
- Evolução das Ocorrências — barras diárias agrupadas (RA verde, SOS vermelho) com linha de total azul
- Por Tipo — rosca com proporção entre RA, SOS e OUTROS
- Por Turno — rosca com distribuição entre Manhã, Tarde e Noite
- Motivos (Top 10) — tabela com ranking dos motivos mais frequentes e barra proporcional
- Por Garagem — barras verticais com total por garagem
- Por Linha (Top 6) — barras horizontais das linhas com mais ocorrências
- Por Tecnologia — rosca com divisão por tipo de propulsão (Elétrico/Convencional)
Como usar os Filtros
- Selecione os critérios desejados e clique em Filtrar para aplicar
- Líderes de garagem têm o filtro de garagem pré-selecionado e bloqueado
- Clique em Limpar abaixo do botão para retornar ao estado padrão
- Clique em qualquer linha da lista para ver os detalhes completos da ocorrência
4. Seção KM Frota
KPIs Principais
- Frotas Rastreadas — veículos com dados de KM no período
- KM 7 Dias — soma do KM dos últimos 7 dias de todos os veículos filtrados
- KM Período — soma do KM no período de 30 dias para os veículos filtrados
- Motoristas Ativos — motoristas identificados no período
- Rotas com Dados — linhas/rotas com telemetria no período
Gráficos
- KM por Dia — barras verticais com KM diário total (azul = dia útil, cinza = fim de semana)
- Média por Dia da Semana — média do KM por dia da semana para identificar padrões
- Por Tecnologia — barras horizontais com frotas e KM total por tecnologia
- Por Garagem — barras horizontais com frotas e KM total por garagem
- Top 10 Frotas — os 10 veículos com maior KM nos últimos 30 dias
- Top 10 Rotas — as 10 rotas com maior KM total
Tabela de Frotas
- Busca por prefixo ou placa em tempo real
- Filtragem por garagem e tecnologia
- Ordenação por KM 7d, KM 30d, KM Total ou Prefixo
- Paginação em grupos de 20 frotas
5. Como Atualizar os Dados
Os dados são atualizados pelos scripts Python de extração:
- km_data.json — gerado pelo script de exportação Maxtrack (consultar ETL correspondente)
- ocorrencias_data.json — gerado pelo
_voll_playwright_scraper.pyque faz scraping do Voll360
Após atualizar os arquivos JSON, execute:
python _gerar_portal.py
O arquivo portal_sambaiba.html será regenerado com os dados mais recentes.
Para automatizar a coleta do Voll360, o _voll_playwright_scraper.py pode ser agendado no Agendador de Tarefas do Windows para rodar a cada 10 minutos.
6. Glossário
| Termo | Significado |
|---|---|
| RA | Retorno Autorizado — veículo retornou à garagem com autorização por falha mecânica ou operacional |
| SOS | Ocorrência de emergência/socorro solicitado em campo |
| OUTROS | Demais tabulações do Voll360 (abandono, não autorizado, etc.) |
| Motivo | Categoria do defeito/motivo da ocorrência (Mecânico, Pneu, Elétrico...) |
| Prefixo | Número identificador interno do veículo na frota |
| Placa | Placa de emplacamento do veículo |
| Tecnologia | Tipo de propulsão: Elétrico (bateria) ou Convencional (diesel) |
| Turno | Manhã (05h–12h59), Tarde (13h–18h59), Noite (19h–04h59) |
| KM 7d | Quilômetros rodados nos últimos 7 dias |
| KM 30d | Quilômetros rodados nos últimos 30 dias |
| Dias Ativo | Quantidade de dias em que o veículo teve registros de KM no período |
Gerenciamento de Usuários
Este é um ambiente de demonstração. No ambiente de produção, usuários serão gerenciados no banco de dados.
| Nome | Nível | Garagem | Senha (demo) |
|---|