CRM con Inteligencia Artificial

Sistema de Gestión de Relaciones con Clientes (CRM) potenciado con herramientas de IA para automatizar y optimizar la interacción con clientes, análisis de datos y toma de decisiones.

Características

• Gestión de Clientes: Administración completa del ciclo de vida del cliente
• Automatización con IA: Integración con modelos de lenguaje para análisis de sentimiento, resumen de conversaciones y predicciones
• Dashboard Inteligente: Visualización de métricas y insights generados por IA
• API RESTful: Backend robusto con arquitectura limpia

Arquitectura

/
├── packages/backend/      # API NestJS + TypeORM + PostgreSQL
│   ├── src/
│   │   ├── application/   # Casos de uso y servicios
│   │   ├── domain/        # Entidades y lógica de negocio
│   │   └── infrastructure/# Controladores, DB, interceptores
│   └── Dockerfile
├── packages/frontend/     # React 19 + Vite + TypeScript
│   └── Dockerfile
└── docker-compose.yml     # Orquestación de servicios

Stack Tecnológico

Backend

• NestJS - Framework Node.js escalable
• TypeORM - ORM para PostgreSQL
• Zod - Validación de esquemas
• PostgreSQL - Base de datos relacional

Frontend

• React 19 - UI library
• Vite - Build tool ultrarrápido
• TypeScript - Tipado estático

Infraestructura

• Docker - Contenedores multi-stage
• Nginx - Servidor web para el frontend

Requisitos

• Docker y Docker Compose
• Node.js 20+ (para desarrollo local)

Instalación

Con Docker (Recomendado)

# Construir y levantar todos los servicios
docker-compose up --build

# Acceder a:
# - Frontend: http://localhost:80
# - API: http://localhost:3000

Desarrollo Local

Backend:

cd packages/backend
npm install
npm run start:dev    # Puerto 3000

Frontend:

cd packages/frontend
npm install
npm run dev          # Puerto 5173 (Vite default)

Scripts Disponibles

Comandos desde la raíz del monorepo (usando workspaces):

Comando	Descripción
npm install	Instala dependencias en raíz y todos los workspaces
npm run backend:dev	Backend con hot-reload (puerto 3000)
npm run frontend:dev	Frontend Vite dev server (puerto 5173)
npm run backend:test	Tests unitarios del backend (Jest)
npm run frontend:test	Tests del frontend
npm run build	Build de producción en todos los workspaces
npm run lint	ESLint en todos los workspaces
npm run test	Tests en todos los workspaces
npm run dev	Levantar todos los servicios con Docker
npm run dev:down	Detener servicios de Docker

Estructura del Proyecto

El backend sigue una arquitectura en capas:

• Domain: Entidades y reglas de negocio puras
• Application: Casos de uso, servicios y lógica de aplicación
• Infrastructure: Controladores HTTP, repositorios, filtros e interceptores

Características implementadas:

• Patrón Unit of Work para transacciones
• Repositorio genérico con soporte transaccional
• Interceptores de respuesta estandarizados
• Manejo global de excepciones
• Validación con Zod

Roadmap de IA

• Análisis de sentimiento en interacciones con clientes
• Generación automática de resúmenes de conversaciones
• Predicción de churn con modelos de ML
• Asistente virtual integrado
• Clasificación automática de leads
• Recomendaciones personalizadas

Licencia

ISC