MonTal

Manual de uso

Portal de operações ambientais · Dataryon

Revisão v1.1: aprofundamento do ciclo operacional, diferenciais do produto no dia a dia, Evidence Drive, QC→alerta→OS e rotinas de excelência.

Í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 e Evidence Drive
6. Navegação e grupos do drawer
7. Mapa
8. Séries e importações
9. Qualidade e QC
10. Alertas
11. Campo e ordens de serviço
12. Rotina ponta a ponta recomendada
13. Cadastros e CSV
14. Relatórios
15. Estação Escola e API
16. Papéis e permissões
17. 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:

Use este manual como referência operacional. Para posicionamento comercial e escopo técnico, consulte os documentos v1.1 na raiz do projeto.

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.

3. Login, idioma e senha

1. Acesse https://montal.dataryon.com.br.
2. Informe e-mail e senha. Para demonstrações, use demo@montal.dataryon.com e a senha fornecida pela equipe.
3. Escolha pt_BR, en ou es pelas bandeiras. A preferência acompanha a navegação e pode ficar gravada no perfil.
4. Aceite os termos quando solicitado e troque a senha se o sistema exigir.
5. Para trocar a senha depois: menu da conta → Senha.

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 — respostas fiéis ao documento, sem “inventar” procedimento.

• Botão do Guto no cabeçalho: iniciar ou retomar o tour.
• Perguntas objetivas: “como importar observações?”, “onde fechar uma OS?”.
• Botão ? na barra superior e item Manual em Ajuda: abrem este manual consolidado (/manual-uso).
• Quando MONTAL_GUTO_CHAT estiver desativado, o tour continua; a consulta textual pode não aparecer.

5. Home, mosaico 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.1 Leitura do mosaico

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

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

• alertas e condições de origem;
• eventos de QC;
• ordens de serviço e execução;
• atalhos de relatórios;
• exportações CSV de séries.

6. Drawer e grupos de navegação

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

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

7. Mapa

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.

8. Séries, CSV e AgroClima

Séries é a linha do tempo do ativo. Janela padrão: últimas 48 horas. Dados diários: histórico da ordem de ~280 dias.

8.1 Lista, filtros e paginação

• Escolha estação, variável e intervalo antes de consultar.
• Na lista: 25, 50 ou 100 itens por página — filtros preservados.
• Exporte CSV; o arquivo pode aparecer como evidência no Drive.

8.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.

8.3 Sincronizar AgroClima

O conector importa agregados diários da estação ICACHO28 (temperatura, umidade, radiação, precipitação etc.). Disponível para gerente (botão na UI) ou API com token de sync. Depende de AGROCLIMA_*. Após o sync, confira Séries — a política da fonte pode tratar QC/regras de forma específica no conector.

8.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.

9. Qualidade e controle QC

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

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

10. 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 aberto por regra e estação — para reduzir ruído.

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.

11. 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.

12. Rotina ponta a ponta recomendada

1. Manhã operacional: Home filtrada pela rede crítica; olhar Rede + Alertas abertos.
2. Investigar: QC ou Séries da estação; confirmar se é clima, sensor ou comunicação.
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.
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.

13. Cadastros e importação CSV

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

13.1 Ordem recomendada

1. Organização e colaboradores;
2. Estação, coordenadas e token de ingestão;
3. Variáveis, unidades e limites (base do QC);
4. Sensores e vínculos;
5. Regras de alerta e política de OS.

13.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+).

14. 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.

• OS: volume, situação, prioridade e responsáveis.
• Estações: inventário e condição cadastral.
• Rede: panorama operacional e atualização.
• Colaboradores: equipe, papel e vínculo.

15. 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.

16. Papéis e permissões

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.

17. Dicas e solução rápida

• Filtre a estação na Home antes de saltar entre módulos.
• Confirme fuso, unidade e período quando o gráfico “parecer errado”.
• Após CSV ou AgroClima, valide série + QC.
• Use o Drive para manter o fio entre dado, alerta, OS e relatório.
• Alerta crítico sem OS? Verifique regra/severidade e permissões.
• Estação fora do mapa? Cadastre coordenadas.
• Dúvidas de uso: ?, Guto e manuais curtos em Doc/manuais.