Gestión de Datos de Tiempo

Almacenamiento de Intervalos de Tiempo

Cómo se Almacenan y Organizan los Datos de Tiempo

El sistema de seguimiento de tiempo usa una estructura de tabla centralizada time_intervals para todo el almacenamiento de datos de tiempo:

Campos Principales de Intervalo de Tiempo:

started_at y finished_at marcas de tiempo para seguimiento preciso de tiempo
user_id vincula tiempo a miembros específicos del equipo
project_id asocia tiempo con proyectos
task_id (opcional) para seguimiento de tiempo específico de tareas
type campo que indica método de seguimiento (START, CONTINUE, FINISH, AUTO)
manual_time bandera que distingue entradas manuales de seguimiento de aplicación de escritorio

Relaciones de Base de Datos:

Las relaciones de clave foránea aseguran integridad de datos con usuarios y proyectos
Capacidades de eliminación suave para referencias de proyecto y usuario
Campo started_at indexado para consultas eficientes basadas en fecha
Soporte para seguimiento de tiempo multi-moneda a través de campo currency_id

Organización de Datos:

Los intervalos de tiempo se almacenan con marcas de tiempo conscientes de zona horaria
Las notas pueden adjuntarse a intervalos de tiempo a través de relaciones polimórficas
Las asociaciones de capturas de pantalla vinculan prueba visual a intervalos de tiempo
El aislamiento del equipo asegura seguridad de datos y control de acceso apropiado

Métodos de Cálculo de Tiempo

Cálculos de Duración y Formato de Tiempo

El sistema emplea múltiples métodos sofisticados para cálculos de tiempo:

Cálculo de Duración:

El cálculo principal usa TIMESTAMPDIFF(SECOND, started_at, finished_at) para precisión
Conversión automática entre segundos, minutos, horas y días
Soporte tanto para horas decimales como formato de tiempo HH:MM:SS
Conversión de tiempo a horas: hours + (minutes/60) + (seconds/3600)

Opciones de Formato de Tiempo:

SEC_TO_TIME() convierte segundos a formato HH:MM:SS
TIME_TO_SEC() convierte HH:MM:SS a total de segundos
Formato personalizado para diferentes contextos de visualización (reportes, paneles, facturas)
Soporte de duración ISO 8601 para cálculos avanzados de tiempo

Precisión de Cálculo:

Precisión a nivel de segundo para todos los cálculos de tiempo
Cálculos conscientes de zona horaria respetan preferencias del equipo y usuario
Manejo automático de transiciones de horario de verano
Métodos de cálculo consistentes en todos los componentes del sistema

Movimiento de Tiempo Entre Proyectos

Mover Tiempo Rastreado a Proyectos Correctos con Rastro de Auditoría

Corcava proporciona la capacidad de mover intervalos de tiempo entre proyectos cuando el tiempo fue accidentalmente rastreado al proyecto incorrecto. Esta característica incluye registro integral de auditoría para asegurar transparencia y prevenir fraude.

Accediendo a Movimiento de Tiempo:

Navegar a página Mi Trabajo
Encontrar el intervalo de tiempo que quieres mover
Hacer clic en botón Mover (ícono de flecha) junto al intervalo

Moviendo Intervalos de Tiempo:

Abrir Diálogo de Movimiento
- Hacer clic en botón de movimiento en cualquier intervalo de tiempo
- Se muestra información del proyecto actual
- Duración y rango de tiempo mostrados para verificación
Seleccionar Proyecto de Destino
- Elegir el proyecto correcto del menú desplegable
- Solo proyectos a los que tienes acceso están disponibles
- Los proyectos deben estar en el mismo equipo
Proporcionar Razón (Opcional pero Recomendado)
- Ingresar por qué se está moviendo el tiempo
- Ejemplos: "Rastreado al proyecto incorrecto", "Cliente cambió alcance"
- La razón se almacena en registro de auditoría para responsabilidad
Confirmar Movimiento
- Hacer clic en "Mover Tiempo" para completar la acción
- El intervalo de tiempo se actualiza inmediatamente
- El cambio se registra automáticamente

Restricciones y Validaciones:

✅ No se puede mover tiempo facturado - Una vez que el tiempo está facturado, no se puede mover
✅ Solo mismo equipo - El tiempo no se puede mover entre diferentes equipos
✅ Permiso requerido - Tanto permisos de empresa como de usuario deben permitir movimiento
✅ Solo proyectos activos - No se puede mover tiempo a proyectos archivados/eliminados

Indicadores Visuales:

Cuando un intervalo de tiempo ha sido movido, una insignia "Movido" aparece junto al nombre del proyecto:

La insignia es clickeable para ver historial completo de movimientos
Muestra quién lo movió, cuándo y desde qué proyecto
Incluye razón si se proporcionó una

Registro de Auditoría de Movimiento

Seguimiento Integral de Todos los Movimientos de Tiempo

Cada movimiento de tiempo se registra automáticamente con información completa de rastro de auditoría para asegurar transparencia y prevenir cambios no autorizados.

Qué se Registra:

Para cada movimiento de tiempo, el sistema registra:

Quién hizo el cambio (nombre de usuario e ID)
Cuándo ocurrió el cambio (marca de tiempo con zona horaria)
Qué cambió (proyecto anterior → proyecto nuevo)
Por qué cambió (razón opcional proporcionada por usuario)
Dónde ocurrió (dirección IP del usuario)
Cómo (información de agente de usuario/navegador)

Visualizando Historial de Movimientos:

Para Intervalos Individuales:

Hacer clic en insignia "Movido" en cualquier intervalo movido
Se abre modal mostrando historial completo de movimientos
Ver todos los movimientos si el intervalo fue movido múltiples veces
Ver quién hizo cada movimiento y por qué

Para Auditoría de Todo el Equipo:

Navegar a Reportes → Registro de Movimiento de Tiempo
Ver todos los movimientos de tiempo en todo tu equipo
Lista paginada con 50 movimientos por página
Muestra: cuándo, quién, desde qué proyecto, a qué proyecto, razón

Características de Registro de Auditoría:

Registros Inmutables - Los registros de auditoría no se pueden editar o eliminar
Rastro Permanente - Historial completo preservado indefinidamente
Contexto de Seguridad - IP y agente de usuario registrados para forense
Buscable - Filtrado futuro por fecha, usuario o proyecto
Acceso Basado en Permisos - Solo usuarios autorizados pueden ver registros de auditoría

Quién Puede Ver Registros de Auditoría:

SuperAdmins - Pueden ver todos los registros de movimiento en su equipo
Gerentes de Organización - Pueden ver todos los registros de movimiento en su equipo
Gerentes de Proyecto - Pueden ver todos los registros de movimiento en su equipo
Usuarios Regulares - Pueden ver registros solo para sus propios intervalos de tiempo

Seguridad de Registro de Auditoría:

El sistema de registro de auditoría está diseñado para prevenir fraude y asegurar responsabilidad:

Todos los cambios rastreados automáticamente - no se puede omitir
Registros almacenados por separado de intervalos de tiempo - a prueba de manipulación
Restricciones a nivel de base de datos previenen modificación
Rastro de auditoría completo para cumplimiento y responsabilidad

Agregación de Tiempo

Acumular Tiempo de Tareas a Niveles de Proyecto y Equipo

El sistema proporciona agregación integral de tiempo a través de múltiples niveles organizacionales:

Agregación a Nivel de Tareas:

Totales de tiempo de tareas individuales calculados desde intervalos de tiempo asociados
Resúmenes de tiempo de tareas muestran tiempo total invertido por tarea
Correlación de finalización de tareas con seguimiento de inversión de tiempo
Análisis de tiempo de tareas diario y semanal para información de productividad

Agregación a Nivel de Proyecto:

Totales de tiempo de proyecto diarios con actualizaciones en tiempo real durante seguimiento
Cálculos de tiempo de proyecto semanales con límites configurables (40 horas por defecto)
Distribución porcentual de tiempo de proyecto a través de miembros del equipo
Análisis histórico de tiempo de proyecto para identificación de tendencias

Agregación a Nivel de Equipo:

Resúmenes diarios de tiempo del equipo a través de todos los proyectos y miembros
Conteos de miembros activos basados en actividad de seguimiento de tiempo
Métricas de productividad del equipo y análisis de asignación de tiempo
Distribución de tiempo entre proyectos para planificación de recursos

Agregación a Nivel de Usuario:

Totales de tiempo de usuario individual a través de todos los proyectos asignados
Límites de tiempo diarios y semanales con aplicación automática
Análisis de productividad personal y patrones de seguimiento de tiempo
Datos históricos de tiempo de usuario para análisis de rendimiento

Datos Históricos de Tiempo

Acceder y Analizar Registros Históricos de Tiempo

El sistema mantiene datos históricos integrales de tiempo con métodos de acceso flexibles:

Acceso a Datos Históricos:

Las consultas de rango de fechas soportan análisis de cualquier período histórico
La indexación eficiente de base de datos permite recuperación rápida de datos históricos
Datos de intervalos de tiempo preservados incluso cuando proyectos o usuarios se eliminan
Rastro de auditoría integral para todas las actividades de seguimiento de tiempo

Capacidades de Análisis Histórico:

Análisis de tendencias de tiempo a través de días, semanas, meses y años
Seguimiento de evolución de tiempo de proyecto para proyectos a largo plazo
Tendencias de productividad del equipo y análisis estacional
Análisis comparativo entre diferentes períodos de tiempo

Retención de Datos:

Almacenamiento permanente de todos los registros de intervalos de tiempo
Datos de capturas de pantalla mantenidos con intervalos de tiempo asociados
Notas y contexto preservados para referencia futura
Registros de seguimiento de tiempo mantenidos para depuración y análisis

Reportes Históricos:

Selección flexible de rango de fechas para reportes históricos personalizados
Agregación de tiempo por varios períodos (diario, semanal, mensual)
Análisis histórico de rentabilidad de proyectos usando datos de tiempo y tarifas
Tendencias de rendimiento del equipo durante períodos extendidos

Exportación de Datos de Tiempo

Exportar Datos de Tiempo para Análisis Externo

El sistema soporta capacidades integrales de exportación de datos de tiempo:

Formatos de Exportación:

Datos de tiempo integrados en generación de facturas para facturación de clientes
Generación de reportes con selección de período de tiempo personalizable
Exportación de datos de gráficos para análisis visual y presentaciones
Generación de reportes del equipo con programación automatizada

Opciones de Alcance de Exportación:

Exportación de datos de tiempo de usuario individual
Extracción de datos de tiempo específicos del proyecto
Compilación de datos de tiempo de todo el equipo
Datos de tiempo específicos del cliente para facturación transparente

Características de Exportación Automatizada:

Reportes diarios del equipo generados y distribuidos automáticamente
Generación semanal de facturas desde datos de tiempo rastreado
Generación programada de reportes para procesos empresariales regulares
Entrega por email de reportes de tiempo a partes interesadas

Integración de Datos:

Los datos de tiempo alimentan directamente sistemas de facturación
Integración con seguimiento de gastos para costeo completo de proyectos
Integración de cálculo de tarifas para facturación precisa
Soporte multi-moneda para operaciones internacionales

Integridad de Datos y Rendimiento

Asegurar Gestión Precisa de Datos de Tiempo

El sistema incluye características robustas de integridad de datos y optimización de rendimiento:

Medidas de Integridad de Datos:

Entrada de tiempo basada en transacciones previene corrupción parcial de datos
Validación automática de relaciones de intervalos de tiempo
Aplicación de restricciones para secuencias lógicas de tiempo
Verificaciones de consistencia de datos a través de registros relacionados

Optimización de Rendimiento:

Indexación estratégica de base de datos para consultas rápidas de tiempo
Consultas de agregación eficientes minimizan carga del sistema
Cálculos en caché para totales de tiempo frecuentemente accedidos
Consultas de rango de fechas optimizadas para acceso a datos históricos

Aseguramiento de Calidad de Datos:

Detección y prevención automáticas de intervalos de tiempo superpuestos
Validación de lógica de secuencia de tiempo (inicio antes de fin)
Aplicación de intervalo mínimo de tiempo (mínimo de 10 minutos)
Validación de límite de tiempo (máximo diario de 24 horas)

Respaldo y Recuperación:

Preservación completa de datos de tiempo en respaldos del sistema
Capacidades de recuperación punto en el tiempo para datos de tiempo
Soporte de migración de datos para actualizaciones del sistema
Capacidades de exportación para portabilidad y respaldo de datos