6.1 KiB
6.1 KiB
EPICA: EPIC-MGN-014 - CRM Basico
Metadata
| Campo | Valor |
|---|---|
| ID | EPIC-MGN-014 |
| Nombre | CRM Basico |
| Modulo | crm |
| Fase | Fase 3 - Extended |
| Prioridad | P2 |
| Estado | Backlog |
| Story Points | 34 |
| Sprint(s) | Sprint 15-17 |
Descripcion
Sistema CRM basico que incluye gestion de leads, oportunidades, pipeline de ventas visual (Kanban), actividades de seguimiento, conversion a cliente y reportes de funnel y forecast. Diseñado para equipos comerciales pequeños y medianos.
Objetivo de Negocio
Proveer CRM que:
- Capture y califique leads de multiples fuentes
- Gestione pipeline de ventas visualmente
- Facilite seguimiento de oportunidades con recordatorios
- Mejore tasa de conversion con scoring
- Analice desempeno comercial con metricas clave
Stakeholders
| Rol | Nombre/Equipo | Responsabilidad |
|---|---|---|
| Product Owner | Equipo Producto | Definicion de funcionalidades comerciales |
| Tech Lead | Equipo Backend | Arquitectura y performance |
| Gerente Comercial | Ventas | Definicion de pipeline y metricas |
| Vendedores | Ventas | Uso diario, feedback UX |
Historias de Usuario
| ID | Historia | Prioridad | SP | Estado |
|---|---|---|---|---|
| US-MGN014-001 | Como vendedor, quiero capturar leads desde formularios web para alimentar el pipeline | P0 | 5 | Backlog |
| US-MGN014-002 | Como vendedor, quiero calificar leads con scoring para priorizar seguimiento | P0 | 3 | Backlog |
| US-MGN014-003 | Como vendedor, quiero crear oportunidades desde leads calificados para gestionar el proceso de venta | P0 | 5 | Backlog |
| US-MGN014-004 | Como vendedor, quiero gestionar pipeline en vista Kanban para visualizar el estado de mis oportunidades | P0 | 5 | Backlog |
| US-MGN014-005 | Como vendedor, quiero registrar actividades de seguimiento para no perder contacto con prospectos | P0 | 3 | Backlog |
| US-MGN014-006 | Como vendedor, quiero convertir lead a cliente/partner para iniciar operaciones comerciales | P0 | 3 | Backlog |
| US-MGN014-007 | Como gerente, quiero ver reporte de funnel para analizar conversion por etapa | P1 | 5 | Backlog |
| US-MGN014-008 | Como gerente, quiero ver forecast de ventas para planificar recursos | P1 | 5 | Backlog |
Total Story Points: 34 SP
Criterios de Aceptacion de la Epica
Funcionales:
- Captura de leads desde formularios web y API
- Scoring de leads configurable (criterios personalizables)
- Pipeline visual (Kanban) con drag & drop
- Etapas configurables por tenant
- Actividades con tipos (llamada, email, reunion) y recordatorios
- Conversion lead -> partner (cliente/proveedor)
- Conversion oportunidad ganada -> cotizacion
- Reportes de funnel y forecast
No Funcionales:
- Performance: Kanban carga en < 1s con 500+ oportunidades
- UX: Drag & drop fluido sin lag
- Responsive: Funcional en tablets
Tecnicos:
- Cobertura de tests > 80%
- API documentada para integraciones
- Webhooks para eventos (lead creado, oportunidad ganada)
Dependencias
Esta epica depende de:
| Epica/Modulo | Estado | Bloqueante |
|---|---|---|
| EPIC-MGN-005 Catalogs (Partners) | Backlog | Si |
| EPIC-MGN-001 Auth | Ready | Si |
| EPIC-MGN-004 Tenants | Ready | Si |
Esta epica bloquea:
| Epica/Modulo | Razon |
|---|---|
| Integracion con EPIC-MGN-013 Sales | Conversion oportunidad a cotizacion |
| Integracion con EPIC-MGN-018 WhatsApp | Canal de comunicacion con leads |
Desglose Tecnico
Database:
- Schema:
core_crm - Tablas: 8 (leads, opportunities, stages, activities, activity_types, tags, sources, scoring_rules)
- Funciones: calcular_score, obtener_forecast
- RLS Policies: Si (por tenant y por vendedor asignado)
Backend:
- Modulo:
crm - Entities: 8 (Lead, Opportunity, Stage, Activity, ActivityType, Tag, Source, ScoringRule)
- Endpoints: 20+
- Services: LeadService, OpportunityService, ActivityService, PipelineService
- Tests: 30+
Frontend:
- Paginas: 6 (Leads, LeadDetail, Opportunities, Pipeline, Activities, Reports)
- Componentes: KanbanBoard, LeadCard, OpportunityCard, ActivityTimeline, FunnelChart, ForecastChart
- Stores: 1 (crmStore con slices: leads, opportunities, activities)
Riesgos
| Riesgo | Probabilidad | Impacto | Mitigacion |
|---|---|---|---|
| Performance Kanban con muchos datos | Media | Alto | Virtualizacion, paginacion server-side |
| Adopcion por usuarios | Media | Medio | UX intuitivo, capacitacion |
| Integracion con ventas compleja | Baja | Alto | API clara, documentacion |
Definition of Ready (DoR)
- Historias de usuario definidas
- Criterios de aceptacion claros
- Dependencias identificadas
- Estimacion completada
- Etapas default del pipeline definidas
- Criterios de scoring default definidos
- Sin bloqueadores activos
Definition of Done (DoD)
- Codigo implementado y revisado
- Tests pasando (unit, integration, e2e)
- Kanban funcional con drag & drop
- Reportes generandose correctamente
- Documentacion actualizada
- Inventarios actualizados
- Trazas registradas
- Demo realizada
- Product Owner aprobo
Documentacion Relacionada
- Requerimientos:
docs/03-requerimientos/RF-crm/ - User Stories:
docs/05-user-stories/mgn-014/ - DDL Spec:
docs/04-modelado/database-design/DDL-SPEC-core_crm.md - Especificaciones:
docs/04-modelado/especificaciones-tecnicas/backend/mgn-014/
Historial
| Fecha | Cambio | Autor |
|---|---|---|
| 2025-12-05 | Creacion de epica | Requirements-Analyst |
| 2025-12-05 | Completado con Stakeholders, Riesgos, DoR/DoD | Requirements-Analyst |
Creada por: Requirements-Analyst Fecha: 2025-12-05 Ultima actualizacion: 2025-12-05