Manual de Usuario - OTD Dashboard
1. Introducción al Sistema
OTD Dashboard (On-Time Delivery Dashboard) es un sistema integral de gestión y seguimiento de órdenes y entregas que permite:
- Monitorear el estado de órdenes y pedidos en tiempo real
- Calcular KPIs de rendimiento y cumplimiento de entregas
- Gestionar problemas y retrasos de manera proactiva
- Mantener historial completo de cambios y modificaciones
- Procesar datos automáticamente mediante ETL
3. KPIs y Métricas
📊 Principales Indicadores de Rendimiento
% Entregas a Tiempo (Pedidos)
Cálculo:
(Pedidos completados a tiempo / Total pedidos completados) × 100
Criterio: Un pedido está "a tiempo" si fecha_completado ≤ fecha_entrega
% Entregas a Tiempo (Órdenes)
Cálculo:
(Órdenes 100% completadas a tiempo / Total órdenes completadas) × 100
Criterio: Una orden está completa cuando todos sus pedidos están completados
Pedidos con Retraso
Pedidos que han superado su fecha de entrega sin completarse.
Criterio: fecha_actual > fecha_entrega AND estatus != 'completado'
Problemas Activos
Número total de problemas registrados que aún no han sido resueltos.
Estados: pendiente, en_proceso, resuelto
🎯 Interpretación de Métricas
- 90-100%: Excelente rendimiento
- 80-89%: Buen rendimiento
- 70-79%: Rendimiento aceptable
- <70%: Requiere atención inmediata
4. Proceso ETL (Extract, Transform, Load)
El proceso ETL es el corazón del sistema que mantiene los datos actualizados automáticamente.
🔄 Flujo del Proceso ETL
1. EXTRACT
Extrae datos de archivos CSV:
ordenes.csvpedidos.csv
2. TRANSFORM
Procesa y limpia los datos:
- Validación de formatos
- Cálculo de prioridades
- Detección de cambios
3. LOAD
Carga datos a PostgreSQL:
- Merge inteligente
- Preserva modificaciones manuales
- Actualiza estados
🔒 Protección de Modificaciones Manuales
El ETL respeta las modificaciones manuales mediante campos de control:
modificado_manualmente: Indica si el registro fue modificado por un usuariofecha_modificacion_manual: Timestamp de la última modificación manualhash_etl: Hash para detectar cambios en datos fuente
⏰ Programación del ETL
El ETL se ejecuta automáticamente cada hora mediante cron job:
0 * * * * cd /var/www/otd-app && /var/www/otd-app/venv/bin/python etl.py >> logs/etl.log 2>&15. Estructura de Datos
🗄️ Tablas Principales
📋 Tabla: ordenes
| Campo | Tipo | Descripción |
|---|---|---|
| id | INTEGER | ID único de la orden |
| clave | VARCHAR | Clave identificadora |
| fecha_entrega | DATE | Fecha programada de entrega |
| prioridad | VARCHAR | alta/media/baja |
| estatus | VARCHAR | pendiente/completado |
| modificado_manualmente | BOOLEAN | Control ETL |
📦 Tabla: pedidos
| Campo | Tipo | Descripción |
|---|---|---|
| id | INTEGER | ID único del pedido |
| orden_id | INTEGER | Referencia a orden |
| producto | VARCHAR | Nombre del producto |
| cantidad | INTEGER | Cantidad solicitada |
| surtido | INTEGER | Cantidad entregada |
| saldo | INTEGER | Cantidad pendiente |
| estatus | VARCHAR | pendiente/completado |
| fecha_completado | TIMESTAMP | Cuándo se completó |
⚠️ Tabla: problemas
| Campo | Tipo | Descripción |
|---|---|---|
| id | INTEGER | ID único del problema |
| orden_id | INTEGER | Orden afectada |
| origen_problema | VARCHAR | Causa del problema |
| estado | VARCHAR | pendiente/resuelto |
| fecha_reporte | TIMESTAMP | Cuándo se reportó |
| descripcion | TEXT | Detalles del problema |
📝 Tabla: cambios_estado
| Campo | Tipo | Descripción |
|---|---|---|
| id | INTEGER | ID único del cambio |
| pedido_id | INTEGER | Pedido modificado |
| estado_anterior | VARCHAR | Estado previo |
| estado_nuevo | VARCHAR | Nuevo estado |
| fecha | TIMESTAMP | Cuándo ocurrió |
| usuario_responsable | VARCHAR | Quién lo cambió |
| comentarios | TEXT | Notas adicionales |
💡 Ejemplo de Relaciones
Una orden puede tener múltiples pedidos. Cada pedido puede generar múltiples cambios de estado y problemas.
Orden #12345
├── Pedido #001: Producto A (cantidad: 100, surtido: 80, saldo: 20)
├── Pedido #002: Producto B (cantidad: 50, surtido: 50, saldo: 0) ✅
└── Pedido #003: Producto C (cantidad: 75, surtido: 0, saldo: 75) ⚠️6. Gestión de Problemas
🚨 Tipos de Problemas
Retrasos
Pedidos que han superado su fecha de entrega
- Detección automática
- Registro en tabla problemas
- Notificación al usuario
Faltantes
Productos no disponibles en inventario
- Registro manual
- Seguimiento de resolución
- Impacto en KPIs
Otros
Problemas diversos del proceso
- Problemas de calidad
- Problemas logísticos
- Problemas de documentación
📋 Flujo de Resolución
- Detección: Automática (ETL) o manual (usuario)
- Registro: Se crea entrada en tabla problemas
- Asignación: Se asigna responsable
- Seguimiento: Actualizaciones de estado
- Resolución: Cierre con comentarios
7. Historial y Auditoría
📊 Registro de Cambios
El sistema mantiene un registro completo de todos los cambios realizados:
Información Registrada
- Estado anterior y nuevo
- Fecha y hora exacta
- Usuario responsable
- Comentarios y notas
- Motivo del cambio
Casos de Uso
- Auditorías internas
- Análisis de rendimiento
- Resolución de disputas
- Mejora de procesos
- Cumplimiento normativo
💡 Tip de Uso
Utiliza los filtros en la página de Historial para encontrar cambios específicos por fecha, usuario o tipo de modificación.
Para soporte técnico o preguntas adicionales, contacta al administrador del sistema.
Manual actualizado: 17/07/2026 | Versión del sistema: OTD Dashboard v1.0