@nightkatana/kronosys-app 1.0.0-beta.2 → 1.0.0-beta.21

package/lib/userGuideCopy.ts

@@ -50,7 +50,7 @@ function frBundle(): UserGuideBundle {
     searchNoResults: "Aucune rubrique ne correspond à votre recherche. Essayez un autre mot-clé ou effacez le filtre.",
     tocHeading: "Sur cette page",
     tocNavAria: "Sommaire du guide d’utilisation",
-    lastUpdated: "Dernière mise à jour : avril 2026",
+    lastUpdated: "Dernière mise à jour : 12 mai 2026",
     sections: [
       {
         id: "ug-essence",
@@ -63,7 +63,7 @@ function frBundle(): UserGuideBundle {
         ],
         optionsTitle: "Trois « pièces » pour trois gestes",
         options: [
-          "**Tableau de bord** — l’*atelier* (sessions, tâches, minuteur, raccourcis d’**étiquettes** / **@projets**).",
+          "**Tableau de bord** — l’*atelier* (sessions, tâches, minuteur, raccourcis **#étiquettes** / **@projets** travail / **!projets** personnels).",
           "**Rapports** — le *regard en hauteur* (période, thèmes, graphiques, sans refabriquer les chiffres).",
           "**Paramètres** — l’*arrière-boutique* (habitudes, raccordements, zone où l’on *efface* l’histoire *avec prudence*). [Ouvrir Paramètres](/settings#settings-usage-profile).",
         ],
@@ -71,7 +71,7 @@ function frBundle(): UserGuideBundle {
         steps: [
           "Ouvrez l’**accueil** (tableau de bord) : c’est ici que démarre l’**atelier**.",
           "Déclenchez **Nouvelle session** (ou laissez l’app en créer une *la première fois* qu’une tâche part).",
-          "Décrivez un **coup de tâche** (titre) ; un **#mot** = étiquette, un **@nom** = *projet* (le formulaire *devine* souvent l’un et l’autre).",
+          "Décrivez un **coup de tâche** (titre) ; un **#mot** = étiquette ; **@nom** = *projet* de travail ; **!nom** = *projet personnel* (le formulaire *devine* souvent l’un et l’autre). Ajoutez au besoin une **note libre** sur la tâche et, côté session, une **note de session**.",
           "Appuyez sur **Démarrer** (ou lancez le **KronoFocus** *à côté*) pour **tenir** un *créneau*.",
           "Quand la journée le demande, ouvrez **Rapports** pour *voir* ce qui c’est *passé* dans la période — *sans* y passer la soirée en tableurs.",
         ],
@@ -84,57 +84,89 @@ function frBundle(): UserGuideBundle {
           "La **barre du haut** est *toujours* la même famille : mêmes outils, même **ton** (zinc, accents **violet**), pour ne pas recharger le cerveau *à chaque page*. L’icône **roue** mène à [Paramètres](/settings#settings-usage-profile) (raccourci **Alt+Shift+S** depuis le tableau de bord).",
         ],
         steps: [
-          "En **tableau de bord** : l’icône **Livre** mène ici, puis **Rapports** (graphe), **Paramètres** (roue).",
-          "Sur **les autres pages** : revenez à l’**accueil** (icône en **grille**), puis mêmes **Livre**, **Rapports**, **Paramètres** (et, sur **Licences** seule, l’icône **document**).",
+          "En **tableau de bord** : l’icône **Livre** mène ici, puis **Rapports** (graphe), **Paramètres** (roue) et **Implémentation** (code — inventaire des user stories).",
+          "Sur **les autres pages** : revenez à l’**accueil** (icône en **grille**), puis mêmes **Livre**, **Rapports**, **Paramètres**, **Implémentation** ; sur **Implémentation**, une icône **changelog** ouvre `/changelog` ; sur **Licences** seule, l’icône **document** s’ajoute.",
+          "Sur **Implémentation**, les lignes pourvues d’un **chevron** déploient une **précision** et un **exemple** (texte plus petit) sans allonger la liste principale.",
+          "Toujours en tableau de bord, un bouton **Gantt du jour** (grille) ouvre une frise globale avec les tâches de **toutes** les sessions pour la journée en cours.",
           "Le **bouton thème** bascule **clair / sombre** (le soir ou salle trop lumineuse).",
           "Le bouton **actualiser** redemande l’**état** au serveur (utile si quelqu’un/quelque chose a changé dehors *sans* recharger toute l’**app**).",
           "Ouvrez le **menu de langue** (FR / EN) ; la **préférence** peut se **mémoriser** côté moteur si c’est la configuration chez vous.",
         ],
         options: [
-          "**Livre** = ce **guide** ; **graphe** = **Rapports** ; **roue** = **Paramètres** ; **fichier** = **Licences** (cette dernière **seule** sur l’icône document).",
+          "**Livre** = ce **guide** ; **graphe** = **Rapports** ; **roue** = **Paramètres** ; **grille** = **Gantt du jour** (tableau de bord) ; **code** = **Implémentation** (user stories ✓/✗) ; **changelog** = journal utilisateur (icône dédiée sur Implémentation) ; **fichier** = **Licences** (cette dernière **seule** sur l’icône document).",
           "Changer de **thème** ne modifie **pas** le **fond** de vos enregistrements — seulement le **confort** visuel (même **décor** d’écran d’une page à l’autre, pour ne pas se **perdre** entre les onglets)."
         ],
       },
       {
         id: "ug-layout",
         title: "Où travailler, où regarder, où régler — + juridique",
-        searchIndex: "navigation tableaux bord rapports paramètres licences",
+        searchIndex: "navigation tableaux bord rapports paramètres licences horloge fuseau",
         paragraphs: [
           "Trois gestes, trois endroits : l’**atelier** (maintenant), les **Rapports** (retour sur une période), les **Paramètres** (coulisses, effacements sensibles, branchements). Puis **Licences**, la page d’honnêteté sur le code **open source** et les polices.",
         ],
         options: [
-          "**Tableau de bord** — à gauche la **file des sessions** ; au centre les **tâches** (minuteurs, détail) ; à droite les raccourcis d’**étiquettes** et **@projets** pour ne pas retaper les mêmes mots. C’est l’usage **quotidien**.",
+          "**Tableau de bord** — à gauche la **file des sessions** ; au centre les **tâches** (minuteurs, détail) ; à droite les raccourcis d’**étiquettes** et de **projets** (**@** travail, **!** personnel) pour ne pas retaper les mêmes mots. C’est l’usage **quotidien**.",
           "**Rapports** — choisir une **plage de dates** et, si besoin, des **#étiquettes** ; lire résumés et graphiques. Une **visite guidée** est proposée la première fois sur l’écran.",
           "**Paramètres** — profil, collecte, planification, étiquettes avancées, **Git** ou miroir en **option** ; la **zone dangereuse** supprime l’historique (avec saisie de confirmation). [Sommaire des paramètres](/settings#settings-usage-profile) · [zone de danger](/settings#settings-danger-zone). N’y entrez **que** quand vous le **décidez**.",
-          "**Licences** — textes MIT, logiciels tiers, polices ; icône **document** **uniquement** sur cette page."
+          "**Licences** — textes MIT, logiciels tiers, polices ; icône **document** **uniquement** sur cette page.",
+          "Une **horloge murale** (fuseau et format 12/24 h des paramètres **Tableau de bord web**) tourne en permanence dans la **barre d’outils** de l’en-tête, à gauche des icônes de navigation."
+        ],
+      },
+      {
+        id: "ug-convention-end-vs-pause",
+        title: "Convention : heure de fin et pause",
+        searchIndex:
+          "convention pause fin programmée échéance terminaison clôture minuteur pause globale différée mise en veille",
+        paragraphs: [
+          "Dans Kronosys, une **heure de fin** que vous **programmez** sur une **tâche** ou une **session** en cours définit une **terminaison** à cet instant — ce n’est **pas** une pause **reportée**, ni une mise en veille différée.",
+          "Pour **mettre en pause** le suivi (minuteur, murale, session), utilisez les **actions de pause** prévues à cet effet ; elles sont **distinctes** de la notion d’**échéance** ou de **fin programmée**.",
+        ],
+        bullets: [
+          "**Fin programmée** → la tâche est **terminée** ou la session **clôturée** à l’instant choisi.",
+          "**Pause** → action **explicite** (minuteur, session live en pause, pause globale, etc.).",
         ],
       },
       {
         id: "ug-sessions-tasks",
         title: "Sessions, tâches, étiquettes et projets",
-        searchIndex: "session live archiver terminer tâche minuteur pause sous-tâche",
+        searchIndex:
+          "session live archiver terminer tâche minuteur pause sous-tâche historique liste résumé planifiée pastille badge conflit navigation projet personnel !perso jeton collé courriel",
         paragraphs: [
-          "La **session** est le **sac** où vient s’additionner le travail sur une période ; la **tâche** est le fil conducteur du moment. **#mot** = thème, **@nom** = projet (le formulaire en propose souvent) — c’est de la **classification**, pas un examen d’orthographe.",
+          "La **session** est le **sac** où vient s’additionner le travail sur une période ; la **tâche** est le fil conducteur du moment. **#mot** = thème ; **@nom** = projet **productif** ; **!nom** = projet **personnel** (suivi hors travail facturable, pastille souvent **rose**) — c’est de la **classification**, pas un examen d’orthographe. Le **`!`** (y compris **`!projet#sous-étiquette`**) peut être **collé** au mot précédent **sans espace** — ex. `Courrier!perso#dentiste` ; le **`@`** reste en principe **après un espace** ou en **début** de segment pour limiter les faux positifs sur les courriels.",
         ],
         optionsTitle: "Nouvelle session — le cadre, au choix",
         options: [
+          "**Début** : **maintenant** (lancement immédiat) ou **dans le passé** — dans ce cas, saisie du **début et de la fin** en heure locale du navigateur — si une session est **déjà active**, un **lancement immédiat** ouvre d’abord la **fin de session** (comme le bouton habituel) ; un **début rétroactif** **n’interrompt pas** la session active : la nouvelle ligne va dans l’**historique** et l’écran se place dessus pour **saisir des tâches** (mode passé).",
           "**Portée minimale** : pas de bordage particulier — vous lancez et c’est le flux qui mène.",
           "**Durée max (horloge murale)** : l’onglet s’y prête (rappel, pas alarme) quand on veut cadrer un gros **morceau** de journée.",
           "**Fenêtre calendrier** : dates de **début** et de **fin** (engagement auprès de vous-même ou d’un tiers).",
           "**Semaine** : jours de la semaine + **plage horaire** (utile en rythme **fixe** — pas pour tout le monde, et c’est normal).",
           "Dans les sélecteurs de dates/heures, les actions rapides **Aujourd’hui** et/ou **Maintenant** sont disponibles pour éviter la saisie manuelle.",
-          "Les **tâches** se suivent en **direct** (minuteur) ou s’inscrivent **dans le passé** (début / fin explicites) : honnête quand on remplit **après coup** le soir, sans théâtre."
+          "Les **tâches** se suivent en **direct** (minuteur) ou s’inscrivent **dans le passé** (début, fin et **durée du minuteur** en h/m/s — comme lors d’un ajustement) : honnête quand on remplit **après coup** le soir, sans théâtre."
         ],
         stepsTitle: "Dès que vous avez cliqué « Démarrer » sur une tâche (ordre usuel)",
         steps: [
-          "Taper un **titre** ; saupoudrer d’un **#** (étiquette) et/ou d’un **@** (projet) dès que le mot vient (aperçu souvent **sous** le champ de saisie).",
+          "Taper un **titre** ; saupoudrer d’un **#** (étiquette), d’un **@** (projet travail) et/ou d’un **!** (projet personnel) dès que le mot vient (aperçu souvent **sous** le champ de saisie).",
           "Cliquer **Démarrer** sur la tâche — ou, si l’heure s’y prête, lancer d’**abord** le **KronoFocus** depuis cette tâche (même bateau, rythme différent).",
           "Si le minuteur d’**une** autre tâche tourne déjà : l’appli offre **pause** sur l’ancienne, **terminer** l’ancienne, ou **tout** tenir en parallèle (vous **pouvez** mémoriser l’**option** pour les prochains lancements).",
           "En **cours** : lister des **sous-tâches** ; les cocher, les reclasser au **glisser-déposer** ; **pause** / reprise en douceur.",
           "**Terminer la session** quand le bloc a une fin (bouton d’en-tête ou bannière) ; une **raison** de clôture **facultative** (dans les temps, en avance, dépassement, autre + note) : pour poser mots sur la **fin** du cycle — d’**abord** pour vous, pas pour un **audit** froid."
         ],
         bullets: [
-          "L’**option** **Commit** à la fin d’une tâche, quand elle apparaît, concerne **Git** (voir [Synchronisation Git](/settings#settings-git) côté paramètres) : elle n’est **là** que **si** l’intégration est en place — les **équipiers** **non** devs peuvent l’**ignorer** sereinement."
+          "Chaque **tâche** peut porter une **note libre** (texte) visible sur la carte ; cette note s’affiche avant les **sous-tâches** pour garder le contexte en tête.",
+          "Chaque **session** peut porter une **note de session** ; un aperçu (icône + extrait) apparaît dans la liste des sessions et dans les archives.",
+          "Le bouton de **pause globale** est **inactif** (avec une infobulle) lorsque **rien ne tourne** : murale déjà figée et aucun minuteur ; sinon il ouvre une **confirmation** avec un **résumé** : **début** et **fin** (ou mention *en cours*), **durée murale**, **temps de codage** et **temps actif** de session lorsque l’hôte les fournit, décompte **tâches** / **sous-tâches**, **total enregistré** sur les minuteurs de tâches puis **répartition** minuteur principal vs sous-tâches, puis la liste des effets sur les minuteurs ; une fois validée, il met en pause la session, les tâches et les sous-tâches en cours du contexte affiché ; le clic suivant **reprend uniquement** ce lot.",
+          "La **pause session** (contrôle d’**en-tête** lorsque la session est **live**) **fige aussi** les minuteurs **actifs** des **tâches** et **sous-tâches** ; **reprendre la session** ne rallume que ce qui avait été gelé **par cette pause** — pas une tâche déjà laissée en pause **manuelle** avant. Reprendre une **tâche** avant le bandeau retire cette entrée du **lot** concerné par une reprise session ultérieure.",
+          "À la **fermeture** d’une session avec des tâches ouvertes, vous pouvez les **terminer**, les **transposer** vers une **nouvelle session en pause**, ou les **laisser ouvertes** dans l’instantané archivé ; dans tous les cas, les **minuteurs** de cette session **cessent**.",
+          "Dans une **session live** ainsi en pause, un **bandeau** propose de **reprendre la session** ; le **lecture** sur une tâche **reprend aussi** l’horloge murale (collecte).",
+          "Lorsque la session live est en **pause** (murale et minuteurs concernés, ou **pause globale**), le bloc **Session en cours** affiche une pastille **En pause** ou **Pause globale** ; un **voile** à l’écran centre un rappel, la **barre du haut** restant utilisable pour **reprendre**.",
+          "Même une **session passée terminée** accepte encore une **entrée dans le passé** : sélectionnez-la, indiquez début, fin et durée, puis ajoutez la tâche à son historique.",
+          "Dans [Paramètres → Tableau de bord web](/settings#settings-default-session-name), un **gabarit** optionnel définit le **nom initial** des **nouvelles** sessions (`%UUID`, codes date/heure façon POSIX `strftime` — référence indiquée sur l’écran) avec le même **fuseau d’affichage** que le tableau de bord et les rapports.",
+          "Sur une tâche **en cours**, **en pause** ou **terminée**, un bouton **Sauvegarder comme template** (icône) enregistre son titre, **#étiquettes** et projet **@** ou **!** ; la saisie « sur quoi travaillez-vous » propose ces modèles (**Modèle :** dans les suggestions) avec recherche **debounce**, la **palette Ctrl+K** les inclut, et [Paramètres → Modèles de tâche](/settings#settings-task-templates) permet aussi de les **gérer**.",
+          "Lors d’une correction d’**heure de début/fin** d’une tâche, une modale vous laisse choisir la règle de durée : conserver la durée système, saisir une durée manuelle, ou recalculer depuis début/fin. Pour une tâche en cours, une **heure de fin** (passée ou future) **termine la tâche** à cet instant — ce n’est pas une simple pause du minuteur.",
+          "Lorsque le **début** d’une tâche **non terminée** est encore **dans le futur** (horloge), l’entrée est sous **Planifiées** avec un style **bleu ciel** : pas de **minuteur** « en direct ». Pour une tâche **terminée**, le bloc « planifié » ne s’applique que si **début et fin** sont encore **tous deux** dans le futur ; si le début est déjà passé et seule la fin est future, l’entrée reste avec les **terminées** (évite d’y rester coincée jusqu’à l’heure de fin). Même logique visuelle pour une **session live** dont l’**heure de début officielle** est encore dans le futur (ligne distincte dans la liste). Il n’y a **pas de pastille texte** « planifié » : la distinction repose sur la section, le style et le point d’état.",
+          "Lorsqu’une tâche **sort de Planifiées** et devient **en cours** alors qu’**au moins un** autre minuteur était déjà affiché comme **en cours**, une modale propose les mêmes options **pause / terminer / parallèle** (avec la même mémorisation que pour le démarrage manuel) pour les **tâches déjà au minuteur** ; hors route du tableau de bord, l’icône **Tableau de bord** peut **pulser** brièvement pour signaler qu’une action est attendue.",
+          "Pour une **session** de l’**historique** (pas la session **live**), le **résumé** (nom, durée, métriques) s’affiche **sous la ligne** correspondante dans la **liste** des sessions, pour garder le détail au même endroit pendant la navigation."
         ],
       },
       {
@@ -158,16 +190,16 @@ function frBundle(): UserGuideBundle {
       },
       {
         id: "ug-search-palette",
-        title: "Recherche : données (tableau de bord) & rubriques (ce guide)",
-        searchIndex: "palette recherche données sessions tâches ctrl k",
+        title: "Recherche Spotlight : données (tableau de bord) & rubriques (ce guide)",
+        searchIndex: "palette recherche données sessions tâches modèles ctrl k",
         paragraphs: [
-          "Même **allure** de champ (bordure zinc, focus **violet**) : **deux cibles** — d’**abord** l’**atelier** (sessions, tâches, étiquettes, mots du workspace) ; **ensuite** le **fil** en tête de **cette** page, qui ne filtre **que** les **rubriques** du **guide**."
+          "Même **allure** de champ (bordure zinc, focus **violet**) : **deux cibles** — d’**abord** l’**atelier** (sessions, tâches, **modèles de tâche**, étiquettes, mots du workspace) ; **ensuite** le **fil** en tête de **cette** page, qui ne filtre **que** les **rubriques** du **guide**."
         ],
         stepsTitle: "Données — la palette (tableau de bord)",
         steps: [
           "Cliquer sur **Rechercher dans les données** ou presser **Ctrl+K** (Windows / Linux) / **⌘K** (macOS) : la **palette** s’ouvre (raccourci **réservé** : on ne le **redéfinit** **pas** dans la modale raccourcis).",
-          "Saisir **deux** ou **trois** **lettres** d’**une** **session**, d’**une** **tâche**, d’**un** **#** ou d’**un** **@** : la **liste** se **restreint** en **direct**.",
-          "Choisir **une** **ligne** (**Entrée** ou **clic**) : l’**écran** **saute** **vers** l’**objet** ; **Échap** **ferme** la **boîte** **sans** **toucher** le **fond**."
+          "Saisir **deux** ou **trois** **lettres** d’**une** **session**, d’**une** **tâche**, d’**un** **modèle**, d’**un** **#**, d’**un** **@** ou d’**un** **!** : la **liste** se **restreint** en **direct**.",
+          "Choisir **une** **ligne** (**Entrée** ou **clic**) : l’**écran** **saute** **vers** l’**objet** ; pour **un modèle**, le **champ** nouvelle **tâche** est **rempli** ; **Échap** **ferme** la **boîte** **sans** **toucher** le **fond**."
         ],
         optionsTitle: "Ce guide — le champ collé en haut de page",
         options: [
@@ -180,7 +212,7 @@ function frBundle(): UserGuideBundle {
         title: "Raccourcis clavier (tableau de bord)",
         searchIndex: "raccourcis clavier alt shift ctrl",
         paragraphs: [
-          "Ouvrez la **modale des raccourcis** depuis le petit clavier près de la palette pour voir, **modifier** ou **réinitialiser** les combinaisons (les touches **Ctrl+K** / **⌘K** restent réservées à la palette de recherche de données). La relance de **certaines** visites guidées et des options d’**API** se gèrent aussi dans [Paramètres — Web & API](/settings#settings-web).",
+          "Ouvrez la **modale des raccourcis** depuis le petit clavier près de la palette pour voir, **modifier** ou **réinitialiser** les combinaisons (les touches **Ctrl+K** / **⌘K** restent réservées à la palette **Spotlight**). La relance de **certaines** visites guidées et des options d’**API** se gèrent aussi dans [Paramètres — Web & API](/settings#settings-web).",
         ],
         bullets: [
           "Nouvelle session : Alt+Shift+N (par défaut).",
@@ -203,18 +235,21 @@ function frBundle(): UserGuideBundle {
           "Ouvrir **Rapports** (icône **graphe** ou raccourci **Alt+Shift+G** sur le tableau de bord).",
           "Choisir une **plage** : champs **Du** / **Au**, bouton **Aujourd’hui**, ou préréglages **jour** / **semaine** / **mois** / **année** (selon ce que l’UI expose).",
           "Optionnel : **sélectionner** une ou plusieurs **#étiquettes** pour **restreindre** les tâches (les **sessions** **sans** tâche **correspondante** **disparaissent** des **vues** **basées** **tâches**).",
-          "Lire les **blocs** : **résumé**, **tableaux** par **jour**, **temps** par **@projet** / **#tag**, **navigation** de **semaine** **le** **cas** **échéant** ; **lancer** la **visite** **guidée** **si** la **pancarte** **le** **propose**."
+          "Lire les **blocs** : **résumé**, **tableaux** par **jour**, temps par **@projet** / **!projet** / **#tag** (les grilles **par projet** du tableau **Rapports** comptent par défaut le temps **@** sans y mélanger le temps **!**) ; **navigation** de **semaine** **le** **cas** **échéant** ; **lancer** la **visite** **guidée** **si** la **pancarte** **le** **propose**.",
         ],
         options: [
           "**Indicateurs non finaux** (pastilles) : rappellent le **travail encore ouvert** dans la plage — lire prudemment, pas de chiffrage *figé* tant que des tâches *bougent* encore.",
+          "Sous le **résumé**, une **ventilation** peut compter les **sessions** par **type de clôture** enregistré à la fin de session (lorsque l’hôte en a choisi un) ; les sessions **sans** catégorie y figurent à part.",
+          "Le **tableau par jour** inclut aussi un total de temps tâche **non concurrent** (sans chevauchement des intervalles horodatés) pour comparer avec le temps enregistré brut.",
           "**Début de semaine** (lundi, dimanche ou samedi) : réglage souvent près des **calendriers** hebdo des rapports — choisissez **ce** qui coïncide avec **votre** semaine réelle.",
-          "Relancer la visite **Rapports** (aide **premier pas** sur l’écran) : [Paramètres — visite Rapports](/settings#settings-reporting-tour)."
+          "Relancer la visite **Rapports** (aide **premier pas** sur l’écran) : [Paramètres — visite Rapports](/settings#settings-reporting-tour).",
+          "Une **deuxième grille** dédiée au seul temps personnel (`!`), **miroir** de celle des projets `@`, **n’est pas** encore dans l’interface ; les agrégats côté moteur prévoient déjà les filtres pour une version ultérieure.",
         ],
       },
       {
         id: "ug-settings-integrations",
         title: "Paramètres, sauvegardes et bouts d’usine (quand vous êtes prêt·e)",
-        searchIndex: "export backup sqlite json csv gitlab mongo v4 v4-dev next dev développement local",
+        searchIndex: "export backup restore restauration sqlite json csv gitlab mongo v4 v4-dev next dev développement local",
         paragraphs: [
           "Ici, vous **réglez** l’**appareil** (KronoFocus, **étiquettes** / **@** avancés, planification) et, **seulement si** vous voulez, le **câble** (Git, GitLab, miroir). La **zone dangereuse** : **lisez** le texte à l’**écran** et la **phrase** de confirmation avant de **valider** un **effacement**. L’[index de la page Paramètres](/settings#settings-usage-profile) liste toutes les sections (sommaire à gauche en grand écran)."
         ],
@@ -222,9 +257,11 @@ function frBundle(): UserGuideBundle {
         options: [
           "**Profil d’usage** ([ancre Profil d’utilisation](/settings#settings-usage-profile)) : ex. *gestion* masque des blocs (p. ex. Lignes de code) qu’un **dév** n’aurait pas caché.",
           "[KronoFocus](/settings#settings-kronoFocus), [Collecte et tampons](/settings#settings-collection), [Horaire de travail](/settings#settings-schedule) ou [sessions planifiées](/settings#settings-planned-sessions), [Tâches et étiquettes](/settings#settings-task-tags) ; [Git](/settings#settings-git) / [MongoDB](/settings#settings-mongo) en branchement **opt-in** (rien n’impose d’ouvrir tout le premier soir).",
-          "**Corrections d’horaire** : commutateurs **on/off** dans [Tâches et étiquettes](/settings#settings-task-tags) pour le **début** et la **fin** d’une **tâche**, et le **début** et la **fin** d’une **session** (la fin : tâches et sessions déjà terminées).",
+          "**Migration d’étiquettes** : dans [Tâches et étiquettes](/settings#settings-task-tags), l’outil de portée permet de **copier** ou **déplacer** une étiquette globale vers une portée projet (`Projet#tag`) et l’inverse.",
+          "**Renommage des étiquettes/projets (inline)** : dans la colonne droite **Tags / Projects / Templates**, cliquez sur le crayon, modifiez le nom directement dans la ligne puis validez par **Entrée** (ou **Échap** pour annuler). Un avertissement précise l’impact sur les **rapports** ; vous pouvez cocher « ne plus afficher » pour les prochains renommages. (Les listes **`knownPersonalProjects`** pour les jetons **`!`** ne disposent pas encore du même écran d’inline que les projets **`@`**.)",
+          "**Corrections d’horaire** : commutateurs **on/off** dans [Tâches et étiquettes](/settings#settings-task-tags) pour le **début** et la **fin** d’une **tâche**, et le **début** et la **fin** d’une **session**. Sur une **tâche** en cours, une heure de fin **termine la tâche** à l’instant prévu. Sur une **session** live, une heure de fin **clôt la session** à l’instant prévu (instantané en historique, équivalent d’une fin de session en mode conserver les tâches ouvertes).",
           "**Général — mode développement (coffre local)** ([Paramètres → Général](/settings#settings-dev-data), seulement en `next dev`) : **Enregistrer** avec le bouton principal ; par défaut, **jeu de données** séparé de la **production** ; on peut partager le coffre `v4` (puis **redémarrer** le serveur de dev).",
-          "**Sauvegarde** (export) : côté technique l’**API** `GET /api/backup` sert le fichier (paramètre de **format**) ; côté **appli** voir aussi [Export par défaut](/settings#settings-export). L’**URL** de base et l’**install** = **README** côté déploiement."
+          "**Sauvegarde / restauration complète** : côté technique, `GET /api/backup` exporte (format), et `POST /api/restore` restaure un fichier JSON ou SQLite ; côté appli, la **Zone de danger** fournit les actions de sauvegarde + restauration guidée.",
         ],
         stepsTitle: "Avant d’effacer l’historique (check-list courte)",
         steps: [
@@ -249,7 +286,7 @@ function enBundle(): UserGuideBundle {
     searchNoResults: "No section matches. Try another keyword or clear the filter.",
     tocHeading: "On this page",
     tocNavAria: "User guide table of contents",
-    lastUpdated: "Last updated: April 2026",
+    lastUpdated: "Last updated: 12 May 2026",
     sections: [
       {
         id: "ug-essence",
@@ -262,7 +299,7 @@ function enBundle(): UserGuideBundle {
         ],
         optionsTitle: "Three “rooms” for three moves",
         options: [
-          "**Dashboard** — the workbench (sessions, tasks, focus timer, **#** tags and **@** projects).",
+          "**Dashboard** — the workbench (sessions, tasks, focus timer, **#** tags, **@** work projects, and **!** personal projects).",
           "**Reports** — the look back (range, themes, charts: numbers come from what you **already** logged).",
           "**Settings** — the back room (habits, connections, the **danger** zone where you wipe history **carefully**). [Open Settings](/settings#settings-usage-profile).",
         ],
@@ -270,7 +307,7 @@ function enBundle(): UserGuideBundle {
         steps: [
           "Open the **home** (dashboard) — the workbench starts there.",
           "Start a **new session** (or let the app start one the first time a task needs it).",
-          "Name a **task**; **#** = tag, **@** = project (the form often **suggests** both from what you type).",
+          "Name a **task**; **#** = tag; **@** = work project; **!** = personal project (the form often **suggests** tags and projects from what you type).",
           "Press **Start** on the task, or add **KronoFocus** on the **side** if a ritual helps more than a bare timer in the list.",
           "When you need the bigger picture, open **Reports** for a **date range** — you should not have to re-run the week in spreadsheets to see it.",
         ],
@@ -283,56 +320,88 @@ function enBundle(): UserGuideBundle {
           "The top bar reuses the **same** **family** of controls (zinc, **violet** accents) on every page so **navigation** stays **light** on the brain. The **cog** icon opens [Settings](/settings#settings-usage-profile) (shortcut **Alt+Shift+S** from the dashboard).",
         ],
         steps: [
-          "On the **dashboard**: **Book** → this guide; **chart** → **Reports**; **cog** → **Settings**.",
-          "On **other** pages: **grid** back to **home**; same book / chart / cog; on **Licenses** only, you also get a **file** icon.",
+          "On the **dashboard**: **Book** → this guide; **chart** → **Reports**; **cog** → **Settings**; **code** → user stories (implementation status).",
+          "On **other** pages: **grid** back to **home**; same book / chart / cog / code; on **Implementation**, a dedicated **changelog** icon opens `/changelog`; on **Licenses** only, you also get a **file** icon.",
+          "On **Implementation**, rows with a **chevron** expand for extra **detail** and an **example** (smaller type) under the short wording.",
+          "Still on the dashboard, a **Today Gantt** button (grid) opens one global timeline for tasks from **all** sessions in the current day.",
           "**Theme** toggle: **light** or **dark** (evening work or a bright room).",
           "**Refresh** fetches state again from the **server** (e.g. after a change you know happened elsewhere).",
           "**Language** menu: **EN** / **FR**; if the server is configured, the choice can **stick** between visits.",
         ],
         options: [
-          "**Book** = this guide; **Chart** = **Reports**; **Cog** = **Settings**; **File** = **Licenses** (only on the licenses page).",
+          "**Book** = this guide; **Chart** = **Reports**; **Cog** = **Settings**; **Grid** = **Today Gantt** (dashboard); **Code** = user stories (✓/✗); **Changelog** = user update log (dedicated icon on Implementation); **File** = **Licenses** (only on the licenses page).",
           "The **theme** only changes how the **UI** looks — it does **not** alter your stored work.",
         ],
       },
       {
         id: "ug-layout",
         title: "Where to work, where to look back, where to tune",
-        searchIndex: "workspace dashboard reports settings license legal",
+        searchIndex: "workspace dashboard reports settings license legal clock timezone",
         paragraphs: [
           "Three main moves: the workbench (now), **Reports** (then), **Settings** (how the app runs + serious cleanup). **Licenses** is the honest credit page for the open building blocks we use.",
         ],
         options: [
-          "**Dashboard** — **sessions** on the left, **tasks** in the **centre**, **tag** and **@** **shortcuts** on the right so you stop retyping the same words.",
+          "**Dashboard** — **sessions** on the left, **tasks** in the **centre**, **tag** and **project** shortcuts (**@** work, **!** personal) on the right so you stop retyping the same words.",
           "**Reports** — pick a **date range** and, if needed, **#** tags; read **summaries** and **charts**; the **tour** may offer itself the first time you land there.",
           "**Settings** — profile, collection, scheduling, **advanced** tags, optional **Git** or **remote**; the **danger zone** can **delete** all **history** (type-to-confirm). [Settings overview](/settings#settings-usage-profile) · [danger zone](/settings#settings-danger-zone).",
           "**Licenses** — MIT, third parties, **fonts**; the **file** icon **only** on that page.",
+          "A **wall clock** (time zone and 12/24 h from **Web dashboard** settings) stays visible in the header **toolbar**, left of the navigation icons."
+        ],
+      },
+      {
+        id: "ug-convention-end-vs-pause",
+        title: "Convention: scheduled end time vs pause",
+        searchIndex:
+          "convention pause scheduled end completion closure timer wall clock deferred break",
+        paragraphs: [
+          "In Kronosys, a **scheduled end time** on a **running task** or **session** means **completion** at that instant — it is **not** a **deferred pause** or “pause later at this clock time”.",
+          "To **pause** tracking (timer, wall clock, session), use the **pause actions** built for that purpose; they are **separate** from **deadlines** and **scheduled ends**.",
+        ],
+        bullets: [
+          "**Scheduled end** → the **task finishes** or the **session closes** at the chosen instant.",
+          "**Pause** → an **explicit action** (task timer, paused live session, global pause, etc.).",
         ],
       },
       {
         id: "ug-sessions-tasks",
         title: "Sessions, tasks, tags, and projects",
-        searchIndex: "session archive end task timer pause subtask",
+        searchIndex:
+          "session archive end task timer pause subtask history list summary planned badge chip conflict navigation personal project glued bang email",
         paragraphs: [
-          "A **session** is the **bag** work piles into; a **task** is the **thread** of a moment. **#** and **@** are naming helpers, not a grammar test.",
+          "A **session** is the **bag** work piles into; a **task** is the **thread** of a moment. **#** tags themes; **@** marks a **work** project; **!** marks a **personal** project (often a **rose** chip) — naming helpers, not a grammar test. **`!`** (including **`!project#subtag`**) may be **glued** to the previous word with **no space** — e.g. `Errands!personal#dentist`; **`@`** still expects **whitespace before** or **start of field** so emails like `user@host` are not parsed as projects.",
         ],
         optionsTitle: "New session — the frame, your choice",
         options: [
+          "**Start** **now** (immediate) or **in the past** — then enter **both start and end** in your browser’s local date and time — if a session is **already live**, **starting now** runs the usual **end session** flow first; a **backdated** row does **not** interrupt the live session: it is added to **history** and the UI focuses it so you can **log tasks** in the past.",
           "**No** extra frame in particular: start, and the flow **carries** you.",
           "**Max wall** clock: a **nudge** to reframe a **very** long stint.",
           "**Calendar** window: from / to **dates** (a commitment to your later self or someone else).",
           "**Week** + time window on selected **weekdays** (handy in a **fixed** rhythm; skip it if you hate that).",
-          "Tasks in **real time** or back-filled with start and end: honest to log the evening for **yesterday**’s work.",
+          "Tasks in **real time** or back-filled with start, end, and **timer duration** (h/m/s — same idea as duration adjustments): honest to log the evening for **yesterday**’s work.",
         ],
         stepsTitle: "After you press “Start” on a task (usual order)",
         steps: [
-          "Type a **title**; add **#** and/or **@** when the words come (a **live** **preview** often shows under the field).",
+          "Type a **title**; add **#**, **@**, and/or **!** when the words come (a **live** **preview** often shows under the field). Add an optional **free-text task note**, and a **session note** when useful.",
           "Click **Start** on the task — or, if it fits, launch **KronoFocus** from that **task** first (same work, different rhythm).",
           "If another **timer** is on: **pause** it, **finish** it, or allow both in **parallel** (you can **save** the choice for the next time).",
           "While in progress: add **subtasks**; check them; **reorder** by **drag and drop**; use **pause** and **resume** kindly.",
           "**End session** from the header or banner: optional end reason (on time, early, overrun, other + note) — a word for **how** the block **ended**, not a cold verdict.",
         ],
         bullets: [
-          "When **Commit** on **finish** appears, it is about **Git** (see [Git sync](/settings#settings-git) in **Settings**) — you can **ignore** it with a clear head if you are not in that workflow.",
+          "Each **task** supports a **free-text note** shown on the card; the note appears before the **subtasks** block to keep context first.",
+          "Each **session** supports a **session note**; a preview (icon + excerpt) appears in the session list and in archived sessions.",
+          "The **global pause** control is **inactive** (with a tooltip) when **nothing is running** — wall clock already frozen and no timers — otherwise it opens a **confirmation** with a **summary**: **start** and **end** (*ongoing* when there is no end yet), **wall duration**, **session coding** and **active** times when the host records them, **task** / **subtask** counts, **total recorded** task-timer time, then the **split** between **main task** time (excluding subtasks) and **subtask** timers, followed by the list of timer effects; once confirmed, it pauses the current session context (session, task timers, and subtask timers); the next click resumes **only that paused set**.",
+          "**Session pause** (header control while the session is **live**) also **freezes** **active** **task** and **subtask** timers; **resume session** only restarts what was frozen **by that pause** — not a task you had already paused **manually** beforehand. Resuming a **single task** removes it from the batch that a later **resume session** would restart.",
+          "When ending a session that still has open tasks, you can **finish** them, **move** them to a **new paused session**, or **leave** them **open** in the archived snapshot — **task timers for that session always stop**.",
+          "In that **live paused** session, a **banner** lets you **resume session**; **play** on a task also **resumes** wall-clock tracking.",
+          "When the live session is **paused** (wall clock and affected timers, or **global pause**), the **Active session** card shows a **Paused** or **Global pause** chip; a **dimmed overlay** centers a reminder while the **top bar** stays usable to **resume**.",
+          "Even a **completed past session** still accepts a **past entry**: select it, set start, end, and duration, then add the task to that history snapshot.",
+          "Under [Settings → Web dashboard](/settings#settings-default-session-name), an optional **template** sets the **default name** for each **new** session (`%UUID`, POSIX-style `strftime` fields — authoritative link on that screen). Expansion uses your **display** **time zone** (same buckets as Reporting).",
+          "On a **running**, **paused**, or **completed** task, **Save as template** (icon) saves its title, **#tags**, and either an **@** or **!** project. The “what are you working on” input suggests them (**Template:** in the dropdown) with **debounced** filtering; **Ctrl+K / ⌘K** search lists them; [Settings → Task templates](/settings#settings-task-templates) also lets you **manage** them.",
+          "When you edit a task **start/end** timestamp, a modal asks how to handle duration: keep system timer duration, enter duration manually, or recalculate from start/end. On a **running** task, an **end time** **completes the task** at that instant — it is not a soft pause.",
+          "When a **not-done** task’s **start** is still **in the future**, it is grouped under **Planned** with **sky** styling (no live timer). For a **completed** task, that **Planned** styling applies only when **both start and end** are still **strictly in the future**; if the start has passed but the end is still ahead (e.g. a scheduled end), the row stays under **Completed** instead of being stuck under **Planned** until the end time. The same idea applies to a **live** session whose official **start time** is still in the future (**distinct** row in the list). There is **no “planned” text badge** — section, styling, and the status dot carry the meaning.",
+          "When a **planned** task **becomes live tracking** while **another** timer was already shown as **running**, a modal offers **pause**, **finish**, and **parallel** (with the same optional **remember** setting as when you start a task manually), applying only to the **tasks that were already running** before the clock crossed; away from the dashboard route, the **Dashboard** icon may **pulse briefly** as a hint.",
+          "For a **session** in **history** (not the **live** one), the **summary** (name, duration, metrics) appears **under that row** in the sessions **list**, so details stay anchored to the same entry while you browse.",
         ],
       },
       {
@@ -356,16 +425,16 @@ function enBundle(): UserGuideBundle {
       },
       {
         id: "ug-search-palette",
-        title: "Search: data (dashboard) and topics (this guide)",
-        searchIndex: "palette data search ctrl k",
+        title: "Spotlight search: data (dashboard) and topics (this guide)",
+        searchIndex: "palette data search templates ctrl k",
         paragraphs: [
-          "Same field **look** (zinc **border**, **violet** ring on **focus**): first the **workshop** (sessions, tasks, **#** / **@**); on **this** page, the line at the top only **filters** this help text.",
+          "Same field **look** (zinc **border**, **violet** ring on **focus**): first the **workshop** (sessions, tasks, **task templates**, **#** / **@** / **!**); on **this** page, the line at the top only **filters** this help text.",
         ],
         stepsTitle: "Data — the search palette (dashboard)",
         steps: [
           "Click **search data** or press **Ctrl+K** (win/linux) / **⌘K** (mac) — the palette is **reserved**; you do **not** rebind that chord in the **shortcuts** **modal**.",
-          "Type a few **letters** of a **session**, **task**, **#**, or **@**; the list **tightens** as you type.",
-          "**Enter** a row to **jump**; **Esc** closes the box without a full **page** **reload**.",
+          "Type a few **letters** of a **session**, **task**, **template**, **#**, **@**, or **!**; the list **tightens** as you type.",
+          "**Enter** a row to **jump**; for a **template**, the **new task** field is **filled**; **Esc** closes the box without a full **page** **reload**.",
         ],
         optionsTitle: "This guide — filter at the top of the page",
         options: [
@@ -402,19 +471,22 @@ function enBundle(): UserGuideBundle {
           "Set **from** and **to** (or a day / week / month / year **preset**, depending on what the UI offers).",
           "Use **Today** / **Now** quick actions in date/time pickers whenever available to jump to the current value.",
           "Optionally pick one or more **#** **tags** (sessions with **no** **matching** task may **disappear** from some **task**-based **views**).",
-          "Scroll the **summary**, per-day **tables**, **@project** / **#tag** **breakdowns**, and the week nudger when your data has **enough** **weeks** to flip through.",
+          "Scroll the **summary**, per-day **tables**, **@** / **!** / **#** **breakdowns** (the **per-project** grids on **Reports** default to **@** work time and **exclude** **!** personal minutes from those rows), and the week nudger when your data has **enough** **weeks** to flip through.",
           "Start the **guided** **tour** if a prompt appears the **first** time.",
         ],
         options: [
           "**Non-final** chips mark work that is not **closed** in the **range** you are looking at: read them gently; the **draft** is not a **failure**.",
+          "Below the **summary** KPIs, a **breakdown** may count **sessions** by **closure type** saved when a session ended (when the host picked one); sessions **without** a stored category are grouped separately.",
+          "The **day table** now includes a **non-concurrent** task-time total (timestamped overlap removed) so you can compare it against raw recorded task time.",
           "**Week** starts on (Monday, Sunday, or Saturday) — often next to the tag-week **grids**; pick the one that **matches** how you read a week.",
           "Re-launch the **Reports** first-time **tour** from [Settings — Reporting tour](/settings#settings-reporting-tour).",
+          "A **second** grid that shows **only** personal (`!`) project time, **parallel** to the `@` project grid, is **not** in the UI yet; the aggregation layer already has filters for a future release.",
         ],
       },
       {
         id: "ug-settings-integrations",
         title: "Settings, safety copies, and extra wiring (when you are ready)",
-        searchIndex: "export backup sqlite json gitlab mongo v4 v4-dev next dev local development",
+        searchIndex: "export backup restore sqlite json gitlab mongo v4 v4-dev next dev local development",
         paragraphs: [
           "Here you tune how the app **presents** itself (KronoFocus, tags and **@** **advanced** paths, **schedule**) and, only if you want, the **cable** to **Git**, GitLab, a **mirror**… The **danger** **zone** — read the on-screen text and the **type**-**to**-**confirm** line before a full **wipe**. The [Settings page index](/settings#settings-usage-profile) links every section (left-hand **TOC** on a wide window).",
         ],
@@ -422,9 +494,11 @@ function enBundle(): UserGuideBundle {
         options: [
           "**Usage** profile ([Usage profile section](/settings#settings-usage-profile)): e.g. *manager* hides some developer-heavy **panels** you might still want in *dev* mode.",
           "[KronoFocus](/settings#settings-kronoFocus), [Collection & buffers](/settings#settings-collection), [work schedule](/settings#settings-schedule) or [planned sessions](/settings#settings-planned-sessions), [Tasks & tags](/settings#settings-task-tags) ; [Git](/settings#settings-git) / [MongoDB mirror](/settings#settings-mongo) as **opt-in** (nothing forces you to turn everything on day one).",
-          "**Time correction**: **on/off** toggles in [Tasks & tags](/settings#settings-task-tags) for **task** and **session** **start** times, plus separate toggles for **end** times on **completed** tasks and **finished** sessions.",
+          "In [Tasks & tags](/settings#settings-task-tags), the scope migration tool lets you **copy** or **move** a global tag into a project scope (`Project#tag`) and back to global.",
+          "**Inline tag/project rename**: in the right **Tags / Projects / Templates** column, click the pencil, edit the name in-place, then confirm with **Enter** (**Escape** cancels). A warning explains the reporting impact; you can tick “don’t show again” for future renames. (**`knownPersonalProjects`** for **`!`** tokens does not yet get the same dedicated inline screen as **`@`** projects.)",
+          "**Time correction**: **on/off** toggles in [Tasks & tags](/settings#settings-task-tags) for **task** and **session** **start** and **end** times. On a **running task**, an end time **completes the task** at that instant. On a **live session**, an end time **closes the session** at that instant (history snapshot), like ending with **keep** for open tasks.",
           "**General — local development (data store)** ([Settings → General](/settings#settings-dev-data), only under `next dev`): use the main **Save** button; by default, **dev** uses a **separate** data folder from **production**; you can opt into the same `v4` path, then **restart** the dev server.",
-          "**Backup** (export): technically `GET /api/backup` with a **format** query; in the app see also [Export defaults](/settings#settings-export). Base URL and deployment = **README** in your **environment**, not this page alone.",
+          "**Backup / full restore**: technically `GET /api/backup` exports by **format**, and `POST /api/restore` restores a JSON or SQLite backup file; in the app, use the **Danger zone** controls for guided backup and restore.",
         ],
         stepsTitle: "Before clearing all history (short list)",
         steps: [

package/next.config.ts

@@ -10,6 +10,13 @@ const nextConfig: NextConfig = {
   },
   serverExternalPackages: ["better-sqlite3"],
   outputFileTracingRoot: appDir,
+  webpack: (config) => {
+    config.resolve.alias = {
+      ...config.resolve.alias,
+      "@": appDir,
+    };
+    return config;
+  },
 };
 
 export default nextConfig;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nightkatana/kronosys-app",
-  "version": "1.0.0-beta.2",
+  "version": "1.0.0-beta.21",
   "description": "Kronosys — application Next.js (UI + API + SQLite).",
   "license": "MIT",
   "author": "nightkatana",
@@ -11,19 +11,6 @@
   "bin": {
     "kronosys": "./bin/kronosys.mjs"
   },
-  "files": [
-    "README.md",
-    "bin",
-    "app",
-    "components",
-    "lib",
-    "public",
-    "server",
-    "next.config.ts",
-    "postcss.config.mjs",
-    "tsconfig.json",
-    "next-env.d.ts"
-  ],
   "engines": {
     "node": ">=20"
   },
@@ -37,12 +24,14 @@
     "build": "next build --webpack",
     "start": "next start -p 5555",
     "lint": "eslint",
+    "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage --reporter=default --reporter=junit --outputFile.junit=reports/vitest-junit.xml",
     "test:watch": "vitest",
     "test:e2e": "playwright test",
     "test:e2e:ui": "playwright test --ui",
     "test:e2e:install": "playwright install chromium",
+    "test:e2e:podman": "bash scripts/e2e-podman.sh",
     "prepare": "husky",
     "prepublishOnly": "npm run build",
     "hooks:install": "husky",
@@ -56,7 +45,6 @@
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
     "@tailwindcss/postcss": "^4",
-    "better-sqlite3": "^12.9.0",
     "date-fns": "^4.1.0",
     "fflate": "^0.8.2",
     "lucide-react": "^1.8.0",
@@ -65,23 +53,23 @@
     "react": "19.2.4",
     "react-day-picker": "^9.14.0",
     "react-dom": "19.2.4",
+    "react-markdown": "^10.1.0",
     "tailwindcss": "^4",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "@types/node": "^22.15.21",
+    "@types/react": "^19",
+    "@types/react-dom": "^19"
   },
   "devDependencies": {
     "@changesets/cli": "^2.31.0",
     "@playwright/test": "^1.59.1",
     "@testing-library/react": "^16.3.0",
     "@testing-library/user-event": "^14.6.1",
-    "@types/better-sqlite3": "^7.6.13",
-    "@types/node": "^22.15.21",
-    "@types/react": "^19",
-    "@types/react-dom": "^19",
-    "@vitest/coverage-v8": "^3.2.4",
+    "@vitest/coverage-v8": "^4.1.5",
     "eslint": "^9",
     "eslint-config-next": "16.2.3",
     "husky": "^9.1.7",
-    "jsdom": "^26.1.0",
-    "vitest": "^3.2.4"
+    "jsdom": "^29.1.1",
+    "vitest": "^4.1.5"
   }
-}
+}