Produto e dados
Painel é ferramenta de decisão. Número técnico em mono, gráfico sobre fundo próprio e uma tabela de verdade por trás de cada gráfico. A cor diz qual é a série; o texto diz o que mudou.
Indicadores
Um número que decide o dia não precisa de gráfico: ele é o indicador. Rótulo em texto comum, valor grande em mono e a variação com sinal, seta e uma palavra, melhor ou pior. A cor de status só reforça. A faísca mostra o caminho até o número; o ponto é agora.
Painel da aceleração
.rq-kpis · .rq-kpi · __rotulo · __periodo · __valor · __unidade · __variacao · data-sentido · __meta · __trilha · __faisca · __pontoReceita do dia
Hoje, 15:40
R$ 18.420
+6,1% melhor que a quinta passada
Pedidos
Hoje, 15:40
142
+9,2% melhor que a quinta passada
No mesmo horário dos últimos 14 dias, os pedidos foram de 118 a 142, em alta.
Ticket médio
Hoje, 15:40
R$ 129,72
−2,8% pior que a quinta passada
Nos últimos 14 dias, o ticket médio oscilou entre R$ 130 e R$ 135 e hoje está no ponto mais baixo.
ROAS
7 dias
4,6
+0,4 melhor que os 7 dias anteriores
ROAS diário dos últimos 14 dias entre 4,0 e 4,6; hoje no ponto mais alto.
Dados de exemplo.
- Quando usar
- Os três a cinco números que a equipe olha primeiro. Mais que seis, vire tabela. A meta entra como trilha só quando há um alvo combinado.
- Sentido
data-sentido="bom","ruim"ou sem atributo (neutro). A seta mostra a direção; a palavra diz se é bom. Em latência e custo, cair é bom: seta para baixo comdata-sentido="bom".- Acessibilidade
- A faísca é
aria-hiddene a tendência vai em texto (.rq-oculto-visual). O menos é o sinal tipográfico (−), não o hífen.
O gráfico
Uma <figure> com legenda e uma <table> de verdade. O módulo lê a tabela e desenha o SVG; a tabela continua no documento para o leitor de tela e aparece pelo botão Ver tabela. Sem JS, só a tabela. As séries seguem a ordem fixa de Cores e temas, sobre --rq-grafico-fundo.
Atributos
data-rq="grafico"| Atributo | Valores | O que faz |
|---|---|---|
data-tipo | barras, barras-empilhadas, linhas, area, rosca | A forma. Área com duas ou mais séries empilha; se uma série troca de sinal, as áreas não empilham e vão cada uma ao zero. |
data-formato | numero, moeda, porcentagem | Formato brasileiro (Intl.NumberFormat). Eixo compacto a partir de 10 mil. |
data-unidade | texto curto | Sufixo do valor na dica e nos rótulos: ms, tokens. |
data-casas | número | Casas decimais fixas. Sem ele, inteiro quando todos os valores são inteiros. |
data-orientacao | horizontal | Barras deitadas. Sem ele, deitam sozinhas quando os nomes não cabem embaixo. |
data-rotulos | nenhum | Tira os rótulos diretos: valor na ponta da barra e no fim da linha. |
data-grafico="fora" | no <th> | A coluna fica só na tabela. |
data-valor | no <td> | O número cru, quando o texto da célula é formatado de outro jeito. |
--altura | medida | Altura da área do gráfico. 280 px; 232 px em bloco estreito. |
- Regras
- Um eixo só. Barras e área partem do zero, e o valor negativo desce abaixo dele. Célula sem número fica sem marca e sem rótulo; sem nenhum número, fica só a tabela. Marcas finas (barra de até 24 px com ponta de 4 px, linha de 2 px, ponto de 8 px), vão de 2 px na cor do fundo, grade de 1 px. Texto nunca na cor da série.
- Teclado
- Tab chega ao gráfico. ← → andam pelas categorias, ↑ ↓ trocam a série nas barras, Home e End vão às pontas, Esc fecha a dica (também a aberta pelo ponteiro). O valor ativo é anunciado.
- Movimento
- As barras crescem da base e a linha se traça uma vez, quando o gráfico chega à tela. Com movimento reduzido, ele já nasce pronto.
Barras
Para comparar quantidades. Uma série leva o valor na ponta e dispensa o eixo; duas ou mais ganham legenda e eixo. Nomes longos deitam a barra.
Agrupadas
.rq-grafico · data-tipo="barras" · data-formato="moeda"| Canal | Setembro | Agosto |
|---|---|---|
| Meta Ads | R$ 182.400 | R$ 158.600 |
| Google Ads | R$ 141.300 | R$ 135.900 |
| E-mail e CRM | R$ 86.900 | R$ 64.300 |
| Orgânico | R$ 51.200 | R$ 49.800 |
| Direto | R$ 38.700 | R$ 41.200 |
Uma série, deitada
data-orientacao="horizontal"| Região | Pedidos |
|---|---|
| Sudeste | 1.982 |
| Sul | 848 |
| Nordeste | 607 |
| Centro-Oeste | 320 |
| Norte | 103 |
Empilhadas
data-tipo="barras-empilhadas"Parte de um todo ao longo do tempo. Cada segmento é separado por um vão na cor do fundo, sem contorno; só o topo da pilha arredonda, e o total vai em cima.
| Mês | Primeira compra | Recompra |
|---|---|---|
| Abr | 2.390 | 560 |
| Mai | 2.480 | 640 |
| Jun | 2.410 | 735 |
| Jul | 2.530 | 860 |
| Ago | 2.570 | 1.080 |
| Set | 2.548 | 1.312 |
- Quando usar
- Agrupadas para comparar séries dentro de cada categoria; empilhadas quando a soma importa. Um valor só não é gráfico de barra: é indicador.
- Séries
- Até seis, na ordem fixa. A sétima vira "Outros" na tabela antes de chegar ao gráfico; cor nunca é reciclada.
Linhas
Para tendência no tempo. Sessões estão na casa das dezenas de milhares e pedidos na das centenas: num eixo só, os pedidos virariam uma reta no chão; com dois eixos, a escala inventa uma correlação. Os dois viram índice com a mesma base, e a leitura fica honesta. Os totais seguem na tabela.
Duas séries em índice
data-tipo="linhas" · data-grafico="fora"| Semana | Sessões (total) | Pedidos (total) | Sessões | Pedidos |
|---|---|---|---|---|
| S34 | 52.400 | 742 | 100,0 | 100,0 |
| S35 | 54.100 | 781 | 103,2 | 105,3 |
| S36 | 51.800 | 726 | 98,9 | 97,8 |
| S37 | 56.900 | 851 | 108,6 | 114,7 |
| S38 | 59.700 | 925 | 113,9 | 124,7 |
| S39 | 58.300 | 896 | 111,3 | 120,8 |
| S40 | 63.200 | 1.012 | 120,6 | 136,4 |
| S41 | 66.500 | 1.083 | 126,9 | 146,0 |
- Quando usar
- Tempo no eixo de baixo, de seis a algumas dezenas de pontos. Medidas de escala diferente: índice, como aqui, ou dois gráficos lado a lado. Nunca dois eixos verticais.
- Rótulos
- Nome e último valor no fim de cada linha, até quatro séries. Se dois rótulos ficam perto demais, saem os dois e ficam a legenda e a dica.
Área
Uma série no tempo, com o volume em véu de 12% sob a linha. Com duas ou mais séries, a área empilha e a borda de cada faixa é a linha da série (exemplo em Engenharia).
Uma série
data-tipo="area"| Dia | Receita |
|---|---|
| 01/09 | R$ 15.330 |
| 02/09 | R$ 16.410 |
| 03/09 | R$ 15.010 |
| 04/09 | R$ 14.490 |
| 05/09 | R$ 13.890 |
| 06/09 | R$ 14.770 |
| 07/09 | R$ 17.010 |
| 08/09 | R$ 17.500 |
| 09/09 | R$ 16.770 |
| 10/09 | R$ 16.120 |
| 11/09 | R$ 15.980 |
| 12/09 | R$ 14.290 |
| 13/09 | R$ 15.890 |
| 14/09 | R$ 17.510 |
| 15/09 | R$ 17.400 |
| 16/09 | R$ 17.340 |
| 17/09 | R$ 17.070 |
| 18/09 | R$ 15.380 |
| 19/09 | R$ 14.940 |
| 20/09 | R$ 15.840 |
| 21/09 | R$ 19.720 |
| 22/09 | R$ 19.020 |
| 23/09 | R$ 16.770 |
| 24/09 | R$ 17.330 |
| 25/09 | R$ 17.720 |
| 26/09 | R$ 15.510 |
| 27/09 | R$ 16.790 |
| 28/09 | R$ 19.650 |
| 29/09 | R$ 19.970 |
| 30/09 | R$ 19.080 |
- Quando usar
- Volume acumulado no tempo, uma série. Para comparar duas séries que não somam, linhas.
- Datas
- Em mono. Quando não cabem todas, o eixo pula de forma regular; a dica e a tabela trazem cada dia.
Rosca
Parte de um todo, para leitura de relance. A legenda ao lado leva o valor e a participação; o centro, o total. Para comparar fatias próximas, barras.
Seis fatias
data-tipo="rosca" · .rq-grafico__legenda--valores| Forma de pagamento | Pedidos |
|---|---|
| Pix | 1.579 |
| Cartão de crédito | 1.308 |
| Boleto | 345 |
| Cartão de débito | 269 |
| Carteira digital | 231 |
| Outros | 128 |
- Quando usar
- Participação com uma fatia claramente maior. A partir da sétima linha, o módulo junta o resto em "Outros".
- Número de fatias
- O anel fecha: a última fatia encosta na primeira. Com seis, o par laranja e verde passa no validador de cores; com três, quatro ou cinco, o par que fecha o anel fica parecido demais. Nesses casos, barra empilhada.
Engenharia: execuções de agente
A telemetria dos agentes de IA nas mesmas peças: indicadores, latência por semana e consumo de tokens por tarefa. Em latência e em tokens, cair é bom.
Indicadores da semana
.rq-kpis · data-sentido · .rq-kpi__unidadeExecuções
7 dias
12.906
+14% sobre a semana anterior
Nas últimas 8 semanas, as execuções subiram todas as semanas, de 8.240 para 12.906.
Taxa de sucesso
7 dias
98,1%
+0,6 p.p. melhor que a semana anterior
Nas últimas 8 semanas, a taxa de sucesso foi de 96,2% para 98,1%.
Latência p95
7 dias
2.140 ms
−180 ms melhor que a semana anterior
Nas últimas 8 semanas, a latência p95 caiu de 2.780 ms para 2.140 ms.
Tokens por tarefa
7 dias
17,1 mil
+6% pior que a semana anterior
Nas últimas 8 semanas, os tokens por tarefa subiram de 15,0 mil para 17,1 mil.
Dados de exemplo.
Latência por semana
data-tipo="linhas" · data-unidade="ms"| Semana | p50 | p95 |
|---|---|---|
| S34 | 910 | 2.780 |
| S35 | 880 | 2.650 |
| S36 | 905 | 2.720 |
| S37 | 860 | 2.540 |
| S38 | 840 | 2.460 |
| S39 | 820 | 2.390 |
| S40 | 805 | 2.320 |
| S41 | 790 | 2.140 |
Tokens por tarefa
data-tipo="area" · várias séries empilham| Semana | Entrada | Entrada em cache | Saída |
|---|---|---|---|
| S34 | 7.100 | 4.900 | 3.000 |
| S35 | 6.900 | 5.300 | 2.950 |
| S36 | 6.800 | 5.700 | 2.900 |
| S37 | 6.700 | 6.100 | 2.900 |
| S38 | 6.500 | 6.500 | 2.850 |
| S39 | 6.400 | 6.800 | 2.900 |
| S40 | 6.200 | 7.100 | 2.870 |
| S41 | 6.300 | 7.700 | 3.140 |
- Quando usar
- Indicadores para o estado da semana; linhas para ver se a latência anda; área empilhada quando as partes somam o total que custa.
- Unidade
data-unidadeentra na dica e nos rótulos; o eixo fica limpo e o título diz a unidade.
Tabela
Quando há mais de seis classes, ou quando a pessoa precisa do número exato, a tabela é a resposta. Números à direita em mono, cabeçalho fixo ao rolar, ordenação pelo cabeçalho. Use o seletor de densidade da barra para ver a compacta.
Ordenável, com cabeçalho fixo
.rq-tabela-rolagem · .rq-tabela · __num · __nota · data-ordenar · aria-sort · data-rq="tabela"| Fluxo | Execuções | Sucesso | Latência p95 | Tokens por tarefa | Estado |
|---|---|---|---|---|---|
| Atendimento ao cliente | 4.312 | 98,6% | 1.840 ms | 9.200 | Estável |
| Triagem de pedidos | 2.876 | 99,2% | 1.120 ms | 6.400 | Estável |
| Descrição de produto | 1.954 | 97,1% | 3.260 ms | 21.800 | Estável |
| Relatório diário de metas | 1.204 | 99,5% | 4.820 ms | 34.600 | Estável |
| Segmentação de CRM | 986 | 96,4% | 2.910 ms | 27.300 | Atenção |
| Criativos de anúncio | 742 | 94,8% | 6.140 ms | 41.900 | Atenção |
| Conciliação de estoque | 512 | 99,8% | 860 ms | 4.100 | Estável |
| Revisão de código | 320 | 92,5% | 8.420 ms | 58.700 | Instável |
- Quando usar
- Comparação exata, muitas linhas ou muitas classes. Todo gráfico já traz a sua tabela; esta é a tabela que vale sozinha.
- Acessibilidade
- O cabeçalho ordenável vira botão; a coluna ordenada leva
aria-sorte a nova ordem é anunciada. A área de rolagem é uma região com nome e entra no Tab, para rolar pelo teclado. Estado com ponto e palavra, nunca só cor. - Ordem
- Número ordena primeiro do maior para o menor; texto, de A a Z. O segundo clique inverte. Célula vazia ou só com traço vai para o fim, nos dois sentidos.