Sambaíba Transportes

📖 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

E-mail	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.py que 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