Portal de operações ambientais · Dataryon
Guia operacional para administradores, gerentes e técnicos
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).
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-mail | Séries, QC, alerta, OS e Drive no mesmo fluxo |
| “Parece estranho” sem dono | Alerta AL-… e, se crítico, OS automática |
| Exportação solta | CSV e relatórios recuperáveis pelo Evidence Drive |
| Ajuda só em PDF | Manual 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).
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.
| Elemento | Amostra | Referência | Uso |
|---|---|---|---|
| Azul principal | #0071e3 | Ações, links e estados ativos | |
| Azul luminoso | #2997ff | Gradientes e destaques | |
| Superfície | #f8fafc | Planos de fundo e cartões |
123456 (quando SMTP Titan estiver configurado)./conta/senha — a inicial não pode ser reutilizada (mínimo 8 caracteres).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.
Doc/manuais (incl. Configuração). Se o trecho não existir, o Guto diz que não encontrou./manual-uso).guto_chat) ou via MONTAL_GUTO_CHAT; o tour continua mesmo com o chat off.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.
À 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.
| Bloco | Como usar | Próximo passo típico |
|---|---|---|
| Estações e rede | Disponibilidade, atualização, estação selecionada | Mapa ou cadastro da estação |
| Qualidade | Flags de faixa, spike, frozen, gap, atraso | Módulo Qualidade + evidência |
| Alertas e Campo | Eventos pendentes e OS | Tratar alerta ou executar OS |
| Séries | Janela recente ou visão diária | Filtrar, exportar ou sync AgroClima |
O Drive reúne links reais (não uma pasta morta) para:
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.
| Grupo | Destinos típicos |
|---|---|
| Operação | Home, Mapa, Estações, Séries, Qualidade, Rede viva, Alertas, Campo/OS, Estação Escola |
| Gestão | Dashboard, Inteligência de Risco, Clima |
| Cadastros | Hub, organizações, estações, variáveis, sensores, regras, OS, colaboradores, organograma, CSV (gerente+) |
| Relatórios | Hub, OS, estações, rede e colaboradores — impressão/PDF |
| Configuração | Só admin: Parâmetros, Audit., Monitor |
| Ajuda e conta | Manual (?), 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.
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).
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.
Use as pílulas ou as setas ‹ ›. São oito telas, no espírito das guias do GCT, com temas ambientais:
| Guia | O que mostra | Para que serve |
|---|---|---|
| Visão geral | Gráfico umidade × chuva no topo; oito cartões iguais; sparkline de volume diário | Ver chuva/umidade e o pulso do recorte sem mudar de guia |
| Mapa | Leaflet da área filtrada; cor = status; raio do marcador cresce com o atraso de ingestão | Ver território e latência no mesmo mapa — o que painéis de fabricante raramente juntam |
| Pulso | Completude por estação (recebido vs intervalo cadastrado), faixas de pontualidade (SLA), mapa de calor estação×tempo, radar de saúde, mistura de atraso | Detectar falha silenciosa e dias mudos (calendário de QC) |
| Qualidade | Rosca válidas vs rejeitadas, QC por região, lista de eventos QC | Confiar no dado antes de decidir |
| Ciclo | Umidade do solo × chuva (hietograma invertido e perfil SMS), hidrograma, chuva acumulada, ciclo das 24 h, volume por dia da semana | Como a água entra no solo e quando a rede fala |
| Gráficos | Barras de volume, região, domínio, série, QC, severidade, OS e status | Comparar fatias do recorte |
| Recortes | Tabelas por UF, domínio, série (mín/média/máx) e ranking de estações | Governança e export mental para reunião |
| Operação | Alertas, OS e eventos QC recentes do recorte | Passar da análise para a acção |
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.
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.
Como no GCT, a equipe tem hierarquia visual.
/equipe, atalho no cartão de perfil, menu Cadastros e botão na lista de colaboradores. A árvore usa o campo superior de cada colaborador. Arraste o fundo para mover; botões e scroll fazem zoom. Cartão: foto ou inicial, empresa, papel/cargo, atalho de edição. Superiores que formariam ciclo são recusados.O Mapa usa Leaflet para posicionar estações e apresentar estado (marcadores por status). Clique no marcador para resumo e atalhos.
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.
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.
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.
, ou ;.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).
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.
O QC classifica observações suspeitas sem esconder o dado original. Isso é parte do diferencial MonTal: confiança explicável.
| Flag | Significado operacional | Ação sugerida |
|---|---|---|
fora_faixa | Valor fora dos limites configurados | Conferir unidade, sensor e regra |
spike | Variação abrupta | Comparar vizinhos e condições locais |
frozen | Valor repetido por tempo anormal | Verificar travamento ou transmissão |
gap | Ausência de observações esperadas | Checar energia, link e ingestão |
atraso | Atualização fora do prazo | Investigar fila e comunicação |
ok | Sem anomalia detectada | Regras 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.
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.
As OS usam numeração OS-000001. Elas conectam anomalia digital ao trabalho físico — o fechamento do ciclo MonTal.
| Etapa | Registro mínimo |
|---|---|
| Abertura | Estação, descrição, prioridade, responsável e origem (alerta/QC/manual) |
| Execução | Diagnóstico, atividade, datas, materiais e evidências |
| Conclusão | Resultado, condição final, pendências |
| Validação | Séries transmitindo de novo e QC sem persistência da anomalia |
Essa rotina materializa a grandeza do produto no cotidiano: não é “olhar gráfico”, é operar com rastro.
Cadastros sustentam tudo: organizações, estações, variáveis, sensores, regras, OS e colaboradores.
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+).
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.
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.
| Papel | Responsabilidade típica | Limites relevantes |
|---|---|---|
| admin | Configuração global, usuários, cadastros, regras, integrações | Maior poder de exclusão e cadastro de colaboradores |
| gerente | Coordenação, alertas, QC, OS, CSV, AgroClima, relatórios | Não exclui organizações/colaboradores |
| tecnico | Consulta e execução/documentação de OS | Escrita 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.
Doc/manuais.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.