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

¿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 y obtener visibilidad de horas facturables en dashboards — sin depender de scripts externos ni de hojas de cálculo paralelas.

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.
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 configurable por espacio para categorizar el esfuerzo.
Festivos	Bloqueo de registros en fechas marcadas en el calendario del espacio.
Gadget de informes	Horas facturables visibles en dashboards de Jira.

Funcionalidades incluidas en la versión 2.0.0

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 página de 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.

Ajustes por espacio

Pestaña LogSense Settings en la navegación del espacio (jira:projectPage):

• General: límite diario, facturable por defecto, estimaciones, bloqueo en festivos.
• Work Types: catálogo de tipos de trabajo.
• Festivos: calendario de festivos del espacio.

Gadget de informes

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

Alcance de esta versión

La configuración en Space settings y la configuración global del sitio llegan en versiones posteriores (2.1.0 / 2.2.0). Esta documentación describe la UX vigente en la versión 2.0.0.

Compatibilidad

• Jira Cloud: Cualquier site (Free, Standard, Premium, Enterprise).
• Plataforma: Atlassian Forge (UI Kit / Custom UI).
• App ID: 2b9c7a64-8273-400f-9a03-ba079ffa2707

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