Calendrier — Guide utilisateur

À quoi sert le module « Calendrier »

Un calendrier complet à l'intérieur de YoBench : événements, plannings récurrents, import et abonnements iCalendar (.ics), rappels et calendriers ouvrés avec jours fériés. Intégré au Suivi des tâches — les tâches avec deadline apparaissent sur la chronologie.

Ce que vous obtenez :

Cinq vues — Année, Mois, Semaine, Jour, Agenda.
Récurrences flexibles — quotidienne, en jours ouvrés, hebdomadaire (avec choix des jours), mensuelle, annuelle ou intervalle personnalisé.
Import/export ICS — ouvrir des calendriers tiers ou exporter les vôtres.
Abonnements à des URLs ICS externes avec auto-sync.
Rappels système — à 0/5/15/30/60/120/1440 minutes avant l'événement.
Calendrier ouvré russe — données depuis consultant.ru : jour ouvré / week-end / férié / jour raccourci.
Tâches du tracker — affichées sur la même chronologie selon due_date.

Paramètres d'un événement

À la création ou à l'édition :

Titre (obligatoire).
Description (optionnel).
Date et heure de début / fin ou drapeau Toute la journée.
Couleur — HEX (par défaut #3b82f6).
Catégorie — travail / personnel / réunion / anniversaire / sans catégorie.
Lieu/lien — texte ou URL.
Statut — confirmé / provisoire / annulé.
Occupé — drapeau d'occupation (pour la vue libre/occupé).
Bloc focus — marquage focus-time.
Rappels — liste de minutes-avant : 0 (au moment de l'événement), 5, 15, 30, 60, 120, 1440 (un jour).
Récurrence — règle de répétition (voir ci-dessous).

Événements récurrents

Pas de RRULE — un format JSON simple :

Type : daily, weekdays, weekly (choix des jours), monthly, yearly, custom.
Intervalle/unité pour custom — par exemple toutes les deux semaines (unit: weeks, interval: 2).
Fin : jamais / à une date / après N occurrences.

Les occurrences virtuelles sont étendues à la volée lors du rendu d'une plage.

iCalendar (.ics)

Import de fichier — choisissez un .ics ; les événements sont dédupliqués par external_uid.
Export — exporte les événements de l'année courante au format .ics (via ical-generator).
Abonnements URL — ajoutez une URL plus une auth Basic optionnelle. Le calendrier est interrogé automatiquement à un intervalle (par défaut 60 minutes). Les événements supprimés à la source sont aussi retirés de YoBench.

Calendriers ouvrés

Le fournisseur ru1 est branché — calendrier ouvré russe via les données ouvertes de consultant.ru. Types de jours :

working — jour ouvré
weekend — week-end
holiday — jour férié
short — jour raccourci

Utilisé pour calculer les heures travaillées et mettre en évidence les jours non ouvrés dans les vues Année/Mois.

L'architecture est extensible — d'autres fournisseurs pays peuvent être ajoutés plus tard.

Rappels

Préréglages dans le formulaire : 0, 5, 15, 30, 60, 120, 1440 minutes avant l'événement. À l'heure dite, une notification système OS est postée via le service de notifications de YoBench. Les canaux Telegram/e-mail ne sont pas utilisés pour les rappels de calendrier.

Contrôlé par le drapeau Notifications du calendrier (calendarNotificationsEnabled, activé par défaut).

Intégration tracker

La chronologie du calendrier affiche non seulement les événements, mais aussi les tâches du Tracker qui ont un due_date. Cliquer sur une tâche ouvre son détail dans Tracker.

Réglages globaux du module

Sous Réglages → Calendrier :

Notifications du calendrier (calendarNotificationsEnabled) — active/désactive les rappels.
Intervalle de sync des abonnements ICS (calendarIcalSyncIntervalMinutes) — par défaut 60 minutes.
L'année dernièrement ouverte et le fournisseur de calendrier ouvré sélectionné sont aussi sauvegardés.

Flux d'utilisation

1. Créez un événement

Ouvrez Calendrier depuis le menu de gauche.
Cliquez sur une cellule vide ou sur + Événement.
Saisissez titre, heure, description.
Optionnellement, définissez récurrence et rappels.
Enregistrez.

2. Changez de vue

Dans l'en-tête du calendrier — bascule Année / Mois / Semaine / Jour / Agenda.

3. Glissez et redimensionnez les événements

Glissez la carte d'un événement vers une autre date/heure. Glissez le bord inférieur pour changer la durée.

4. Connectez un calendrier externe

Dans la section Abonnements, ajoutez l'URL ICS et (si besoin) les identifiants. Cliquez sur Synchroniser maintenant ou attendez l'auto-sync.

5. Import/export

Import ICS — bouton Importer, choisissez un fichier. La déduplication par UID évite les doublons.
Export ICS — bouton Exporter, enregistre les événements de l'année courante.

6. Activez le calendrier ouvré

Dans les réglages, choisissez le fournisseur ru1 — les jours non ouvrés sont mis en évidence et les jours fériés apparaissent dans les vues Mois/Année.

Étapes suivantes

Branchez le Suivi des tâches — les deadlines apparaîtront automatiquement sur la chronologie.
Utilisez Email si vous voulez créer des événements à partir de messages.

Aide et retour

Vous voulez un calendrier ouvré pour un autre pays ou un support RRULE ? Contactez-nous via le formulaire de retour.