Virex — Sistema Interno de Gestão

Sistema interno para controle de projetos, financeiro e colaboradores, com autenticação e permissões via Supabase.

Versão atual: v1.3
Última atualização: 03/01/2026

---

Stack

• Front-end: React + TypeScript + Vite + Tailwind
• Rotas: React Router
• Backend (BaaS): Supabase (Auth + Postgres + RLS)

---

Estrutura do repositório

• app/: aplicação web (UI)
• supabase/: SQL do banco (schema + RLS) e seeds/exemplos
• docs/: documentação do projeto (ex.: escopo, próximas fases)

---

Pré-requisitos

• Node.js (recomendado 18+)
• pnpm (padrão do projeto)

---

Configurar o Supabase (banco + permissões)

Siga o passo a passo em supabase/README.md. Em resumo:

1. Crie um projeto no Supabase.
2. Em SQL Editor, execute na ordem:
   • supabase/schema.sql
   • supabase/rls.sql
3. (Opcional) Seed:
   • supabase/examples.sql
   • supabase/seed-ceo.sql (depois de criar o usuário no Auth)

Importante: além do usuário no Auth, deve existir o perfil em public.users (com role e active) para as regras funcionarem.

---

Variáveis de ambiente (Front-end)

1. Copie app/env.example para app/.env
2. Preencha:
   • VITE_SUPABASE_URL
   • VITE_SUPABASE_ANON_KEY (ou VITE_SUPABASE_PUBLISHABLE_DEFAULT_KEY)

---

Rodar localmente

cd app
pnpm install
pnpm dev

---

Scripts úteis (app)

Dentro de app/:

• pnpm dev: roda o servidor de desenvolvimento
• pnpm build: build de produção
• pnpm preview: preview do build
• pnpm lint: lint do projeto

---

Funcionalidades Principais

• Dashboard: Visão geral com métricas financeiras, projetos ativos e colaboradores
• Projetos: Gestão completa de projetos com controle de progresso, valores e recebimentos
• Financeiro: Controle de entradas e saídas, extrato, fluxo de caixa e pagamentos de colaboradores
• Colaboradores: Gestão de colaboradores fixos e freelancers com controle de pagamentos

Rotas

• /login - Página de login
• /dashboard - Dashboard principal com métricas
• /projects - Lista e gestão de projetos
• /projects/:id - Detalhes do projeto
• /finance - Módulo financeiro (apenas CEO)
• /collaborators - Gestão de colaboradores (apenas CEO)

---

Deploy na Vercel (sugestão)

1. Importe o repositório na Vercel.
2. Configure:
   • Root Directory: app
   • Build Command: pnpm build
   • Output Directory: dist
3. Em Environment Variables, adicione:
   • VITE_SUPABASE_URL
   • VITE_SUPABASE_ANON_KEY (ou VITE_SUPABASE_PUBLISHABLE_DEFAULT_KEY)

---

Documentação

• Escopo do MVP: docs/Escopo do Projeto.md
• Próxima fase (design): docs/Melhoria de Design (Proxima Fase).md