MonTal
Manual de uso

Portal de operações ambientais · Dataryon

Manual de uso — MonTal

Guia operacional para administradores, gerentes e técnicos

Versão 1.5  |  22 de setembro de 2026

montal.dataryon.com.br · Demonstração: demo@montal.dataryon.com

Vitrine: dataryon.com.br/#montal

Revisão v1.5: widget Clima após Inteligência de Risco (Open-Meteo, busca de estação/município BR); filtro De/Até nas Séries com histórico completo por defeito.

Revisão v1.4: menu Configuração (Parâmetros, Audit., Monitor); parâmetros modelo GCT; e-mail de boas-vindas; troca de senha no primeiro acesso; Inteligência de Risco (CEMADEN como base técnica).

Índice

  1. O que o MonTal é (e o que muda na operação)
  2. Identidade e cores
  3. Login, idioma e senha
  4. Guto e o botão ?
  5. Home, mosaico, foto e Evidence Drive
  6. Navegação, atalhos e grupos do drawer
  7. Gestão da rede (oito guias)
  8. Clima e previsão
  9. Organograma e foto de perfil
  10. Mapa de leituras
  11. Séries e importações
  12. Qualidade e QC
  13. Alertas
  14. Campo e ordens de serviço
  15. Rotina ponta a ponta recomendada
  16. Cadastros e CSV
  17. Relatórios
  18. Estação Escola e API
  19. Papéis e permissões
  20. Dicas e solução rápida

1. O que o MonTal é (e o que muda na operação)

O MonTal é o portal de operações ambientais da Dataryon. Ele não substitui o sensor nem o técnico — organiza o caminho entre os dois:

Ver → Confiar → Agir → Provar. Você enxerga a rede, valida o dado, aciona o campo e guarda a evidência — na mesma plataforma.

Antes (fragmentado)Com MonTal
Gráfico em um portal, OS em outro, prova no e-mailSéries, QC, alerta, OS e Drive no mesmo fluxo
“Parece estranho” sem donoAlerta AL-… e, se crítico, OS automática
Exportação soltaCSV e relatórios recuperáveis pelo Evidence Drive
Ajuda só em PDFManual no botão ?, menu Ajuda e Guto

Use este manual como referência operacional. Para posicionamento comercial e escopo técnico, consulte os documentos v1.2 na raiz do projeto. Dúvidas pontuais: botão ? (este documento) e o Guto (manuais curtos em Doc/manuais).

2. Identidade e cores MonTal

A interface inspira-se no iCloud: superfícies translúcidas, cartões em vidro, azul #0071e3 e animação de abertura com a letra M em órbita. A identidade reforça clareza e foco operacional — não distração.

ElementoAmostraReferênciaUso
Azul principal#0071e3Ações, links e estados ativos
Azul luminoso#2997ffGradientes e destaques
Superfície#f8fafcPlanos de fundo e cartões

3. Login, idioma e senha

  1. Acesse https://montal.dataryon.com.br.
  2. Informe e-mail e senha. Novos colaboradores recebem e-mail de boas-vindas de montal@dataryon.com.br com senha inicial 123456 (quando SMTP Titan estiver configurado).
  3. No primeiro acesso, o sistema obriga a troca de senha em /conta/senha — a inicial não pode ser reutilizada (mínimo 8 caracteres).
  4. Escolha pt_BR, en ou es pelas bandeiras. O cookie e, se autenticado, o perfil gravam a preferência.
  5. Aceite os termos quando solicitado.
  6. Administradores: menu Configuração → Parâmetros do sistema, Audit. e Monitor (modelo GCT; parâmetros valem na hora).
Segurança: não compartilhe credenciais nem tokens de estação. Em equipamentos partilhados, encerre a sessão. Há logout por inactividade (configurável).

4. Guto e o botão ?

O Guto apresenta um tour contextual pelas telas e responde perguntas com trechos dos manuais internos. O chat é extrativo: procura no conteúdo publicado e não usa modelo de linguagem generativo.

5. Home, mosaico, foto e Evidence Drive

A Home é o posto de comando. O mosaico operacional resume a rede; o filtro de estação reduz todos os cartões ao ativo de interesse. Tiles de variáveis podem exibir sparkline — um olhar rápido antes de abrir Séries.

5.0 Cartão de perfil

À esquerda: nome, e-mail, organização e cargo. O avatar mostra a foto do perfil (PNG, JPG, WebP ou GIF até 2 MB) ou a inicial. Use Alterar foto no próprio cartão. Há atalho para o organograma e para Alterar senha.

5.1 Leitura do mosaico

BlocoComo usarPróximo passo típico
Estações e redeDisponibilidade, atualização, estação selecionadaMapa ou cadastro da estação
QualidadeFlags de faixa, spike, frozen, gap, atrasoMódulo Qualidade + evidência
Alertas e CampoEventos pendentes e OSTratar alerta ou executar OS
SériesJanela recente ou visão diáriaFiltrar, exportar ou sync AgroClima

5.2 Evidence Drive — a memória da decisão

O Drive reúne links reais (não uma pasta morta) para:

Antes de compartilhar uma evidência em reunião ou auditoria, abra o link e confirme estação, variável, período e estado da OS ou alerta. O Drive existe para provar — não para acumular atalhos cegos.

6. Navegação, atalhos e grupos do drawer

Ao lado da marca MonTal ficam dois atalhos do mesmo tamanho: Operação (Home) e Gestão (dashboard analítico). O clique abre a tela direto, sem passar pelo menu. A guia activa fica destacada.

O ☰ à esquerda abre o menu lateral. A composição varia conforme o papel.

GrupoDestinos típicos
OperaçãoHome, Mapa, Estações, Séries, Qualidade, Rede viva, Alertas, Campo/OS, Estação Escola
GestãoDashboard, Inteligência de Risco, Clima
CadastrosHub, organizações, estações, variáveis, sensores, regras, OS, colaboradores, organograma, CSV (gerente+)
RelatóriosHub, OS, estações, rede e colaboradores — impressão/PDF
ConfiguraçãoSó admin: Parâmetros, Audit., Monitor
Ajuda e contaManual (?), idioma, tema claro/escuro, senha e saída

Na barra superior, o trio típico de ações é: personalizar (··· na Home), manual (?) e sair (→). O ☰ do menu não deve ser confundido com o atalho do manual.

7. Gestão da rede (oito guias)

A Gestão (/gestao) é a visão gerencial: qualidade, cobertura, alertas, OS e séries no recorte escolhido. O filtro fica acima; as páginas de visuais ficam abaixo. Todo gráfico, tabela e o mapa usam o mesmo recorte (período, UF, domínio, série e estação).

7.1 Filtros

O sistema compara o recorte com o período imediatamente anterior (mesmo número de dias) nos cartões de QC, observações e alertas.

7.2 Guias (paginação por tema)

Use as pílulas ou as setas ‹ ›. São oito telas, no espírito das guias do GCT, com temas ambientais:

GuiaO que mostraPara que serve
Visão geralGráfico umidade × chuva no topo; oito cartões iguais; sparkline de volume diárioVer chuva/umidade e o pulso do recorte sem mudar de guia
MapaLeaflet da área filtrada; cor = status; raio do marcador cresce com o atraso de ingestãoVer território e latência no mesmo mapa — o que painéis de fabricante raramente juntam
PulsoCompletude por estação (recebido vs intervalo cadastrado), faixas de pontualidade (SLA), mapa de calor estação×tempo, radar de saúde, mistura de atrasoDetectar falha silenciosa e dias mudos (calendário de QC)
QualidadeRosca válidas vs rejeitadas, QC por região, lista de eventos QCConfiar no dado antes de decidir
CicloUmidade do solo × chuva (hietograma invertido e perfil SMS), hidrograma, chuva acumulada, ciclo das 24 h, volume por dia da semanaComo a água entra no solo e quando a rede fala
GráficosBarras de volume, região, domínio, série, QC, severidade, OS e statusComparar fatias do recorte
RecortesTabelas por UF, domínio, série (mín/média/máx) e ranking de estaçõesGovernança e export mental para reunião
OperaçãoAlertas, OS e eventos QC recentes do recortePassar da análise para a acção
Por que isto existe: redes hidrometeorológicas (Synoptic, NWP SAF, dashboards de QC) pedem completude, atraso e calor temporal. O MonTal coloca isso no mesmo recorte da estação, com mapa e ciclo hidrológico — sem exigir outro produto.

7.3 Cartões (etiquetas)

Os oito KPIs têm a mesma altura e largura. Filtros (incluindo Aplicar/Cancelar) também são proporcionais. Os textos dos visuais seguem o idioma da bandeira.

8. Clima e previsão

Em Gestão → Clima (/clima), após Inteligência de Risco, o portal mostra um widget de previsão (temperatura actual, alerta operacional, próximas horas e cinco dias). Digite o código da estação MonTal ou qualquer município do Brasil; as sugestões vêm de estações/organizações cadastradas e do geocoding Open-Meteo (BR). Fonte operacional — não substitui CEMADEN/INMET. Manual curto: Doc/manuais/Manual_Clima.html.

9. Organograma e foto de perfil

Como no GCT, a equipe tem hierarquia visual.

10. Mapa de leituras

O Mapa usa Leaflet para posicionar estações e apresentar estado (marcadores por status). Clique no marcador para resumo e atalhos.

  1. Ajuste zoom até a área desejada.
  2. Selecione um marcador: confira nome, código e atualização.
  3. Siga para detalhes, séries ou operação relacionada.

Marcador ausente: coordenadas faltando, filtro ativo ou permissão. Cadastre lat/long na estação para incluir o ativo no território. A Gestão tem um segundo mapa (guia Mapa): mesma base Leaflet, limitado ao recorte de filtros, com raio do marcador proporcional ao atraso de ingestão.

11. Séries, CSV e AgroClima

Séries é a linha do tempo do ativo. Janela padrão: últimas 48 horas. Estações diárias (intervalo ≥ 86400 s): histórico persistido, sem corte de 48 h.

11.0 Gráfico umidade × chuva

Na tela /series, abaixo do seletor da estação, o portal desenha o hietograma invertido (chuva 24 h a descer do topo + acumulada a tracejado) e as linhas de umidade. Use De / Até para recortar; por defeito mostra todo o histórico («Todo o histórico» limpa o filtro). O mesmo SVG está no topo da Gestão (Visão geral e Ciclo). Na ICACHO28 a linha é umidade relativa do ar. Na MT-AGR-04 são as profundidades SMS 0,5–3,0 m. A tabela abaixo não é o gráfico: a primeira página (~25 linhas) mostra só o último dia da ICACHO28 porque cada dia tem várias variáveis — use a paginação. Manual curto: Doc/manuais/Manual_Series.html.

11.1 Lista, filtros e paginação

11.2 Importar observações por CSV

  1. Arquivo UTF-8 com cabeçalhos do modelo do portal.
  2. Separador , ou ;.
  3. Revise validação (estação, variável, data/hora, valor) e confirme.
  4. Consulte a série e as flags de QC geradas.

11.3 Sincronizar AgroClima

O conector importa agregados diários da estação ICACHO28 (temperatura, extremos, umidade relativa, radiação, precipitação). Disponível para gerente (botão na UI) ou API com token de sync. Depende de AGROCLIMA_*. A API corta janelas ~215 dias; o MonTal pede fatias de 60 dias. Nesta estação EM TESTE a série começa em 08/12/2025 (~219 dias por variável) — não há histórico anterior na fonte. Cron diário 05:15 America/Sao_Paulo incrementa o dia. Após o sync, confira Séries (gráfico + tabela).

11.4 Ingestão por API (visão do operador)

Estações próprias enviam pontos a POST /api/ingest com token da estação. Em caso de falha de chegada de dados, verifique token, conectividade e depois QC de gap/atraso — não só o gráfico.

12. Qualidade e controle QC

O QC classifica observações suspeitas sem esconder o dado original. Isso é parte do diferencial MonTal: confiança explicável.

FlagSignificado operacionalAção sugerida
fora_faixaValor fora dos limites configuradosConferir unidade, sensor e regra
spikeVariação abruptaComparar vizinhos e condições locais
frozenValor repetido por tempo anormalVerificar travamento ou transmissão
gapAusência de observações esperadasChecar energia, link e ingestão
atrasoAtualização fora do prazoInvestigar fila e comunicação
okSem anomalia detectadaRegras de alerta podem avaliar o ponto

Registre a análise e use o vínculo de evidência. Risco operacional → alerta ou OS conforme a regra vigente.

13. Alertas

Regras (operadores como lt/gt/eq/fora_faixa, severidade info/alerta/crítico) podem criar um AlertEvent (AL-…). Há no máximo um evento em curso (aberto, reconhecido ou adiado) por regra e estação. Na tela Alertas: Reconhecer, Adiar (15 min / 1 h / 6 h / 24 h) ou Resolver. O adiamento volta a aberto quando expira.

Estação sem ponto além de intervalo × 3 (mín. 15 min; série diária 1,5 dia) abre alerta de silêncio. A próxima ingestão fecha esse evento. Destinatário da regra começando por http dispara webhook JSON. Widget público (Escola): /widget/MT-SOL-05.

  1. Abra o evento: confirme regra, estação, variável, horário e evidência.
  2. Classifique ou reconheça conforme o fluxo da equipe.
  3. Severidade crítica pode já ter gerado OS de visita — acompanhe em Campo.
  4. Encerre só após documentar causa e resultado.

14. Campo e ordens de serviço

As OS usam numeração OS-000001. Elas conectam anomalia digital ao trabalho físico — o fechamento do ciclo MonTal.

EtapaRegistro mínimo
AberturaEstação, descrição, prioridade, responsável e origem (alerta/QC/manual)
ExecuçãoDiagnóstico, atividade, datas, materiais e evidências
ConclusãoResultado, condição final, pendências
ValidaçãoSéries transmitindo de novo e QC sem persistência da anomalia
Boa prática de excelência: OS “fechada no papel” sem retorno na série não conta como ciclo completo. Valide sempre em Séries/QC após a visita.

15. Rotina ponta a ponta recomendada

  1. Manhã operacional: Home filtrada pela rede crítica; olhar Rede + Alertas abertos. Se precisar de recorte gerencial (UF, domínio, 7/30/90 dias), abra Gestão.
  2. Investigar: QC ou Séries da estação; confirmar se é clima, sensor ou comunicação. Na Gestão, use Pulso (completude/atraso) e Ciclo (hidrograma/chuva).
  3. Decidir: reconhecer alerta, ajustar regra (admin/gerente) ou abrir/executar OS.
  4. Provar: anexar/registrar evidência; exportar CSV se a análise exigir; CSV da Gestão para ranking de estações.
  5. Fechar o dia: Drive com os itens do dia; relatório de OS se houver governança formal.

Essa rotina materializa a grandeza do produto no cotidiano: não é “olhar gráfico”, é operar com rastro.

16. Cadastros e importação CSV

Cadastros sustentam tudo: organizações, estações, variáveis, sensores, regras, OS e colaboradores.

15.1 Ordem recomendada

  1. Organização e colaboradores (foto, cargo, superior hierárquico para o organograma);
  2. Estação, coordenadas e token de ingestão;
  3. Variáveis, unidades e limites (base do QC);
  4. Sensores e vínculos (intervalo esperado alimenta a completude na Gestão);
  5. Regras de alerta e política de OS.

15.2 CSV cadastral e de observações

Importadores aceitam UTF-8 com , ou ;. Preserve cabeçalhos. Observações alimentam Séries; cadastros atualizam catálogos. Importação CSV exige perfil autorizado (gerente+).

17. Relatórios

Em /relatorios: versões imprimíveis de OS, estações, rede e colaboradores. Filtre antes de imprimir; use a impressão do navegador para PDF. Os atalhos estáveis também alimentam o Evidence Drive.

18. Estação Escola e API pública

A Estação Escola (/escola e GET /api/escola) demonstra o produto e apoia aprendizagem sem expor tokens nem PII. Ideal para parceiros, treinamentos e vitrine. Não use o endpoint público para dados sensíveis da operação real.

19. Papéis e permissões

PapelResponsabilidade típicaLimites relevantes
adminConfiguração global, usuários, cadastros, regras, integraçõesMaior poder de exclusão e cadastro de colaboradores
gerenteCoordenação, alertas, QC, OS, CSV, AgroClima, relatóriosNão exclui organizações/colaboradores
tecnicoConsulta e execução/documentação de OSEscrita focada em campo

Princípio: menor privilégio. Se uma tela não aparece, confirme o papel com o administrador — o menu reflete, mas a segurança é no servidor.

20. Dicas e solução rápida


Suporte: ao relatar problema, informe URL, horário, estação, variável, ação e mensagem. Nunca envie senha ou token de ingestão.

Personalização visual (v1.7)

No cabeçalho, ··· abre o seletor de fundo (aurora em degrade). As letras adaptam-se a qualquer cor. No painel, as etiquetas tremem e podem ser arrastadas para reposicionar. O lápis amarelo na foto altera o avatar. Rodapé com Ajuda e © Dataryon (link); na tela de acesso, o mesmo copyright abaixo do cartão.