Pular para o conteúdo
~/rafael-ferreira

Markmedi

SaaS de gestão para clínicas de dermatologia estética, construído e operado de ponta a ponta

ver projeto repositório privado
  • Laravel
  • Vue 3
  • Inertia.js
  • TypeScript
  • Tailwind CSS
  • Filament
  • MySQL
  • Redis
  • Horizon
  • Reverb
  • AWS
  • Docker
  • Pest
Capa do projeto Markmedi

O Markmedi é o produto em que trabalho hoje, e o maior que já construí. É um SaaS para clínicas de dermatologia estética que cobre o dia inteiro de uma clínica: a paciente marca pela página pública, recebe confirmação e lembrete no WhatsApp, chega e entra na fila da recepção, é atendida com prontuário, fotos de evolução e receita assinada digitalmente, paga, avalia a consulta e volta a receber comunicação quando o tratamento pede manutenção. Fundei a empresa em janeiro de 2026 e cuido de tudo sozinho: requisitos, arquitetura, código, infraestrutura e suporte.

O código é privado e vai continuar assim, mas dá para contar como ele funciona por dentro. Como o assunto é grande, escrevi uma série de artigos no blog, um por decisão importante, e os links estão no fim desta página.

Agenda semanal da clínica, com fila da recepção e filtros por status

O que o produto faz

  • Atendimento: agenda por médico, sala e equipamento, página pública de agendamento, lista de espera, fila da recepção e check-in.
  • Clínico: prontuário com versões, anamnese, fichas clínicas por especialidade, mapeamento facial, séries de fotos com vídeo de evolução, prescrições, atestados e pedidos de exame com assinatura digital.
  • Telemedicina: sala de consulta por vídeo com transcrição por segmentos e resumo gerado por IA.
  • Gestão: financeiro com fluxo de caixa, DRE, repasses, faturamento de convênios (TISS), estoque e planos de tratamento.
  • Crescimento: CRM com funil, automações, campanhas de e-mail enviadas pelo domínio da própria clínica, NPS, gestão de reputação no Google e relatórios de posicionamento.
  • Paciente: portal com consultas, documentos, receitas, formulários e carteira de créditos.

Página do paciente com histórico clínico, acompanhamento e próximo atendimento

Como ele é construído

É um monólito modular em Laravel 12 com Vue 3, Inertia e TypeScript. O backend é dividido em 33 contextos de domínio (cerca de 1.500 classes), com regras de negócio em Actions pequenas, enums como máquinas de estado e eventos de domínio disparados só depois do commit. O frontend tem pouco mais de 200 páginas e rotas tipadas geradas pelo Wayfinder. O painel interno usa Filament.

O trabalho pesado fica em filas Redis gerenciadas pelo Horizon, com supervisores separados para a operação da clínica, IA, e-mail em massa e mídia. As atualizações em tempo real, como a agenda e a fila da recepção, passam por WebSockets com Laravel Reverb. Os dados de saúde são cifrados campo a campo com uma chave por clínica, protegida no AWS KMS.

A base de testes tem perto de 7 mil casos em Pest, entre unitários, de feature e de navegador, e roda no GitHub Actions em PHP 8.4 e 8.5, com jobs dedicados a filas, cache e schema no MySQL. Desenvolvo com o Claude Code sob regras rígidas de segurança, TDD desde o primeiro commit e revisão humana de cada mudança.

A produção é enxuta: um servidor na Hetzner atrás da Cloudflare, gerenciado pelo Coolify, com uma imagem Docker que roda a aplicação, o Reverb, o Horizon e o agendador. Backups cifrados saem para uma conta AWS separada com retenção imutável, e a restauração é testada todo mês.

Os bastidores, artigo por artigo

  1. Concorrência no agendamento: como dois pacientes nunca ficam com o mesmo horário.
  2. Filas com Laravel Horizon: isolamento de cargas, idempotência e limites de envio.
  3. Arquitetura, DDD e orientação a eventos: o monólito modular por dentro.
  4. TDD e integração contínua: os testes e o pipeline que os roda.
  5. Tempo real com Laravel Reverb: canais versionados e eventos sem dados pessoais.
  6. Multitenancy e segurança: isolamento entre clínicas e as decisões de segurança.
  7. Criptografia do prontuário: envelope com chave por clínica no AWS KMS.
  8. Tracking próprio em SQL: métricas de produto sem vazar dado sensível.
  9. E-mail marketing com domínio próprio e Amazon SES.
  10. Infraestrutura enxuta e resistente a falhas, com o fluxo de CI/CD.
  11. O Markmedi como PWA: app instalável, push próprio e nada de dado de paciente em cache.

Galeria

Outros projetos

Capa do projeto Plataforma B2B para venda de ingressos e cursos
plataforma-b2b-ingressos-e-cursos · privado ★ destaque

Plataforma B2B para venda de ingressos e cursos

Plataforma B2B que vende ingressos e cursos, valida a entrada em eventos com QR assinado e check-in offline e deixa a empresa comprar licenças e acompanhar o progresso de cada colaborador.

  • Laravel
  • Vue 3
  • Inertia.js
  • TypeScript
  • Tailwind CSS
Capa do projeto Evidens
evidens · privado ★ destaque

Evidens

Pipeline em Python que coleta acórdãos do TJRJ com Playwright, guarda cada evidência com hash, extrai o texto dos PDFs e faz um modelo de linguagem ler 1.048 decisões inteiras, aceitando só classificações sustentadas por citações conferidas na página indicada.

  • Python
  • Playwright
  • BeautifulSoup
  • PostgreSQL
  • psycopg 3