Qlinic
ERP SaaS multi-tenant e multiunidade para odontologia, medicina ambulatorial, veterinária, estética, psicologia, fisioterapia e nutrição.
Dois ambientes no mesmo build:
- Demonstração (
/demonstracao): dados fictícios no navegador, integrações simuladas.
- Conectado (
/auth/login, quando VITE_SUPABASE_* está definido): Supabase Auth + Postgres com RLS, IA (Gemini) e WhatsApp (Evolution) reais via Edge Functions. Ver docs/BACKEND_SUPABASE.md.
Ainda simulados no conectado (dependem de contrato): pagamentos, e-mail transacional, worker da fila de mensagens, assinatura eletrônica, TISS, NFS-e, push, armazenamento de arquivos.
Antes de operar com pacientes reais: revisão jurídica/LGPD e auditoria de segurança. Nome e marca “Qlinic” são provisórios.
Requisitos
Node 22+ e npm 10+. (Para regenerar ícones PWA e rodar E2E: npx playwright install chromium.)
Instalação e scripts
npm ci
npm run dev # http://localhost:5173
npm run build # typecheck + build de produção em dist/
npm run preview # serve dist/ em http://localhost:4173 (SW e PWA ativos)
npm run typecheck
npm run lint
npm test # Vitest (regras de domínio)
npm run e2e # Playwright (usa build: rode npm run build antes)
npm run icons # regenera public/t/<slug>/ (manifestos + ícones por clínica)
Como usar a demonstração
Abra /demonstracao e escolha clínica + perfil. Ambientes:
| Ambiente | Rota | Perfis |
|---|
| Site comercial | /, /segmentos/:segmento, /planos, /recursos, /ajuda | público |
| Identidade visual | /demonstracao/identidade | público |
| Autenticação (demonstrativa) | /auth/login, /auth/recuperar, /auth/convite, /auth/verificar, /auth/mfa | público |
| Super Admin | /master/* | proprietário, financeiro SaaS, suporte SaaS |
| Equipe da clínica | /app/:slug/* | proprietário, gestor da rede/unidade, recepção, profissional, auxiliar, financeiro, estoque |
| Página pública | /c/:slug, /c/:slug/agendar | público |
| Portal paciente/tutor | /c/:slug/portal/* | paciente, tutor, responsável |
| Totem / painel | /c/:slug/totem, /c/:slug/painel | quiosque |
| Proposta | /c/:slug/proposta/:token | link |
Clínicas fictícias: sorriso-pleno (odontologia, 2 unidades), clinica-vitta (medicina), vet-amigo (veterinária), lumiere-estetica,
espaco-escuta (psicologia), movimento-fisio, nutri-equilibrio. Também é possível criar uma clínica nova (onboarding).
Banner permanente de demonstração com “Restaurar dados” (apaga tudo do navegador, com confirmação). Data-base configurável na página de demonstração.
Limitações reais
- Persistência apenas no
localStorage deste navegador (isolamento por namespace não é segurança).
- Pagamentos, WhatsApp, e-mail, IA, assinatura, TISS, NFS-e: simulados e marcados como tal.
- PWA instalável para as clínicas seed (manifestos gerados em build). Clínicas criadas na demo não têm manifesto publicado (exige backend).
- Push: só permissão/estado; entrega real exige backend. iOS físico não testado.
- Ver
docs/QA_REPORT.md para o que foi efetivamente testado.
Documentação
docs/ESCOPO_E_STATUS.md (rastreabilidade) · docs/ARQUITETURA.md · docs/DESIGN_SYSTEM.md · docs/PERMISSOES.md · docs/PWA_WHITE_LABEL.md ·
docs/INTEGRACOES.md · docs/BACKEND_SUPABASE.md · docs/DEPLOY_GITHUB_VERCEL_CLOUDFLARE.md · docs/QA_REPORT.md · docs/PROXIMA_ETAPA_BACKEND.md ·
identidade: docs/IDENTIDADE_VISUAL.md, docs/Qlinic_Manual_de_Identidade.pdf.
