📦 Items del Contrato

La sección de Items del Contrato es el corazón del módulo de Pagos. Es su catálogo centralizado o "lista de precios" de todos los trabajos, materiales y servicios que pueden ser ejecutados y pagados dentro de su proyecto.

Cada "item" es un concepto que se puede contratar, como "Hormigón H25", "Excavación manual" o "Arriendo de grúa".

Estructura de un Item

Cada item que cree en su catálogo tendrá tres componentes principales que puede gestionar desde la interfaz:

Creación de un Item

Control de Cantidades y Alertas

El sistema lleva un control automático de las cantidades.

• Cuando se crea una Orden de Trabajo, la cantidad usada del item aumenta y la disponible disminuye.
• Puede configurar alertas de agotamiento para que el sistema le notifique cuando a un item le quede poca cantidad disponible (ej: menos del 10%).
• Si un item se agota (cantidad disponible llega a cero), se marca automáticamente para que no pueda ser utilizado hasta que se apruebe un aumento de contrato.

Gestión del Catálogo

🗂️ Organización Jerárquica

El sistema organiza los items en una estructura jerárquica para facilitar la navegación:

Categorías Principales:

• Materiales: Hormigón, acero, agregados, etc.
• Mano de Obra: Trabajos especializados
• Equipos: Arriendo y operación de maquinaria
• Servicios: Transporte, ensayos, otros servicios

Subcategorías por Tipo:

Materiales/
├── Hormigones/
│   ├── Estructurales (H20, H25, H30)
│   ├── Magros (H5, H10)
│   └── Especiales (Bombeable, Autocompactante)
├── Aceros/
│   ├── Barras (A630-420H)
│   ├── Mallas (ACMA)
│   └── Perfiles (Estructurales)
└── Agregados/
    ├── Arena
    ├── Grava
    └── Ripio

➕ Creación de Items

Funcionalidades Avanzadas

🔄 Control de Cantidades Dinámico

Seguimiento Automático:

• Cantidad utilizada: Se actualiza automáticamente al crear OT
• Cantidad disponible: Cálculo en tiempo real
• Alertas de agotamiento: Notificaciones cuando queda poco stock
• Proyección de uso: Estimación basada en tendencias

Validaciones de Uso:

// Validación antes de crear ODS
if (cantidadSolicitada > cantidadDisponible) {
  throw new Error('Cantidad solicitada excede disponibilidad');
}

// Actualización automática al aprobar OT
cantidadUsada += cantidadEjecutada;
cantidadDisponible = cantidadTotal - cantidadUsada;

💱 Sistema de Reajustes

Aplicación Automática:

• Reajustes configurables: Cada item puede tener múltiples reajustes
• Cálculo dinámico: Precios actualizados según índices vigentes
• Historial de precios: Registro de todas las variaciones
• Validación de fórmulas: Verificación de cálculos

Ejemplo de Reajuste:

const precioReajustado = precioBase * factorReajuste;

// Factor de reajuste calculado según fórmula
const factorReajuste = 0.15 + 
  0.40 * (indiceCemento / indiceCementoBase) +
  0.25 * (indiceManoObra / indiceManoObraBase) +
  0.20 * (indiceCombustible / indiceCombustibleBase);

🔍 Búsqueda y Filtrado Avanzado

Filtros Disponibles:

• Por código: Búsqueda exacta o parcial
• Por nombre: Búsqueda de texto libre
• Por categoría: Filtro por tipo de item
• Por estado: Activos, inactivos, agotados
• Por reajuste: Items con reajustes específicos
• Por cantidad: Rangos de disponibilidad

Ordenamiento:

• Código (A-Z, Z-A)
• Nombre (A-Z, Z-A)
• Precio (menor a mayor, mayor a menor)
• Cantidad disponible
• Porcentaje de utilización

Gestión de Estados

✅ Estados de Items

Estados Principales:

• Activo: Item disponible para uso en ODS
• Inactivo: Item temporalmente no disponible
• Agotado: Cantidad disponible = 0
• Suspendido: Item bloqueado por problemas

Transiciones de Estado:

const transicionesPermitidas = {
  activo: ['inactivo', 'suspendido'],
  inactivo: ['activo', 'suspendido'],
  agotado: ['activo'], // Solo si se aumenta cantidad
  suspendido: ['activo', 'inactivo']
};

🔄 Activación/Desactivación Masiva

Operaciones en Lote:

• Activar múltiples items: Por categoría o selección
• Desactivar por período: Items estacionales
• Suspender por problemas: Items con incidencias
• Reactivar automática: Según fechas programadas

Integración con Otros Módulos

📋 Órdenes de Servicio

• Selección de items: Solo items activos y disponibles
• Validación de cantidades: Control automático de límites
• Cálculo de precios: Aplicación de reajustes vigentes
• Reserva temporal: Bloqueo de cantidades durante creación

🔧 Órdenes de Trabajo

• Consumo automático: Descuento de cantidades al ejecutar
• Validación de disponibilidad: Verificación antes de ejecución
• Actualización de estados: Cambio automático si se agota
• Trazabilidad de uso: Historial de consumo por OT

📊 Reajustes

• Aplicación automática: Precios actualizados según índices
• Validación de fórmulas: Verificación de cálculos
• Historial de cambios: Registro de todas las variaciones
• Proyección de costos: Estimación de precios futuros

Reportes y Análisis

📊 Reportes de Items

Reporte de Inventario:

• Lista completa de items con cantidades
• Estado de cada item (activo/inactivo)
• Porcentaje de utilización
• Valor total del inventario

Reporte de Consumo:

• Items más utilizados
• Tendencias de consumo por período
• Proyección de agotamiento
• Análisis de rotación

Reporte de Precios:

• Evolución de precios por item
• Impacto de reajustes
• Comparación de costos
• Análisis de variaciones

📈 Análisis de Utilización

Métricas Clave:

• Tasa de utilización: % de items utilizados vs. total
• Velocidad de consumo: Cantidad consumida por período
• Items críticos: Con baja disponibilidad
• Items inactivos: Sin uso en período determinado

Alertas Automáticas:

• Items próximos a agotarse (< 10% disponible)
• Items sin uso por más de 30 días
• Precios con variaciones significativas (> 15%)
• Items con errores en reajustes

Configuración Avanzada

⚙️ Parámetros del Sistema

Configuraciones Generales:

{
  alertaAgotamiento: 10, // % mínimo para alerta
  diasSinUsoAlerta: 30,  // Días para marcar como inactivo
  variacionPrecioAlerta: 15, // % de variación para alerta
  decimalesCantidad: 2,  // Precisión en cantidades
  decimalesPrecios: 0    // Precisión en precios
}

Validaciones Personalizadas:

• Códigos con formato específico
• Nombres con longitud mínima/máxima
• Precios dentro de rangos permitidos
• Cantidades con límites por categoría

🔐 Permisos y Seguridad

Niveles de Acceso:

• Lectura: Ver items y precios
• Creación: Agregar nuevos items
• Edición: Modificar items existentes
• Eliminación: Borrar items (con restricciones)
• Administración: Control total del catálogo

Restricciones de Seguridad:

• No eliminar items con uso registrado
• Validar permisos antes de cambios de precio
• Auditar todas las modificaciones
• Requerir aprobación para cambios masivos

Mejores Prácticas

✅ Gestión Eficiente

Organización del Catálogo:

• Códigos consistentes: Usar nomenclatura estándar
• Descripciones claras: Especificaciones técnicas completas
• Categorización lógica: Agrupación por tipo de trabajo
• Mantenimiento regular: Revisión periódica del catálogo

Control de Cantidades:

• Estimaciones realistas: Cantidades basadas en experiencia
• Monitoreo continuo: Seguimiento de consumo
• Alertas tempranas: Notificaciones de agotamiento
• Planificación de reposición: Gestión proactiva de stock

💰 Gestión de Precios

Actualización de Precios:

• Reajustes automáticos: Configurar fórmulas apropiadas
• Validación de índices: Verificar fuentes de información
• Historial completo: Mantener registro de cambios
• Comunicación de cambios: Notificar variaciones significativas

Control de Costos:

• Análisis de tendencias: Monitorear evolución de precios
• Comparación de mercado: Validar precios con proveedores
• Optimización de reajustes: Ajustar fórmulas según necesidad
• Proyección de costos: Estimar impacto en presupuesto

🔍 Auditoría y Control

Trazabilidad:

• Registro de cambios: Quién, cuándo y qué modificó
• Historial de uso: Seguimiento de consumo por proyecto
• Validación de cálculos: Verificación de precios reajustados
• Documentación completa: Respaldo de todas las operaciones

Controles de Calidad:

• Validación de datos: Verificar consistencia de información
• Revisión periódica: Auditoría regular del catálogo
• Corrección de errores: Procedimientos de rectificación
• Mejora continua: Optimización basada en experiencia

La gestión eficiente de items del contrato es fundamental para el control de costos y la valorización precisa de trabajos en Smart Control. Un catálogo bien organizado y actualizado garantiza la exactitud en los cálculos de pagos por progreso.