Voz e tom
Como a TRDR escreve, dentro e fora do codigo. A voz e de engenharia e trading: tecnica, precisa, confiavel. Serio e exato, nunca decorativo. O Hub nao vende, ele documenta com a autoridade de quem e a fonte canonica.
Como a TRDR escreve
Cena que trava o registro (adaptada de trdr-design/skills/trdr-design/scripts/palette.mjs, sem travessao, para seguir a propria regra de escrita desta pagina): um terminal de operacoes financeiras as 3h da manha, fundo quase preto, dados densos em fonte monoespacada, cyan eletrico marcando o que e acionavel, verde e vermelho apenas para alta e baixa. Precisao de instrumento, zero decoracao.
O teste de qualidade nao e "pareceu feito por IA", e sim: um trader acostumado com as melhores ferramentas da categoria confiaria nesta tela, ou pararia em cada componente sutilmente errado? A falha do produto nao e ser piso, e ser estranho sem proposito: botao decorado demais, controle de formulario fora do padrao, animacao gratuita, fonte de destaque onde deveria ter um rotulo. A ferramenta deve desaparecer na tarefa.
Isso vale para todo texto de interface: microcopy tecnica, precisa, sem enfeite, sem familiaridade forcada. Nada de eyebrow, gradiente de texto ou marcador numerado 01/02/03 por reflexo. O Hub documenta com autoridade, nao convence com adjetivo.
Faca e nao faca
A coluna "Faca" usa strings reais, ja publicadas no codigo do Hub ou do @trdr/ui (fonte na ultima coluna). A coluna "Nao faca" e contraste ilustrativo, escrito para esta pagina, do que a mesma regra proibe: nao e microcopy real do produto.
| Contexto | Faca (real) | Nao faca (ilustrativo) | Fonte |
|---|---|---|---|
| Rotulo de estado (badge) | "novo" · "migrado" · "client" · "server safe" | "Novidade!!!" · "Componente Novo, muito irado" · "Compativel com o servidor, sim!" | apps/hub/src/app/componentes/page.tsx e [slug]/page.tsx |
| Confirmacao de acao | "Copiar" -> "Copiado" | "Clique aqui para copiar" -> "Copiado com sucesso, boa escolha!" | apps/hub/src/components/copy-button.tsx |
| Mensagem de sucesso | "Ordem executada" / "Sua ordem de compra foi concluida com sucesso." | "Sucesso! Sua ordem foi executada com perfeicao, parabens!" | packages/ui/src/alert/alert.demo.tsx |
| Mensagem de erro | "Falha ao conectar" / "Nao foi possivel sincronizar com a corretora." | "Ops! Alguma coisa deu errado por aqui. Tenta de novo, please!" | packages/ui/src/alert/alert.demo.tsx |
| Aviso de risco | "Margem proxima do limite" / "Revise suas posicoes para evitar liquidacao automatica." | "Cuidado! Sua margem ta quase estourando, fica ligado!" | packages/ui/src/alert/alert.demo.tsx |
Glossario de trading
Grafia recomendada para manter consistencia entre telas. "Long", "short" e "stop" ja aparecem nomeados assim nos tokens de contexto de trading do design system; os demais termos seguem a convencao do mercado brasileiro, nao um documento especifico da TRDR.
| Termo | Grafia correta | Evitar | Fonte |
|---|---|---|---|
| Boleta | boleta | "order ticket" | convencao do mercado brasileiro, nao especifica da TRDR |
| Ordem | ordem | "order" | convencao do mercado brasileiro, nao especifica da TRDR |
| Cotacao | cotacao | "quote" | convencao do mercado brasileiro, nao especifica da TRDR |
| Long | long (compra) | "comprado" isolado, sem o termo tecnico | packages/tokens/src/context/trading.tokens.json, grupo "Long (Compra)" |
| Short | short (venda) | "vendido" isolado, sem o termo tecnico | packages/tokens/src/context/trading.tokens.json, grupo "Short (Venda)" |
| Stop | stop ou stop loss | "parada" (traducao literal que o mercado nao usa) | packages/tokens/src/context/trading.tokens.json, grupo "Stop Loss" |
Mensagem de erro: boa vs ruim
A boa vem literal do alert.demo.tsx do @trdr/ui: e o que o produto realmente mostra hoje. A ruim e contraste ilustrativo, escrito para esta pagina, do que as regras acima proibem.
Regras fixas de escrita
- Nunca travessao (
—ou–). Use dois pontos, virgula ou parenteses. Esta e a mesma regra aplicada a esta propria pagina. - Nunca emoji. Icone de produto e Material Symbols Outlined, weight 300, pela classe
.mi(ver Assets e templates). - Nunca all caps no corpo do texto. Reserve maiusculas para rotulos curtos.
- Numero e sempre
font-mono: preco, quantidade, percentual, horario.