update doc for cyclevie + cron

Author: tacxou

docs/.vuepress/config.js

@@ -40,7 +40,8 @@ export default defineUserConfig({
              'validation',
              'formulaire',
               'config-gestion-mdp',
-              'cyclevie'
+              'cyclevie',
+              'cron'
           ]
 	},
         {

docs/configuration/cron.md

@@ -0,0 +1,90 @@
+---
+lang: fr-FR
+title: Cron
+description: Configuration des tâches cron et variables dynamiques
+---
+
+# Configuration cron
+
+Sésame supporte des tâches planifiées via des fichiers YAML dans `configs/cron`.
+Chaque tâche définit une planification, un handler console et des options.
+
+## Emplacement
+
+- Côté conteneur : `/data/configs/cron/*.yml`
+
+Au démarrage, si des fichiers par défaut existent dans `defaults/cron`, ils sont copiés dans `configs/cron` lorsqu’ils sont absents.
+
+## Structure d’un fichier cron
+
+Exemple :
+
+```yml
+tasks:
+  - name: lifecycle-execute
+    description: Exécute les règles lifecycle avec trigger.
+    enabled: true
+    schedule: "*/5 * * * *"
+    handler: lifecycle-execute
+    options:
+      retentionPeriodDays: 30
+      executedAt: "{{ date.now }}"
+      executedAtIso: "{{ date.isoNow }}"
+      monthlyKey: "job-{{ date.nowDate | dateFormat: 'YYYY-MM' }}"
+```
+
+### Champs disponibles
+
+- `name` : identifiant unique de la tâche (obligatoire)
+- `description` : description de la tâche (obligatoire)
+- `enabled` : active/désactive la tâche (obligatoire)
+- `schedule` : expression cron (obligatoire)
+- `handler` : commande console à exécuter (obligatoire)
+- `options` : options transmises au handler (optionnel)
+  - objet clé/valeur recommandé
+  - peut aussi être un tableau de chaînes selon les handlers
+
+## Exécution du handler
+
+La tâche exécute une commande de type :
+
+```bash
+yarn run console <handler> --key='value'
+```
+
+Les options booléennes `true` sont passées comme flags (`--flag`), les objets sont sérialisés en JSON.
+
+## Variables dynamiques dans `options`
+
+Les `options` supportent des variables dynamiques évaluées au runtime (à chaque exécution de la tâche).
+Les variables doivent être écrites en template Liquid (`{{ ... }}`).
+
+### Variables disponibles
+
+- `date.now` : timestamp courant en millisecondes (number)
+- `date.isoNow` : date courante au format ISO (string)
+- `date.nowDate` : date courante (Date)
+- `date.unix` : timestamp courant en millisecondes (number)
+- `date.unixSeconds` : timestamp courant en secondes (number)
+- `date.today` : date du jour (`YYYY-MM-DD`)
+- `date.yesterday` : date de la veille (`YYYY-MM-DD`)
+- `date.tomorrow` : date du lendemain (`YYYY-MM-DD`)
+
+### Syntaxes supportées
+
+- Template simple : `executedAtIso: "{{ date.isoNow }}"`
+- Interpolation : `batchId: "cron-{{ date.now }}"`
+- Filtre : `day: "{{ date.nowDate | dateFormat: 'YYYY-MM-DD' }}"`
+
+### Filtres Liquid disponibles
+
+- `dateFormat` : format Dayjs
+  - `{{ date.nowDate | dateFormat: 'YYYY-MM-DD HH:mm:ss' }}`
+- `unixMs` : conversion en timestamp millisecondes
+  - `{{ date.nowDate | unixMs }}`
+- `unixSeconds` : conversion en timestamp secondes
+  - `{{ date.nowDate | unixSeconds }}`
+
+### Moteur de templates
+
+Le rendu des templates est assuré par [LiquidJS](https://liquidjs.com/).

docs/configuration/cyclevie.md

@@ -135,7 +135,59 @@ identities:
 ```
 `mutation` permet d’appliquer un `$set` des champs avant le passage à l’état cible. Ici, `inetOrgPerson.cn` sera modifié avant de passer à D.
 
-### Planification des triggers (cron)
+### Variables dynamiques et templates
+
+Les champs `rules` et `mutation` supportent des variables dynamiques évaluées à l’exécution.
+Les variables doivent être écrites en template Liquid (`{{ ... }}`).
+
+Exemples valides :
+
+```yml
+mutation: {
+  'example.updatedAtMs': '{{ date.now }}',
+  'example.updatedAtIso': '{{ date.isoNow }}',
+  'example.batchKey': 'batch-{{ date.nowDate | dateFormat: "YYYY-MM-DD" }}',
+}
+```
+
+#### Variables disponibles
+
+- `date.now` : timestamp courant en millisecondes (number)
+- `date.isoNow` : date courante au format ISO (string)
+- `date.nowDate` : date courante (Date)
+- `date.unix` : timestamp courant en millisecondes (number)
+- `date.unixSeconds` : timestamp courant en secondes (number)
+- `date.today` : date du jour (`YYYY-MM-DD`)
+- `date.yesterday` : date de la veille (`YYYY-MM-DD`)
+- `date.tomorrow` : date du lendemain (`YYYY-MM-DD`)
+
+#### Syntaxes supportées
+
+- Template simple : `field: '{{ date.isoNow }}'`
+- Template avec interpolation : `field: 'prefix-{{ date.now }}'`
+- Template avec filtre : `field: '{{ date.nowDate | dateFormat: "YYYY-MM-DD HH:mm:ss" }}'`
+
+#### Filtres Liquid disponibles
+
+- `dateFormat` : formatte une date selon le format Dayjs
+  - Ex. `{{ date.nowDate | dateFormat: "YYYY-MM-DD" }}`
+- `unixMs` : convertit une date en timestamp millisecondes
+  - Ex. `{{ date.nowDate | unixMs }}`
+- `unixSeconds` : convertit une date en timestamp secondes
+  - Ex. `{{ date.nowDate | unixSeconds }}`
+
+#### Comportement d’évaluation
+
+- L’évaluation est faite au runtime (au moment où la règle est exécutée), pas uniquement au chargement des fichiers.
+- Les objets et tableaux imbriqués sont résolus récursivement.
+- Pour une expression template seule (ex. `{{ date.now }}`), la valeur est résolue avec son type utile.
+- En cas d’erreur de rendu Liquid, la valeur d’origine est conservée.
+
+#### Moteur de template
+
+Le rendu de templates utilise [LiquidJS](https://liquidjs.com/).
+
+### Planification des triggers lifecycle (cron)
 
 Les règles avec `trigger` sont exécutées par une tâche planifiée. Le cron est configurable par variable d’environnement :
 
@@ -146,6 +198,8 @@ Exemples d’expressions :
 - toutes les heures : `0 * * * *`
 - chaque nuit à 2h30 : `30 2 * * *`
 
+Pour la configuration des tâches cron YAML (`configs/cron/*.yml`) et leurs variables dynamiques, voir la page dédiée : `Configuration > Cron`.
+
 ### Ignorer le cycle de vie pour une identité
 
 Une identité peut être exclue des traitements de cycle de vie en positionnant son champ `ignoreLifecycle` à `true`. Dans ce cas, elle n’est pas prise en compte par les règles, qu’elles soient immédiates ou à délai.