Plataforma SaaS multi-tenant para gestão completa de Torcidas Organizadas: sócios, mensalidades, ingressos, eventos e muito mais.
TorcidaClub nasceu para resolver a dor de torcidas organizadas que ainda usam planilhas, cadernos e grupos de WhatsApp para gerenciar associados. A plataforma centraliza:
- Cadastro e aprovação de sócios (com documentos, foto e assinatura digital)
- Controle de mensalidades e inadimplência
- Sistema de ingressos para eventos/jogos
- Dashboard analítico para gestores
- Notificações por e-mail e WhatsApp
Atualmente em fase beta com ~2 fases concluídas (autenticação e cadastro de sócios) – o sistema já roda localmente e está sendo preparado para deploy.
| Camada | Tecnologias |
|---|---|
| Frontend | Next.js 14 (App Router), TypeScript, Tailwind CSS, shadcn/ui |
| Backend | Supabase (PostgreSQL, Auth, Storage, RLS) |
| Validação | React Hook Form, Zod |
| Pagamentos | Asaas API (PIX – em integração) |
| Notificações | SMTP próprio (servidor de e-mail) + WhatsApp API (futuro) |
| Infraestrutura | VPS dedicado (deploy e hospedagem) |
git clone https://github.com/seu-usuario/torcidaclub.git cd torcidaclub
npm install
cp .env.example .env.local
npm run dev
Acesse http://localhost:3000
- Node.js 18+
- Conta no Supabase (gratuita)
- Conta no Google Cloud (para OAuth)
- Servidor SMTP (para envio de e-mails)
Para um guia detalhado, consulte SETUP.md.
| Comando | Descrição |
|---|---|
npm run dev |
Servidor de desenvolvimento |
npm run build |
Build de produção |
npm run lint |
Verifica padrões de código |
npm run type-check |
Valida tipos TypeScript |
npm run validate |
Lint + type-check (antes de commit) |
npm run seed:mock |
Popula banco com dados de teste |
src/
├── app/ # Next.js App Router
│ ├── (auth)/ # Login, cadastro
│ ├── (gestor)/ # Dashboard do administrador
│ ├── (socio)/ # Área do associado
│ └── api/ # Endpoints (cadastro, pagamentos, webhooks)
├── components/ # UI reutilizável (shadcn/ui + custom)
├── lib/ # Clientes Supabase, validações, serviços
├── types/ # Tipagens geradas do banco
└── contexts/ # AuthContext (gestão de estado do usuário)
- Autenticação com Google OAuth (gestores)
- Cadastro multi‑etapa de sócios (validação, documentos, assinatura)
- Painel de aprovação de novos sócios
- Módulo de mensalidades (geração automática, PIX)
- Sistema de ingressos com QR Code
- Dashboard analítico (gráficos, exportação)
- Notificações por e-mail (SMTP) e WhatsApp
Este repositório não contém nenhuma credencial real, chave de API ou dado de cliente. Todas as variáveis sensíveis são gerenciadas via arquivo .env.local (ignorado pelo Git). Consulte o arquivo .env.example para ver as variáveis necessárias.
- LinkedIn: linkedin.com/in/gm5/
- GitHub: github.com/AxiomP
- E-mail: maia050604@gmail.com
Este repositório é privado e não pode ser copiado ou distribuído sem autorização.
Feito com TypeScript, Next.js, Supabase e infraestrutura própria (VPS + SMTP).