Allison Verdam
Voltar para a página inicial

TatamiFlow: Como Criei um SaaS de Gestão para CTs de Artes Marciais

Conheça a história e a arquitetura técnica por trás do TatamiFlow, um SaaS completo desenvolvido para resolver a gestão financeira, graduações de faixas e cobranças via WhatsApp em Centros de Treinamento de artes marciais.

Por Allison Verdam22 de julho de 20266 mins de leitura
react nativetypescriptSaaSDevlogFastifyReactArtes MarciaisGestão de CTWhatsApp APIStartup

🥊 Construindo o TatamiFlow: Como desenvolvi um SaaS completo para Gestão de Centros de Treinamento e Artes Marciais

Criei o TatamiFlow, um SaaS completo para descomplicar a gestão de Centros de Treinamento (CTs) e academias de artes marciais (Jiu-Jitsu, Muay Thai, MMA, Boxe, etc.). Neste devlog, conto os motivos, os desafios de produto e a arquitetura técnica por trás do sistema (Fastify + React 19 + Expo + BullMQ + PostgreSQL).

🥋 1. A Origem: Por que criar um sistema específico para Lutas?

Se você já treinou em um Centro de Treinamento (CT) de Jiu-Jitsu, Muay Thai ou MMA, provavelmente já presenciou a mesma cena:

  • O mestre ou dono do CT anotando cobranças em um caderno de papel ou planilha do Excel.

  • Mensagens manuais de cobrança sendo enviadas uma a uma no WhatsApp no final do mês.

  • Dificuldade para saber quem trocou de faixa, quem faltou ou quem está em dia com a mensalidade.

  • Vendas de produtos (kimonos, faixas, luvas) sem nenhum controle de estoque ou caixa.

Os softwares tradicionais de academia foram feitos para musculação (catracas, fichas de treino na esteira). Eles não entendem a dinâmica de um tatame: graduação de faixas, cobranças familiares, múltiplos instrutores por turma e horários flexíveis.

Foi para resolver essas dores que nasceu o TatamiFlow.

⚡ 2. As Dores Reais do Tatame (e as Soluções)

1. Inadimplência & Cobrança Automática via WhatsApp

Cobrar alunos manualmente é chato, demorado e consome o tempo que o instrutor deveria passar no tatame.

Solução TatamiFlow: Integrado à Evolution API via WhatsApp, o sistema possui um motor de tarefas agendadas que identifica mensalidades a vencer nos próximos 5 dias, cruza dados com os pagamentos já liquidados e dispara lembretes amigáveis via WhatsApp automaticamente, com intervalo humanizado (anti-spam).

2. Graduações e Histórico de Faixas

A evolução do atleta é a alma de qualquer arte marcial.

Solução TatamiFlow: Módulo exclusivo para gestão de graduações e faixas (StudentBelt), registrando a data de cada graduação, promovendo transparência e histórico para o aluno e o professor.

3. Venda de Equipamentos no Balcão (PDV Integrado)

Muitos CTs vendem kimonos, protetores bucais, faixas e bebidas.

Solução TatamiFlow: Ponto de Venda (PDV) integrado que permite realizar a venda associada ao aluno, dar baixa automática no estoque e consolidar tudo no relatório financeiro da academia.

4. Descoberta de Academias (Mapa Público)

Solução TatamiFlow: Disponibilizamos um mapa interativo público (/mapa) com tecnologia Leaflet para que novos alunos possam encontrar CTs parceiros em sua região.

🛠️ 3. Bastidores da Arquitetura Técnica (Devlog)

Como desenvolvedor, um dos meus maiores objetivos com o TatamiFlow foi construir uma arquitetura moderna, escalável e extremamente performática.

Abaixo está o panorama geral da infraestrutura:

┌──────────────┐      ┌──────────────┐      ┌──────────────────────┐
│  Web Admin   │      │  App Mobile  │      │    Landing Page      │
│  React/Vite  │      │  Expo/RN     │      │ (tatamiflow.com.br)  │
└──────┬───────┘      └──────┬───────┘      └──────────┬───────────┘
       │                     │                         │
       └─────────────────────┼─────────────────────────┘
                             │ REST / WebSocket
                            ▼
                ┌───────────────────────┐
                │      Backend API      │
                │  Fastify + TypeScript │
                └───┬───────┬───────┬───┘
                    │       │       │
           ┌────────┘       │       └────────┐
          ▼               ▼               ▼
    ┌─────────────┐  ┌─────────────┐  ┌──────────────┐
    │  PostgreSQL │  │    Redis    │  │ Evolution API│
    │  (Prisma)   │  │  (BullMQ)   │  │  (WhatsApp)  │
    └─────────────┘  └──────┬──────┘  └──────────────┘
                            │
                    ┌───────┴───────┐
                    │ Worker Engine │
                    └───────────────┘

Stack Tecnológica Escolhida

🚀 Backend

  • Node.js + Fastify 5 + TypeScript: Optei pelo Fastify devido ao seu altíssimo desempenho e suporte nativo a rotas assíncronas de baixa latência.

  • Prisma ORM + PostgreSQL: Mapeamento seguro de tipos com validação de esquemas via Zod.

  • BullMQ + Redis: O coração do processamento assíncrono. O envio massivo de notificações no WhatsApp e os webhooks de cobrança funcionam em filas separadas com suporte a retentativas (retry) e locks atômicos, permitindo escalar o backend horizontalmente sem duplicar disparos.

  • Segurança: Autenticação via JWT (Access + Refresh tokens), hashing de senhas com Argon2, rate-limiting por IP/rota e headers protegidos com Helmet.

💻 Frontend Web (Painel Administrativo)

  • React 19 + Vite 8 + TypeScript: Carregamento instantâneo (HMR rápido) e interface limpa.

  • Lucide Icons & Tailwind/Vanilla CSS: Design focado em usabilidade, com suporte a modo escuro e layout responsivo.

  • React Router v7 & Axios: Gerenciamento de rotas com interceptors para renovação automática de tokens.

📱 App Mobile (Alunos e Responsáveis)(Ainda em desenvolvimento)

  • React Native 0.83 + Expo 55: Permite que alunos e pais acompanhem mensalidades, recebam avisos e vejam seus treinos em tempo real no iOS e Android.

  • Zustand v5: Gerenciamento de estado leve e direto ao ponto.

🔒 4. Desafios de Engenharia Notáveis

1. Multi-Tenancy Isolado

Como o TatamiFlow é um SaaS multi-tenant, qualquer vazamento de dados entre academias seria inaceitável. Toda query do banco passa por verificações de contexto da organização (organizationId), garantindo que administradores e alunos vejam apenas as informações do seu próprio CT.

3. Disparo de WhatsApp Humano e Anti-Spam

Disparar mensagens em massa no WhatsApp sem cuidados resulta em banimento do número. Para contornar isso:

  1. Implementamos uma fila no BullMQ com rate limit fixo de 5 mensagens por minuto.

  2. Adicionamos um delay aleatório de 3 a 8 segundos entre cada mensagem.

  3. Criamos logs de auditoria (WhatsappNotificationLog) que evitam cobrar o mesmo aluno duas vezes ou disparar para quem já pagou.

3. Integração com Gateway de Pagamentos Nacional

Para a gestão de assinaturas do SaaS (Planos Standard e Premium com cobrança recorrente), integramos o gateway Asaas com consumo de Webhooks para ativar, renovar ou suspender o acesso das organizações automaticamente.

🚀 5. Venha Conhecer o TatamiFlow!

O TatamiFlow já está rodando em produção e pronto para receber novos Centros de Treinamento!

Se você é dono de um CT ou academia de artes marciais, pode testar a plataforma gratuitamente por 15 dias sem compromisso.

👉 Acesse o site oficial: https://tatamiflow.com.br/

O que você pode fazer no TatamiFlow hoje:

  • 📊 Dashboard Completo: Visão de faturamento mensal, inadimplência e previsão de caixa.

  • 📱 WhatsApp Automático: Lembretes de cobrança sem você mover um dedo.

  • 🥋 Alunos e Graduações: Controle de faixas e históricos.

  • 📑 Importação em Massa: Migre sua planilha do Excel em segundos.

  • 🛒 PDV: Controle de vendas de kimonos e estoque.

💬 Feedback & Conexão

Se você é desenvolvedor, adoraria saber o que achou da arquitetura do projeto! Se for dono de academia ou praticante de artes marciais, me diga nos comentários qual funcionalidade faria a diferença no seu treino diário.

Obrigado por acompanhar este devlog e até o próximo post! 🥊🔥