PROJECT.md — VixCert
Visão Geral
Plataforma de venda de certificados digitais (e-CPF, e-CNPJ, SSL, NFe) com checkout próprio integrado ao ASAAS. VixCert é AR credenciada ICP-Brasil.
Identidade
| Campo |
Valor |
| Domínio |
vixcert.oakia.com.br |
| Stack file |
/root/vixcert.yaml |
| Código na VPS |
/root/vixcert |
| Repo |
github.com/felipesabores/vixcert-final |
| Branch |
final |
| Imagem Docker |
vixcert:latest (build local) |
| Referência visual |
https://boneca.vixcert.com.br (repo vixcert sem -final — não modificar) |
Stack Técnica
- Next.js 15 + TypeScript + Tailwind + shadcn/ui + Framer Motion
- Docker Swarm + Traefik
Infraestrutura
| Recurso |
Detalhe |
| Rede |
network_public |
| Banco |
Supabase cloud — exceção (ver abaixo) |
| TLS |
Traefik + Let's Encrypt |
Exceções às Convenções
| Convenção |
Exceção |
Justificativa |
| Self-hosted / PostgreSQL local |
Supabase cloud (projeto xqckfgwskenseorytcxq) |
Projeto iniciado antes da convenção self-hosted. Migração desejável, não prioritária. |
| Self-hosted |
ASAAS (gateway de pagamento) |
Necessário para PIX/Boleto/Cartão |
| Self-hosted |
Resend (email transacional) |
Necessário para entrega de emails |
Integrações Externas
| Serviço |
Detalhe |
| Supabase |
PostgreSQL + tabelas: produtos, clientes, pedidos, cupons, agendamentos |
| ASAAS |
PIX, Boleto, Cartão — sandbox ativo |
| Resend |
Email from: VixCert <noreply@oakia.com.br> |
| Evolution API v2 |
WhatsApp self-hosted — https://evolution2.oakia.com.br — instância: vixcert |
Automações n8n
| Workflow |
ID |
Webhook |
| VixCert — Notificação de Pagamento |
tfuwr2t0NEo0dH5g |
POST /webhook/vixcert-pagamento |
| VixCert — PIX Gerado |
lKrE9vTDnSaUAjMq |
POST /webhook/vixcert-pix |
Deploy
Aviso Crítico — Edição de Workflows n8n
Sempre atualizar AMBAS as tabelas: workflow_entity E workflow_history + reiniciar serviço.