PescaRadar← Voltar à estação

PESCARADAR · SOBRE O PROJETO

Tecnologia para planejar melhor a pescaria.

O PescaRadar reúne informações ambientais, ferramentas de planejamento e referências para ajudar pescadores a interpretar as condições do local — sem prometer capturas nem transformar estimativas em medições reais.

01 · PROPÓSITO

O que o projeto oferece

Uma experiência integrada, pensada para celular e para consulta durante o planejamento.

Contexto ambiental

Consulta de condições meteorológicas, tendências horárias e indicadores disponíveis para a localização escolhida.

Local e navegação

Busca de cidade, localização pelo navegador, mapa e previsão de marés quando há referência aplicável.

Planejamento da pescaria

Busca de espécies, ficha de referência, configurações de pesca e orientação sobre iscas e equipamento quando existe perfil específico.

Lua e estações

Calendário lunar e estações como contexto complementar, sem tratar essas informações como garantia de atividade dos peixes.

Gráficos e indicadores

Visualizações para comparar condições e apoiar a interpretação dos dados disponíveis, com limitações explícitas.

Experiência multiplataforma

Site responsivo instalável como PWA e um projeto Android nativo mantido separadamente na mesma organização.

02 · COMO É CONSTRUÍDO

Arquitetura do PescaRadar

Os componentes têm responsabilidades distintas; a existência de uma configuração não significa, por si só, que um serviço esteja ativo em produção.

Frontend web

HTML, CSS e JavaScript em site/, com layout responsivo e suporte a instalação PWA.

API e backend

Cloudflare Worker em src/index.js, responsável pelas rotas de API documentadas no repositório.

Aplicativo Android

Projeto nativo oficial em PescaRadarAndroid/, desenvolvido com Kotlin e Jetpack Compose.

Licença

O repositório publica os termos de licença e avisos de terceiros na página de licenças.

03 · IOT E CONECTIVIDADE

Do ambiente ao dispositivo conectado

O PescaRadar combina a Estação Ambiental com uma camada IoT complementar. Os estados abaixo distinguem recursos implementados de etapas que ainda dependem de validação ou ativação.

Telemetria ESP32

A API recebe leituras autenticadas de dispositivos e o painel apresenta snapshots e histórico KV de amostras recebidas. O firmware candidato 2.4.0 ainda depende de compilação Arduino e validação física.

API e painel implementados

GPS NEO-6M

O fluxo de localização é separado da telemetria ambiental, exige opt-in no equipamento e mantém somente a última posição privada. Não há trilha de deslocamento.

Backend e painel implementados

Alertas e webhooks de saída

Regras de limiar e eventos podem alimentar destinos HTTPS com assinatura HMAC. A entrega usa fila KV e não oferece garantia transacional exactly-once.

Fluxo de saída implementado

Discord por conta

O painel permite configurar a aplicação/bot de cada conta, vincular usuário e servidor, selecionar canal e acompanhar entregas e alertas.

Integração implementada

WhatsApp: Evolution API e WAHA

Os adaptadores de transporte estão versionados e possuem testes simulados. Rotas Worker, persistência por conta, sessão e envio real ainda não estão ativos.

Adaptadores em evolução

BLE e gateway Android

O projeto documenta a arquitetura de conectividade, mas provisionamento BLE Security 2 e gateway Android em segundo plano ainda não estão concluídos.

Etapas pendentes

Limite operacional: leitura local, código versionado, ingestão remota, histórico e publicação são estados diferentes. O PescaRadar não declara firmware validado em campo, envio WhatsApp ativo ou entrega garantida quando essas etapas ainda não foram comprovadas.

04 · PRINCÍPIOS

Como interpretar os dados

O PescaRadar é uma ferramenta de apoio ao planejamento. As condições meteorológicas e os índices apresentados não equivalem a uma previsão científica da atividade dos peixes nem à probabilidade de captura.

Temperatura do ar não substitui a temperatura da água. Medições ausentes, previsões de modelo, dados estimados e observações devem ser interpretados de acordo com sua origem e cobertura.

05 · EXPLORE

Acesse as áreas principais sem precisar voltar ao menu superior.