66161b1566
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
3.0 KiB
3.0 KiB
US-MMD004-007: Ver Kardex de Refaccion
Metadata
| Campo | Valor |
|---|---|
| ID | US-MMD004-007 |
| Epica | EPIC-MMD-004 - Inventario y Refacciones |
| Modulo | inventario |
| Prioridad | P1 |
| Story Points | 5 |
| Sprint | Sprint 5 |
| Estado | Backlog |
Historia de Usuario
Como administrador, quiero ver el kardex completo de movimientos de una refaccion, para rastrear entradas, salidas y saldos historicos.
Descripcion Detallada
El kardex es el registro detallado de todos los movimientos de inventario de una refaccion, incluyendo entradas, salidas, ajustes, y el saldo resultante despues de cada movimiento.
Criterios de Aceptacion
Escenario 1: Ver kardex de refaccion
DADO que consulto kardex de "Filtro aceite ISX"
CUANDO veo los movimientos
ENTONCES muestra cronologicamente:
| Fecha | Tipo | Referencia | Entrada | Salida | Saldo |
| 01-Nov | Compra | OC-001 | 20 | - | 20 |
| 05-Nov | Consumo | OS-123 | - | 2 | 18 |
| 10-Nov | Consumo | OS-125 | - | 1 | 17 |
| 15-Nov | Ajuste | AJ-001 | - | 2 | 15 |
Escenario 2: Filtrar por rango de fechas
DADO que veo el kardex
CUANDO filtro por "Noviembre 2025"
ENTONCES solo muestra movimientos de ese periodo
Y muestra saldo inicial y final del periodo
Escenario 3: Detalle de movimiento
DADO que veo un movimiento
CUANDO hago clic en referencia "OS-123"
ENTONCES navega a la orden de servicio relacionada
Y puedo ver contexto completo del consumo
Escenario 4: Kardex valorizado
DADO que necesito reporte financiero
CUANDO activo "Ver costos"
ENTONCES agrega columnas:
| Costo unit | Debe | Haber | Saldo valor |
| $150 | $3,000 | - | $3,000 |
| $150 | - | $300 | $2,700 |
Escenario 5: Exportar kardex
DADO que necesito el reporte
CUANDO exporto a Excel
ENTONCES genera archivo con:
- Todos los movimientos
- Saldos calculados
- Formato listo para contabilidad
Tipos de Movimiento
| Tipo | Descripcion | Afecta |
|---|---|---|
| Compra | Entrada por orden de compra | +Stock |
| Consumo | Salida a orden de servicio | -Stock |
| Ajuste+ | Ajuste positivo | +Stock |
| Ajuste- | Ajuste negativo/merma | -Stock |
| Devolucion | Regreso de pieza | +Stock |
| Traspaso | Entre ubicaciones | Neutro |
Tareas Tecnicas
Database:
- DB-088: Vista materializada
vw_kardex - DB-089: Indices para performance
Backend:
- BE-177: Endpoint GET /api/parts/:id/kardex
- BE-178: Calculo de saldos
- BE-179: Kardex valorizado
- BE-180: Export a Excel
Frontend:
- FE-175: Crear KardexPage
- FE-176: Crear KardexTable
- FE-177: Crear MovementDetail modal
Definition of Done (DoD)
- Ver kardex cronologico
- Filtrar por fechas
- Ver detalle de movimiento
- Kardex valorizado
- Exportar a Excel
- Tests pasando
Creada por: Requirements-Analyst Fecha: 2025-12-06