Fluxo de dados de ponta a ponta

Acompanhe uma leitura do fio da sonda, passando pelos feeds JSON e pelo armazenamento, até o dashboard de histórico após o login.

Close de cabos Ethernet Cat-5e brancos com conectores RJ45
O JSON das sondas normalmente sai da rede local por Ethernet ou por um relay próximo, não direto pela internet pública. Foto: DiscDepotDundee.co.uk. CC BY-SA 4.0

Cada número da página inicial passa por várias camadas. Entender esse caminho ajuda a investigar leituras desatualizadas, sondas faltando ou buracos no histórico.

Passo 1. Medição no ambiente

As sondas medem temperatura e umidade. O sketch do Arduino consulta as sondas a cada poucos segundos, descarta valores claramente fora da curva e monta uma estrutura JSON na memória. Detalhes: sketches do Arduino e sondas de temperatura.

Arduino Uno ligado a um sensor de temperatura e umidade DHT com três jumpers
Uma primeira montagem mínima de microcontrolador e sensor, antes da Ethernet, do LCD e da fiação com duas sondas. Foto: Wikimedia Commons contributor. CC BY-SA 4.0

Passo 2. Publicação do JSON

A placa ou um relay próximo expõe JSON via HTTPS. Um serviço FastAPI em Python pode guardar as respostas em cache no Redis para que a internet nunca acesse diretamente a conexão da sua casa: veja scripts e feeds em Python.

Visualizador de JSON do navegador mostrando as chaves de sonda 0, 1 e avg com Fahrenheit, Celsius e umidade
Formato do feed ao vivo consumido pelo site depois de sair da rede local.

Passo 3. Busca e exibição no site

Quando você carrega a página inicial, o servidor busca cada URL de feed configurada, interpreta as chaves das sondas e monta os cartões de leitura. Usuários conectados carregam do Supabase os próprios mapeamentos de feeds e sondas em vez dos padrões. Os dados de clima seguem um caminho paralelo pelo OpenWeather, usando a cidade que você escolher, se quiser.

Passo 4. Gravação do histórico

Se você estiver conectado, cada leitura bem-sucedida insere linhas no Supabase com nome do feed, rótulo e chave da sonda, temperaturas, umidade e data e hora. Visitantes continuam vendo os dados ao vivo, mas não adicionam histórico. Saiba mais em uso dos dados históricos.

Passo 5. Painel e exportação

A tabela de histórico mostra essas linhas em páginas. A exportação em CSV entrega o conjunto completo para administradores e assinantes. Webhooks do Stripe mantêm a participação no grupo com permissão de exportar. As ferramentas da conta estão descritas em contas e painel.

Pontos de falha para verificar

  1. Fiação ou alimentação da sonda: logs seriais no Arduino.
  2. Rede de casa ou certificado: rode curl na URL do feed a partir de um notebook conectado no 4G (LTE).
  3. Cache do relay desatualizado: reinicie a busca na origem no fast-api-relay.
  4. Mapeamento no painel: um erro de digitação na chave da sonda esconde leituras mesmo com o JSON válido.
  5. Cookies de login: o histórico só é salvo em sessões conectadas.

Perguntas frequentes

Como as leituras chegam ao painel?
Os dispositivos enviam por push ou os feeds são buscados por pull, as leituras vão para o armazenamento, os gráficos consultam ou recebem atualizações em streaming, e os jobs de alerta avaliam os limites em intervalos programados.