O ingestia.bi é 100% web — não há app nativo na App Store/Play Store. Em vez disso, ele é um PWA (Progressive Web App): você o instala na tela inicial pelo próprio navegador, pode receber notificações push e abrir deep links para um painel específico. Esta página explica o que existe, o que está em Preview e por que o cache no seu aparelho é propositalmente "burro" (nunca guarda dado).
Para o layout de telas pequenas (layout próprio de celular e de tablet, ou empilhamento quando o dono não arrumou), veja Layout por aparelho e modo TV; para ler o painel com o dedo (balão que abre no toque, filtros, clique cruzado), veja Ler um painel. Esta página cobre a camada PWA/push, que é Preview.
Maturidade
Instalação, push, deep links e cache seguro estão em Preview. A lógica (o que
o cache pode tocar, quando o push pode assinar) é coberta por suíte
determinística, mas o funcionamento em dispositivo real (iOS ≥ 16.4 /
Android, chaves VAPID em produção) é um etapa de homologação manual da nossa equipe — ainda
NÃO MEDIDO nesta documentação.
O que é#
Um PWA é um site que o navegador trata como app: ícone na tela inicial, abertura em tela cheia (sem barra de endereço), notificações e um service worker (um proxy local que decide o que servir da rede e o que guardar).
Para que serve#
- Acesso rápido: o painel vira um ícone no celular da diretoria.
- Aviso na hora: um alerta de KPI pode chegar como notificação push.
- Link direto: compartilhar um deep link que abre exatamente o painel certo.
Quando usar / quando não#
- Use para consumo executivo no celular e avisos pontuais.
- Não conte com uso offline dos números: por segurança, o painel não fica disponível offline (veja abaixo). Offline você vê uma tela genérica, sem dado.
Instalar como app#
Abra o ingestia.bi no navegador do celular
Use Safari (iOS ≥ 16.4) ou Chrome (Android).
Adicione à tela inicial
No iOS: menu Compartilhar → "Adicionar à Tela de Início". No Android: menu → "Instalar app".
Abra pelo ícone
O app abre em tela cheia, com o ícone da marca.
Notificações push#
Um alerta de painel (ex.: "Receita do dia abaixo da meta") pode ser entregue como notificação push no dispositivo instalado.
- Depende de chaves VAPID configuradas no ambiente. Sem a chave pública, o app simplesmente não assina push — degrada em silêncio, nunca finge que assinou.
- Você precisa conceder permissão de notificação ao app.
- Os canais de alerta tradicionais (e-mail, WhatsApp, webhook) continuam valendo em paralelo — ver Exportação e distribuição e Alertas e webhooks.
Deep links#
Um deep link abre o app já no painel (e, quando aplicável, no recorte) certo, em vez de cair na home. Útil para colar num aviso ou numa notificação que leva direto ao número.
Por que o app nunca guarda seu dado (cache seguro)#
Um service worker persiste respostas no aparelho — e esse cache sobrevive a fechar a aba, trocar de usuário e até ao logout. Se ele guardasse o HTML/JSON de um painel, o dado financeiro do seu workspace vazaria. Por isso a regra é rígida:
| Tipo de conteúdo | O que o app faz |
|---|---|
| Shell estático público (ícones, assets versionados, manifest) | Guarda em cache (cache-first). |
HTML de rota e chamadas de dados (/api/**, dados do painel) | Nunca guarda. Tenta a rede; offline mostra uma tela genérica sem dado. |
Ou seja: o app instalável acelera o casco (ícones/estilos), mas todo dado do painel vem sempre da rede, com sua sessão e sua RLS — nada sensível fica no dispositivo.
Pré-requisitos#
- Dispositivo compatível (iOS ≥ 16.4 para push; Android atual).
- Para push: chaves VAPID configuradas no ambiente e permissão do usuário.
- Sessão ativa e workspace com o painel publicado.
Limites e ressalvas#
- Sem app nativo e sem uso offline dos dados (por design de segurança).
- Push e instalação em produção nunca foram homologados em dispositivo real
—
NÃO MEDIDOaqui. - O comportamento de instalação varia por navegador/OS (iOS restringe push a apps adicionados à tela inicial).
Erros comuns#
- "Não recebo push": confirme que instalou o app (iOS só entrega push ao PWA na tela inicial), concedeu permissão, e que o ambiente tem VAPID configurado.
- "Sumiu tudo offline": esperado — o app não guarda dados; reconecte à rede.
Relacionados#
Última revisão: 2026-09-08.