Deploy

Deploy

Onde roda

Qualquer runtime que execute Hono: Node 18+, Cloudflare Workers, Deno, Bun. Rotas de API do Next.js são o padrão documentado.

Variáveis

Padrão .env.local para desenvolvimento local. Em produção, defina no ambiente da plataforma (Vercel, Worker Secrets). Segredos de tenant (X-Apointoo-Tenant-Key e equivalentes) nunca recebem prefixo NEXT_PUBLIC_: variável pública é variável vazada.

Fila e outbox

Uploads de conversão passam pela fila com outbox. Uma falha transitória do Google não derruba o confirm; a tentativa repete conforme a agenda. Sem persistência configurada, use os stores de memória apenas em desenvolvimento.

Deduplicação

Guarde a chave de idempotência junto ao registro. Um confirm repetido devolve o mesmo resultado; nada duplica no destino.

Checklist de produção

• NEXT_PUBLIC_SITE_URL aponta para o host canônico (www).
• Segredos de tenant só no ambiente servidor.
• Store de estado persistente configurado (não memória).
• Consentimento ativo na frente da captura.
• Webhook de revalidação ligado se você usa CMS.
• Logs de entrega acessíveis ao time que responde incidentes.