Introducción a LogSense for Jira

¡Bienvenido a la documentación oficial de LogSense for Jira! 🎉

LogSense for Jira es una aplicación Forge para Jira Cloud que aporta time tracking inteligente: clasificación billable / non-billable, tipos de trabajo por defecto y personalizados, límite diario de horas, bloqueo en festivos, estados activos, tipos de work item activos, Facturación con cierre semanal o mensual, configuración global del sitio, ajustes por espacio en Space settings, restauración del acceso administrativo, integración con eazyBI y flujo de aprobación de worklogs, además de gadgets de dashboard para el informe de horas facturables y la cola de pendientes de aprobación.

El complemento actúa como proveedor de time tracking de Jira, sustituyendo la experiencia nativa de Log work por registro con metadata LogSense. La interfaz se adapta al idioma del usuario en Jira (inglés y español).

¿Cómo obtener este complemento?

LogSense for Jira aún no se encuentra disponible en el Atlassian Marketplace, pero puede realizar la instalación inmediata mediante el siguiente enlace: Instalar LogSense for Jira.

Prerrequisitos:

• Debe tener permisos de Administrador de Jira o Administrador del site para realizar la instalación.
• Una conexión activa a internet y acceso a su instancia de Jira Cloud.

Consulte la Guía de Instalación para los pasos detallados y la activación del proveedor de time tracking.

¿Para quién es este complemento?

Audiencia objetiva

LogSense for Jira está pensado para equipos de consultoría, agencias, mesas de servicio y operaciones que necesitan registrar tiempo con contexto de facturación, respetar límites diarios por persona, obtener visibilidad de horas facturables en dashboards y, cuando usan eazyBI, explotar billable/work type sin integraciones ad hoc.

Valor diferencial

Capacidad	Beneficio
Proveedor de time tracking	UI unificada de registro con metadata LogSense en modal Log work, pestaña Work log y administración del provider.
Configuración global	Defaults del site (límite diario, work types, festivos) heredables por cada espacio.
Límite diario	Validación contra el total real de worklogs del día del usuario (JQL + worklogs paginados), con comportamiento fail-safe si la API no responde.
Billable / non-billable	Clasificación explícita en cada registro para informes y facturación.
Tipos de trabajo	Catálogo global o por espacio con tipos por defecto (no eliminables) y tipos personalizados creados por el administrador.
Estados activos	El administrador define, por espacio, en qué estados se puede registrar tiempo.
Tipos de work item activos	El administrador define, por espacio, qué tipos de work item admiten time logging.
Facturación	Apertura y cierre semanal o mensual; un periodo cerrado bloquea o limita el registro y la edición de tiempo.
Festivos	Bloqueo de registros en fechas marcadas en el calendario del espacio o heredadas del sitio.
Notas enriquecidas	Campo Notas multilínea con formato básico; el contenido formateado se muestra correctamente al revisar el worklog.
Panel lateral como resumen visual	KPIs del issue, desglose por work type, alertas y últimas entradas sin duplicar la pestaña Work log.
Aprobación de worklogs	Flujo PENDIENTE → APROBADO / RECHAZADO con aprobadores configurables por espacio.
Integración eazyBI	Stamp [LogSense:v1 ...] en comentarios de worklog para calculated fields.
Gadgets del dashboard	Horas facturables y pendientes de aprobación visibles y accionables desde dashboards de Jira.
Interfaz localizada	UI en inglés o español según el locale del usuario en Jira.

Funcionalidades

Proveedor de time tracking (Preview)

• Módulo Forge jira:timeTrackingProvider (logsense-time-provider).
• Al activar LogSense en Settings → Work items → Time tracking, desaparece la UI nativa de Log work.
• Puntos de entrada: acción Log work en el issue, pestaña Work log y administración del provider.

Registro de tiempo enriquecido

• Selector de fecha con calendario (locale del usuario).
• Atajos de tiempo (15 minutos, 30 minutos, 1 hora, 2 horas, 4 horas) presentados como acciones, no como texto suelto.
• Barras de progreso de estimación del issue y límite diario sin valores confusos.
• Campos de metadata: billable, tipo de trabajo y notas.

Tipos de trabajo

• Catálogo global o por espacio con tipos por defecto (no eliminables, se pueden desactivar) y tipos personalizados que el administrador crea y el usuario selecciona al registrar tiempo.

Estados activos

• El administrador define, por espacio, los estados del work item en los que se permite registrar tiempo.
• Fuera de esos estados, LogSense bloquea el registro con un mensaje claro para el usuario.

Tipos de work item activos

• El administrador define, por espacio, los tipos de work item que admiten time logging.
• El comportamiento es consistente con estados activos: fuera de los tipos habilitados, LogSense bloquea el registro con un mensaje claro.

Facturación

• Apertura y cierre de periodos semanales o mensuales para controlar el registro y la edición de tiempo.
• Un periodo cerrado impide registrar o editar trabajo en esas fechas.

Notas enriquecidas

• El campo Notas admite varias líneas y formato básico (Forge UI / Custom UI).
• El contenido formateado se visualiza correctamente al revisar el worklog desde la pestaña Work log.

Edición de worklogs

• Edite worklogs existentes desde el panel del issue y la pestaña Work log, respetando los permisos nativos de Jira.
• Los campos editables incluyen tiempo, fecha, tipo de trabajo, billable y notas.
• Si no tiene permiso para editar, el botón Edit no se muestra.

Notas obligatorias

• Los administradores pueden activar la opción Exigir notas en la configuración global o por espacio.
• Cuando está activa, el campo Notas es obligatorio al crear o editar un worklog.

Panel lateral como resumen visual del issue

• El panel lateral (jira:issuePanel) funciona como un dashboard de métricas del issue: KPIs (total registrado, billable / no billable, % billable), desglose por tipo de trabajo, tiempo estimado y usado según tipo trabajo, alertas de umbral

Aprobación de worklogs

• Cuando el administrador activa Activar flujo de aprobación en la configuración global o por espacio, los nuevos worklogs se crean en estado PENDIENTE y no computan en totales ni reportes hasta ser aprobados.
• Worklogs APROBADOS son efectivos para LogSense; RECHAZADOS se excluyen de totales.
• Aprobadores configurables por espacio en Space Settings → LogSense Settings → General.
• Worklogs existentes antes de activar el flujo se tratan como APROBADOS (retrocompatibilidad).

Logo oficial de LogSense

• El logo oficial de LogSense for Jira ya está disponible en la documentación y materiales de la aplicación.
• Variantes para fondo claro y oscuro.

Configuración global del sitio

Panel LogSense — Global Settings (jira:adminPage, logsense-global-admin):

• General, Work Types, Facturación, Festivos y Aprobación a nivel site.
• Herencia global → espacio con override por espacio y acción Reset to Site Defaults.
• Pestaña eazyBI con snippets para reporting externo.

Ver Configuración global del sitio.

Ajustes por espacio en Space settings

Pantalla LogSense Settings dentro de Space settings (jira:projectSettingsPage):

• General: límite diario, facturable por defecto, estimaciones, bloqueo en festivos.
• Work Types: catálogo de tipos de trabajo (override del global si aplica).
• Festivos: calendario de festivos del espacio.
• Reglas de registro: estados activos y tipos de work item activos (control de logging).
• Facturación: periodos semanales o mensuales; un periodo cerrado bloquea el registro y la edición.

Integración eazyBI

• Stamp estructurado [LogSense:v1 billable=1 type=...] en el comentario del worklog de Jira.
• Metadata sigue en Forge KVS para la UI de LogSense.
• Guía de calculated fields en la pestaña eazyBI y en Integración con eazyBI.

Gadgets del dashboard

LogSense ofrece dos gadgets para consultar el trabajo desde un dashboard:

• Horas facturables: muestra el informe del espacio y mes configurados, y señala los issues cuyo tiempo registrado en LogSense supera su estimación original.
• Pendientes de aprobación: muestra los worklogs pendientes de aprobación de uno o más espacios y permite aprobarlos o rechazarlos directamente desde el dashboard cuando el usuario está autorizado.

Consulte la guía de gadgets del dashboard para conocer su configuración y uso.

Cambio clave en la versión 2.2.0

La configuración por espacio deja la navegación principal del espacio y pasa a Space settings, alineándose con permisos de administración y reduciendo la exposición a usuarios no administradores.

Compatibilidad

• Jira Cloud: Cualquier site (Free, Standard, Premium, Enterprise).
• Plataforma: Atlassian Forge (UI Kit / Custom UI).
• Idiomas de la UI: inglés (en-US) y español (es-ES), con fallback a inglés.
• App ID: 2b9c7a64-8273-400f-9a03-ba079ffa2707

Bienvenido a LogSense: tiempo registrado con contexto, límites y visibilidad para equipos que facturan por horas.