Símbolos
A biblioteca de Símbolos: as onze bibliotecas do sistema e Meus símbolos, a busca e os filtros da galeria, o inspetor com as entradas ao vivo e os terminais, o editor Novo símbolo de usuário e cada tipo de slot, o Importar símbolo…, o Exportar pacote, o Duplicar, o Copiar instrução de chat, e onde um símbolo é usado.
Símbolos é a quarta categoria sob a raiz Ativos: a arte que um componente Símbolo de dashboard desenha e anima. O painel tem o título "Símbolos", com a frase "Bibliotecas feitas sob medida para dashboards modernos, bancadas de ensaio, produtos conectados, diagramas normativos, sistemas industriais e instalações. Todo símbolo do sistema é inspecionável e pode ser duplicado para Meus símbolos." e a pílula de contagem. Ler e inspecionar exigem Ver a lógica; criar, importar, duplicar, editar e excluir exigem Configurar a lógica. O formato de arquivo em que um símbolo viaja está descrito em Símbolos SVG portáteis.
As bibliotecas
| Biblioteca | O que contém | Norma | Símbolos |
|---|---|---|---|
| Process | Arte em camadas de equipamento de processo, para dashboards de supervisão e diagramas de processo | 86 | |
| ISA / P&ID | Arte esquemática de processo, tubulação, válvulas e instrumentação | ANSI/ISA-5.1 / ISO 10628 | 99 |
| Manufatura e fluxo de materiais | Equipamento de manufatura discreta, montagem, batelada, embalagem, inspeção e intralogística | 48 | |
| Laboratório e bancada de ensaio | Símbolos de laboratório, aquisição de dados, metrologia, fixação de peça sob teste, câmara ambiental e inspeção da qualidade | 35 | |
| Eletrônica de prototipagem | Controladores, placas de desenvolvimento, conectores, módulos de sensor, atuadores, energia e sem fio | 35 | |
| Sensores IoT de campo | Símbolos ambientais, de condição, de posição, de medição, de gateway sem fio e de controle na borda | 36 | |
| Casa e prédio inteligentes | Iluminação, conforto, acesso, segurança, eletrodomésticos, água e dispositivos de controle interoperáveis | Matter / BACnet / notação comum de automação predial | 39 |
| TI, rede e datacenter | Computação, racks, armazenamento, redes, segurança, plataformas de nuvem, energia e refrigeração da instalação | Notação comum de infraestrutura de TI / SNMP / Redfish | 35 |
| Elétrica e energia | Unifilares, distribuição de energia, conversão, medição e renováveis, com estados de contato baseados na geometria | IEC 60617 / IEEE 315 | 39 |
| Energia, microrredes e mobilidade elétrica | Geração distribuída, conversão, armazenamento, medição, proteção, microrredes e recarga de veículos elétricos | Notação de dashboard orientada a IEC / IEEE / OCPP | 40 |
| Instalações e utilidades | HVAC, água e efluentes, sistemas de segurança, utilidades de planta e infraestrutura de controle | 38 | |
| Meus símbolos | Os símbolos que você compõe, importa ou duplica | Seus |
As bibliotecas do sistema são arte original do Ganter Lab, compilada dentro do produto e somente leitura: uma atualização as substitui sem tocar nos dados da sua estação. Cada definição carrega uma referência estável system:<key>, a biblioteca e a categoria dela, uma descrição, etiquetas de busca, a norma aplicável e metadados de origem e de licença.
A galeria
Acima dos cartões: Buscar (texto de exemplo "Nome, categoria ou tag"; casa o nome, a descrição, a categoria, a norma e as etiquetas do símbolo, sem diferenciar maiúsculas de minúsculas; a biblioteca é escolhida no filtro próprio dela), Biblioteca ("Todas as bibliotecas (530)" ou uma biblioteca com a contagem dela; escolher uma limpa a categoria e mostra a descrição da biblioteca abaixo dos filtros), Categoria ("Todas as categorias" ou uma categoria da biblioteca escolhida), Origem e Por página. Um cartão mostra a biblioteca, uma prévia na proporção natural da arte, o nome, a categoria, a origem (Sistema ou Meus) e uma linha de capacidade: "Estático", "1 entrada" ou "N entradas", seguida de "· N terminal(is)" quando o símbolo declara terminais de ligação. Um resultado vazio diz "Nenhum símbolo casa com estes filtros." com Limpar filtros. Quando os seus próprios símbolos não puderam ser lidos, uma nota diz "Meus símbolos está indisponível agora. Só as bibliotecas do sistema estão listadas.", em vez de passar o pacote do sistema por catálogo inteiro.
O inspetor
Selecionar um cartão abre o inspetor ao lado da galeria:
- O nome e um distintivo: Sistema · somente leitura, Meu símbolo, ou Rascunho não salvo enquanto o editor está aberto.
- A biblioteca, a categoria e a norma; a descrição.
- Área ocupada (o tamanho sugerido no dashboard, em células, largura × altura) e Ajuste (Conter, Esticar, Esticar em X ou Esticar em Y).
- "N entradas · N terminais de ligação", ou "apenas visual" quando não há terminais.
- Procedência da arte, um revelador com a origem e, num símbolo do sistema, a licença.
- As ações: Exportar pacote para todo papel; num símbolo do sistema, Duplicar para Meus símbolos; nos seus, Editar e Excluir (só papéis que configuram).
- O palco de prévia: a arte higienizada, desenhada pelo mesmo runtime de um dashboard, com uma alça desenhada no ancoradouro de cada terminal. Uma arte que não consegue ser desenhada deixa o palco vazio com "Prévia indisponível" e o motivo. Quando o higienizador precisou reparar a marcação, um revelador "A prévia usa SVG higienizado" lista os reparos (oito no máximo, e então "Mais N reparos não são mostrados.").
- Entradas: "Constantes transitórias afetam apenas esta prévia." e Redefinir entradas. Uma seção por slot declarado, com o nome dele, o efeito que ele conduz, uma frase descrevendo o mapeamento, a faixa de entrada e o elemento alvo (
#id), e um controle para experimentar: um número (com um controle deslizante quando a faixa de entrada é finita), um interruptor Ligado/Desligado, uma caixa de texto, ou um seletor de cor com uma caixa de valor de pintura. "Este símbolo não declara entradas dinâmicas." quando não há nenhuma; uma declaração inválida mostra o erro dela em vez de um controle. As constantes que você define aqui nunca são salvas e nunca chegam a um dashboard.
Os efeitos e como o inspetor os descreve:
| Tipo (rótulo do editor) | Efeito | Controle | Descrição |
|---|---|---|---|
| Rotacionar | Rotação | Número | Rotaciona de <output min>° a <output max>° |
| Opacidade | Opacidade | Número | Muda a opacidade de <output min> para <output max> |
| Preenchimento | Estado do preenchimento | Interruptor | Troca o preenchimento da cor de desligado para a de ligado; origens numéricas trocam no ponto médio da entrada |
| Visível | Visibilidade | Interruptor | Esconde o elemento quando desligado e o mostra quando ligado |
| Texto | Texto exibido | Texto | Substitui o texto exibido dentro do elemento |
| Transladar | Posição | Número | Move de (x, y) para (x, y) em unidades SVG |
| Escalar | Escala | Número | Escala de (x, y) para (x, y) |
| Traço | Estado do contorno | Interruptor | Troca o contorno entre as cores de desligado e de ligado; origens numéricas trocam no ponto médio |
| Giro (°/s) | Velocidade de giro | Número | Gira continuamente de <min>°/s a <max>°/s; zero pausa e valores negativos invertem o sentido |
| Giro ligado | Estado do giro | Interruptor, ligado por padrão | Pausa ou retoma a rotação sem esconder o elemento nem zerar o ângulo dele |
| Cor de preenchimento | Cor de preenchimento | Cor | Define o preenchimento diretamente, a partir de um ativo de Cor, de uma variável de Cor ou de uma cor literal |
| Cor de traço | Cor do contorno | Cor | Define o contorno diretamente, a partir de um ativo de Cor, de uma variável de Cor ou de uma cor literal |
| Largura do traço | Largura do contorno | Número | Define a largura do contorno diretamente, de 0,5 a 32 unidades SVG |
Novo símbolo de usuário
O verbo sobre a linha Símbolos abre o editor na coluna da galeria ("Novo símbolo de usuário": "Componha SVG inerte e os slots de entrada de Dashboard nomeados dele."); o inspetor acompanha o rascunho não salvo enquanto você digita, então você testa o símbolo antes de criá-lo.
| Campo | O que é | Valores / padrão | Efeito |
|---|---|---|---|
| Nome | O nome de exibição. | Obrigatório; "Um nome é obrigatório." enquanto está vazio. | Diferente de um ícone ou de uma cor, o nome de um símbolo pode mudar depois: os dashboards o referenciam pelo id. |
| Marcação SVG | A arte, colada como texto. | Obrigatória. | Higienizada enquanto você digita; um erro de arte ("A marcação SVG precisa ter uma raiz <svg>.", "A marcação SVG passa do limite de 512 KB.", um id duplicado…) bloqueia a criação e todos os slots. |
| Ajuste | Como a arte preenche a célula do dashboard. | Conter (padrão), Esticar nos dois, Esticar em X, Esticar em Y. | Lido pelo editor de dashboard quando o símbolo é colocado. |
| Largura inicial, Altura inicial | A área ocupada com que uma instância nova de dashboard começa. | De 1 a 24 células, de 1 a 12 células; 4 × 4 por padrão. | O mesmo. |
| Terminais de ligação | Uma nota somente leitura. | "Esta arte é apenas visual. Terminais tipados podem vir de um pacote Ganter Symbol v2." ou "N terminal(is) autorado(s) no pacote são preservados. A geometria dos terminais é intencionalmente somente leitura no Ganter Lab." | Terminais não podem ser desenhados nem editados aqui: eles vêm de um pacote importado ou de um símbolo do sistema duplicado, e editar os mantém como estão. |
| Slots | As entradas que o símbolo expõe ("Cada slot mira o id de um elemento SVG e expõe uma primitiva de runtime segura."). | O Adicionar slot acrescenta uma linha sob um nome gerado (param, depois numerado). |
Cada linha: um nome, um id de elemento (uma lista com os ids achados na marcação, ou qualquer id que você digitar), Remover, o tipo, Entrada mín. e máx., Saída mín. e máx. (o eixo X em Transladar e Escalar), um par opcional de Y mín. e máx., e, por tipo: em Largura do traço, a nota "O valor do Dashboard é uma largura SVG direta, de 0,5 a 32."; em Cor de preenchimento e Cor de traço, uma Cor de prévia; em todo outro tipo, uma cor de Ligado e uma cor de Desligado. |
Regras de slot, cada uma relatada abaixo dos campos, com a linha problemática contornada: o nome precisa ser um identificador (uma letra ou _ primeiro, depois letras, dígitos, _, ., : ou -) e ser único; o id do elemento precisa existir na marcação; o Texto mira apenas text e tspan; o Preenchimento e a Cor de preenchimento miram formas que podem ser preenchidas, grupos, use e texto; os outros tipos miram grupos, use, formas e texto; Rotacionar, Giro e Escalar precisam que o elemento carregue data-ganter-pivot="x y"; todo valor de faixa precisa ser finito; o par de Y é ou os dois ou nenhum, e só em Transladar e Escalar; as cores de ligado e de desligado precisam ser um hexadecimal, um símbolo de tema como var(--color-success) ou um nome de cor do CSS; um elemento aceita no máximo um slot por canal (preenchimento, traço, largura do traço, ou um por cada outro tipo); um slot de Giro ligado precisa de um slot de Giro no mesmo elemento.
O Criar símbolo continua esmaecido enquanto qualquer erro estiver de pé; o Cancelar ou o Voltar sai sem criar. Quando dá certo, o feed diz "Símbolo criado." e o cartão novo fica selecionado.
Editar, Duplicar, Excluir
O Editar (só nos seus símbolos) abre o mesmo editor com "Alterações válidas de nome, SVG e slots salvam sozinhas.": uma mudança válida é salva meio segundo depois da última edição ("Símbolo salvo."), e um rascunho inválido não é salvo e cancela qualquer salvamento pendente, então o símbolo guardado nunca diverge do que o inspetor mostra. O Duplicar para Meus símbolos (símbolos do sistema) copia a arte, a caixa de visão, o ajuste, a área ocupada, as configurações de tipo, os terminais e as sugestões para um símbolo independente chamado "cópia de <Name>" ("cópia 2 de <Name>"… enquanto o nome estiver ocupado) e o abre para edição ("Símbolo do sistema copiado para Meus símbolos."); a definição do sistema nunca é alterada. O Excluir pergunta "Excluir 'X'? Os dashboards que o usam vão mostrar um marcador de lugar. Isso não pode ser desfeito." ("Símbolo excluído.").
Importar símbolo…
O segundo verbo sobre a linha é um seletor de arquivo que aceita arquivos .svg e .ganter-symbol.json de no máximo 1 MB ("O arquivo de símbolo é maior que o limite de 1 MB."). O conteúdo decide o caminho:
- SVG cru (o conteúdo começa com
<) é importado como arte apenas visual: sem slots e sem terminais. O higienizador o repara e o feed conta os reparos ("Símbolo importado como um ativo novo; 3 item(ns) SVG inseguro(s) foram removidos."). O nome é o nome do arquivo sem a extensão. - Um pacote Ganter symbol v2 (o conteúdo começa com
{) é importado inteiro: nome, SVG, caixa de visão, ajuste, área ocupada, slots, configurações de tipo, terminais e sugestões. Um pacote é estrito: o formato, a versão e o esquema precisam bater, o SVG já precisa estar higienizado (um pacote que precise de reparos é recusado, não reparado), a caixa de visão precisa bater com a raiz do SVG, e todo terminal, configuração e sugestão precisa ser válido (o contrato). O feed nomeia o primeiro problema ("A importação do símbolo falhou: …").
Um nome já usado por um dos seus símbolos recebe sufixo (" 2", " 3"…). Toda importação cria um símbolo novo e nunca sobrescreve um.
Exportar pacote
O Exportar pacote do inspetor baixa o símbolo selecionado, do sistema ou seu, como <name>.ganter-symbol.json: o mesmo pacote v2 que a importação lê, sem nenhuma identidade de estação, para que ele viaje entre estações ("<file> exportado."). Um símbolo cuja arte não tem caixa de visão na raiz, ou um dos cujos slots carrega um endereço de estação, é recusado ("A exportação do símbolo falhou: …").
Copiar instrução de chat
O Copiar instrução de chat copia para a área de transferência uma instrução autossuficiente para um chat de IA externo, que não tem acesso à estação. Ela abre com "Crie um símbolo do Ganter Lab para mim. Devolva SOMENTE o conteúdo do arquivo, seja SVG cru, seja um único pacote .ganter-symbol.json v2, sem comentário nenhum, para que eu possa salvá-lo como arquivo e importá-lo sem alteração.", continua com o contrato v2 completo (as duas entradas aceitas, o envelope do pacote, os dezesseis ancoradouros globais, os oito tipos de ligação, os tipos de slot e as regras deles, os símbolos de tema, as regras de geometria de terminal, os limites do higienizador e um pacote válido mínimo), e termina com como trazer a resposta de volta: salve a resposta como um arquivo .svg ou .ganter-symbol.json e importe-o aqui. O mesmo contrato é o que as ferramentas symbol_validate e symbol_import do agente leem, então um chat e um agente produzem o mesmo arquivo. O feed diz "Instrução de chat copiada. Cole-a em qualquer chat de IA e importe o SVG que ele devolver." (ou "A área de transferência recusou a cópia."). O verbo é desenhado para todo papel, porque ele só lê.
Onde um símbolo é usado
O componente Símbolo de dashboard referencia um símbolo como system:<key> ou user:<id>, mapeia cada slot para um endereço da Logic, escolhe o tipo de ligação de qualquer terminal configurável, e une terminais com ligações desenhadas no editor de dashboard pelos tipos de ligação. Um símbolo não tem endereço próprio na Logic.
O que a biblioteca não faz
Ela não desenha nem move terminais e caminhos internos, não edita a arte do sistema no lugar, não importa um pacote que precisa de reparos, não guarda histórico de versões, e não compartilha sozinha os seus símbolos entre estações: exporte e importe o pacote.