Nexo CRM
CRM B2B para gestionar contactos, empresas, oportunidades y actividades comerciales desde una única interfaz.
Funcionalidades
- Autenticación con correo y contraseña mediante Supabase Auth.
- Dashboard con indicadores de pipeline, conversión, tareas y oportunidades recientes.
- Pipeline Kanban con creación, edición, eliminación y movimiento de oportunidades entre etapas.
- Gestión de contactos y empresas con búsqueda y formularios.
- Actividades comerciales: tareas, llamadas, reuniones y notas con estados y prioridades.
- Reportes de pipeline, embudo y resultados de ventas.
- Configuración para administradores: usuarios, pipelines y etapas.
- Interfaz responsive, tema claro/oscuro y diseño CRM moderno.
Stack
- React 19 + TypeScript
- TanStack Start, Router y React Query
- Tailwind CSS + componentes Radix UI
- Supabase (Auth y PostgreSQL con RLS)
- Vite + Nitro
Requisitos
- Node.js 20 o superior
- npm 10 o superior
- Proyecto de Supabase configurado
Instalación local
git clone https://github.com/Felipe7774/NEXUS.git
cd NEXUS
npm install
cp .env.example .env
npm run dev
En Windows, crea el archivo .env manualmente a partir de .env.example.
Variables de entorno
Para ejecutar la app y las pruebas con Docker Desktop y Supabase local:
npm ci
npm run docker:up # App en http://localhost:3000
npm run docker:test # Suite, RLS, spike y compilación dentro de Docker
npm run docker:down # Detiene desarrollo y conserva sus datos locales
Consulta el entorno Docker para requisitos, aislamiento de
datos y resultados. No requiere credenciales de Supabase Cloud.
VITE_SUPABASE_URL=https://<project-ref>.supabase.co
VITE_SUPABASE_PUBLISHABLE_KEY=sb_publishable_<key>
VITE_SUPABASE_PROJECT_ID=<project-ref>
# Requeridas únicamente para operaciones del servidor.
SUPABASE_URL=https://<project-ref>.supabase.co
SUPABASE_PUBLISHABLE_KEY=sb_publishable_<key>
SUPABASE_PROJECT_ID=<project-ref>
SUPABASE_SERVICE_ROLE_KEY=sb_secret_<key>
Nunca expongas SUPABASE_SERVICE_ROLE_KEY en variables VITE_* ni en el navegador.
Base de datos
El proyecto está vinculado mediante Supabase CLI. Las migraciones viven en supabase/migrations.
npx supabase login
npx supabase link --project-ref <project-ref>
npx supabase db push
npx supabase gen types typescript --linked --schema public > src/integrations/supabase/types.ts
Scripts
npm run dev # Desarrollo
npm run build # Compilación de producción
npm run lint # Análisis estático
npm run format # Formatea el código
Arquitectura
src/
components/ Componentes reutilizables y UI
hooks/ Hooks de autenticación y estado
integrations/supabase/ Cliente, middleware y tipos de Supabase
lib/ Consultas, mutaciones y utilidades CRM
routes/ Rutas y pantallas de TanStack Router
supabase/
migrations/ Esquema versionado de la base de datos
docs/ Documentación del proyecto
Los hooks públicos de React Query están en src/lib/crm.ts; el acceso a datos pertenece a src/modules/{identity,relationships,sales,followup}/api.ts, protegido por pruebas de arquitectura. Las pantallas consumen hooks de React Query y los componentes de formularios mantienen las operaciones de creación, edición y eliminación separadas de la capa visual.
La documentación académica de arquitectura está disponible en docs/Arquitectura en software.docx.
Módulo 6
Entrega y explicación, crecimiento k6, matrices y defensa.
Despliegue
La aplicación puede desplegarse con Vercel. Configura las variables VITE_SUPABASE_* y SUPABASE_* necesarias en el proyecto de Vercel y ejecuta:
vercel --prod
Seguridad
- Las políticas RLS de Supabase protegen los datos del CRM.
- Las claves locales se mantienen en
.env, archivo que no se versiona.
- Las claves de servicio se usan solo desde código de servidor.
