Contexto
O VetDesk é uma plataforma SaaS para clínicas veterinárias e médicos veterinários independentes. Reúne fichas clínicas, relatórios, receitas, agenda, financeiro e stock num único sistema.
Problema
A rotina de uma clínica veterinária é feita de muitas tarefas pequenas e ligadas entre si: registar cada consulta, emitir documentos, marcar consultas, cobrar e controlar o stock. O VetDesk existe para tratar dessa rotina num só produto, em vez de ferramentas separadas.
Restrições
- Dados clínicos sensíveis e documentos regulamentados, como receitas, que exigem cuidado com a segurança e a conformidade.
- Planos de subscrição com período de teste e acesso controlado por funcionalidade.
- Acesso web em computador e telemóvel a partir de uma única base de código, com margem para evoluir para uma aplicação de loja no futuro.
- Documentos carregados limitados a PDF ou DOC, até 3 MB cada e cinco ficheiros por registo.
Solução
- Ficha do paciente com histórico, vacinas, exames e documentos anexados.
- Relatórios com modelos, assinatura digital e exportação em PDF.
- Receitas e pedidos de exame exportados em PDF.
- Agenda com notificações por WhatsApp.
- Relatórios financeiros e gestão de stock.
- Calculadora de dosagem por peso.
- Subscrições com controlo de teste e acesso por funcionalidade, além de um programa de recomendação.
Arquitetura
O sistema está organizado por funcionalidade (pacientes, relatórios, agenda, financeiro, stock e outras). Cada funcionalidade mantém os seus tipos, serviço de dados, schema de formulário e hooks. O código segue camadas conceptuais, domínio, aplicação, infraestrutura e interface, e o domínio não depende da framework, da base de dados nem do fornecedor de pagamentos. A aplicação web usa o App Router do Next.js e mantém a renderização no servidor sempre que o navegador não é necessário.
Tecnologias
- Next.js (App Router)
- React
- TypeScript
- Redux Toolkit (RTK Query)
- Zod
- Tailwind CSS
- Node.js + Express on Firebase Cloud Functions
- Cloud Firestore
- Firebase Authentication
- Firebase Storage
- Firebase Hosting
- Stripe
- Google Gemini
Inteligência artificial
As funcionalidades de IA apoiam o veterinário: um assistente de triagem clínica que pode analisar imagens e ajuda a redigir e refinar relatórios. Assentam no Google Gemini e correm no servidor, por trás da API.
Integrações
- Stripe para planos de subscrição.
- Notificações de agendamento por WhatsApp.
- Assinatura digital de documentos através de um fornecedor de certificado na cloud, atrás de uma interface independente do fornecedor.
- Geração de PDF para relatórios, receitas e pedidos.
Segurança
Os utilizadores autenticam-se com o Firebase Authentication (e-mail e palavra-passe ou Google). As operações sensíveis passam por uma API no servidor, em Cloud Functions, e não pelo navegador, e os segredos ficam no servidor. A segurança está documentada como parte do projeto: revisões de API e de segredos e um modelo de ameaças para receitas controladas.
Resultados
O VetDesk é um produto completo construído de ponta a ponta: aplicação web, API, modelo de dados, autenticação, pagamentos, funcionalidades de IA e documentação de segurança. Não publicamos métricas de utilização nem de negócio para este case.