Bilonai
Micro SaaS da A Bilonai Group para escritórios de contabilidade em Portugal e Espanha: pedir os documentos do mês por link, ver quem ainda não entregou e enviar lembretes por WhatsApp.
- Produção:
https://entrega.bilonai.com
- Stack: Next.js 15 (App Router) · Tailwind CSS 4 · Lucide · Supabase (eu-west-1) · Vercel · Paddle (assinaturas, Merchant of Record) · Resend
- Idiomas:
pt-PT, es-ES, pt-BR (textos em lib/dictionaries/). Preços: euros (PT, ES) e reais no Brasil (R$ 49 / R$ 79), configurados na Paddle como preço por país (BR, BRL) no mesmo produto.
Estrutura
app/ — páginas (público, /app privado, /p/[token] página do cliente)lib/supabase/ — clientes client (navegador), server (sessão), admin (só servidor)lib/site.ts — marca, planos e dados legais (fonte única)lib/i18n.ts — textos PT/ES
Base de dados (Supabase Micro-SaaS)
Migração entrega_core_schema: offices, clients, document_types, requests, request_items, billing_events, vista requests_overview.
O cliente final nunca toca nas tabelas: usa só get_public_request(token) e set_public_item_sent(token, item, bool).
Variáveis de ambiente
Ver .env.example. A SUPABASE_SECRET_KEY e o PADDLE_WEBHOOK_SECRET vivem só na Vercel.
Pagamentos (Paddle)
- Checkout:
/app/assinatura cria a transação no servidor (custom_data.office_id) e abre o overlay do Paddle.js.
- Webhook:
POST /api/webhooks/paddle — verifica Paddle-Signature, grava em billing_events (idempotente por event_id), ignora eventos fora de ordem (offices.paddle_event_at) e nunca deixa uma 2.ª assinatura sobrepor uma ativa.
- Eventos a subscrever na Paddle:
transaction.completed, subscription.created, subscription.updated, subscription.activated, subscription.past_due, subscription.paused, subscription.resumed, subscription.canceled.
- Default payment link na Paddle:
https://entrega.bilonai.com/pagamento.
- Sandbox por defeito (token e preços públicos em
lib/paddle/config.ts); produção via variáveis NEXT_PUBLIC_PADDLE_*.
