S.P.Y.

CRM/ERP multi-tenant (React + Vite no frontend, Express no backend, Supabase/Postgres como banco). Um único deploy atende vários tenants (empresas) isolados por Row Level Security.

Documentação completa em docs/. A documentação de projeto, verificada contra o banco vivo e o código em 2026-09-24, está em docs/projeto/:

• PRD — requisitos de produto
• TRD — requisitos técnicos, inventário de rotas, segurança
• Fluxo do sistema
• UI/UX
• Esquema de backend — dicionário de dados do banco vivo
• Plano de implementação

Guias temáticos em docs/:

• Arquitetura — como as peças se encaixam, fluxo de dados, multi-tenancy
• Autenticação — login, sessão, recuperação de senha
• Autorização — papéis, RBAC, o que é validado onde
• API — inventário de todas as rotas de server.ts/api/
• Banco de dados — convenções de tenant_id (dicionário completo em docs/projeto/05-ESQUEMA-BACKEND.md)
• Segurança do banco — matriz de RLS/policies
• Webhooks
• Variáveis de ambiente
• Deploy
• Segurança — práticas do projeto, ver também SECURITY_AUDIT.md e SECURITY_CHECKLIST.md
• Desenvolvimento — rodar localmente, estrutura de pastas
• Troubleshooting

Começando

Pré-requisitos: Node.js 20+, um projeto Supabase.

npm install
cp .env.example .env   # preencha com suas credenciais reais — nunca commite o .env
npm run dev

Veja docs/ENVIRONMENT.md para o que cada variável faz e docs/DEVELOPMENT.md para a estrutura do projeto.

Scripts

Comando	O que faz
npm run dev	Sobe o frontend (Vite) + backend (server.ts via tsx) em modo desenvolvimento (porta 3002)
npm run build	Build de produção do frontend (dist/) + bundle do backend (dist/server.cjs)
npm start	Roda o backend já buildado (dist/server.cjs)
npm run lint	Type-check (tsc --noEmit)