A janela

A moldura em volta de toda página: a barra de título com as teclas de tema e o chip de usuário, o trilho de navegação e o que mostra cada entrada, a barra de status e o feed de ações, a faixa de runtime parado, as notificações, o diálogo de consentimento de falha, as telas que uma conexão perdida mostra, a tela cheia e a área de notificação.

Toda página do Ganter Lab é desenhada dentro de uma moldura: uma barra de título, um trilho de navegação à esquerda, a página em si, e uma barra de status ao longo do rodapé. A moldura é a mesma em toda página e em toda tela que olha para a estação, tanto a janela da própria estação quanto um navegador na rede (veja Acesso remoto); os poucos pontos em que as duas diferem estão apontados abaixo. Ver a moldura não exige permissão nenhuma, mas várias entradas e marcas dela são desenhadas só para uma identidade que carrega a permissão correspondente, exatamente como as páginas por trás delas.

A moldura de relance

A janela abre com no mínimo 880 por 520 pixels e lembra onde você a deixou (posição, tamanho, maximizada) entre as aberturas; veja Primeira abertura.

Barra de título

A tecla de ajuda

Um ponto de interrogação à esquerda do grupo direito da barra de título, depois de um divisor fino que a separa das teclas de tema. Ela abre o painel de ajuda descrito em Ajuda contextual e fica marcada enquanto o painel está aberto. Ela é desenhada em toda rota, para toda identidade, e também enquanto o runtime está parado.

Teclas de tema

Três teclas lado a lado, nesta ordem, cada uma com uma dica que a nomeia:

A tecla em relevo é a preferência guardada, nunca a aparência em que ela resulta: Sistema continua marcada como Sistema enquanto parece Claro ou Escuro. Pressionar uma tecla a aplica ao vivo na tela que a pressionou e a salva como preferência da estação no banco de configuração; Configurações, Aparência mostra e muda os mesmos três valores. A preferência é da estação, não da tela: a janela da própria estação acompanha na hora uma mudança feita de um navegador, e outro navegador a recebe quando a página dele for carregada de novo.

O chip de usuário

À direita das teclas de tema, depois de um divisor fino, o chip nomeia quem está autenticado nesta tela: Entrar enquanto ninguém está, o nome de exibição depois que alguém entra. O ponto no glifo de pessoa é verde enquanto há alguém autenticado e cinza no resto do tempo. O chip é sempre desenhado, em toda rota e em toda tela, porque os papéis estão sempre em vigor e não estar autenticado é uma identidade em si (o papel "Não conectado").

Pressioná-lo abre o diálogo de entrada:

• O título diz Entrar, ou Trocar de usuário quando alguém já está autenticado e a lista está à mostra. Nesse caso uma linha de cabeçalho "Conectado como nome" carrega um botão Sair.
• A lista traz todo usuário local com uma sigla de duas letras, o nome e uma marca: um cadeado para um usuário com PIN (dica "PIN obrigatório"), uma seta para um usuário sem PIN (dica "Entra com um toque"), que entra no instante em que a linha é pressionada.
• Um usuário com PIN abre o passo do PIN: a sigla e o nome do usuário, Voltar, o rótulo "Digite o PIN" e um teclado que aceita de 4 a 6 dígitos. A tecla de confirmação ou o Enter envia.
• Uma recusa fica no teclado, ali mesmo: "Esse PIN não está correto.", ou "PINs errados demais. Tente de novo em n segundos/minutos." Cinco PINs errados seguidos fecham a porta por um minuto; cada nova sequência de cinco dobra a espera, até quinze minutos.
• Sem nenhum usuário local na estação ainda, o diálogo diz isso em vez de mostrar uma lista vazia: "Esta estação ainda não tem usuários locais. O primeiro, o administrador principal, é criado na página Usuários."

Na janela da própria estação o chip muda a sessão da estação, a identidade sob a qual todo comando daquela janela roda; num navegador ele autentica aquela conexão e nada mais. De um jeito ou de outro o desfecho também aparece no feed de ações da barra de status ("Conectado como Ana.", "Ana saiu.", "Entrada recusada. Ainda conectado como Ana."), porque quem está autenticado decide o que todo outro comando pode fazer. O fluxo inteiro está descrito em Entrar.

Trilho de navegação

O trilho tem 64 pixels de largura: um glifo e um rótulo por entrada, com a entrada ativa destacada. Cada entrada é desenhada só quando a identidade desta tela carrega ao menos uma das permissões listadas; as próprias páginas conferem de novo ao abrir, então o trilho só corta o que seria recusado de qualquer forma. As permissões são as chaves do editor de papéis; veja Permissões.

Sem ninguém autenticado, quem decide é o papel "Não conectado". As permissões de fábrica dele têm tudo menos Gerenciar usuários locais e Acesso remoto (LAN), então uma estação nova desenha todas as entradas até um administrador estreitar esse papel em Papéis. Quando uma troca de papel remove a entrada da página em que você está, o shell leva você para a primeira entrada que ele ainda desenha.

Duas entradas carregam uma marca:

• Validação exibe uma pílula de atenção com o número de itens a reparar (99+ passando de noventa e nove), escondida enquanto a configuração está limpa. Ela acompanha a revarredura em segundo plano do validador, então muda conforme você edita; veja Validação.
• Conta exibe um ponto de exclamação só quando a licença precisa de atenção: âmbar quando a assinatura está em atraso, termina em até 14 dias, ou não tem data de término conhecida mesmo estando marcada para terminar; vermelho quando a assinatura foi cancelada, ou quando ela poderia conceder um posto e esta estação não tem nenhum. Pressionar a entrada marcada leva à seção da assinatura, e não ao topo da página; veja Assinatura. Não existe um ponto neutro de "conectado".

Barra de status

A barra se lê, da esquerda para a direita: o grupo de indicadores, o feed de ações no meio elástico, depois a marca de versão nova, a versão e o relógio. Ela se atualiza a cada segundo.

Os indicadores

O ponto de saúde segue as mesmas cores de todo ponto de estado do aplicativo: verde para saudável, âmbar para degradado ou iniciando, vermelho para em falha ou offline, cinza para neutro. O ícone da área de notificação lê a mesma saúde do servidor (abaixo).

O feed de ações

O meio da barra é o único lugar onde o resultado do que você acabou de fazer aparece: um salvamento, uma exclusão, uma renomeação, uma importação, uma impressão, uma varredura, um reconhecimento. Todo comando que muda estado relata os dois desfechos, quando funcionou e quando foi recusado.

• Um sucesso some sozinho depois de seis segundos. Uma falha mantém uma marca vermelha e fica até um resultado mais novo a substituir ou até você pressionar o Dispensar (x) dela.
• O texto é cortado com reticências contra o relógio; o texto inteiro é a dica.
• Uma entrada pode carregar um botão de continuação ao lado dela, por exemplo Desfazer depois de remover um componente de dashboard. Ele vive e morre com a entrada: a expiração da entrada, o resultado seguinte, um dispensar e o próprio toque levam o botão embora, para que a barra nunca ofereça um verbo que não responde mais pelo texto ao lado dele.
• O feed pertence à conexão: esta tela mostra os resultados do que esta tela fez, nunca o que um navegador em outro lugar fez. A janela da própria estação carrega além disso o trabalho que nenhuma tela pediu (um backup automático, um relatório gerado sozinho, uma falha do hospedeiro).
• A única exceção: um comando pressionado dentro de um componente de dashboard (um Botão, uma Chave, uma Entrada) responde sob aquele componente, a superfície que ainda existe quando um dashboard em tela cheia esconde esta barra.

As páginas nunca criam um "Salvo" piscando nem uma linha de estado própria; se você procura a resposta a um toque, ela está aqui.

A marca de versão nova, a versão e o relógio

• Uma versão nova à espera de ser adotada é uma linha discreta ao lado do relógio: "Versão 1.5.0 disponível", ou "Versão 1.5.0 · correções importantes" no tom de atenção quando a versão está marcada como portadora de correções importantes. A dica acrescenta se ela já foi baixada ("Ela já foi baixada e é instalada na próxima vez que o Ganter Lab reiniciar.") e para onde o toque leva: Configurações, Atualizações. A marca é desenhada só para uma identidade que carrega Alterar configurações ou Editar dashboards, para que um operador num tablet remoto nunca veja uma decisão que não é dele, e nunca numa compilação sem canal de atualização.
• A versão que está rodando agora, no mesmo tom discreto (dica "Configurações: Sobre"); Sobre mostra o mesmo número.
• O relógio: a data e a hora locais nos formatos escolhidos em Configurações, Idioma e formatos (por exemplo dd/MM/yyyy HH:mm:ss), avançando a cada segundo. A dica diz "Configurações: Idioma e formatos", que é a seção em que esses formatos são definidos.

Enquanto o runtime está parado

A saúde, os alarmes e as gravações não podem ser afirmados enquanto nada está sendo lido, então o grupo de indicadores dá lugar a uma mensagem que leva a algum lugar útil: "Entre para ampliar a janela gratuita" ou "Adicione uma licença para remover o limite" (as duas abrem a página da conta), ou, sem mais nada a comprar, "Reinicie o runtime para continuar" na janela da estação e "O reinício acontece na estação, o computador que roda o Ganter Lab." num navegador. A contagem continua primeiro, à esquerda, dizendo "Gratuito · runtime parado".

A faixa de runtime parado e a página pausada

Quando a janela do modo gratuito acaba, o runtime para (veja Modo gratuito e a licença), e o shell diz isso uma vez, do mesmo jeito em toda rota e em toda tela:

• Uma faixa sob a barra de título: Runtime parado, "A aquisição, a Logic e a gravação estão pausadas. Sua configuração e as execuções gravadas estão intactas.", e o único botão Reiniciar o runtime. O botão só existe na janela da própria estação: um navegador lê "O reinício acontece na estação, o computador que roda o Ganter Lab." no lugar dele, para que uma janela de modo gratuito nunca possa ser zerada pela rede.
• Toda página menos a da conta dá lugar a um aviso de pausa: Esta tela está pausada, "Ela lê a estação ao vivo, e nada está sendo lido enquanto o runtime está parado. Ela espera aqui em vez de mostrar valores que não são mais verdadeiros.", e depois "Reiniciar é imediato e sem limite. O runtime volta no momento em que você pedir." na estação e "O operador da estação pode reiniciá-lo a qualquer momento, sem limite. Esta tela volta sozinha." em outro lugar. A conta mantém a página dela, porque entrar ou adicionar uma licença é o que tira o limite.
• Um dashboard em tela cheia sai dela, para que a faixa e o trilho fiquem à vista.
• Todo comando que mudaria a estação é recusado com as mesmas duas palavras, "Runtime parado": nas barras de ferramentas, nos menus, nos botões das tarjas (esmaecidos com essa dica) e no endpoint de agente.

Um reinício que falha levanta uma notificação de atenção, "Falha ao reiniciar o runtime: o runtime não pôde ser reiniciado por completo. Consulte Eventos e tente de novo.", e o botão fica para outra tentativa.

Ajuda contextual

A tecla de ajuda abre um painel à direita, ao lado da página e não sobre ela: a página continua funcionando, então a instrução pode ser executada na tela de que ela fala. Numa tela estreita (um telefone, ou um tablet na vertical) o painel toma a janela. O Escape o fecha, assim como a tecla de fechar dele, e o foco volta para a tecla de ajuda.

O que ele mostra é a página de documentação daquilo que está na sua frente. A rota é quem decide, então abrir o painel na Logic abre a página da Logic desta documentação; numa página lida como uma coluna longa (Configurações, Agente, Conta) quem decide é a seção até onde você rolou, então Configurações em Backups abre Backups. Ir para outra página, ou para outra seção da mesma, traz a página que pertence ao que está agora na tela, em vez de deixar o artigo anterior parado por cima.

O painel carrega o título da página, o resumo dela, a lista das seções e o texto inteiro. Os links para outras páginas da documentação e para seções abrem dentro do painel; um link que sai da documentação abre no seu navegador. A tecla Abrir a documentação completa do painel abre a mesma página no site, no mesmo idioma e para a versão que esta estação roda; é a única coisa aqui que precisa de rede.

A documentação é instalada junto com o aplicativo, não buscada: é a documentação da versão que você está rodando, no idioma da estação, e ela abre sem nenhuma conexão com a internet. Um navegador na rede lê as mesmas páginas a partir da estação, então uma tela no chão de fábrica nunca fica sem elas. Quando um pacote não traz ajuda para a versão em execução ou para o idioma da estação, o painel diz qual versão e qual idioma ele procurou, em vez de abrir outra coisa, e a mesma linha é escrita em Eventos, Console.

Notificações

Tarjas de notificação

Os avisos que interrompem se empilham no canto inferior direito sobre a página, o mais novo por cima. Cada cartão carrega um destaque colorido para a gravidade dele (Informação, Alerta, Erro), um título opcional, a mensagem, os botões de ação que houver e um Dispensar (x). Um cartão fica grudado a menos que quem o levantou tenha dado um tempo de vida a ele. Enquanto o runtime está parado, um botão de cartão que mudaria a estação fica esmaecido com a dica "Runtime parado".

O que os levanta, entre outras coisas:

As tarjas são para o que interrompe; o resultado da sua própria ação nunca é um cartão (veja o feed de ações acima).

Notificações do Windows

Os cartões vivem dentro da janela, então, enquanto a janela está escondida na área de notificação ou minimizada, os mesmos momentos também levantam uma notificação do Windows: a ativação de um alarme ("Alarme de prioridade prioridade: nome"), o disparo de um intertravamento, o aviso e a parada do modo gratuito, uma falha de servidor ou de restauração numa partida escondida, e a dica única na primeira vez que a janela some. Clicar na notificação abre a janela, onde o cartão está esperando. Essas notificações só existem numa compilação instalada; uma cópia portátil ou de desenvolvimento fica só com os cartões de dentro da janela.

O diálogo de consentimento de falha

Se o Ganter Lab fechou de forma inesperada, a próxima partida que mostra a janela abre Enviar o relatório de falha? sobre a página (uma partida escondida na área de notificação espera pela próxima visível):

• "O Ganter Lab fechou de forma inesperada na última vez. Enviar este relatório ajuda a corrigir o problema. Ele contém o erro e um trecho curto do diário recente. Revise o conteúdo abaixo antes de enviar."
• Detalhe da falha: a carga inteira que seria enviada, com um botão Copiar ("Copiado" por um instante). A carga é o momento da captura, o contexto, a versão do aplicativo, o sistema operacional, a exceção com a pilha dela, e as últimas 60 linhas do log, limpas do nome de usuário do Windows e do caminho do perfil. Nada além disso sai da estação.
• Enviar sempre os relatórios de falha automaticamente: opta por enviar falhas futuras sem perguntar (a mesma chave de Configurações, Relatórios de falha). Ela fica esmaecida com "Runtime parado" enquanto o runtime está parado, porque a opção não poderia ser salva.
• Não enviar apaga a falha capturada, para que ela não seja oferecida de novo. Enviar o relatório a envia; um envio que falha guarda a falha e pergunta de novo na próxima partida. O relatório é atribuído à sua conta Ganter quando a estação está autenticada, e aceito de forma anônima no resto do tempo.

A falha fica guardada como crash\pending-crash.json sob a pasta de dados até ser enviada ou recusada.

Quando a tela perde a estação

A página é servida pela estação ao vivo, então uma tela pode perdê-la: a conexão cai, a estação reinicia, a página encontra uma falha. Um navegador na rede encontra essas telas com mais frequência; a janela da própria estação é servida do mesmo jeito e também pode mostrá-las.

• A faixa do circuito. Uma página que falha dentro de uma tela em execução mostra uma faixa discreta no rodapé: "Esta página encontrou um problema, mas o aplicativo continua funcionando. Os detalhes estão na página Eventos.", com Recarregar e uma marca de dispensa. Nada se perde; recarregar reconecta.
• O cartão de reconexão toma a tela inteira enquanto a conexão está fora:

• A janela não pôde ser servida. A janela da própria estação é servida por uma porta dentro da máquina. Quando essa porta não pode ser aberta (quase sempre uma segunda cópia do Ganter Lab já rodando), a janela pinta um aviso próprio em vez de uma página em branco: O Ganter Lab não conseguiu abrir a tela dele, "O aplicativo está rodando e os seus dispositivos continuam sendo lidos. O que falta é a tela…", a porta, o que o sistema relatou e a pasta de logs. Ela tenta de novo a cada cinco segundos e abre sozinha assim que a porta ficar livre.
• Não encontrada. Um endereço que não casa com nenhuma página aparece dentro da moldura: Esta tela não faz parte desta estação, "Esse endereço não corresponde a nenhuma tela daqui. Ela pode ter sido renomeada ou removida.", com Ir para o View, que abre a página dos dashboards.
• Entre para ver. Um navegador na rede cuja identidade não tem Acesso remoto (LAN), ou qualquer tela cujo papel não abre a página pedida, recebe o cartão de entrada no lugar da página ("Entre para ver esta estação pela rede." ou "Entre para abrir esta página."), nomeando a identidade que foi recusada. Entrar desenha a página que foi pedida. A janela da própria estação e um navegador na máquina da estação nunca passam pelo portão de acesso remoto.

Tela cheia e Expandir

Um dashboard na View, e o painel ou a tela de uma unidade sob o Process, podem esconder a moldura de duas formas, ambas no agrupamento final da barra do dashboard:

Os dois verbos ficam esmaecidos enquanto nenhum dashboard está aberto e não são desenhados enquanto um dashboard está sendo editado: entrar num deles encerraria a edição sem avisar. Se a barra de status fica no rodapé em qualquer dos dois modos é uma configuração do próprio dashboard (veja Configurações do dashboard). Os modos são exclusivos: pressionar Tela cheia estando expandido eleva o modo, não o alterna.

Teclas: F11 alterna a tela cheia (e não faz nada enquanto você edita ou enquanto uma pasta está aberta); Esc sai, do mais interno para o mais externo: uma pasta em renomeação, depois a sobreposição de navegação, depois a tela cheia, depois o Expandir. Um navegador que sai da tela cheia por gesto próprio leva o modo junto. Sair da rota do dashboard devolve a moldura, e um runtime parado sai da tela cheia para que a faixa e o trilho voltem. A ferramenta Tela cheia de um gráfico preenche o monitor do mesmo jeito (veja Gráficos); o Esc fecha o gráfico primeiro. Mais em Tela cheia.

Zoom do Desktop

Na janela da própria estação, Ctrl + roda do mouse amplia a superfície inteira nos passos nativos do motor de navegador (cada passo multiplica por 1,2, entre 25 % e 500 %) e Ctrl + 0 volta para 100 %. Cada mudança é anunciada no feed de ações ("Zoom: 120%") e salva na hora, por instalação, em window-placement.json sob a pasta de dados (nunca no banco de configuração, nunca num backup). Configurações, Aparência mostra o nível atual e o zera. Um navegador mantém o zoom próprio dele.

A área de notificação

O Ganter Lab é sempre ativo: fechar a janela a esconde enquanto o servidor embutido, a aquisição e as gravações seguem trabalhando (a menos que "Continuar em segundo plano ao fechar" esteja desligada em Configurações, Inicialização, caso em que o X encerra). O ícone da área de notificação é o ladrilho da marca com um ponto de saúde que espelha o servidor embutido, a mesma leitura da saúde na barra de status: verde online, âmbar iniciando ou parcial, vermelho offline, cinza no resto. A dica dele diz "Ganter Lab: estado", com "(gravando)" acrescentado enquanto alguma execução grava (conferido a cada 15 segundos).

• Um clique esquerdo abre a janela; um clique direito abre o menu: Abrir o Ganter Lab, uma linha somente leitura "Servidor: estado (gravando)", e Sair. Não há controles de iniciar ou parar no menu: um clique perdido não pode derrubar os clientes que leem o servidor.
• Na primeira vez que a janela some, uma notificação do Windows diz "O Ganter Lab continua rodando: o servidor e as gravações seguem trabalhando daqui. Clique no ícone da área de notificação para abrir; clique com o botão direito para sair." Ela é mostrada uma vez, e só conta como mostrada depois de ter sido entregue.
• Sair para tudo por um encerramento só: o acesso de agente, o hospedeiro web, os monitores, o runtime de processo (as execuções continuam retomáveis), o servidor embutido, o runtime da lógica (os valores retidos são gravados), o diário de eventos e o hospedeiro. Enquanto uma gravação corre, a janela volta primeiro com uma confirmação calma, Há uma gravação em curso: "Sair interrompe a aquisição de dados. Tudo o que foi gravado até agora está salvo e reabre na próxima vez que você iniciar o Ganter Lab, mas nada novo é gravado enquanto o aplicativo estiver fechado." Continuar rodando é o padrão; Sair mesmo assim segue adiante. Uma atualização já baixada instala na saída.

O que a moldura não faz

• Ela nunca esconde a página de usuários de quem não é administrador; a página carrega o aviso próprio dela em vez disso.
• Ela nunca oferece o reinício do runtime em outro lugar que não a faixa, e nunca num navegador.
• Ela nunca mostra os resultados de ação de outra tela, e nunca transforma um resultado de ação num cartão.
• Ela nunca muda o tema de um navegador remoto até aquele navegador carregar a página de novo.
• O painel de ajuda nunca busca no site um artigo para mostrar, nunca abre uma página escrita para outra versão, e nunca recorre ao inglês para um idioma que a ajuda instalada não traz.
• A tecla de ajuda, as teclas de tema, o chip, o trilho e a barra de status são os únicos controles da moldura; todo verbo sobre uma coisa que você está configurando pertence à página daquela coisa (veja Como as páginas funcionam).