Cartão na Hoje

1 Quando aparece

Todas as condições ao mesmo tempo. Se faltar uma, o cartão simplesmente não nasce:

• Está no celular (a mesma faixa de 780px do shell) ou no desktop com o beforeinstallprompt na mão.
• Da segunda sessão em diante: Date.now() - eng_visita1_<id> > 12h. É a doutrina que já existe no app: na primeira entrada quem fala é o checklist, e só ele.
• A pessoa já lançou 3 pedidos ou mais. Atalho pra quem ainda não usa é só mais um banner.
• A tela Hoje está sem aviso âmbar e o nudge do catálogo não vai aparecer. Um convite por vez, e o do catálogo ganha - ele é sobre o negócio dela, o nosso é sobre a nossa conveniência.

2 Quando nunca aparece

• Já está instalado: matchMedia('(display-mode: standalone)') ou navigator.standalone. Convidar quem já entrou é o jeito mais rápido de parecer um app burro.
• Na loja da cliente (/loja/:slug e /m/:slug). O manifesto já é removido nessas rotas: quem compra um bolo não recebe convite pra instalar a ferramenta de gestão de outra pessoa. O cartão respeita a mesma fronteira.
• No adm.engrenou.com.br - o painel interno nem registra service worker.
• Na demo pública - conta de avaliação, sem tenant de verdade.
• Depois do segundo "agora não".

3 Quantas vezes

Duas, no máximo, na vida da conta. O motor é o mesmo do nudge do catálogo, só com o prazo maior:

• 1ª aparição. Se sair com "agora não", volta uma única vez, 21 dias depois.
• No 2º "agora não", nunca mais.
• Android: se a pessoa tocar em "Colocar na tela" e recusar o diálogo do sistema, isso conta como um "agora não" - ela já viu a oferta.
• iPhone: "Já coloquei" encerra pra sempre, mesmo que ela não tenha colocado. Acreditar na pessoa custa menos que insistir.

4 O que acontece ao dispensar

Grava eng_pwa_convite_<bakeryId> com {fechado_em, vezes} - mesma forma e mesmo prefixo do resto da casa, dentro de try/catch (modo privado: só não lembra).

• O cartão sai da tela na hora, sem toast e sem "tem certeza?". Dispensar é uma resposta, não um erro.
• Não tem X, de propósito. No Hoje o X quer dizer "guarda por hoje, volta amanhã". Este cartão não volta amanhã, volta em 21 dias - usar o mesmo X aqui estragaria o significado que o app já ensinou.
• Quem dispensou e depois quiser: o caminho continua em Meu negócio, na lista de ações da conta. Sem gritar, mas existindo.

A Forma emprestada do convite

Todo card de dado no Hoje é branco com borda cinza de 1px. A borda de 1,5px na cor da marca só existe hoje no checklist de primeiro uso - ou seja, o app já ensinou que aquela moldura quer dizer "isto é um convite, não é um número". Quando o checklist morre, essa forma fica livre. O cartão herda o significado em vez de inventar um.

B Objeto, não parágrafo

O olho pousa em desenho antes de texto. Por isso a tela de celular em miniatura com o ícone do Engrenou no meio dos outros apps: em meio segundo ela mostra o resultado, sem precisar da headline. É o único card da Hoje com ilustração, e essa singularidade é o que compra atenção sem subir o tom.

C Momento, não posição

Ele não briga por topo. Aparece na 2ª sessão em diante, com 3 pedidos no histórico e num dia sem aviso âmbar - quer dizer, num dia calmo, com a pessoa já convencida de que volta ali todo dia. Atenção comprada por contexto dura mais que atenção comprada por interrupção.

D Slot exclusivo

Um convite por vez na tela, sempre. O nudge do catálogo tem preferência; o aviso âmbar cancela os dois. Sozinho num campo limpo, um card de 200px não precisa gritar. Empilhado com outros três, nenhum tamanho salvaria.

i Onde encaixa

• Componente novo src/components/ConviteInstalar.jsx, renderizado no fim do .hj3-rail do Hoje.jsx, ao lado do NudgeCatalogo e sob a mesma trava !temAmber.
• CSS .hj3-pwa em src/styles/hoje-v3.css. Sem token novo: usa --brand, --linha, --creme2, --shadow-sm.
• Botão primário reusa .btn.btn-terra. Nada de variante nova de botão - o app tem três e continua com três.
• Régua: fonte mínima 12px no rodapé (acima do piso de 11px), botão e "agora não" com 44px de alvo, raio 16px.

ii Detecção

• Segurar o beforeinstallprompt num listener global (junto do iniciarPwa()), guardar o evento e só então liberar o cartão do Android. Sem evento em mão, sem botão.
• iPhone: /iphone|ipad|ipod/i no user agent e ausência de navigator.standalone. Chrome/Firefox no iOS usam o mesmo motor, mas o menu é outro - a frase do passo 1 muda.
• Instalado: display-mode: standalone ou navigator.standalone, checado a cada montagem.

iii Medição, sem inventar

Não existe tipo de evento pra isso e criar um exige migração na whitelist da policy de eventos. Enquanto isso, o caminho já usado pelo Tutorial: nav com meta:{para:'pwa_convite_ok'} e meta:{para:'pwa_convite_nao'}.

E a honestidade que precisa constar em qualquer leitura: no Android dá pra ler o userChoice; no iPhone não dá pra saber se a pessoa instalou. Qualquer taxa de instalação que alguém apresentar vai ser parcial por natureza.