Skip to main content

šŸ“‡ CRM - Customer Relationship Management

1. šŸ§© DescripciĆ³n Generalā€‹

El mĆ³dulo de CRM (Customer Relationship Management) estĆ” diseƱado para gestionar relaciones con prospectos y clientes, seguimiento comercial, y automatizaciĆ³n de tareas previas a la venta. Este mĆ³dulo se conecta con Ventas, Clientes y eventualmente con Marketing o Postventa.

2. šŸ§± Modelos del MĆ³duloā€‹

a. Leadā€‹

  • id: integer (PK)
  • name: string
  • email: string
  • phone: string
  • source: string (referido, sitio web, evento, etc.)
  • assigned_to: FK ā†’ User
  • status: enum (nuevo, en seguimiento, convertido, perdido)
  • created_at: datetime

b. Opportunityā€‹

  • id: integer (PK)
  • lead_id: FK ā†’ Lead
  • title: string
  • estimated_value: decimal
  • probability: integer (0-100%)
  • stage: enum (contacto, propuesta, negociaciĆ³n, cerrado)
  • expected_close_date: date

c. Activityā€‹

  • id: integer (PK)
  • opportunity_id: FK ā†’ Opportunity
  • type: enum (llamada, correo, visita, reuniĆ³n)
  • description: string
  • scheduled_at: datetime
  • status: enum (pendiente, completada)

d. Conversionā€‹

  • id: integer (PK)
  • lead_id: FK ā†’ Lead
  • client_id: FK ā†’ Client
  • converted_at: datetime
  • notes: text

3. šŸ” Funciones del Controladorā€‹

  • indexLeads(): Ver prospectos.
  • storeLead(): Registrar nuevo lead.
  • convertLead(): Convertir a cliente.
  • indexOpportunities(): Ver oportunidades activas.
  • storeOpportunity(): Crear oportunidad.
  • logActivity(): Registrar acciĆ³n comercial.
  • closeOpportunity(): Marcar como cerrada (ganada o perdida).

4. šŸŒ Endpoints detallados y justificadosā€‹

MĆ©todoRutaDescripciĆ³nJustificaciĆ³n
GET/api/crm/leadsListar prospectosSeguimiento previo a venta
POST/api/crm/leadsCrear leadRegistro inicial de interƩs
POST/api/crm/leads/{id}/convertConvertir a clienteFormalizar relaciĆ³n
GET/api/crm/opportunitiesVer oportunidadesGestiĆ³n del embudo
POST/api/crm/opportunitiesCrear oportunidadPotencial de negocio
POST/api/crm/opportunities/{id}/activityRegistrar actividadSeguimiento comercial
POST/api/crm/opportunities/{id}/closeCerrar oportunidadEstado final de la venta

5. šŸ–„ļø DiseƱo UX sugerido (flujo de usuario)ā€‹

PĆ”gina: "Leads"ā€‹

  • Tabla con nombre, email, telĆ©fono, fuente, estado
  • Filtros por estado, fuente
  • Acciones: Ver, Convertir, Eliminar

PĆ”gina: "Oportunidades"ā€‹

  • Tabla con tĆ­tulo, etapa, valor, fecha esperada
  • Acciones: Ver, Registrar actividad, Cerrar

PĆ”gina: "Calendario de Actividades"ā€‹

  • Vista de actividades agendadas por fecha
  • BotĆ³n: Marcar como completada

6. šŸ“„ Vistas sugeridas (tipo wireframe)ā€‹

VistaCampos sugeridosAcciones
LeadsNombre, email, fuente, estadoVer, Convertir
OportunidadesTĆ­tulo, valor, etapa, fechaVer, Registrar actividad, Cerrar
ActividadTipo, descripciĆ³n, fecha, estadoCompletar, Editar

7. šŸ”— ConexiĆ³n Frontend ā†” API JSON:APIā€‹

AcciĆ³n en FrontendMĆ©todo/APIResultado esperado
Ver leadsGET /api/crm/leadsTabla general
Crear leadPOST /api/crm/leadsNuevo contacto
Convertir a clientePOST /api/crm/leads/{id}/convertAsociar con mĆ³dulo Clientes
Ver oportunidadesGET /api/crm/opportunitiesSeguimiento comercial
Crear oportunidadPOST /api/crm/opportunitiesIniciar seguimiento
Registrar actividadPOST /api/crm/opportunities/{id}/activityAgendar/completar
Cerrar oportunidadPOST /api/crm/opportunities/{id}/closeFinalizar caso

šŸ“‡ Este mĆ³dulo permite a la empresa anticipar ventas, identificar oportunidades de negocio, y convertir prospectos en clientes activos con historial completo desde el primer contacto.