workspace-v1/projects/erp-mecanicas-diesel/docs/02-definicion-modulos/MMD-004-inventario/historias-usuario/US-MMD004-002-consultar-stock.md
rckrdmrd 66161b1566 feat: Workspace-v1 complete migration with NEXUS v3.4
Sistema NEXUS v3.4 migrado con:

Estructura principal:
- core/orchestration: Sistema SIMCO + CAPVED (27 directivas, 28 perfiles)
- core/catalog: Catalogo de funcionalidades reutilizables
- shared/knowledge-base: Base de conocimiento compartida
- devtools/scripts: Herramientas de desarrollo
- control-plane/registries: Control de servicios y CI/CD
- orchestration/: Configuracion de orquestacion de agentes

Proyectos incluidos (11):
- gamilit (submodule -> GitHub)
- trading-platform (OrbiquanTIA)
- erp-suite con 5 verticales:
  - erp-core, construccion, vidrio-templado
  - mecanicas-diesel, retail, clinicas
- betting-analytics
- inmobiliaria-analytics
- platform_marketing_content
- pos-micro, erp-basico

Configuracion:
- .gitignore completo para Node.js/Python/Docker
- gamilit como submodule (git@github.com:rckrdmrd/gamilit-workspace.git)
- Sistema de puertos estandarizado (3005-3199)

Generated with NEXUS v3.4 Migration System
EPIC-010: Configuracion Git y Repositorios
2026-01-04 03:37:42 -06:00

2.4 KiB

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

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

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

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

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

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