BridgePay — 02. Arquitetura do Sistema

Este documento descreve a topologia, subdomínios, infraestrutura de microserviços e integrações da BridgePay.

---

1. Visão Geral da Infraestrutura

O BridgePay opera sob uma infraestrutura descentralizada e otimizada para custo zero. Os componentes principais do ecossistema são descritos no diagrama abaixo:

mermaid
graph TD
    Client[Navegador do Usuário] -->|Requisições HTTP| Cloudflare[Cloudflare DNS & Proxies]
    Cloudflare -->|web.bridgepay.site| VercelWeb[Vercel: Dashboard & Landing]
    Cloudflare -->|pay.bridgepay.site| VercelPay[Vercel: Checkout]
    Cloudflare -->|members.bridgepay.site| VercelMembers[Vercel: Area de Membros]
    Cloudflare -->|admin.bridgepay.site| VercelAdmin[Vercel: Painel Admin]
    
    VercelWeb & VercelPay & VercelMembers & VercelAdmin -->|Autenticação & Querys| Supabase[Supabase: DB & Realtime]
    VercelPay -->|Armazenar Comprovativos / Arquivos| R2[Cloudflare R2 Storage]
    
    Supabase -->|Realtime Session Update| Bot[WhatsApp Bot Microservice: VPS Oracle]
    Bot -->|Disparo de Mensagens| Customer[Celular do Cliente]

---

2. Tecnologias Utilizadas (Tech Stack)

Framework Core: Next.js 15 (App Router / React) com TypeScript.

Estilização: CSS Vanilla e Tailwind CSS para layouts responsivos.

Banco de Dados & Autenticação: Supabase (PostgreSQL) com suporte a conexões Edge e Realtime.

Hospedagem de Mídia: Cloudflare R2 (bucket seguro S3-compatible).

Provedor de E-mail: Resend (integração via SDK nativa).

Orquestrador / Servidor Principal: Vercel (distribuição global de borda).

---

3. Estrutura de Subdomínios (middleware.ts)

Toda a roteamento é interceptado no middleware.ts. O sistema identifica o Host da requisição e reescreve internamente para a respectiva pasta do Next.js:

web.bridgepay.site (Host Padrão / Fallback):

Direciona para a landing page e para o Painel do Vendedor principal (ex: /app/web/[...path]).

pay.bridgepay.site (Checkout):

Redireciona e reescreve internamente para as rotas de pagamento otimizadas para conversão (ex: /app/pay/[id]).

members.bridgepay.site (Área de Membros):

Permite que compradores façam login e acessem cursos, player de vídeo e downloads de PDFs comprados (ex: /app/members/[id]).

admin.bridgepay.site (Administração Global):

Reescreve internamente para a pasta raiz administrativa /app/admin_subdomain.

Regra de Segurança: O middleware bloqueia de imediato qualquer usuário que não esteja autenticado ou cuja coluna role na tabela profiles seja diferente de 'admin' ou 'super_admin'. Os infratores são redirecionados para o domínio principal de login.

---

4. Microserviço do Bot WhatsApp (VPS)

Para evitar bloqueios de execução na Vercel Serverless, criamos um microserviço Express rodando em Node.js sob o processo PM2 em uma VPS externa:

Biblioteca: @whiskeysockets/baileys para gerenciar a sessão em tempo real sem precisar de emulação de navegador pesada (Puppeteer).

Sincronização: Escuta atualizações da tabela bot_sessions do Supabase via Realtime para atualizar o QR Code e Pairing Code no painel do administrador em tempo real.

Disparo: Rota POST para recebimento de solicitações de disparo automático com links de acesso aos arquivos para o WhatsApp do comprador no momento em que um pagamento é confirmado.