# US-MMD004-002: Consultar Stock Disponible

## Metadata

| Campo | Valor |
|-------|-------|
| **ID** | US-MMD004-002 |
| **Epica** | EPIC-MMD-004 - Inventario y Refacciones |
| **Modulo** | inventario |
| **Prioridad** | P0 |
| **Story Points** | 3 |
| **Sprint** | Sprint 4 |
| **Estado** | Backlog |

---

## Historia de Usuario

**Como** mecanico o almacenista,
**quiero** consultar rapidamente el stock disponible de una refaccion,
**para** saber si tenemos la pieza antes de ofrecerla al cliente.

## Descripcion Detallada

La consulta de stock debe ser rapida y accesible desde cualquier pantalla. El sistema debe mostrar disponibilidad en tiempo real considerando reservas pendientes.

---

## Criterios de Aceptacion

**Escenario 1: Busqueda rapida**
```gherkin
DADO que necesito una refaccion
CUANDO busco "filtro aceite ISX"
ENTONCES veo resultados:
  | Codigo | Descripcion | Stock | Ubicacion |
  | FLT-001 | Filtro aceite ISX15 | 5 | A-01-03 |
  | FLT-002 | Filtro aceite ISX12 | 3 | A-01-04 |
```

**Escenario 2: Stock disponible vs reservado**
```gherkin
DADO que hay 5 unidades en stock
Y 2 estan reservadas para ordenes
CUANDO consulto disponibilidad
ENTONCES veo:
  | Total | Reservado | Disponible |
  | 5 | 2 | 3 |
```

**Escenario 3: Stock bajo**
```gherkin
DADO que el stock esta por debajo del minimo
CUANDO veo la refaccion
ENTONCES muestra indicador amarillo "Stock bajo"
Y sugiere hacer pedido
```

**Escenario 4: Sin existencia**
```gherkin
DADO que no hay stock
CUANDO consulto la refaccion
ENTONCES muestra indicador rojo "Sin existencia"
Y muestra ultima fecha de entrada
Y proveedores sugeridos
```

**Escenario 5: Busqueda por codigo alterno**
```gherkin
DADO que el cliente tiene numero de parte diferente
CUANDO busco por codigo alterno "LF14000NN"
ENTONCES encuentra la refaccion equivalente
Y muestra todos los codigos alternos
```

---

## Tareas Tecnicas

**Backend:**
- [ ] BE-160: Endpoint GET /api/parts/search
- [ ] BE-161: Calculo de disponibilidad real
- [ ] BE-162: Busqueda por codigo alterno

**Frontend:**
- [ ] FE-160: Crear SearchParts component
- [ ] FE-161: Crear StockIndicator component
- [ ] FE-162: Quick search modal (Ctrl+K)

---

## Definition of Done (DoD)

- [ ] Busqueda rapida funcionando
- [ ] Mostrar stock disponible vs reservado
- [ ] Indicadores visuales de stock
- [ ] Busqueda por codigo alterno
- [ ] Tests pasando

---

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