MGConnect
🎨 Design System · v0.2.0

Filosofia

MGConnect é um sistema de telemetria veicular operado por frotistas, mecânicos e analistas. A interface precisa entregar muita informação rapidamente, sem distrair. O design é industrial, não consumer; operacional, não decorativo; e privilegia densidade informacional sobre espaço em branco generoso.

Princípios

  • Leitura rápida — números monoespaçados, hierarquia tipográfica enxuta, sem decoração entre dado e olho.
  • Baixa distração — animações curtas (≤250ms), cores fortes só para sinal, não para decoração.
  • Alta densidade — minicards de 95×~60px cabem 3-12 por linha; grid é o padrão sobre lista vertical.
  • Estado sempre visível — online/offline/loading nunca ambíguo; tempos sempre presentes; OTA com etapa numerada.
  • Dark é primário — operadores passam horas na tela; light existe para sol direto.
  • Mobile preserva densidade — não simplificamos no celular; mantemos minicards, viramos modal em bottom-sheet.

Regras

Decisões fechadas. Não negociar caso-a-caso — alinhe aqui antes.

✓
Todo card usa raio --mgc-radius-xl (16px). Minicards usam --mgc-radius-md (8px). Modais usam --mgc-radius-2xl (18px). Nenhum valor entre estes.
✓
Toda ação destrutiva usa --mgc-danger (#e74c3c): deletar, abortar OTA, reset hard, desativar veículo. Não confundir com erro de display (que é alert, não button).
✕
Vermelho nunca é cor decorativa. Usuário associa vermelho a "fui clicar e algo ruim aconteceu". Use --mgc-info ou --mgc-warning para destacar sem alarmar.
✓
Todo hover usa --mgc-trans-fast (120ms). Exceção: cards que levantam (transform translateY) usam --mgc-trans-slow (250ms) porque elasticidade pede mais tempo.
✓
Todo modal usa overlay --mgc-overlay (rgba 0.55 / 0.68 dark) com backdrop-filter: blur(2px). Mobile vira bottom-sheet automaticamente abaixo de 600px.
✓
Toda fonte mono (números, IDs, timestamps) usa .mgc-mono. Habilita tabular-nums — colunas de números alinham sozinhas.
✕
Nunca hard-code cor literal (#fff, #1e293b). Use sempre var(--mgc-…). Hard-code quebra dark mode.
✕
Texto secundário não usa itálico, cinza-claro, nem fonte < 11px. Operadores leem em movimento; texto que parece "menos importante" vira invisível. Padrão Albert View: bold ≥0.9em, cor herdada.
✓
Dark mode é ativado por <body class="dark-mode">. Compatível com Albert View atual. Todos os componentes herdam via variáveis — nenhuma classe precisa de override manual.
✓
Foco de teclado é sempre visível (outline 2px --mgc-info). Não remover. Acessibilidade não é opcional.

Como usar

Em qualquer página MGConnect, adicione apenas o link CSS e marque o body.

Setup mínimo

<!DOCTYPE html> <html lang="pt-BR"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover"> <link rel="stylesheet" href="https://designsystem.mgconnect.online/mgconnect.css"> </head> <body class="mgc-app dark-mode"> <header class="mgc-header">…</header> <main class="mgc-main">…</main> </body> </html>

Toggle dark/light em JS

document.getElementById('btn').onclick = () => { document.body.classList.toggle('dark-mode'); localStorage.setItem('mgc-theme', document.body.classList.contains('dark-mode') ? 'dark' : 'light'); }; // On load: if (localStorage.getItem('mgc-theme') === 'dark') { document.body.classList.add('dark-mode'); }

Logo & Ícone

Ativos de marca MGConnect em PNG com fundo transparente. Servidos centralmente pelo design system — referencie sempre por URL. Atualizar o arquivo aqui propaga para todas as UIs (View, Portal, Server, Service, Admin, Config Tool).

Logo (ícone + texto)

Usado no header via .mgc-header .mgc-logo. Já contém o texto "MGConnect" — não acompanhe de rótulo separado (.mgc-brand fica oculto).

Logo MGConnect sobre fundo claro fundo claro
Logo MGConnect sobre fundo escuro fundo escuro
https://designsystem.mgconnect.online/assets/logo.png

Logo dinâmico

O logo numa caixa escura com um anel que gira devagar (4,5 s por volta). É o logo dos headers do Albert View 2. A caixa é sempre escura, nos dois temas. O tamanho vem de --mgc-logo-spin-size: 48 px (--sm), 72 px (padrão) e 112 px (--lg). No header do celular a caixa cai para 56 px. Com prefers-reduced-motion o anel para.

MGConnect MGConnect MGConnect
MGConnect no header
<span class="mgc-logo-spin"><img src="https://designsystem.mgconnect.online/assets/logo.png" alt="MGConnect"></span> <span class="mgc-logo-spin mgc-logo-spin--sm">…</span> <!-- 48 px --> <span class="mgc-logo-spin mgc-logo-spin--lg">…</span> <!-- 112 px --> <span class="mgc-logo-spin" style="--mgc-logo-spin-size: 64px">…</span> <!-- outro tamanho -->
✓
Um logo dinâmico por tela, no header. Fora do header (listas, cards, rodapés) use o logo estático.
✕
Não troque a cor da caixa nem do anel. A caixa escura é parte da marca, também no tema claro.

Ícone (favicon / app icon)

Versão só-símbolo, transparente. Favicon da aba do navegador e ícone de app (apple-touch).

Ícone 64 Ícone 32 Ícone 16
Ícone 64 Ícone 32 Ícone 16
<link rel="icon" href="https://designsystem.mgconnect.online/assets/favicon.ico" sizes="any"> <link rel="icon" type="image/png" sizes="32x32" href="https://designsystem.mgconnect.online/assets/favicon-32.png"> <link rel="apple-touch-icon" href="https://designsystem.mgconnect.online/assets/apple-touch-icon.png">

Regras de uso

✓
Referencie por URL do design system. O ativo é central — trocar o arquivo aqui atualiza o favicon e o logo de todas as UIs de uma vez.
✓
O logo já inclui o texto. No header, deixe só o <img class="mgc-logo">; o .mgc-brand é ocultado pelo CSS do DS.
✕
Não copie o PNG para o repositório de cada UI. Cópias locais divergem e quebram a propagação central.
✕
Não aplique o ícone sobre fundo vermelho saturado. O símbolo é vermelho (#c1121f) — em fundo vermelho perde contraste.

Emojis

Emoji é sinal semântico, não decoração. Cada significado tem um emoji padrão — não troque por sinônimos visuais. Use o glifo listado aqui; mantenha o seletor de cor (U+FE0F) nos que renderizam mono por padrão (⚠️, ☀️, ⚙️…).

Estado & sinalização

✓confirmar / aplicar
U+2713
✅sucesso / concluído
U+2705
✕fechar / cancelar
U+2715
❌erro / falha
U+274C
⚠️aviso / atenção
U+26A0
🛑parar / abortar
U+1F6D1
⏳aguardando / processando
U+23F3

Pontos de status (cor)

Bolinhas de estado — espelham as cores semânticas dos tokens de status.

🟢online / OK
U+1F7E2
🔴offline / crítico
U+1F534
🟡atenção
U+1F7E1
🔵info / OTA
U+1F535
⚪neutro / sem dado
U+26AA

Navegação & direção

→fluxo / próximo
U+2192
←anterior
U+2190
↑ordenar ↑
U+2191
↓ordenar ↓
U+2193
🔁repetir / loop
U+1F501
🔄atualizar / sincronizar
U+1F504
↩️voltar / desfazer
U+21A9
☰menu
U+2630

Ações & ferramentas

⚙️configurações / admin
U+2699
🔧manutenção / ajuste
U+1F527
🛠️ferramentas / setup
U+1F6E0
🔍buscar
U+1F50D
✏️editar
U+270F
🗑️excluir
U+1F5D1
🧹limpar
U+1F9F9
💾salvar
U+1F4BE
📥receber / importar
U+1F4E5
➕adicionar
U+2795
🔑credencial / chave
U+1F511
🔒bloqueado / seguro
U+1F512

Telemetria & veículo

🚛veículo / frota
U+1F69B
⛽combustível
U+26FD
🌡️temperatura
U+1F321
💨velocidade
U+1F4A8
🛣️rota / trajeto
U+1F6E3
🧭direção / bússola
U+1F9ED
🗺️mapa
U+1F5FA
📍localização
U+1F4CD
📡sinal / comunicação
U+1F4E1
⏱️tempo / duração
U+23F1
🔋bateria / tensão
U+1F50B

Análise, saúde & gamificação

📈tendência / subida
U+1F4C8
📉queda
U+1F4C9
📊métricas / dashboard
U+1F4CA
🫀saúde mecânica
U+1FAC0
🩺diagnóstico
U+1FA7A
🧠preditivo / IA
U+1F9E0
🏅medalha
U+1F3C5
🏆troféu / ranking
U+1F3C6
⭐destaque
U+2B50
🔥streak / em alta
U+1F525
🌿economia / eco
U+1F33F

Tema, conta & conteúdo

🌙tema escuro
U+1F319
☀️tema claro
U+2600
🎨design system / tema
U+1F3A8
🔔notificações
U+1F514
📋lista / relatório
U+1F4CB
📄documento
U+1F4C4
📁pasta / grupo
U+1F4C1
🏢empresa / sigla
U+1F3E2
👤usuário / conta
U+1F464

Regras de uso

✓
Um significado, um emoji. Reuse o glifo desta lista; não introduza sinônimos (ex.: não use 🔎 onde o padrão é 🔍, nem ✔/✗ onde é ✓/✕).
✓
Pareie cor e emoji. Pontos de status seguem os tokens semânticos — 🟢 online, 🔴 crítico, 🟡 atenção, 🔵 info.
✕
Emoji não é enfeite. Se não codifica estado, ação ou domínio, não entra. Texto que "parece" mais bonito com emoji geralmente fica mais ruidoso.
✕
Não empilhe emojis (🔥🚀✨) para dar ênfase. Um por rótulo, no máximo.

Ícones (SVG)

Ícones SVG inline usados nos controles das UIs (sobretudo no Albert View). Desenhados em viewBox próprio, herdam a cor do contexto via fill="currentColor" ou stroke="currentColor" — então funcionam em header escuro e em botão claro sem ajuste.

Conjunto

Inicial
home · volta à grade
Mapa
pin de localização
Condução
volante
Diagnóstico
sinal vital · cor fixa #0ea5e9
Gamificação
troféu
Detalhar / buscar
lupa
Motorista
pessoa / conta

Símbolos tipográficos

Glifos Unicode (não-emoji) usados como ícone de botão em toolbars de análise — herdam a fonte e a cor do texto.

Σagrega tudo (modo Σ)
U+03A3
∿curva de tendência
U+223F
⇄comparação / alternar
U+21C4
∂derivada (dX/dt)
U+2202

Como usar

<button class="mgc-icon-btn" title="Inicial"> <svg viewBox="0 0 24 24" width="15" height="15" fill="currentColor"> <path d="M12 2.1 1 12h3v9h6v-6h4v6h6v-9h3z"/> </svg> </button>
✓
Use currentColor (em fill ou stroke) para o ícone herdar a cor do botão/header. Evita uma cópia por tema.
✓
Sempre com title — o tooltip é o rótulo acessível do ícone (ex.: "Inicial", "Mapa").
✕
Não fixe cor literal salvo intenção semântica (ex.: o ícone de Diagnóstico usa #0ea5e9 de propósito como "sinal vital").
✕
Símbolos de marca não entram aqui. O ícone "Meu Agente" (Einstein) é uma marca específica do View (<use href="#einsteinSymbol">), não um ícone de UI reutilizável.

Cores

Tokens semânticos, nunca literais. Cada cor tem um papel definido.

Superfícies

Texto

Ação principal

Status semântico

Fundo de botão, etiqueta ou selo com texto branco usa o preenchimento forte (--mgc-*-strong, ≥ 4,5:1 com branco). As cores acima ficam para bolinhas, barras, gráficos e mapa. Notas A–E: texto com --mgc-grade-ink-*.

Bordas e sombras

Header (cromo)

Claro: degradê grafite claro, um tom acima do fundo da página, com fio embaixo, letras grafite e botões brancos translúcidos; o logo fica numa caixa escura. Escuro: o cromo grafite escuro de sempre.

Telemetria — frescor do último contato

Telemetria — escala de score e notas

Telemetria — estado e marcador do veículo

Tipografia

Sans para texto, mono para dados. Escala compacta — 6 tamanhos.

Famílias

Segoe UI / Roboto / Arial — texto, labels, títulos.
ui-monospace 12345.67 km/h — números, IDs, timestamps.

Escala

3xl · 28px · títulos de página
2xl · 22px · seções
xl · 18px · subseções, ícones grandes
lg · 15px · h3, números em destaque
md · 13px · texto corrido, labels
base · 12px · UI padrão (botões, toolbar)
sm · 11px · meta, footer, label
xs · 10px · minicard, pill (não use para texto principal)

Espaçamento

Escala 4px. Tudo é múltiplo. Nada de ad-hoc.

Raios

7 valores. Cada componente tem o seu — fixo.

xs · 3px
sm · 6px
md · 8px
lg · 12px
xl · 16px
2xl · 18px
pill · 999px

Sombras

4 níveis. Adapta automaticamente para dark mode.

shadow-sm
shadow-md (card)
shadow-lg (hover)
shadow-modal

Transições

3 velocidades. Padrão é fast (120ms).

--mgc-trans-fast: 120ms — hover, mudança de cor, toggle. Padrão.
--mgc-trans-base: 200ms — barras de progresso, painéis abrindo.
--mgc-trans-slow: 250ms — transform elástico (cards levantando).

Demo (passe o mouse)

Slow (250ms)
levanta no hover

Botões

Default → ação reversível. Primary → ação principal. Danger → destrutivo.

Variantes

Tamanhos

Icon button

Status badges & Pills

Sinalização visual de estado. Cor sempre semântica.

Status badge (120×38px, dentro de card)

Online
2s atrás
Offline
3h12m
Atenção
tensão baixa
OTA
etapa 2/4
Estacionado
15min
Carregando

Pills (tag minúscula em listas)

NEUTRO OK ERRO AVISO NOVO

Cards

Container padrão. Radius 16px (xl), padding 16px, shadow-md.

PRZ · IVC4026

OK
Volvo VM 270 · 2019
Online
12s
82 km/h

GRT · JCU5A70

SENSOR
Scania R450 · 2021
Atenção
arref. 102°C
0 km/h

PZT · XAF1100

ERRO
Iveco Daily · 2018
Offline
3h12m
—

Minicards

Densidade máxima — 95px de largura. 9-12 por linha em desktop, 3 em mobile.

Grids

.mgc-grid padrão é responsivo (auto-fill minmax 240px). Para mini, use .mgc-grid--mini.

Padrão

Card A
Card B
Card C

Alerts

Mensagens contextuais. Diferente de status — fala da operação, não do veículo.

✓
OTA finalizado
Firmware k2_v1.4.2 instalado em 12 dispositivos.
ⓘ
Sincronização em andamento
Ingestor processando lote de 1.247 eventos.
⚠
Veículo sem heartbeat
GRT · JCU5A70 não comunica há 18 minutos.
✕
Falha de transporte k2
HTTP_BODY_SHA_MISMATCH em 3 sessões consecutivas. Investigar.

Tabelas

Densas, monoespaçadas, sticky-header. Hover de linha sinaliza interatividade.

Sigla Placa Status Vel RPM Último sinal
PRZ IVC4026 OK 82 1840 12s
GRT JCU5A70 ATENÇÃO 0 760 8s
PZT XAF1100 OFFLINE — — 3h12m
VND VEC8821 OTA 0 820 2s

Timeline

Eventos discretos em ordem temporal. Cor do marcador codifica natureza.

2026-05-22 14:32:08
OTA-3 confirmado pelo device
2026-05-22 14:31:45
Payload k2 entregue (16.4 KB)
2026-05-22 14:31:12
Retry #1 — HTTP timeout
2026-05-22 14:30:01
Sessão k2 aberta

Barra OTA

Progresso + etapa numerada. Cor da barra sinaliza estado global.

k2_v1.4.2 → PRZ · IVC4026 68%
OTA-0
OTA-1
OTA-2
OTA-3
OTA-4
k1_v3.2 → GRT · JCU5A70 100%
k2_v1.4.2 → VND · VEC8821 42%
OTA-0
OTA-1
OTA-2
OTA-3
OTA-4

Modal

Overlay 0.55, blur 2px, content radius 18px. Mobile vira bottom-sheet.

Tooltips

Conteúdo informativo on-hover, fora do fluxo da página.

Passe o mouse no card abaixo para ver o tooltip.

PRZ · IVC4026
Hover para tooltip
Volvo VM 270
Última mensagem: 12s atrás
−23.5505, −46.6333

Loaders

Spinner, dots, pulse, toast. Cada um sinaliza um tipo de espera.

spinner — operação rápida
dots — aguardando dado
pulse-dot — live indicator

Forms

Inputs, selects, textareas e checkboxes. Densidade compacta, foco com glow azul.

Estados

10 chars, alfanumérico
Modificado — pendente de salvar
Campo obrigatório

Inline (linha de filtro)

Fieldsets

Agrupa campos relacionados com legenda. Substitui o div+h2 para formulários longos.

🚛 Nova Identidade

Modal — small / dialog

Para confirmações e fluxos curtos. Diferente do modal full-screen padrão.

Action list

Lista de operações tipadas. Cor codifica o tipo — backup, move, create, db, update, conflict.

  • Criar backup
    ~/albert/agent/_backup/PRZ_IVC4026_20260522_1432.tgz
  • Mover pasta
    ~/albert/agent/OLD/IVC4026 → ~/albert/agent/PRZ/IVC4026
  • Criar estrutura
    ~/albert/agent/PRZ/IVC4026/{T,al,TWiFi,hWiFi,segmentos,contr}/
  • Atualizar contr.txt
    Campos [7]=14LBE, [8]=PRZ, [9]=IVC4026, [10]=Volvo, [11]=VM 270
  • Upsert no banco
    INSERT INTO veiculos(numserie, sigla, placa, marca, modelo) VALUES(…) ON CONFLICT(numserie) DO UPDATE …
  • CMD11 será enviado
    Dispositivo atualiza contr.txt no próximo ping (~30s)
  • Conflito — placa já existe
    IVC4026 atualmente vinculada a numSerie=09ABC. Use "Forçar" para rebinding.

Editable cell

Para tabelas com edição inline. Clique = vira input. Salvamento explícito (botão "Aplicar" na linha).

SiglaPlacaMarcaModeloChip
PRZ IVC4026 Volvo VM 270 8932011234
GRT JCU5A70 Scania R450 8932011567
Estados: idle · dirty · saving

State box

Resultado de busca/consulta. Diferente de alert — representa um estado do dado, não um aviso de UI.

Encontrado: DB FS
numSerie=14LBE · sigla=LBG · placa=XAF1100
Não encontrado — numSerie 99ZZZ não existe no banco nem no filesystem. Será criado como novo.
Erro — conexão com banco perdida durante a consulta. Tentar novamente.

Two-column layout

Form à esquerda (400px), preview/resultado à direita (flex). Colapsa abaixo de 800px.

Formulário
Resultado
  • Criar pasta
    ~/albert/agent/PRZ/IVC4026/
  • Inserir veículo

Painéis

Peças das páginas de painel do Albert View 2: card de escopo, KPIs, segmentado, paginação, medidor e botões do header escuro. Alturas de controle pelos tokens --mgc-control-h (36 px) e --mgc-control-h-sm (28 px).

Card de escopo

Primeiro card de toda página: título, descrição curta e os filtros (empresa, frota, período…). Rótulos em caixa alta, campos de 36 px.

Frota e Mapa

Acompanhe seus veículos em tempo real.

<div class="mgc-scope"> <div class="mgc-scope-top"><div class="mgc-scope-lead"><h2>Título</h2><p>Descrição</p></div> …ações</div> <div class="mgc-scope-filters"><div class="mgc-field"><label class="mgc-label">Empresa</label><select class="mgc-select">…</select></div>…</div> </div>

KPI e ícone em quadrado

Valor grande, rótulo e linha de apoio. Com .is-interactive o KPI filtra a página (sobe no hover); .is-on marca o filtro ativo. .mgc-kpi--compact: linhas com 5–6 KPIs (valor 22 px, ícone 40 px). O ícone usa .mgc-icon-tile--{info,success,warning,danger,neutral} (44 px; --sm 32 px).

13
Parados
27%
<button class="mgc-kpi is-interactive"> <div class="mgc-kpi-top"><span class="mgc-icon-tile mgc-icon-tile--success"><svg…></span> <div><div class="mgc-kpi-val">22 <small>/ 49</small></div><div class="mgc-kpi-lab">Veículos online</div></div></div> <div class="mgc-kpi-sub">45% da frota</div> </button>

Segmentado

Escolha exclusiva entre poucas opções ou abas em pílula. A opção ligada usa --mgc-primary (.is-on ou aria-pressed="true").

Paginação

21–40 de 90

Medidor

Barra de proporção (8 px; --sm 6 px, --lg 10 px). Cor do segmento por .is-success/.is-warning/.is-danger/.is-neutral (padrão info). --stacked empilha segmentos.

<div class="mgc-meter"><span style="width:64%"></span></div> <div class="mgc-meter mgc-meter--stacked"><span class="is-success" style="width:45%"></span><span class="is-warning" style="width:20%"></span>…</div>

Botão do header

Ações sobre o cromo do header, nos dois temas: translúcido (--mgc-header-btn-*), 34 px. --icon = só ícone (tema, voltar/X).

<button class="mgc-header-btn">Sair</button> <button class="mgc-header-btn mgc-header-btn--icon" aria-label="Fechar"><svg…></button>

Círculo do usuário

Iniciais de quem fez o login, no cromo do header. É sempre o último item do grupo de ações (ponta direita), em todos os headers da aplicação, inclusive os de modais com header próprio. Só informação: não é botão; o tooltip diz Usuário: nome · login.

M2 KL
RegraDefinição
Tamanho34 px nos headers do View 2; --sm 30 px no header clássico. No celular (≤ 720 px) todos ficam com 30 px.
CorFundo --mgc-info, texto --mgc-text-on-accent, fio de 2 px branco a 55 % (destaca do cromo escuro nos dois temas).
Tipografia--mgc-font-sans, --mgc-text-md (sm no --sm), negrito, espaçamento 0,3 px, duas letras em caixa alta.
Posiçãoorder: 99 e anexado por último no grupo de ações da direita (depois do chip "Última atualização" e dos botões); se o header for reconstruído, o círculo volta para o fim.
IniciaisLogin institucional mgconnectN → MN (mgconnect2 → M2). Nome com espaços → primeira letra da primeira e da última palavra (Klaus Liesenberg → KL). E-mail ou login com separadores (. _ - +) → primeira letra das duas primeiras partes (klaus.liesenberg.biz → KL). Uma parte só → duas primeiras letras. Nada → "?".
Fonte dos dadosSessão da aplicação (ui_session: login e nome, quando houver). Sem sessão não há círculo.
<span class="mgc-user-badge" role="img" title="Usuário: Klaus Liesenberg · klaus" aria-label="Usuário: Klaus Liesenberg">KL</span> <span class="mgc-user-badge mgc-user-badge--sm">M2</span> <!-- header clássico -->

Barra de ação

Linha de contato/ação entre blocos de uma página (nasceu no Portal do Motorista, 12/11/2026): tile com ícone, título e subtítulo à esquerda; botões comuns do DS à direita (.mgc-btn e --primary, sem contorno colorido próprio). No celular os botões descem e dividem a largura.

Gestor da frota Maria Souza · (11) 91234-5678
RegraDefinição
Estrutura.mgc-actionbar > .mgc-actionbar-lead (tile + título com <small>) + .mgc-actionbar-actions (1–3 botões).
SuperfícieMesma dos KPIs: --mgc-surface-elevated, borda --mgc-border-subtle, raio xl, sombra sm.
BotõesSó variantes do DS. Links (tel:, wa.me) usam <a class="mgc-btn">; sem destino, aria-disabled="true".
Celular≤ 720 px: ações em linha própria, cada botão com a mesma largura.

Popover

Painel flutuante ancorado num botão para informação rápida e temporária (histórico curto, legenda, atalhos). Abre com .is-open; a página fecha no ✕, com Esc e no clique fora. Não substitui o modal: nada de formulário longo nem ação destrutiva.

Histórico mensal
OutubroA
SetembroA
AgostoB
ⓘ Visão rápida e temporária dos últimos meses.
RegraDefinição
Estrutura.mgc-popover-wrap (position: relative) > botão âncora + .mgc-popover > .mgc-popover-head (ícone, título, ✕ à direita) + conteúdo + .mgc-popover-foot.
PosiçãoAbaixo do botão, alinhado à direita com seta; --left alinha à esquerda. Largura 230–320 px (máx. 90 vw).
Camada--mgc-z-tooltip; superfície --mgc-surface, borda --mgc-border, sombra lg.
ConteúdoCurto e sem rolagem; para mais do que isso, use o modal.
Regra de ouroSempre na área visível. No celular o card é estreito e o painel transbordaria: a página mede o botão e o painel, aplica .is-fixed com left/top presos às bordas (8 px), usa .is-up quando não cabe embaixo e ajusta a seta com --mgc-popover-arrow. Reposicionar em resize e scroll. Vale para todo balão flutuante (tooltip, hover do mapa): nunca sair do mapa nem da tela.

Marcador do veículo

O veículo no mapa (Albert View 2: Frota e Mapa, mapa ampliado e mapa detalhado) é um único SVG que codifica, sem indicadores externos, contato (carroceria), motor (capô), DTC (borda do capô), movimento (ondas na traseira) e rumo (rotação). Cores só pelos tokens --mgc-fresh-* e --mgc-veh-*. Pacote de origem: "MGConnect — marcador de veículo", revisão 6 (27/10/2026) + revisão 7 (28/10/2026: carroceria estreita em cunha, ondas no lugar da seta).

Anatomia

  • Carroceria = frescor do último contato (tempo sem dado): --mgc-fresh-online / recent / silent / offline / dead.
  • Capô = motor: --mgc-veh-hood-on ligado · --mgc-veh-hood-off desligado.
  • Borda do capô = DTC ativo: --mgc-veh-dtc com fio preto por fora; sem DTC a borda é preta.
  • Ondas na traseira = em movimento (≥ 5 km/h) com rumo válido: --mgc-veh-wave-a / wave-b alternadas; alcance e ritmo crescem com a velocidade.
  • Rotação = rumo (0° = norte, horário) em torno de (56,56). Parado mantém a última orientação.
  • Contorno, rodas e para-brisa: --mgc-veh-ink sobre fio branco, para destacar de qualquer fundo de mapa.

Estados

Cinco cores de contato × cinco combinações de motor, DTC e movimento (a prancha do pacote). Rumo 35° em todas; as linhas "em movimento" a 60 km/h.

ContatoTempo sem dado (t, em segundos)Token
Online0 ≤ t ≤ 600--mgc-fresh-online
Recente600 < t ≤ 3600--mgc-fresh-recent
Silencioso3600 < t ≤ 21600--mgc-fresh-silent
Offline21600 < t ≤ 86400--mgc-fresh-offline
Inativot > 86400--mgc-fresh-dead

Limites inclusivos no fim de cada faixa (10 min exatos = Online; 1 h = Recente; 6 h = Silencioso; 24 h = Offline). Classificar em segundos; arredondar só o texto exibido. A referência é o "tempo sem dado" do MGConnect, não o horário de contato de rede.

Círculo de seleção

Veículo selecionado no mapa coletivo: círculo de 44 px sob o marcador, estático (a pulsação atrapalhava a leitura do mapa). Azul --mgc-info; com alerta do preditivo toma a cor do alerta: --crit vermelho, --warn âmbar.

<!-- Leaflet: dois marcadores na mesma posição; o círculo por baixo e sem interação --> L.marker(ll, { icon: L.divIcon({ className: "", html: '<div class="mgc-veh-halo mgc-veh-halo--crit"></div>', iconSize: [44, 44], iconAnchor: [22, 22] }), interactive: false, zIndexOffset: -100 }); L.marker(ll, { icon: L.divIcon({ className: "", html: '<div class="mgc-veh-marker">' + svg + '</div>', iconSize: [48, 48], iconAnchor: [24, 24] }), zIndexOffset: 900 }); <!-- fora do mapa (card, lista, documentação) --> <div class="mgc-veh-stack"><div class="mgc-veh-halo"></div><div class="mgc-veh-marker">…svg…</div></div>

Geometria e tamanhos

ItemDefinição
viewBox · âncora10 10 92 92 · âncora e centro de rotação em (56,56). overflow: visible (as ondas saem da caixa).
TamanhosMapa: caixa de 48 px (iconSize [48,48], iconAnchor [24,24]). Cards, listas e modal: 36 px (.mgc-veh-marker--sm); card mini: 36 px × 0,72 (--mini). O marcador não escala com o zoom do mapa.
Rotaçãorotate(heading 56 56) no grupo inteiro (carroceria + ondas). Heading válido: número finito de 0 a 360 (0 = norte válido). Sem rumo válido: 0° e sem ondas.
Carroceria (rev. 7)29 unidades de largura (x 41,5–70,5) × 52 de comprimento (y 30–82); frente em cunha de ~26° (ponta x 50–62, abre em reta até a largura cheia em y 45); cantos traseiros r 6.
M50 30H62Q64.2 30 64.8 33.4L70.5 45V76Q70.5 82 64.5 82H47.5Q41.5 82 41.5 76V45L47.2 33.4Q47.8 30 50 30Z
Capôy 32–41,9, acompanha a cunha. Comprimento inclui a borda que sinaliza DTC.
M50 32H62Q63.1 32 63.4 34.3L66 41.9H46L48.6 34.3Q48.9 32 50 32Z
Para-brisay 43,5–50,5; larguras 16 (frente) e 20 (trás). Branco com contorno --mgc-veh-ink 1,4.
M48 43.5H64L66 50.5H46Z
RodasQuatro retângulos 5 × 12, r 2, em (35,5; 42) (35,5; 64) (71,5; 42) (71,5; 64): --mgc-veh-ink com fio branco 3.
TraçosCarroceria: fio branco 6 por baixo, contorno --mgc-veh-ink 2. Capô: fio branco 5,6 e borda 3,2 (preta sem DTC); com DTC: fio branco 9,6 + fio preto 7,8 + borda --mgc-veh-dtc 3,2 (laranja com contorno preto, para contraste). Tudo stroke-linejoin: round.
Ordem de desenhoondas → rodas → carroceria → capô → para-brisa (tudo dentro do grupo rotacionado).
Balão (tooltip)Foge da traseira (do rastro): padrão à direita (offset 12,0). Se a traseira aponta entre 15° e 165°: até 90° → embaixo (0,28); senão → em cima (0,−16). Aparece no hover/toque; ao selecionar, fica 7 s.

Movimento (ondas)

Substituem a seta amarela desde 28/10/2026. Nascem no para-choque traseiro (56,78) e se propagam para trás; perceptíveis a partir de 5 km/h, alcance, intensidade e ritmo crescem até 90 km/h.

ParâmetroValor
Intensidade kk = 0,35 + 0,65 · min((v − 5) / 85, 1) (v em km/h; 0,35 a 5 km/h, 1 a 90 km/h). Abaixo de 5 km/h não há ondas.
Alcance RR = 12 + 20k unidades do viewBox atrás do para-choque.
Período TT = 2,4 − 1,4k segundos por onda.
Ondas4 simultâneas, defasadas em T/4, cores alternadas --mgc-veh-wave-a (laranja) e --mgc-veh-wave-b (preta), cada uma com fio branco 5,6 sob o traço 3,4 (stroke-linecap: round).
FormaArco de 124° (meio-ângulo 62°) de raio R, escalado de 0,28 a 1 (keySplines 0.2 0.6 0.6 1); opacidade 0 → pico → 0 (keyTimes 0; 0.12; 0.6; 1), pico 0,85 + 0,15k.
AnimaçãoSMIL no próprio SVG (animateTransform + animate), begin negativo derivado do relógio: as ondas continuam em fase quando o marcador é redesenhado a cada atualização.

Regras

✓
Carroceria sempre pela régua de frescor do último contato (tempo sem dado), nunca pelo estado do motor ou pela velocidade.
✓
Movimento é independente do motor. Parado com motor ligado: capô verde, sem ondas. Movendo com motor desligado: capô preto, com ondas. A regra de movimento é a do MGConnect (velocidade > 0 com dado fresco), sem inventar limiar novo.
✕
Sem rumo válido não se desenha onda nem se aponta para o norte por engano. Ocultar e informar a situação no detalhe. Ao parar, só esconder as ondas; a orientação fica a última conhecida.
✓
Offline ou Inativo preserva o último estado conhecido de motor e DTC (a carroceria já diz que o dado é velho); indicar a antiguidade no detalhe. Manter a diferença entre data/hora do contato e data/hora da amostra de telemetria.
✕
Nada fora do desenho: sem bolinhas externas de motor/DTC (removidas na revisão 6), sem escalar com o zoom, sem trocar as cores por hex próprios. Um estado desconhecido não é "preto": a paleta do capô é binária.
✓
A aplicação atualiza fill, stroke, transform e as ondas a cada dado novo; não basta mudar atributos data-*. Vários SVGs inline no mesmo documento: sem ids (o gerador não usa) ou prefixos únicos.
✓
Mesmo vocabulário fora do mapa: o ícone de 36 px em listas e cards é o mesmo SVG (mesma cor de contato, capô, borda e ondas), e o balão/tooltip repete em texto o que o desenho mostra (contato, há quanto tempo, motor, DTC, velocidade e rumo).

Como usar

O gerador de referência (cópia de _vehIconSvg / makeVehicleIcon do Albert View 2) está no fonte desta página: mgcVehSvg({ fresh, engineOn, dtc, heading, vel, px }). Lê as cores dos tokens em tempo de execução.

// fresh: "online" | "recente" | "silencioso" | "offline" | "inativo" (pela régua de tempo sem dado) const svg = mgcVehSvg({ fresh: "online", engineOn: true, dtc: true, heading: 35, vel: 60, px: 48 }); // mapa (Leaflet) L.divIcon({ className: "", html: '<div class="mgc-veh-marker">' + svg + '</div>', iconSize: [48, 48], iconAnchor: [24, 24] }); // lista / card <span class="mgc-veh-marker mgc-veh-marker--sm">…mgcVehSvg({ …, px: 36 })…</span>