erp-mecanicas-diesel/docs/02-definicion-modulos/MMD-004-inventario/historias-usuario/US-MMD004-002-consultar-stock.md

104 lines
2.4 KiB
Markdown

# 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