Psicoagora: da primeira entrevista à plataforma no ar

Em 18 meses, a Winget Software tirou do papel uma plataforma completa para psicólogos: agenda, prontuário, financeiro, cobranças e lembretes automáticos por WhatsApp e e-mail. Tudo roda na AWS, com um custo de infraestrutura que cresce junto com o uso, e não antes dele.

Psicoagora: agenda do psicólogo num notebook e lembrete ao paciente no celular
A agenda do psicólogo e um lembrete ao paciente (dados fictícios)

18 meses

da primeira entrevista à produção

188

casos de uso especificados

310

operações de API documentadas

11,8 mil

testes automatizados

2.500+

commits e 214 pull requests

O desafio

Psicólogos estudam anos para cuidar de pessoas, mas boa parte da semana vai embora em tarefas administrativas. Nas entrevistas com o cliente e com profissionais em atividade, as mesmas dores apareciam sempre:

  • Agenda em planilha ou caderno, sem controle de sessões recorrentes, férias e feriados.
  • Lembretes enviados um a um pelo WhatsApp, e faltas que só eram percebidas com o paciente já ausente.
  • Cobrança no papel, com pacotes de sessões difíceis de acompanhar e pagamentos atrasados descobertos tarde demais.
  • Prontuários e documentos espalhados, num cenário em que dados clínicos exigem cuidado redobrado pela LGPD.

O cliente queria uma plataforma por assinatura (SaaS) que resolvesse tudo isso num só lugar, simples para o psicólogo e segura para o paciente. Nosso papel foi conduzir o projeto inteiro: pesquisa, design, desenvolvimento, infraestrutura e entrega em produção.

Como começamos: entender antes de construir

Antes da primeira linha de código, nós já sabíamos exatamente o que construir e por quê. Isso evita o maior custo de um projeto de software, que é refazer o que foi feito errado.

  1. Entrevistas com o cliente e com psicólogos em atividade, para ouvir as dores reais do dia a dia.
  2. Pesquisa de mercado, qualitativa e quantitativa, para validar quais problemas resolver primeiro.
  3. UX research, design de produto e protótipos das telas, testados antes do desenvolvimento.
  4. 188 casos de uso documentados, cada um com regras de negócio e critérios de aceite.
  5. Documentos de produto e de arquitetura (requisitos, desenho de alto nível e desenho de cada funcionalidade), que guiaram todas as decisões técnicas.
  6. Uma especificação por funcionalidade: 70 especificações detalhadas, com plano de implementação e lista de tarefas, antes de cada entrega.

O ganho para o cliente: escopo claro desde o início, estimativas mais confiáveis e nenhuma surpresa no meio do caminho.

O produto: tudo o que o consultório precisa, num só lugar

O Psicoagora junta numa única plataforma o que antes ficava espalhado em planilhas, cadernos e conversas de WhatsApp. Cada módulo resolve uma dor que ouvimos nas entrevistas.

MóduloO que resolve
AgendaSessões recorrentes, horário de funcionamento, bloqueios, férias e feriados. Editar uma série funciona como no Google Agenda: só esta sessão, esta e as seguintes, ou todas.
Pacientes e prontuárioCadastro, histórico, anotações de sessão e documentos clínicos com modelos prontos e exportação em PDF.
Sessões e pacotesPacotes de sessões viram créditos, cada sessão realizada consome um, e o saldo de cada paciente fica sempre à vista.
FinanceiroPainel com gráficos, contas a pagar e a receber e lançamentos recorrentes, tudo consolidado.
Mensagens automáticasLembretes e cobranças por e-mail e WhatsApp. O paciente confirma ou cancela a sessão por um link, sem precisar de login.
AssinaturasPlanos com período de teste e pagamento com cartão dentro do próprio app, pelo Mercado Pago.
Painel administrativoGestão de contas, grupos de permissão, modelos de documentos e de mensagens, avisos e planos.
Agenda do Psicoagora com sessões semanais recorrentes
Agenda do mês com sessões semanais recorrentes (dados fictícios)
Psicoagora no celular: agenda do mês e detalhes do paciente
O mesmo app no celular, com a agenda do mês e os detalhes do paciente (dados fictícios)
Painel financeiro do Psicoagora
Painel financeiro com saldo, receitas, despesas e meios de pagamento (dados fictícios)
Configuração de mensagens automáticas do Psicoagora
Mensagens automáticas e notificações por e-mail e WhatsApp
Ilustração: paciente recebe lembrete e confirma a sessão
O paciente recebe o lembrete e confirma a sessão com um toque (ilustração)

Os desafios e como resolvemos cada um

Um sistema de cadastro comum não daria conta do Psicoagora. Cinco problemas exigiram soluções de engenharia sob medida.

1. Um financeiro que não se perde

O problema: pacientes pagam de jeitos diferentes (sessão avulsa, pacote mensal, pacote compartilhado) e um simples “pago / não pago” não diz quem deve quanto.

A solução: modelamos o financeiro como um extrato. Pacotes geram créditos, sessões geram débitos, os créditos não usados continuam valendo e um saldo negativo indica inadimplência. Todos os pagamentos, de sessões, pacotes e assinaturas, são consolidados num só lugar.

O ganho: o psicólogo vê o saldo de cada paciente na hora, e a conciliação deixa de ser trabalho manual.

2. Mensagens que precisam chegar

O problema: um lembrete de WhatsApp que não chega pode significar uma sessão vazia.

A solução: criamos uma fila de envio com processamento a cada minuto. Cada mensagem é reservada por um único processo, para nunca sair duplicada. Falhas temporárias são reenviadas com intervalos crescentes, falhas definitivas são registradas e alarmes avisam a equipe se algo trava. O sistema também respeita um horário de silêncio (meia-noite às 5h30) e as preferências de cada profissional.

O ganho: nenhum lembrete se perde sem que alguém saiba, e nenhum paciente recebe mensagem de madrugada.

3. Confirmação com um toque, sem login

O problema: pedir que o paciente crie uma conta só para confirmar presença não funciona na prática.

A solução: 24 horas antes da sessão, o paciente recebe por e-mail ou WhatsApp um link único e seguro para confirmar ou cancelar. O link é gerado a partir de 32 bytes aleatórios, vale só para aquela consulta, e reenviar a mensagem nunca gera uma confirmação duplicada.

O ganho: menos faltas e menos mensagens manuais. O psicólogo sabe com antecedência quem vem.

4. Dados clínicos protegidos de verdade

O problema: prontuários e documentos são dos dados mais sensíveis que existem, e a plataforma atende muitos profissionais ao mesmo tempo.

A solução: cada conta é isolada das demais e cada ação passa por permissões verificadas na API. Os documentos clínicos são criptografados no banco de dados (AES-256-GCM). Senhas, tokens, conteúdo de documentos e anotações de sessão nunca aparecem nos logs, e a API tem limite de requisições para conter abusos.

O ganho: segurança alinhada à LGPD desde a primeira versão, e não como remendo depois.

5. Uma agenda que pensa como o psicólogo

O problema: a maioria dos atendimentos é semanal, e mudar uma sessão de uma série não pode bagunçar as outras.

A solução: implementamos a recorrência como no Google Agenda: ao editar ou cancelar, o profissional escolhe entre só esta sessão, esta e as seguintes, ou todas. Exceções ficam registradas, e o registro clínico e financeiro de cada sessão é criado automaticamente no dia certo.

O ganho: a agenda funciona do jeito que o profissional já está acostumado, sem retrabalho.

Arquitetura: moderna, segura e de baixo custo

A plataforma roda inteira em serviços gerenciados da AWS, sem servidores ligados 24 horas esperando acesso. Em junho de 2026 migramos a API de servidores tradicionais (EC2) para AWS Lambda, sem mudar nada para quem usa o app.

Diagrama da arquitetura serverless do Psicoagora na AWS
Arquitetura do Psicoagora em produção

Três escolhas mantêm a conta da AWS baixa sem sacrificar segurança:

  • Paga por uso: a API só consome recursos quando recebe uma requisição. Sem acessos, o custo da API cai praticamente a zero.
  • Rede privada sem NAT: a API e o banco de dados ficam isolados da internet. As poucas funções que precisam falar com serviços externos (e-mail, WhatsApp, Mercado Pago) rodam fora dessa rede, o que elimina o custo fixo mensal de um NAT Gateway.
  • Infraestrutura como código: todo o ambiente está descrito em arquivos versionados, e cada mudança passa por testes automáticos antes de ir para homologação e produção.

O contrato da API (OpenAPI, com 310 operações) gera automaticamente o código que o app usa para conversar com o servidor. Assim, app e API nunca saem de sincronia.

Inteligência artificial a serviço da qualidade

Usamos IA para ganhar velocidade, sem abrir mão do controle. O segredo foi combinar agentes de IA com especificações claras, testes automáticos e revisão humana.

  • Desenvolvimento guiado por especificação: cada funcionalidade nasce de uma especificação aprovada, com plano e tarefas, e só depois vira código.
  • Agentes especialistas: montamos dentro dos repositórios um conjunto de agentes e habilidades para cada tecnologia do projeto (NestJS, Prisma, Flutter, testes e outras), usados com Claude Code, Codex, Cursor e Antigravity.
  • Regras do projeto por escrito: uma “constituição” define padrões de arquitetura, segurança e testes que humanos e agentes seguem igualmente.
  • Portões de qualidade: nada entra sem testes passando, zero alertas de análise estática e revisão de código em cada pull request.

O ganho para o cliente: entregas mais rápidas, com a mesma (ou maior) confiabilidade de um time grande trabalhando no método tradicional.

Qualidade em números

Qualidade não é promessa, é método. No Psicoagora, para cada linha de código que vai para produção existe mais de uma linha de teste conferindo se ela funciona.

Gráfico: linhas de código de produção e de testes no backend e no frontend
Linhas contadas nos repositórios em 19/11/2026, sem código gerado
IndicadorNúmero
Testes automatizados11,8 mil (4,8 mil na API e 7 mil no app)
Casos de uso especificados188
Especificações de funcionalidades70
Operações de API documentadas310
Tabelas no banco de dados54
Funções serverless (Lambda)10
Commits e pull requests2.529 commits e 214 pull requests
Alertas de análise estática aceitos para fazer merge0

Tem um projeto assim?

Se você precisa tirar do papel uma plataforma SaaS, um sistema de saúde, uma integração de pagamentos ou uma arquitetura na AWS, a gente conhece o caminho da primeira entrevista até a produção.

É desenvolvedor ou trabalha com TI? Se um cliente trouxer um projeto desse tamanho e ele estiver fora do seu escopo, indique a Winget. Cuidamos do seu cliente com o mesmo cuidado que tivemos com o Psicoagora.