# EPICA: EPIC-MGN-013 - Ventas

## Metadata

| Campo | Valor |
|-------|-------|
| **ID** | EPIC-MGN-013 |
| **Nombre** | Ventas |
| **Modulo** | sales |
| **Fase** | Fase 2 - Core Business |
| **Prioridad** | P1 |
| **Estado** | Backlog |
| **Story Points** | 42 |
| **Sprint(s)** | Sprint 10-12 |

---

## Descripcion

Sistema de gestion de ventas que incluye cotizaciones, ordenes de venta, entregas, facturacion de ventas, precios y descuentos. Integrado con inventario y contabilidad.

---

## Objetivo de Negocio

Proveer gestion de ventas que:
- Agilice el ciclo de ventas
- Facilite seguimiento de cotizaciones
- Controle entregas y facturacion
- Gestione precios y descuentos
- Analice desempeno de ventas

---

## Historias de Usuario

| ID | Historia | Prioridad | SP | Estado |
|----|----------|-----------|-----|--------|
| US-MGN013-001 | Como vendedor, quiero crear cotizaciones | P0 | 5 | Backlog |
| US-MGN013-002 | Como vendedor, quiero convertir cotizaciones en ordenes de venta | P0 | 3 | Backlog |
| US-MGN013-003 | Como almacenista, quiero procesar entregas de venta | P0 | 5 | Backlog |
| US-MGN013-004 | Como vendedor, quiero facturar ordenes de venta | P0 | 5 | Backlog |
| US-MGN013-005 | Como vendedor, quiero gestionar listas de precios | P0 | 5 | Backlog |
| US-MGN013-006 | Como vendedor, quiero aplicar descuentos | P1 | 3 | Backlog |
| US-MGN013-007 | Como gerente, quiero ver pipeline de ventas | P1 | 5 | Backlog |
| US-MGN013-008 | Como gerente, quiero reportes de ventas por periodo | P1 | 5 | Backlog |
| US-MGN013-009 | Como vendedor, quiero ver historial de cliente | P2 | 3 | Backlog |
| US-MGN013-010 | Como admin, quiero configurar comisiones de vendedores | P2 | 3 | Backlog |

**Total Story Points:** 42 SP

---

## Criterios de Aceptacion de la Epica

**Funcionales:**
- [ ] Cotizaciones con vigencia y seguimiento
- [ ] Ordenes de venta con workflow
- [ ] Entregas parciales y totales
- [ ] Facturacion vinculada (CFDI)
- [ ] Listas de precios por cliente/categoria
- [ ] Descuentos por volumen, cliente, promo

**No Funcionales:**
- [ ] Trazabilidad cotizacion-orden-entrega-factura
- [ ] Dashboard de ventas en tiempo real

---

## Dependencias

**Esta epica depende de:**
| Epica/Modulo | Estado | Bloqueante |
|--------------|--------|------------|
| EPIC-MGN-005 Catalogs | Backlog | Si |
| EPIC-MGN-010 Financial | Backlog | Si |
| EPIC-MGN-011 Inventory | Backlog | Si |

---

## Desglose Tecnico

**Database:**
- [ ] Schema: `core_sales`
- [ ] Tablas: 8+ (quotations, sale_orders, so_lines, deliveries, pricelists, etc.)
- [ ] Funciones: 3+

**Backend:**
- [ ] Modulo: `sales`
- [ ] Entities: 8+
- [ ] Endpoints: 20+
- [ ] Tests: 35+

**Frontend:**
- [ ] Paginas: 7 (cotizaciones, ordenes, entregas, precios, reportes)
- [ ] Componentes: 18+
- [ ] Stores: 1 (salesStore)

---

**Creada por:** Requirements-Analyst
**Fecha:** 2025-12-05