366 lines
14 KiB
Markdown
366 lines
14 KiB
Markdown
# RF-PURCH-004: Kárdex y Alertas de Stock
|
||
|
||
**Épica:** MAI-004 - Compras e Inventarios
|
||
**Versión:** 1.0
|
||
**Fecha:** 2025-11-17
|
||
|
||
---
|
||
|
||
## 1. Descripción General
|
||
|
||
Sistema de control detallado por material (kárdex) con análisis de consumo, proyecciones de faltantes, comparación contra presupuesto y alertas automáticas de stock mínimo, sobreconsumo y materiales obsoletos.
|
||
|
||
---
|
||
|
||
## 2. Objetivos de Negocio
|
||
|
||
- **Prevención:** Evitar paros de obra por falta de material
|
||
- **Control:** Detectar sobreconsumo vs presupuesto
|
||
- **Optimización:** Reducir inventario ocioso (capital inmovilizado)
|
||
- **Visibilidad:** Dashboard ejecutivo de inventarios
|
||
|
||
---
|
||
|
||
## 3. Alcance Funcional
|
||
|
||
### 3.1 Kárdex por Material
|
||
|
||
**Vista Detallada:**
|
||
```
|
||
┌────────────────────────────────────────────────────────────────┐
|
||
│ KÁRDEX - Cemento CPC 30R │
|
||
│ Almacén: Fracc. Los Pinos | Período: Nov 2025 │
|
||
├────────────────────────────────────────────────────────────────┤
|
||
│ Fecha │ Movim. │ Detalle │Entrada│Salida│Saldo│Costo U││
|
||
├───────┼────────┼────────────────┼───────┼──────┼─────┼───────┤│
|
||
│01/Nov │ENT-234 │OC-145 Cemex │120 ton│ │120 │$4,350 ││
|
||
│05/Nov │SAL-456 │Cimentación E1 │ │25 ton│95 │$4,350 ││
|
||
│10/Nov │SAL-457 │Cimentación E1 │ │30 ton│65 │$4,350 ││
|
||
│15/Nov │ENT-235 │OC-146 Cemex │80 ton │ │145 │$4,400 ││
|
||
│20/Nov │SAL-458 │Cimentación E2 │ │45 ton│100 │$4,367*││
|
||
│25/Nov │SAL-459 │Muros E1 │ │20 ton│80 │$4,380 ││
|
||
│30/Nov │ │Inventario final│ │ │80 │$4,380 ││
|
||
└───────┴────────┴────────────────┴───────┴──────┴─────┴───────┘
|
||
*Costo promedio ponderado
|
||
|
||
Resumen Noviembre:
|
||
Entradas: 200 ton ($876,000)
|
||
Salidas: 120 ton ($524,400)
|
||
Saldo final: 80 ton ($351,600)
|
||
Costo promedio: $4,380/ton
|
||
```
|
||
|
||
### 3.2 Análisis de Consumo
|
||
|
||
**Comparativo Presupuesto vs Real:**
|
||
```
|
||
┌────────────────────────────────────────────────────────────┐
|
||
│ ANÁLISIS DE CONSUMO - Cemento CPC 30R │
|
||
│ Proyecto: Fracc. Los Pinos | Avance: 45% │
|
||
├────────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ Presupuesto Total: 250 ton │
|
||
│ Presupuestado al 45%: 112.5 ton │
|
||
│ Consumo Real: 120 ton │
|
||
│ Desviación: +7.5 ton (+6.7%) 🟡 │
|
||
│ │
|
||
│ Proyección al 100%: 267 ton │
|
||
│ Sobreconsumo esperado: +17 ton (+6.8%) │
|
||
│ Impacto económico: +$74,460 📊 │
|
||
│ │
|
||
│ ■ Causas Identificadas: │
|
||
│ • Mayor desperdicio en mezclas (4% vs 3% presup) │
|
||
│ • Cambio de diseño en cimentación (+5 viviendas) │
|
||
│ │
|
||
│ ■ Recomendaciones: │
|
||
│ ✓ Revisar dosificaciones con laboratorio │
|
||
│ ✓ Capacitar cuadrillas en manejo de material │
|
||
│ ✓ Actualizar presupuesto por cambio de alcance │
|
||
└────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
**Gráfica de Tendencia:**
|
||
```
|
||
Consumo Semanal (ton)
|
||
30│ ╱╲
|
||
│ ╱───╯ ╲
|
||
25│ ╱───╯ ╲___
|
||
│ ╱───╯ ╲
|
||
20│╱───╯ ╲___
|
||
│ ╲
|
||
15│ ╲___
|
||
└─────────────────────────────────────→
|
||
S1 S2 S3 S4 S5 S6 S7 S8 Semanas
|
||
|
||
Promedio: 22.5 ton/semana
|
||
Tendencia: Estable
|
||
```
|
||
|
||
### 3.3 Alertas Automáticas
|
||
|
||
#### Configuración por Material
|
||
```
|
||
Material: Cemento CPC 30R
|
||
┌──────────────────────────────────────────┐
|
||
│ CONFIGURACIÓN DE ALERTAS │
|
||
├──────────────────────────────────────────┤
|
||
│ Stock Mínimo: 20 ton │
|
||
│ Stock Máximo: 150 ton │
|
||
│ Punto Reorden: 40 ton │
|
||
│ Lead Time: 5 días │
|
||
│ │
|
||
│ Alertas Activas: │
|
||
│ ☑ Stock bajo mínimo │
|
||
│ ☑ Punto de reorden alcanzado │
|
||
│ ☑ Sobreconsumo vs presupuesto >5% │
|
||
│ ☐ Material sin movimiento 90 días │
|
||
│ ☑ Stock sobre máximo │
|
||
│ │
|
||
│ Notificar a: │
|
||
│ • Gerente de Compras (email) │
|
||
│ • Residente de Obra (in-app) │
|
||
└──────────────────────────────────────────┘
|
||
```
|
||
|
||
#### Tipos de Alertas
|
||
|
||
**1. Stock Mínimo**
|
||
```
|
||
⚠️ ALERTA: Stock Bajo Mínimo
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
Material: Varilla 3/8" fy=4200
|
||
Almacén: Fracc. Los Pinos
|
||
|
||
Stock actual: 150 kg
|
||
Stock mínimo: 500 kg
|
||
Faltante: 350 kg
|
||
|
||
Consumo promedio: 85 kg/día
|
||
Días restantes: 1.8 días ⚠️
|
||
|
||
Acción requerida:
|
||
→ Generar requisición urgente
|
||
→ Solicitar traspaso de Alm. General
|
||
→ Alertar a residente de posible paro
|
||
```
|
||
|
||
**2. Punto de Reorden**
|
||
```
|
||
🔔 NOTIFICACIÓN: Punto de Reorden
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
Material: Block 15cm
|
||
Stock actual: 2,000 pza
|
||
Punto reorden: 2,000 pza
|
||
|
||
Consumo semanal: 1,500 pza
|
||
Lead time: 7 días
|
||
|
||
Sugerencia:
|
||
→ Ordenar 6,000 pza (4 semanas de consumo)
|
||
→ Proveedores recomendados:
|
||
• Bloques del Norte (A-87pts)
|
||
• Prefabricados SA (A-85pts)
|
||
```
|
||
|
||
**3. Sobreconsumo**
|
||
```
|
||
🔴 ALERTA CRÍTICA: Sobreconsumo
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
Material: Acero fy=4200
|
||
Partida: 03-Estructura
|
||
|
||
Presupuestado (45%): 38.2 ton
|
||
Consumo real: 42.5 ton
|
||
Desviación: +4.3 ton (+11.3%) 🔴
|
||
|
||
Proyección al 100%: 94.4 ton
|
||
Presupuesto total: 85.0 ton
|
||
Sobrecosto esperado: +9.4 ton (+11%)
|
||
Impacto económico: +$192,700
|
||
|
||
Causas posibles:
|
||
• Cambio en diseño estructural
|
||
• Mayor desperdicio de corte
|
||
• Error en cuantificación inicial
|
||
|
||
Acción inmediata:
|
||
→ Reunión con ingeniero estructural
|
||
→ Revisión de planos ejecutivos
|
||
→ Plan de mitigación obligatorio
|
||
```
|
||
|
||
**4. Material Obsoleto**
|
||
```
|
||
⏰ ALERTA: Material Sin Movimiento
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
Material: Azulejo blanco 20x20
|
||
Almacén: Almacén General
|
||
Stock: 85 m²
|
||
Valor: $25,500
|
||
|
||
Sin movimiento desde: 15/Ago/2025 (107 días)
|
||
|
||
Sugerencia:
|
||
→ Verificar si es material discontinuado
|
||
→ Ofrecer a otros proyectos
|
||
→ Liquidar con descuento
|
||
→ Donar si no hay demanda
|
||
```
|
||
|
||
### 3.4 Dashboard de Inventarios
|
||
|
||
**Vista Ejecutiva:**
|
||
```
|
||
┌─────────────────────────────────────────────────────────┐
|
||
│ DASHBOARD DE INVENTARIOS │
|
||
│ Actualizado: 30/Nov/2025 18:00 │
|
||
├─────────────────────────────────────────────────────────┤
|
||
│ │
|
||
│ ■ Resumen General │
|
||
│ Almacenes activos: 5 │
|
||
│ Materiales en stock: 1,847 │
|
||
│ Valor total inventario: $11,280,000 │
|
||
│ │
|
||
│ ■ Alertas Activas (12) │
|
||
│ 🔴 Stock crítico: 3 materiales │
|
||
│ 🟡 Punto reorden: 6 materiales │
|
||
│ 🟠 Sobreconsumo: 2 materiales │
|
||
│ ⏰ Sin movimiento 90d: 1 material │
|
||
│ │
|
||
│ ■ Top 5 Materiales por Valor │
|
||
│ 1. Acero fy=4200 $3,250,000 (28.8%) │
|
||
│ 2. Cemento CPC 30R $1,840,000 (16.3%) │
|
||
│ 3. Block 15cm $875,000 (7.8%) │
|
||
│ 4. Concreto premezclado $720,000 (6.4%) │
|
||
│ 5. Varilla corrugada $650,000 (5.8%) │
|
||
│ │
|
||
│ ■ Rotación de Inventario │
|
||
│ Índice rotación: 8.5 veces/año ✓ │
|
||
│ Días inventario: 43 días │
|
||
│ Meta: <60 días │
|
||
└─────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 3.5 Reportes Especializados
|
||
|
||
**1. Consumo por Proyecto**
|
||
```
|
||
REPORTE: Consumo de Materiales por Proyecto
|
||
Período: Nov 2025
|
||
|
||
Proyecto: Fracc. Los Pinos
|
||
┌──────────────────┬─────────┬──────────┬────────────┐
|
||
│ Material │ Consumo │ Costo │ %Total │
|
||
├──────────────────┼─────────┼──────────┼────────────┤
|
||
│ Cemento CPC 30R │ 120 ton │ $524,400 │ 35.2% │
|
||
│ Acero fy=4200 │ 42.5 ton│ $871,250 │ 58.5% │
|
||
│ Block 15cm │ 4,500pza│ $94,500 │ 6.3% │
|
||
│ TOTAL │ │$1,490,150│ 100% │
|
||
└──────────────────┴─────────┴──────────┴────────────┘
|
||
```
|
||
|
||
**2. Análisis ABC**
|
||
```
|
||
Clasificación ABC de Inventario
|
||
|
||
Clase A (80% del valor, 20% de items):
|
||
• Acero fy=4200
|
||
• Cemento CPC 30R
|
||
• Concreto premezclado
|
||
→ Control estricto, inventario justo
|
||
|
||
Clase B (15% del valor, 30% de items):
|
||
• Block 15cm
|
||
• Varilla corrugada
|
||
• Arena, grava
|
||
→ Control moderado
|
||
|
||
Clase C (5% del valor, 50% de items):
|
||
• Consumibles menores
|
||
• Herramienta menor
|
||
→ Control básico
|
||
```
|
||
|
||
---
|
||
|
||
## 4. Modelo de Datos
|
||
|
||
```typescript
|
||
// material_stock_config
|
||
{
|
||
id: UUID,
|
||
materialId: UUID,
|
||
warehouseId: UUID,
|
||
|
||
minimumStock: DECIMAL(12,4),
|
||
maximumStock: DECIMAL(12,4),
|
||
reorderPoint: DECIMAL(12,4),
|
||
leadTimeDays: INTEGER,
|
||
|
||
alertOnMinimum: BOOLEAN,
|
||
alertOnReorder: BOOLEAN,
|
||
alertOnOverconsumption: BOOLEAN,
|
||
alertOnNoMovement: BOOLEAN,
|
||
noMovementDays: INTEGER DEFAULT 90,
|
||
|
||
notifyUsers: UUID[],
|
||
}
|
||
|
||
// consumption_analysis
|
||
{
|
||
id: UUID,
|
||
projectId: UUID,
|
||
materialId: UUID,
|
||
period: VARCHAR(7), // 2025-11
|
||
|
||
budgetedQuantity: DECIMAL(12,4),
|
||
actualQuantity: DECIMAL(12,4),
|
||
variance: DECIMAL(12,4),
|
||
variancePercentage: DECIMAL(6,2),
|
||
|
||
averageWeeklyConsumption: DECIMAL(12,4),
|
||
projectedTotal: DECIMAL(12,4),
|
||
|
||
status: ENUM('ok', 'warning', 'critical'),
|
||
analysisDate: DATE,
|
||
}
|
||
|
||
// stock_alerts
|
||
{
|
||
id: UUID,
|
||
alertType: ENUM('minimum_stock', 'reorder_point', 'overconsumption', 'no_movement', 'maximum_stock'),
|
||
severity: ENUM('info', 'warning', 'critical'),
|
||
|
||
warehouseId: UUID,
|
||
materialId: UUID,
|
||
projectId: UUID NULLABLE,
|
||
|
||
message: TEXT,
|
||
currentValue: DECIMAL(12,4),
|
||
thresholdValue: DECIMAL(12,4),
|
||
|
||
status: ENUM('active', 'acknowledged', 'resolved'),
|
||
notifiedUsers: UUID[],
|
||
createdAt: TIMESTAMP,
|
||
resolvedAt: TIMESTAMP NULLABLE,
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 5. Criterios de Aceptación
|
||
|
||
- [ ] Kárdex detallado por material/almacén
|
||
- [ ] Análisis consumo vs presupuesto
|
||
- [ ] 5 tipos de alertas configurables
|
||
- [ ] Dashboard ejecutivo de inventarios
|
||
- [ ] Proyección de faltantes
|
||
- [ ] Clasificación ABC
|
||
- [ ] Reportes de rotación
|
||
- [ ] Notificaciones automáticas
|
||
- [ ] Gráficas de tendencias
|
||
|
||
---
|
||
|
||
**Estado:** ✅ Ready for Development
|