Cliwefy — Documentação Técnica¶
Plataforma SaaS multi-tenant de gestão para clínicas odontológicas, em três níveis: Cliwefy (plataforma) → Franqueadora (rede, ex.: Coife Odonto, 311 unidades) → Clínica (unidade), mais o PWA do Dentista e o Portal do Paciente.
Para que serve esta documentação
É a fonte de verdade técnica do sistema — arquitetura, modelo de dados, módulos, integrações, segurança/LGPD e decisões. Mantida como código (versionada no repositório), publicada e sempre atual.
Stack¶
| Camada | Tecnologia |
|---|---|
| Frontend/Backend | Next.js 15 (App Router, TypeScript) · Tailwind |
| Banco | Supabase (PostgreSQL) — acesso por RPC SECURITY DEFINER |
| Infra | Docker no VPS · nginx (TLS Let's Encrypt) |
| Mídia | Bunny.net (CDN, URL assinada) |
| Integrações | Asaas · Memed · WhatsJá · Nuvem Fiscal/NFSe · Supabase Auth |
Princípios de arquitetura¶
- Acesso a dados = RPC
SECURITY DEFINER+ guards. O service-role não bypassa RLS; oclinic_id/org_idvem sempre do servidor. (ver Arquitetura e Decisões) - Isolamento multi-tenant por
clinic_id(unidade) eorganization_id(rede). (ver Segurança & LGPD) - O app clínico é idêntico para clínica solo e para unidade de rede; a franqueadora é camada aditiva.
- Dados sensíveis de saúde (LGPD art. 11): imagem clínica em CDN com URL assinada, retenção com soft-delete.
Mapa da documentação¶
- Arquitetura — padrões, multi-tenant, deploy.
- Modelo de dados — catálogo das tabelas por domínio.
- Módulos — o que o produto faz.
- Integrações — parceiros externos, status e lock-in.
- Segurança & LGPD — postura de segurança e privacidade.
- Decisões (ADR) — o porquê das escolhas técnicas.
- Regras de negócio · Perfis & dashboards
- Runbooks — deploy, backup, incidentes.
- Histórico
Changelog de releases
O histórico de lançamentos (o que mudou a cada deploy) fica na própria aplicação em /dev/atualizações, com segmentação de audiência (interno/público).