CRM da Techlithy

O problema

Equipes comerciais, como as de captação de escolas e cursos, atendem leads ao mesmo tempo pelo WhatsApp, pelo Instagram, por e-mail e por formulários de anúncio. Com o atendimento espalhado em vários aplicativos e planilhas, leads se perdem, ninguém sabe quem está atendendo quem e a gestão não tem números confiáveis.

O produto

• Atendimento de WhatsApp, Instagram e e-mail numa só tela, em tempo real, mostrando quem está online e permitindo atribuir e transferir conversas.
• Pipeline kanban em que o card avança sozinho quando o lead responde ou agenda, com distribuição automática entre os atendentes e redistribuição dos leads que ficam parados.
• Bot de triagem configurável que cria leads e respeita o horário de cada unidade e os feriados.
• Campanhas de WhatsApp e e-mail por segmento, sequências automáticas por etapa do funil e editores visuais de fluxos e de e-mails.
• Central de IA com agentes que fazem o diagnóstico diário de cada unidade, avaliam os atendimentos e sugerem a próxima mensagem para leads parados, sempre com aprovação humana.
• Dashboards de KPIs por perfil, controle de custos por unidade, trilhas de treinamento e auditoria de acessos e downloads.

Arquitetura

O frontend é uma SPA em React 19 com TanStack Router e Query. O backend é uma API NestJS organizada em camadas (domínio, aplicação, infraestrutura e apresentação), com regras de arquitetura garantidas por lint e por testes.

Um único deploy atende todos os clientes. O isolamento é feito por empresa no banco, e uma mesma pessoa pode pertencer a várias empresas e trocar de empresa na sessão sem novo login. Filas BullMQ processam mensagens, campanhas, importações e jobs de IA, e o Socket.IO entrega as mensagens na tela em tempo real.

• PostgreSQL, Redis e armazenamento compatível com S3 (MinIO).
• Observabilidade com OpenTelemetry e SigNoz self-hosted.
• Integrações com WhatsApp Cloud API, Instagram, Meta Lead Ads, Gmail e provedores de IA, com chaves criptografadas e teto de custo mensal por empresa.
• Conformidade com a LGPD: anonimização de leads, retenção por empresa e trilha de auditoria.

Infraestrutura e deploy

• Deploy sem downtime numa VPS, sem orquestrador: a nova versão sobe ao lado da antiga, as migrations rodam antes da troca e o tráfego só muda quando o container está saudável. Em laboratório, as 47 mil requisições feitas durante um rollout responderam 200.
• CI em três níveis com failover automático: minutos gratuitos do GitHub, runners efêmeros em EC2 spot na AWS e runners próprios na VPS.
• Infraestrutura da AWS em Terraform, com plan no PR, apply no merge e acesso por OIDC, sem chaves estáticas.
• Um repositório central de workflows mantém todos os repositórios da empresa com os mesmos padrões de CI, deploy e atualização de dependências.

Qualidade

• Em todo pull request: testes unitários e de integração no backend, com Postgres e Redis reais via Testcontainers, e todas as migrations aplicadas num banco vazio.
• Testes de componentes e de regras de negócio no frontend.
• Modo demo que roda inteiro no navegador, com mocks fiéis ao contrato da API, usado em vendas e para gerar os vídeos de treinamento automaticamente.

Problemas que resolve