Calendario — Guía del usuario | YoBench

Para qué sirve el módulo «Calendario»

Un calendario completo dentro de YoBench: eventos, agendas recurrentes, importación y suscripciones iCalendar (.ics), recordatorios y calendarios laborales con festivos. Integrado con el Seguimiento de tareas — las tareas con fecha límite aparecen en la línea de tiempo.

Lo que obtienes:

• Cinco vistas — Año, Mes, Semana, Día, Agenda.
• Recurrencias flexibles — diaria, días laborables, semanal (con elección de días), mensual, anual o intervalo personalizado.
• Importación/exportación ICS — abre calendarios de terceros o exporta los tuyos.
• Suscripciones a URLs ICS externas con auto-sync.
• Recordatorios del sistema — a 0/5/15/30/60/120/1440 minutos antes del evento.
• Calendario laboral ruso — datos de consultant.ru: laborable / fin de semana / festivo / día reducido.
• Tareas del tracker — se renderizan en la misma línea de tiempo según due_date.

Parámetros del evento

Al crear o editar:

• Título (obligatorio).
• Descripción (opcional).
• Fecha y hora de inicio / fin o bandera Todo el día.
• Color — HEX (por defecto #3b82f6).
• Categoría — trabajo / personal / reunión / cumpleaños / sin categoría.
• Ubicación/enlace — texto o URL.
• Estado — confirmado / tentativo / cancelado.
• Ocupado — bandera de ocupación (para vista libre/ocupado).
• Bloque de enfoque — marcador focus-time.
• Recordatorios — lista de minutos-antes: 0 (en el momento del evento), 5, 15, 30, 60, 120, 1440 (un día).
• Recurrencia — regla de repetición (ver abajo).

Eventos recurrentes

No es RRULE — un formato JSON simple:

• Tipo: daily, weekdays, weekly (elige días), monthly, yearly, custom.
• Intervalo/unidad para custom — por ejemplo, cada dos semanas (unit: weeks, interval: 2).
• Fin: nunca / por fecha / tras N apariciones.

Las apariciones virtuales se expanden al vuelo al renderizar un rango.

iCalendar (.ics)

• Importar archivo — elige un .ics; los eventos se deduplican por external_uid.
• Exportar — vuelca los eventos del año actual a .ics (vía ical-generator).
• Suscripciones por URL — añade una URL más auth Basic opcional. El calendario se consulta automáticamente en un intervalo (por defecto 60 minutos). Los eventos eliminados en la fuente también se quitan de YoBench.

Calendarios laborales

Está cableado el proveedor ru1 — calendario laboral ruso vía datos abiertos de consultant.ru. Tipos de día:

• working — día laborable
• weekend — fin de semana
• holiday — festivo
• short — día reducido

Se usa para calcular horas trabajadas y resaltar días no laborables en las vistas Año/Mes.

La arquitectura es extensible — más adelante se pueden añadir proveedores para otros países.

Recordatorios

Preestablecidos en el formulario: 0, 5, 15, 30, 60, 120, 1440 minutos antes del evento. Cuando llega la hora se publica una notificación del sistema operativo a través del servicio de notificaciones de YoBench. Los canales Telegram/email no se usan para recordatorios de calendario.

Controlado por la bandera Notificaciones del calendario (calendarNotificationsEnabled, activada por defecto).

Integración con el tracker

La línea de tiempo del calendario muestra no solo eventos, sino también tareas del Tracker que tienen due_date. Pulsar una tarea abre su detalle en Tracker.

Ajustes globales del módulo

En Ajustes → Calendario:

• Notificaciones del calendario (calendarNotificationsEnabled) — activa/desactiva los recordatorios.
• Intervalo de sincronización de suscripciones ICS (calendarIcalSyncIntervalMinutes) — por defecto 60 minutos.
• También se guarda el último año abierto y el proveedor de calendario laboral seleccionado.

Flujo de uso

1. Crea un evento

1. Abre Calendario en el menú lateral izquierdo.
2. Pulsa una celda de día vacía o + Evento.
3. Rellena título, hora, descripción.
4. Opcionalmente configura recurrencia y recordatorios.
5. Guarda.

2. Cambia de vista

En la cabecera del calendario — selector Año / Mes / Semana / Día / Agenda.

3. Arrastra y redimensiona

Arrastra una tarjeta a otra fecha/hora. Arrastra el borde inferior para cambiar la duración.

4. Conecta un calendario externo

En la sección Suscripciones, añade la URL ICS y (si hace falta) credenciales. Pulsa Sincronizar ahora o espera al auto-sync.

5. Import/export

• Importar ICS — botón Importar, elige un archivo. La deduplicación por UID evita duplicados.
• Exportar ICS — botón Exportar, guarda los eventos del año actual.

6. Activa el calendario laboral

En ajustes elige el proveedor ru1 — los días no laborables se destacan y los festivos aparecen en las vistas Mes/Año.

Siguientes pasos

• Vincula el Seguimiento de tareas — las deadlines aparecen automáticamente en la línea de tiempo.
• Usa Email si quieres crear eventos a partir de mensajes.

Ayuda y comentarios

¿Quieres un calendario laboral para otro país o soporte de RRULE? Escríbenos a través del formulario de contacto.