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, límite diario de horas, bloqueo en festivos, 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 un gadget de informes de horas facturables.

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 para categorizar el esfuerzo.
Festivos	Bloqueo de registros en fechas marcadas en el calendario del espacio o heredadas del sitio.
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.
Gadget de informes	Horas facturables visibles en 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 (15m, 30m, 1h, 2h, 4h).
• Barras de progreso de estimación del issue y límite diario.
• Campos de metadata: billable, tipo de trabajo y notas.

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 y Festivos 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.

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.

Gadget de informes

• Dashboard gadget de horas facturables con consultas optimizadas a la API de Jira.

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.