From 180b00e8ed1d415e12ed7ceaf3c1e2d289185455 Mon Sep 17 00:00:00 2001
From: stephan <stephan@progiweb.ca>
Date: Wed, 17 Jun 2026 07:01:02 -0400
Subject: [PATCH] Refactor documentation trigger and styles for improved user
 interaction

This commit updates the CSS for the documentation overlay, consolidating styles for the help button and ensuring it aligns with the existing button styles. The PHP files have been modified to enhance the integration of the documentation trigger within the block headers, allowing for optional documentation links. Additionally, the SQL file has been updated to improve the content of the documentation pages, providing clearer instructions and enhancing user experience.
---
 css/ms1-doc.css                        | 47 +++-----------------------
 php/inc_fx_doc.php                     |  4 +--
 php/inc_fx_promoteur.php               | 12 ++++---
 php/inc_settings.php                   |  2 +-
 sql/MSIN-doc-module-update-content.sql | 32 ++++++++++++++++++
 sql/MSIN-doc-module.sql                | 38 ++++++++++-----------
 6 files changed, 67 insertions(+), 68 deletions(-)
 create mode 100644 sql/MSIN-doc-module-update-content.sql

diff --git a/css/ms1-doc.css b/css/ms1-doc.css
index 0c38f1d..6883e74 100644
--- a/css/ms1-doc.css
+++ b/css/ms1-doc.css
@@ -2,50 +2,13 @@ body.ms1-doc-open {
     overflow: hidden;
 }
 
- * Distinct de ms1-bib / Tippy (info_aide).
+/**
+ * MS1 — Module documentation (overlay paginé).
+ * Le bouton ? réutilise .btn-aide-bib (style.css) — pas de style rond dupliqué ici.
  */
 
-/* Bouton ? à côté d'un titre de bloc */
-.ms1-doc-trigger,
-.btn-doc-trigger {
-    display: inline-flex;
-    align-items: center;
-    justify-content: center;
-    width: 22px;
-    height: 22px;
-    margin-left: 6px;
-    padding: 0;
-    border: 1px solid #6c757d;
-    border-radius: 50%;
-    background: #6c757d;
-    color: #fff;
-    font-size: 12px;
-    font-weight: 600;
-    line-height: 1;
-    vertical-align: middle;
-    cursor: pointer;
-}
-
-.ms1-doc-trigger:hover,
-.btn-doc-trigger:hover {
-    background: #5a6268;
-    border-color: #5a6268;
-    color: #fff;
-}
-
-/* En-tête bleu épreuve dossards — second ? (guide paginé) */
-.epr-header .ms1-doc-trigger,
-.epr-header .btn-doc-trigger {
-    border-color: rgba(255, 255, 255, 0.85);
-    background: rgba(255, 255, 255, 0.2);
-    color: #fff;
-}
-
-.epr-header .ms1-doc-trigger:hover,
-.epr-header .btn-doc-trigger:hover {
-    background: rgba(255, 255, 255, 0.35);
-    border-color: #fff;
-    color: #fff;
+.btn-aide-bib.ms1-doc-trigger {
+    flex-shrink: 0;
 }
 
 /* Overlay plein écran */
diff --git a/php/inc_fx_doc.php b/php/inc_fx_doc.php
index 5ffdaae..941459d 100644
--- a/php/inc_fx_doc.php
+++ b/php/inc_fx_doc.php
@@ -293,12 +293,12 @@ function afficheDocSousTitre($clef, $mem_echo = 1, $mem_global = 0, $modClef = '
     return $str;
 }
 
-/** Bouton ? pour ouvrir le module doc (clé doc_anchor_clef). */
+/** Bouton ? pour ouvrir le module doc (clé doc_anchor_clef) — même rond que btn-aide-bib. */
 function fxDocRenderTrigger($anchorClef, $mem_global = 0, $strAriaLabel = 'Documentation') {
     $modClef = fxDocResolveModClef($anchorClef, $mem_global);
 
     return '<button type="button"'
-        . ' class="btn-doc-trigger ms1-doc-trigger"'
+        . ' class="btn-aide-bib ms1-doc-trigger btn-doc-trigger"'
         . ' data-doc-anchor="' . fxDocEsc($anchorClef) . '"'
         . ' data-doc-mod="' . fxDocEsc($modClef) . '"'
         . ' aria-label="' . fxDocEsc($strAriaLabel) . '"'
diff --git a/php/inc_fx_promoteur.php b/php/inc_fx_promoteur.php
index 613ae1a..e7336c0 100644
--- a/php/inc_fx_promoteur.php
+++ b/php/inc_fx_promoteur.php
@@ -2780,9 +2780,13 @@ function fxBibTexteAide($clef, $mem_echo = 1, $strFallback = '') {
     return $html;
 }
 
-/** Titre d'en-tête de bloc (assignation, gestion…) + aide. */
-function fxBibBlockHeader($clef, $strFallback = '') {
-    return '<span class="epr-header-label">' . fxBibEsc(fxBibTexte($clef, 0, $strFallback)) . fxBibAideButton($clef) . '</span>';
+/** Titre d'en-tête de bloc (assignation, gestion…) + aide + doc overlay optionnel. */
+function fxBibBlockHeader($clef, $strFallback = '', $docAnchorClef = '') {
+    $html = '<span class="epr-header-label">' . fxBibEsc(fxBibTexte($clef, 0, $strFallback)) . fxBibAideButton($clef);
+    if ($docAnchorClef !== '') {
+        $html .= fxDocRenderTrigger($docAnchorClef);
+    }
+    return $html . '</span>';
 }
 
 /** Cellule d'en-tête de colonne séquence + aide optionnelle (info_texte peut être vide). */
@@ -3082,7 +3086,7 @@ if ($teamMode <= 0) {
 
                     <?php /* MSIN-4379 — Assignation de dossard : séquences + actions (ex 3e colonne). */ ?>
                     <div class="epr-block epr-block-assign">
-                        <div class="epr-header"><?php echo fxBibBlockHeader('bib_v4_assign_title', 'Assignation de dossard') . fxDocRenderTrigger('bib_v4_assign_doc'); ?></div>
+                        <div class="epr-header"><?php echo fxBibBlockHeader('bib_v4_assign_title', 'Assignation de dossard', 'bib_v4_assign_doc'); ?></div>
                         <div class="epr-content">
 
                     <?php if (count($tabBibStats) == 0) { ?>
diff --git a/php/inc_settings.php b/php/inc_settings.php
index 51116ab..9528862 100644
--- a/php/inc_settings.php
+++ b/php/inc_settings.php
@@ -7,7 +7,7 @@
  * Constantes *
  *
  **************/
-define('_VERSION_CODE', '4.72.639');
+define('_VERSION_CODE', '4.72.640');
 define('_DATE_CODE', '2026-06-17');
 //MSIN-4290
 define('QR_SECRET_KEY', 'ms1_qr_2026_cle_secrete_longue_et_fixe');
diff --git a/sql/MSIN-doc-module-update-content.sql b/sql/MSIN-doc-module-update-content.sql
new file mode 100644
index 0000000..5d31a24
--- /dev/null
+++ b/sql/MSIN-doc-module-update-content.sql
@@ -0,0 +1,32 @@
+-- MSIN-doc — Mise à jour du contenu guide assignation de dossard (si tables déjà créées).
+-- Exécuter sur la BD client après MSIN-doc-module.sql initial.
+
+UPDATE doc_page SET doc_titre = 'Assignation de dossard', doc_sous_titre = 'Vue d''ensemble du module',
+doc_html = '<article class="ms1-doc-article"><p>Définissez les <strong>séquences de dossards</strong> et assignez les numéros aux participants inscrits sur chaque épreuve.</p><h3>À quoi sert ce bloc ?</h3><p>Ce panneau regroupe tout ce qui touche l''<strong>assignation des dossards</strong> : création des séquences, assignation groupée (batch), assignation automatique à l''inscription et réinitialisation.</p><h3>Workflow recommandé</h3><ol><li>Créer une ou plusieurs <strong>séquences</strong> (numéros de début et de fin).</li><li>Optionnel : activer l''<strong>assignation automatique</strong> pour les nouvelles inscriptions.</li><li>Pour les participants déjà inscrits sans dossard : <strong>Assigner par séquence</strong>, puis <strong>Simuler</strong>, puis <strong>GO</strong>.</li></ol><blockquote>Utilisez toujours <strong>Simuler</strong> avant <strong>GO</strong> pour vérifier le résultat sans modifier la base de données.</blockquote></article>',
+doc_maj = NOW()
+WHERE doc_page_clef = 'bib_doc_overview' AND doc_langue = 'fr' AND doc_prg = 'compte.php';
+
+UPDATE doc_page SET doc_titre = 'Séquences de dossards', doc_sous_titre = 'Tableau des séquences',
+doc_html = '<article class="ms1-doc-article"><p>Chaque ligne du tableau représente une <strong>séquence de dossards</strong> (plage de numéros disponibles pour l''épreuve).</p><h3>Colonnes et actions</h3><table><tr><th>Icône œil</th><td>Voir la grille des dossards de cette séquence (occupés / libres).</td></tr><tr><th>Début</th><td>Premier numéro de la séquence.</td></tr><tr><th>Fin</th><td>Dernier numéro de la séquence.</td></tr><tr><th>OK</th><td>Enregistrer cette séquence après modification.</td></tr><tr><th>Suppr.</th><td>Supprimer la séquence.</td></tr><tr><th>Dernier</th><td>Dernier dossard assigné dans la séquence.</td></tr><tr><th>Utilisé</th><td>Nombre de dossards déjà assignés.</td></tr><tr><th>Dispo</th><td>Dossards encore disponibles dans la séquence.</td></tr></table><h3>+ Ajouter</h3><p>Ajoute une nouvelle séquence de dossards pour cette épreuve. Indiquez le numéro de <strong>début</strong> et de <strong>fin</strong>, puis cliquez <strong>OK</strong>.</p><p>La case à gauche de chaque ligne permet de <strong>sélectionner</strong> la séquence pour l''assignation batch ou l''assignation automatique.</p></article>',
+doc_maj = NOW()
+WHERE doc_page_clef = 'bib_doc_sequences' AND doc_langue = 'fr' AND doc_prg = 'compte.php';
+
+UPDATE doc_page SET doc_titre = 'Assigner par séquence', doc_sous_titre = 'Mode batch — Simuler puis GO',
+doc_html = '<article class="ms1-doc-article"><p>Le bouton <strong>Assigner par séquence</strong> ouvre le mode batch : il assigne tous les participants <em>sans dossard</em> en une seule opération.</p><h3>Étapes</h3><ol><li><strong>Cochez</strong> une ou plusieurs séquences de dossards.</li><li>Choisissez l''<strong>ordre d''assignation</strong> : critère pour trier les participants avant d''attribuer les dossards (nom, date d''inscription, équipe, etc.).</li><li><strong>Simuler</strong> — affiche qui recevrait quel dossard sans modifier la base de données.</li><li><strong>GO</strong> — lance l''assignation batch pour de vrai.</li></ol><p>Le résumé (disponibles / à assigner / manquants) s''affiche après simulation ou GO.</p><h3>Réinitialiser</h3><p>Retire les dossards déjà assignés pour les séquences concernées. <strong>Attention :</strong> vérifiez l''impact avant de confirmer. Ce bouton n''apparaît que s''il existe déjà des dossards assignés sur l''épreuve.</p></article>',
+doc_maj = NOW()
+WHERE doc_page_clef = 'bib_doc_batch' AND doc_langue = 'fr' AND doc_prg = 'compte.php';
+
+UPDATE doc_page SET doc_titre = 'Assignation automatique', doc_sous_titre = 'Dossard à chaque nouvelle inscription',
+doc_html = '<article class="ms1-doc-article"><p><strong>Assignation automatique</strong> : active l''assignation d''un dossard à chaque nouvelle inscription, en utilisant les séquences choisies.</p><h3>Activation</h3><ol><li>Cliquez <strong>Assignation automatique</strong> (ou <strong>Auto — configurer</strong> si déjà actif).</li><li>Cochez les séquences à utiliser pour l''assignation auto.</li><li>Cliquez <strong>Accepter</strong> pour enregistrer la configuration.</li></ol><p>Le badge <strong>Auto actif</strong> confirme que l''assignation automatique est activée pour cette épreuve.</p><h3>Annuler / Désactiver</h3><ul><li><strong>Annuler</strong> — quitte le mode édition sans enregistrer.</li><li><strong>Désactiver l''auto</strong> — désactive l''assignation automatique. Les séquences de dossards restent en place.</li></ul><blockquote>L''auto et le batch peuvent coexister : l''auto gère les nouveaux inscrits ; le batch rattrape les participants sans dossard.</blockquote></article>',
+doc_maj = NOW()
+WHERE doc_page_clef = 'bib_doc_auto' AND doc_langue = 'fr' AND doc_prg = 'compte.php';
+
+UPDATE doc_page SET doc_titre = 'Épreuve individuelle', doc_sous_titre = 'Participants solo',
+doc_html = '<article class="ms1-doc-article"><p>Sur une épreuve <strong>individuelle</strong> (solo), chaque participant reçoit son propre numéro de dossard.</p><h3>Ordre d''assignation</h3><p>Lors d''un assignation par séquence, choisissez le critère de tri dans la liste <strong>Ordre d''assignation</strong> : nom de famille, prénom, date d''inscription, date de naissance, etc.</p><p>L''option liée au <strong>nom d''équipe</strong> est masquée sur une épreuve solo — elle n''a pas de sens sans épreuve en équipe.</p><h3>Grille des dossards</h3><p>L''icône <strong>œil</strong> sur une séquence ouvre la grille visuelle. Un numéro peut y être modifié manuellement ; le système vérifie les doublons sur l''événement.</p></article>',
+doc_maj = NOW()
+WHERE doc_page_clef = 'bib_doc_solo' AND doc_langue = 'fr' AND doc_prg = 'compte.php';
+
+UPDATE doc_page SET doc_titre = 'Épreuve en équipe', doc_sous_titre = 'Dossards individuels vs 1 équipe = 1 dossard',
+doc_html = '<article class="ms1-doc-article"><p>Sur une épreuve <strong>en équipe</strong>, choisissez la <strong>méthode d''assignation</strong> dans le panneau de gauche, <em>avant le premier dossard assigné</em>. Le choix est verrouillé ensuite.</p><h3>Dossards individuels</h3><p>Chaque membre de l''équipe reçoit un numéro distinct, comme en solo. L''ordre d''assignation <strong>Nom d''équipe</strong> devient disponible pour grouper l''assignation.</p><h3>1 équipe = 1 dossard</h3><p>Tous les membres d''une équipe partagent le <strong>même numéro</strong>. L''assignation batch traite les équipes, pas chaque personne individuellement.</p><blockquote>Changer de méthode après des dossards assignés nécessite une réinitialisation — planifiez le mode avant le premier GO.</blockquote><p>La grille des dossards (icône œil) regroupe visuellement les membres par équipe pour faciliter la lecture.</p></article>',
+doc_maj = NOW()
+WHERE doc_page_clef = 'bib_doc_equipe' AND doc_langue = 'fr' AND doc_prg = 'compte.php';
diff --git a/sql/MSIN-doc-module.sql b/sql/MSIN-doc-module.sql
index 84b3465..39a204c 100644
--- a/sql/MSIN-doc-module.sql
+++ b/sql/MSIN-doc-module.sql
@@ -68,44 +68,44 @@ VALUES ('bib_assignment', 'compte.php', 'Assignation de dossard', 1, 10, NOW());
 INSERT INTO `doc_anchor` (`doc_anchor_clef`, `doc_mod_clef`, `doc_prg`, `doc_actif`, `doc_creation`)
 VALUES ('bib_v4_assign_doc', 'bib_assignment', 'compte.php', 1, NOW());
 
--- FR — pages du guide (contenu à composer ; structure HTML prête)
+-- FR — pages du guide (contenu composé depuis les clés info bib_v4_*)
 INSERT INTO `doc_page` (`doc_mod_clef`, `doc_page_clef`, `doc_langue`, `doc_titre`, `doc_sous_titre`, `doc_html`, `doc_prg`, `doc_tri`, `doc_actif`, `doc_creation`) VALUES
 ('bib_assignment', 'bib_doc_overview', 'fr', 'Assignation de dossard', 'Vue d''ensemble du module',
-'<article class="ms1-doc-article"><p>Définissez des <strong>séquences de dossards</strong> et assignez les numéros aux participants inscrits.</p><h3>Workflow typique</h3><ol><li>Créer une ou plusieurs séquences (ex. 1–500).</li><li>Choisir le mode batch ou l''assignation automatique.</li><li>Utiliser <strong>Simuler</strong> avant <strong>GO</strong>.</li></ol></article>',
+'<article class="ms1-doc-article"><p>Définissez les <strong>séquences de dossards</strong> et assignez les numéros aux participants inscrits sur chaque épreuve.</p><h3>À quoi sert ce bloc ?</h3><p>Ce panneau regroupe tout ce qui touche l''<strong>assignation des dossards</strong> : création des séquences, assignation groupée (batch), assignation automatique à l''inscription et réinitialisation.</p><h3>Workflow recommandé</h3><ol><li>Créer une ou plusieurs <strong>séquences</strong> (numéros de début et de fin).</li><li>Optionnel : activer l''<strong>assignation automatique</strong> pour les nouvelles inscriptions.</li><li>Pour les participants déjà inscrits sans dossard : <strong>Assigner par séquence</strong>, puis <strong>Simuler</strong>, puis <strong>GO</strong>.</li></ol><blockquote>Utilisez toujours <strong>Simuler</strong> avant <strong>GO</strong> pour vérifier le résultat sans modifier la base de données.</blockquote></article>',
 'compte.php', 10, 1, NOW()),
-('bib_assignment', 'bib_doc_sequences', 'fr', 'Séquences de dossards', 'Colonnes et actions du tableau',
-'<article class="ms1-doc-article"><h3>Colonnes</h3><p><strong>Début / Fin</strong> — bornes de la séquence. <strong>OK</strong> enregistre. <strong>Suppr.</strong> retire la séquence.</p><p>Statistiques : <em>Dernier</em>, <em>Utilisé</em>, <em>Dispo</em>.</p><h3>+ Ajouter</h3><p>Ajoute une nouvelle séquence pour cette épreuve.</p></article>',
+('bib_assignment', 'bib_doc_sequences', 'fr', 'Séquences de dossards', 'Tableau des séquences',
+'<article class="ms1-doc-article"><p>Chaque ligne du tableau représente une <strong>séquence de dossards</strong> (plage de numéros disponibles pour l''épreuve).</p><h3>Colonnes et actions</h3><table><tr><th>Icône œil</th><td>Voir la grille des dossards de cette séquence (occupés / libres).</td></tr><tr><th>Début</th><td>Premier numéro de la séquence.</td></tr><tr><th>Fin</th><td>Dernier numéro de la séquence.</td></tr><tr><th>OK</th><td>Enregistrer cette séquence après modification.</td></tr><tr><th>Suppr.</th><td>Supprimer la séquence.</td></tr><tr><th>Dernier</th><td>Dernier dossard assigné dans la séquence.</td></tr><tr><th>Utilisé</th><td>Nombre de dossards déjà assignés.</td></tr><tr><th>Dispo</th><td>Dossards encore disponibles dans la séquence.</td></tr></table><h3>+ Ajouter</h3><p>Ajoute une nouvelle séquence de dossards pour cette épreuve. Indiquez le numéro de <strong>début</strong> et de <strong>fin</strong>, puis cliquez <strong>OK</strong>.</p><p>La case à gauche de chaque ligne permet de <strong>sélectionner</strong> la séquence pour l''assignation batch ou l''assignation automatique.</p></article>',
 'compte.php', 20, 1, NOW()),
 ('bib_assignment', 'bib_doc_batch', 'fr', 'Assigner par séquence', 'Mode batch — Simuler puis GO',
-'<article class="ms1-doc-article"><p>Cochez les séquences, choisissez l''<strong>ordre d''assignation</strong>, puis <strong>Simuler</strong> (aperçu) ou <strong>GO</strong> (exécution).</p><p><strong>Réinitialiser</strong> retire les dossards déjà assignés — à utiliser avec prudence.</p></article>',
+'<article class="ms1-doc-article"><p>Le bouton <strong>Assigner par séquence</strong> ouvre le mode batch : il assigne tous les participants <em>sans dossard</em> en une seule opération.</p><h3>Étapes</h3><ol><li><strong>Cochez</strong> une ou plusieurs séquences de dossards.</li><li>Choisissez l''<strong>ordre d''assignation</strong> : critère pour trier les participants avant d''attribuer les dossards (nom, date d''inscription, équipe, etc.).</li><li><strong>Simuler</strong> — affiche qui recevrait quel dossard sans modifier la base de données.</li><li><strong>GO</strong> — lance l''assignation batch pour de vrai.</li></ol><p>Le résumé (disponibles / à assigner / manquants) s''affiche après simulation ou GO.</p><h3>Réinitialiser</h3><p>Retire les dossards déjà assignés pour les séquences concernées. <strong>Attention :</strong> vérifiez l''impact avant de confirmer. Ce bouton n''apparaît que s''il existe déjà des dossards assignés sur l''épreuve.</p></article>',
 'compte.php', 30, 1, NOW()),
-('bib_assignment', 'bib_doc_auto', 'fr', 'Assignation automatique', 'Dossard à chaque inscription',
-'<article class="ms1-doc-article"><p>Attribue un dossard à chaque nouvelle inscription dans les séquences cochées.</p><p><strong>Accepter</strong> enregistre la configuration. Le badge <strong>Auto actif</strong> confirme que le mode est en marche.</p></article>',
+('bib_assignment', 'bib_doc_auto', 'fr', 'Assignation automatique', 'Dossard à chaque nouvelle inscription',
+'<article class="ms1-doc-article"><p><strong>Assignation automatique</strong> : active l''assignation d''un dossard à chaque nouvelle inscription, en utilisant les séquences choisies.</p><h3>Activation</h3><ol><li>Cliquez <strong>Assignation automatique</strong> (ou <strong>Auto — configurer</strong> si déjà actif).</li><li>Cochez les séquences à utiliser pour l''assignation auto.</li><li>Cliquez <strong>Accepter</strong> pour enregistrer la configuration.</li></ol><p>Le badge <strong>Auto actif</strong> confirme que l''assignation automatique est activée pour cette épreuve.</p><h3>Annuler / Désactiver</h3><ul><li><strong>Annuler</strong> — quitte le mode édition sans enregistrer.</li><li><strong>Désactiver l''auto</strong> — désactive l''assignation automatique. Les séquences de dossards restent en place.</li></ul><blockquote>L''auto et le batch peuvent coexister : l''auto gère les nouveaux inscrits ; le batch rattrape les participants sans dossard.</blockquote></article>',
 'compte.php', 40, 1, NOW()),
 ('bib_assignment', 'bib_doc_solo', 'fr', 'Épreuve individuelle', 'Participants solo',
-'<article class="ms1-doc-article"><p>Chaque participant reçoit son propre numéro. L''option « Nom d''équipe » est masquée sur ce type d''épreuve.</p></article>',
+'<article class="ms1-doc-article"><p>Sur une épreuve <strong>individuelle</strong> (solo), chaque participant reçoit son propre numéro de dossard.</p><h3>Ordre d''assignation</h3><p>Lors d''un assignation par séquence, choisissez le critère de tri dans la liste <strong>Ordre d''assignation</strong> : nom de famille, prénom, date d''inscription, date de naissance, etc.</p><p>L''option liée au <strong>nom d''équipe</strong> est masquée sur une épreuve solo — elle n''a pas de sens sans épreuve en équipe.</p><h3>Grille des dossards</h3><p>L''icône <strong>œil</strong> sur une séquence ouvre la grille visuelle. Un numéro peut y être modifié manuellement ; le système vérifie les doublons sur l''événement.</p></article>',
 'compte.php', 50, 1, NOW()),
 ('bib_assignment', 'bib_doc_equipe', 'fr', 'Épreuve en équipe', 'Dossards individuels vs 1 équipe = 1 dossard',
-'<article class="ms1-doc-article"><p>Choisissez la <strong>méthode d''assignation</strong> avant le premier dossard — le choix est verrouillé ensuite.</p><ul><li><strong>Dossards individuels</strong> — un numéro par membre.</li><li><strong>1 équipe = 1 dossard</strong> — tous les membres partagent le même numéro.</li></ul></article>',
+'<article class="ms1-doc-article"><p>Sur une épreuve <strong>en équipe</strong>, choisissez la <strong>méthode d''assignation</strong> dans le panneau de gauche, <em>avant le premier dossard assigné</em>. Le choix est verrouillé ensuite.</p><h3>Dossards individuels</h3><p>Chaque membre de l''équipe reçoit un numéro distinct, comme en solo. L''ordre d''assignation <strong>Nom d''équipe</strong> devient disponible pour grouper l''assignation.</p><h3>1 équipe = 1 dossard</h3><p>Tous les membres d''une équipe partagent le <strong>même numéro</strong>. L''assignation batch traite les équipes, pas chaque personne individuellement.</p><blockquote>Changer de méthode après des dossards assignés nécessite une réinitialisation — planifiez le mode avant le premier GO.</blockquote><p>La grille des dossards (icône œil) regroupe visuellement les membres par équipe pour faciliter la lecture.</p></article>',
 'compte.php', 60, 1, NOW());
 
--- EN — stubs (à traduire)
+-- EN — contenu aligné sur les clés info bib_v4_*
 INSERT INTO `doc_page` (`doc_mod_clef`, `doc_page_clef`, `doc_langue`, `doc_titre`, `doc_sous_titre`, `doc_html`, `doc_prg`, `doc_tri`, `doc_actif`, `doc_creation`) VALUES
 ('bib_assignment', 'bib_doc_overview', 'en', 'Bib assignment', 'Module overview',
-'<article class="ms1-doc-article"><p>Define <strong>bib sequences</strong> and assign numbers to registered participants.</p></article>',
+'<article class="ms1-doc-article"><p>Define <strong>bib sequences</strong> and assign numbers to registered participants for each race.</p><h3>Recommended workflow</h3><ol><li>Create one or more <strong>sequences</strong> (start and end numbers).</li><li>Optionally enable <strong>automatic assignment</strong> for new registrations.</li><li>For participants already without a bib: <strong>Assign by sequence</strong>, then <strong>Simulate</strong>, then <strong>GO</strong>.</li></ol><blockquote>Always <strong>Simulate</strong> before <strong>GO</strong> to preview without changing the database.</blockquote></article>',
 'compte.php', 10, 1, NOW()),
-('bib_assignment', 'bib_doc_sequences', 'en', 'Bib sequences', 'Table columns and actions',
-'<article class="ms1-doc-article"><p><strong>Start / End</strong> define the sequence range.</p></article>',
+('bib_assignment', 'bib_doc_sequences', 'en', 'Bib sequences', 'Sequence table',
+'<article class="ms1-doc-article"><p>Each row is a <strong>bib sequence</strong> (range of numbers for this race).</p><table><tr><th>Eye icon</th><td>View the bib grid for this sequence.</td></tr><tr><th>Start / End</th><td>First and last number in the sequence.</td></tr><tr><th>OK</th><td>Save this sequence.</td></tr><tr><th>Delete</th><td>Remove the sequence.</td></tr><tr><th>Last / Used / Avail.</th><td>Statistics: last assigned bib, count used, count available.</td></tr></table><h3>+ Add</h3><p>Adds a new bib sequence. Enter start and end numbers, then click <strong>OK</strong>.</p></article>',
 'compte.php', 20, 1, NOW()),
-('bib_assignment', 'bib_doc_batch', 'en', 'Assign by sequence', 'Batch mode',
-'<article class="ms1-doc-article"><p>Select sequences, choose sort order, then <strong>Simulate</strong> or <strong>GO</strong>.</p></article>',
+('bib_assignment', 'bib_doc_batch', 'en', 'Assign by sequence', 'Batch mode — Simulate then GO',
+'<article class="ms1-doc-article"><p><strong>Assign by sequence</strong> opens batch mode: assign all participants <em>without a bib</em> in one operation.</p><ol><li>Check one or more sequences.</li><li>Choose <strong>Assignment order</strong> (name, registration date, team, etc.).</li><li><strong>Simulate</strong> — preview without saving.</li><li><strong>GO</strong> — run the batch assignment.</li></ol><p><strong>Reset</strong> removes assigned bibs. Check the impact before confirming.</p></article>',
 'compte.php', 30, 1, NOW()),
-('bib_assignment', 'bib_doc_auto', 'en', 'Automatic assignment', 'Bib on each registration',
-'<article class="ms1-doc-article"><p>Assigns a bib automatically for each new registration.</p></article>',
+('bib_assignment', 'bib_doc_auto', 'en', 'Automatic assignment', 'Bib on each new registration',
+'<article class="ms1-doc-article"><p><strong>Automatic assignment</strong> assigns a bib on each new registration using the selected sequences.</p><p>Click <strong>Accept</strong> to save. The <strong>Auto on</strong> badge confirms the mode is active.</p><p><strong>Disable auto</strong> turns off automatic assignment but keeps bib sequences.</p></article>',
 'compte.php', 40, 1, NOW()),
 ('bib_assignment', 'bib_doc_solo', 'en', 'Individual race', 'Solo participants',
-'<article class="ms1-doc-article"><p>Each participant gets their own bib number.</p></article>',
+'<article class="ms1-doc-article"><p>On an <strong>individual</strong> race, each participant gets their own bib number. Team name sort order is hidden on solo races.</p></article>',
 'compte.php', 50, 1, NOW()),
 ('bib_assignment', 'bib_doc_equipe', 'en', 'Team race', 'Individual bibs vs one bib per team',
-'<article class="ms1-doc-article"><p>Choose assignment method before the first bib is assigned.</p></article>',
+'<article class="ms1-doc-article"><p>On a <strong>team</strong> race, choose the assignment method <em>before the first bib</em> — then it is locked.</p><ul><li><strong>Individual bibs</strong> — each member gets a number.</li><li><strong>1 team = 1 bib</strong> — all members share the same number.</li></ul></article>',
 'compte.php', 60, 1, NOW());