Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

⬢ Identidade Visual — Iconografia

Os ícones do PAEBIRU não são meros adornos; são sinais funcionais que comunicam o estado metabólico, a escala fractal e a integridade das membranas do sistema.

Este documento detalha o uso de ícones, glifos e símbolos no ecossistema PAEBIRU, expandindo as diretrizes do Livro de Estilo.

1. Famílias de Ícones

A iconografia é dividida em três famílias funcionais. Cada uma possui uma geometria e um comportamento cromático específico, derivado da paleta Papiro Antropofágico.

1.1 Membrana (Bounded Contexts)

Representa as fronteiras de isolamento hexagonal e a permeabilidade seletiva.

  • Geometria: Quadrado ou hexágono com borda dupla.
  • Cor: --membrana (#1A6F5C).
  • Uso: Identificação de crates, módulos core e limites de domínio.

1.2 Fluxo (CausalBlock, Plasmídeo)

Representa o movimento de informação e valor através da malha.

  • Geometria: Seta orgânica com curvatura fractal ou espiral.
  • Cor: --correnteza (#3FA796).
  • Uso: Transmissão de mensagens, execução de plasmídeos e sincronização de dados.

1.3 Algedonia (Sensores de Dor/Prazer)

Representa a saúde do sistema e o feedback homeostático.

  • Geometria: Bulbo cromático ou círculo pulsante.
  • Comportamento:
    • Saudável: Cor --algedonia-prazer (#D4A017), pulso lento (1 Hz).
    • Crítico/Dor: Cor --algedonia-dor (#C0392B), pulso rápido (4 Hz).
  • Uso: Dashboards, status de nós e alertas de segurança (Veto Algedônico).

2. Glifos e Tipografia

Para interfaces de texto (CLI, TUI) e logs, utilizamos glifos da Iosevka Nerd Font.

2.1 Mapeamento Canônico

ConceitoNerd Font (Hex)Fallback UnicodeSignificado
Membrana\ueb12●Limite de Bounded Context
Fluxo (Correnteza)\uf0c1▶Fluxo de dados/CausalBlock
Algedonia-dor\uf071▲Alerta crítico / Saturação
Algedonia-prazer\uf00c▼Operação nominal / Sucesso
Manguezal\uf06a◆Quarentena / MacrophageVM
Oceano\uf1b3■Persistência Causal alta
Nascente\uf043○Ingestão hot-path
Plasmídeo\ue22b❖Contrato WASM
Receipt (Soberano)\uf02d◉Prova de interação
Veto Algedônico\uf05e✗Interrupção por hardware

3. Logomarca

A logomarca está disponível em diversos tamanhos no diretório docs/src/brand/icons/.

3.1 Variantes

  • 1024px: Master para impressos e alta resolução.
  • 256px / 512px: Dashboards e documentação.
  • 16px / 32px / 64px: Favicons e ícones de aplicação.

3.2 Regras de Aplicação

  1. Zona de Respiro: Mantenha um espaço livre ao redor da logo equivalente a 1x a altura do glifo central.
  2. Contraste: Utilize a variante escura sobre fundos claros (--ceu) e a variante clara sobre fundos escuros.
  3. Distorção: Nunca altere a proporção ou as cores originais da logo.

4. Fallback e Acessibilidade

Sempre que a interface não suportar glifos Nerd Font ou cores TrueColor:

  • Modo TTY/Serial: Use a coluna Fallback Unicode da tabela acima.
  • Acessibilidade: Não utilize apenas cores para transmitir estado. Combine o glifo específico com a cor (ex: Vermelho + ▲ para erro).
  • Contraste: Verifique o contraste WCAG AA entre o ícone e o fundo.

5. Como Adicionar Novos Ícones

  1. Defina a Função: O ícone pertence a uma das três famílias (§1)?
  2. Escolha o Glifo: Selecione um glifo Nerd Font que não conflite com os existentes.
  3. Documente o Fallback: Todo novo ícone DEVE ter um correspondente Unicode padrão.
  4. Atualize este Documento: Adicione a nova entrada na tabela de mapeamento (§2.1).

Veja também