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.
--mgc-radius-xl (16px). Minicards usam --mgc-radius-md (8px). Modais usam --mgc-radius-2xl (18px). Nenhum valor entre estes.--mgc-danger (#e74c3c): deletar, abortar OTA, reset hard, desativar veículo. Não confundir com erro de display (que é alert, não button).--mgc-info ou --mgc-warning para destacar sem alarmar.--mgc-trans-fast (120ms). Exceção: cards que levantam (transform translateY) usam --mgc-trans-slow (250ms) porque elasticidade pede mais tempo.--mgc-overlay (rgba 0.55 / 0.68 dark) com backdrop-filter: blur(2px). Mobile vira bottom-sheet automaticamente abaixo de 600px..mgc-mono. Habilita tabular-nums — colunas de números alinham sozinhas.#fff, #1e293b). Use sempre var(--mgc-…). Hard-code quebra dark mode.<body class="dark-mode">. Compatível com Albert View atual. Todos os componentes herdam via variáveis — nenhuma classe precisa de override manual.--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
Toggle dark/light em JS
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).
fundo claro
fundo escuro
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.
no header
Ícone (favicon / app icon)
Versão só-símbolo, transparente. Favicon da aba do navegador e ícone de app (apple-touch).
Regras de uso
<img class="mgc-logo">; o .mgc-brand é ocultado pelo CSS do DS.#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
Pontos de status (cor)
Bolinhas de estado — espelham as cores semânticas dos tokens de status.
Navegação & direção
Ações & ferramentas
Telemetria & veículo
Análise, saúde & gamificação
Tema, conta & conteúdo
Regras de uso
Í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
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.
Como usar
currentColor (em fill ou stroke) para o ícone herdar a cor do botão/header. Evita uma cópia por tema.title — o tooltip é o rótulo acessível do ícone (ex.: "Inicial", "Mapa").#0ea5e9 de propósito como "sinal vital").<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
Escala
Espaçamento
Escala 4px. Tudo é múltiplo. Nada de ad-hoc.
Raios
7 valores. Cada componente tem o seu — fixo.
Sombras
4 níveis. Adapta automaticamente para dark mode.
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)
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)
Pills (tag minúscula em listas)
Cards
Container padrão. Radius 16px (xl), padding 16px, shadow-md.
PRZ · IVC4026
OKGRT · JCU5A70
SENSORPZT · XAF1100
ERROMinicards
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
Alerts
Mensagens contextuais. Diferente de status — fala da operação, não do veículo.
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.
Barra OTA
Progresso + etapa numerada. Cor da barra sinaliza estado global.
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.
Loaders
Spinner, dots, pulse, toast. Cada um sinaliza um tipo de espera.
Forms
Inputs, selects, textareas e checkboxes. Densidade compacta, foco com glow azul.
Estados
Inline (linha de filtro)
Fieldsets
Agrupa campos relacionados com legenda. Substitui o div+h2 para formulários longos.
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.txtCampos [7]=14LBE, [8]=PRZ, [9]=IVC4026, [10]=Volvo, [11]=VM 270
-
Upsert no bancoINSERT INTO veiculos(numserie, sigla, placa, marca, modelo) VALUES(…) ON CONFLICT(numserie) DO UPDATE …
-
CMD11 será enviadoDispositivo atualiza contr.txt no próximo ping (~30s)
-
Conflito — placa já existeIVC4026 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).
| Sigla | Placa | Marca | Modelo | Chip | |
|---|---|---|---|---|---|
| PRZ | IVC4026 | Volvo | VM 270 | 8932011234 | |
| GRT | JCU5A70 | Scania | R450 | 8932011567 |
State box
Resultado de busca/consulta. Diferente de alert — representa um estado do dado, não um aviso de UI.
numSerie=
14LBE · sigla=LBG · placa=XAF1100
99ZZZ não existe no banco nem no filesystem. Será criado como novo.
Two-column layout
Form à esquerda (400px), preview/resultado à direita (flex). Colapsa abaixo de 800px.
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.
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).
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
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.
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).
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.
| Regra | Definição |
|---|---|
| Tamanho | 34 px nos headers do View 2; --sm 30 px no header clássico. No celular (≤ 720 px) todos ficam com 30 px. |
| Cor | Fundo --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ção | order: 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. |
| Iniciais | Login 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 dados | Sessão da aplicação (ui_session: login e nome, quando houver). Sem sessão não há círculo. |
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.
| Regra | Definição |
|---|---|
| Estrutura | .mgc-actionbar > .mgc-actionbar-lead (tile + título com <small>) + .mgc-actionbar-actions (1–3 botões). |
| Superfície | Mesma dos KPIs: --mgc-surface-elevated, borda --mgc-border-subtle, raio xl, sombra sm. |
| Botões | Só 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.
| Regra | Definiçã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ção | Abaixo 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údo | Curto e sem rolagem; para mais do que isso, use o modal. |
| Regra de ouro | Sempre 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-onligado ·--mgc-veh-hood-offdesligado. - Borda do capô = DTC ativo:
--mgc-veh-dtccom 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-balternadas; 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-inksobre 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.
| Contato | Tempo sem dado (t, em segundos) | Token |
|---|---|---|
| Online | 0 ≤ t ≤ 600 | --mgc-fresh-online |
| Recente | 600 < t ≤ 3600 | --mgc-fresh-recent |
| Silencioso | 3600 < t ≤ 21600 | --mgc-fresh-silent |
| Offline | 21600 < t ≤ 86400 | --mgc-fresh-offline |
| Inativo | t > 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.
Geometria e tamanhos
| Item | Definição |
|---|---|
| viewBox · âncora | 10 10 92 92 · âncora e centro de rotação em (56,56). overflow: visible (as ondas saem da caixa). |
| Tamanhos | Mapa: 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ção | rotate(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-brisa | y 43,5–50,5; larguras 16 (frente) e 20 (trás). Branco com contorno --mgc-veh-ink 1,4.M48 43.5H64L66 50.5H46Z |
| Rodas | Quatro 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ços | Carroceria: 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 desenho | ondas → 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âmetro | Valor |
|---|---|
| Intensidade k | k = 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 R | R = 12 + 20k unidades do viewBox atrás do para-choque. |
| Período T | T = 2,4 − 1,4k segundos por onda. |
| Ondas | 4 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). |
| Forma | Arco 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ção | SMIL 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
data-*. Vários SVGs inline no mesmo documento: sem ids (o gerador não usa) ou prefixos únicos.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.