Olyvia CRM
Plataforma CRM multi-tenant para gestão de clientes, contactos, leads, oportunidades, orçamentos, propostas, contratos, marketing e operações.
Stack
- React 18, TypeScript e Vite
- Tailwind CSS e shadcn/ui
- Supabase: PostgreSQL, autenticação, RLS, Storage e Edge Functions
- Vitest e Testing Library
- Playwright para testes end-to-end
- Vercel para alojamento do frontend
Requisitos
- Node.js
- npm
- Supabase CLI para desenvolvimento e migrações
- Docker Desktop apenas para executar a stack Supabase local
Configuração
git clone https://github.com/Miguel-olyvia/Olyvia-crm.git
cd Olyvia-crm
npm install
Cria os ficheiros de ambiente locais a partir do exemplo:
copy .env.example .env.local
Preenche apenas variáveis do teu ambiente. Nunca publiques chaves secretas, passwords ou a service_role.
Comandos
npm run dev
npm run build
npm run lint
npm run preview
npx vitest run
O servidor de desenvolvimento usa, por defeito:
http://localhost:8080
Supabase
As migrações versionadas encontram-se em:
supabase/migrations/
Comandos principais:
supabase start
supabase status
supabase migration list
supabase db push --dry-run
supabase db push
Antes de aplicar alterações na base de dados ativa:
- Confirma o projeto Supabase ligado.
- Executa
supabase migration list.
- Executa sempre o
dry-run.
- Não alteres migrações que já tenham sido aplicadas.
Secrets das Edge Functions
As funcionalidades de IA (ai-assistant, chat-widget-ai, quote-ai-assistant, generate-proposal-ai, import-contract-pdf, suggest-schedule-assignee) chamam o Google Gemini através de supabase/functions/_shared/aiGateway.ts, que requer o secret GEMINI_API_KEY configurado no projeto Supabase:
supabase secrets set GEMINI_API_KEY="your-key-here"
Obtém uma chave em https://aistudio.google.com/apikey.
Branches
development: desenvolvimento e integração.- A publicação para produção deve seguir o fluxo definido no GitHub/Vercel.
Segurança
- A autorização real deve ser aplicada na base de dados através de RLS e RPCs seguras.
- Controlos do frontend não substituem autorização no servidor.
- Não incluir dados pessoais, tokens ou segredos nos logs.
- Não fazer commit de
.env, .env.local, dumps privados ou credenciais.
Deploy
O frontend é compilado com:
npm run build
A configuração SPA da Vercel encontra-se em vercel.json.
