# EPICA: EPIC-MGN-011 - Inventario

## Metadata

| Campo | Valor |
|-------|-------|
| **ID** | EPIC-MGN-011 |
| **Nombre** | Inventario y Stock |
| **Modulo** | inventory |
| **Fase** | Fase 2 - Core Business |
| **Prioridad** | P1 |
| **Estado** | Backlog |
| **Story Points** | 42 |
| **Sprint(s)** | Sprint 7-9 |

---

## Descripcion

Sistema de gestion de inventario que incluye almacenes, ubicaciones, movimientos de stock, valoracion de inventario, ajustes y transferencias. Soporta multiples metodos de valoracion (PEPS, UEPS, Promedio).

---

## Objetivo de Negocio

Proveer control de inventario que:
- Rastree stock en tiempo real
- Soporte multiples almacenes
- Valore inventario correctamente
- Minimice perdidas por faltantes
- Optimice reabastecimiento

---

## Historias de Usuario

| ID | Historia | Prioridad | SP | Estado |
|----|----------|-----------|-----|--------|
| US-MGN011-001 | Como almacenista, quiero gestionar almacenes y ubicaciones | P0 | 5 | Backlog |
| US-MGN011-002 | Como almacenista, quiero registrar entradas de inventario | P0 | 5 | Backlog |
| US-MGN011-003 | Como almacenista, quiero registrar salidas de inventario | P0 | 5 | Backlog |
| US-MGN011-004 | Como almacenista, quiero realizar transferencias entre almacenes | P0 | 5 | Backlog |
| US-MGN011-005 | Como almacenista, quiero realizar ajustes de inventario | P0 | 5 | Backlog |
| US-MGN011-006 | Como contador, quiero ver la valoracion del inventario | P1 | 8 | Backlog |
| US-MGN011-007 | Como gerente, quiero ver reportes de movimientos de stock | P1 | 5 | Backlog |
| US-MGN011-008 | Como comprador, quiero ver alertas de stock minimo | P1 | 3 | Backlog |

**Total Story Points:** 41 SP (ajustado a 42)

---

## Criterios de Aceptacion de la Epica

**Funcionales:**
- [ ] Gestion de almacenes y ubicaciones jerarquicas
- [ ] Movimientos de entrada, salida y transferencia
- [ ] Ajustes de inventario con motivo
- [ ] Valoracion PEPS, UEPS, Promedio
- [ ] Kardex por producto
- [ ] Alertas de stock minimo

**No Funcionales:**
- [ ] Consulta de stock < 100ms
- [ ] Trazabilidad completa de movimientos

---

## Dependencias

**Esta epica depende de:**
| Epica/Modulo | Estado | Bloqueante |
|--------------|--------|------------|
| EPIC-MGN-005 Catalogs (Products) | Backlog | Si |

**Esta epica bloquea:**
| Epica/Modulo | Razon |
|--------------|-------|
| EPIC-MGN-012 Purchasing | Recepciones de compra |
| EPIC-MGN-013 Sales | Entregas de venta |

---

## Desglose Tecnico

**Database:**
- [ ] Schema: `core_inventory`
- [ ] Tablas: 8+ (warehouses, locations, stock_quants, stock_moves, etc.)
- [ ] Funciones: 4+ (calcular_stock, valorar_inventario, etc.)

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

**Frontend:**
- [ ] Paginas: 6 (almacenes, inventario, movimientos, kardex, reportes)
- [ ] Componentes: 15+
- [ ] Stores: 2 (inventoryStore, stockStore)

---

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