Some documentation changes

copienator_gui/app.py

@@ -1749,6 +1749,15 @@ class CopienatorApp(tk.Tk):
         self.state_store.update_step(
             step_id, status=stored_status, return_code=return_code
         )
+        if (step_id == "statement" and status == "success"
+                and self.state_store.step(step_id).get("last_run_variant") == "gemini"):
+            reason = "Barèmes déjà générés par l’analyse Gemini de l’énoncé."
+            self.state_store.update_step("statement_persp", status="skipped")
+            self.state_store.add_history({
+                "step": "statement_persp", "status": "skipped",
+                "manual": False, "reason": reason,
+            })
+            self._append_console(f"Remplacer les barèmes par Gemini : ignorée — {reason}\n")
         if step_id == "annotation" and status == "success":
             generation_variant = self.state_store.step("annotation").get(
                 "last_run_variant"

copienator_gui/workflow.py

@@ -88,6 +88,12 @@ def build_workflow(show_personal_steps: bool) -> list[StepDefinition]:
     manual = lambda ident, label="Étape manuelle": CommandVariant(
         ident, label, None, "manual"
     )
+    personnal_binding = (
+        "\nWorkflow personnel : les raccourcis t/s/r/n sont aussi disponibles "
+        "(t : gauche, s : réduire, r : élargir, n : droite)."
+        if show_personal_steps
+        else ""
+    )
 
     return_answer_arguments = ()
     if configuration.RETURN_ANSWERS_ENABLED:
@@ -136,7 +142,9 @@ def build_workflow(show_personal_steps: bool) -> list[StepDefinition]:
             "statement",
             "Prétraitement de l’énoncé",
             "Analyser l’énoncé",
-            "Détecte les questions, leurs groupes, le corrigé et les indications de barème.",
+            "Avec Gemini : extrait les questions, les contextes et les solutions."
+            "Propose, sur la base des labels, des groupement de questions. Ces groupes seront utilisés lors des requêtes de correction."
+            "Génère aussi des barèmes détaillés de chaque question. ",
             ((python("personal", "Énoncés et solutions personnels (SHEETINFO)", "statement-personal"),)
              if show_personal_steps else ())
             + (python("gemini", "Analyse avec Gemini", "statement"),),
@@ -156,16 +164,16 @@ def build_workflow(show_personal_steps: bool) -> list[StepDefinition]:
         ),
         StepDefinition(
             "statement_groups", "Prétraitement de l’énoncé", "Regrouper les questions avec Gemini",
-            "Facultatif après la génération : remplace les groupes par exercice par des groupes "
-            "proposés par Gemini, en conservant les labels, les énoncés, les solutions et les barèmes.",
+            "Facultatif. Demande à Gemini de regrouper les questions selon leurs dépendances et leur contexte commun. "
+            "L’analyse Gemini initiale regroupe d’après la structure des labels ; cette étape peut donc proposer un autre découpage. "
+            "Ignorez cette étape si les groupes actuels vous conviennent.",
             (python("default", "Groupes Gemini", "statement", fixed_args=("--groups-only",)),),
             arguments=(arg_target("le dossier de l’évaluation"),),
             optional=True, personal=True, requires=("labels", "Text2", "Sol2"),
         ),
         StepDefinition(
-            "statement_persp", "Prétraitement de l’énoncé", "Remplacer les barèmes par Gemini",
-            "Facultatif : remplace Persp par des barèmes Gemini sur 4 points, pour les groupes actuels. "
-            "Les énoncés et les solutions personnels sont conservés.",
+            "statement_persp", "Prétraitement de l’énoncé", "Générer les barèmes par Gemini",
+            "Facultatif. Inutile après l'analyse de l'énoncé par Gemini, puisque les barèmes ont déjà été générés. ",
             (python("default", "Barèmes Gemini", "statement", fixed_args=("--persp-only",)),),
             arguments=(arg_target("le dossier de l’évaluation"),),
             optional=True, personal=True, requires=("labels", "label_groups", "Text2", "Sol2"),
@@ -261,9 +269,11 @@ def build_workflow(show_personal_steps: bool) -> list[StepDefinition]:
             "cutleft",
             "Prétraitement des copies",
             "Découper une partie à gauche pour détection des labels",
-            "Produit les images de la partie gauche des copies. Dans la fenêtre de découpe : "
-            "n décale la zone de 50 px vers la droite, N de 100 px, t de 50 px vers la gauche, "
-            "l l’élargit de 50 px, 1 utilise les pages entières, Entrée valide et s signale une erreur. "
+            "Produit les images de la partie gauche des copies. "
+            "Dans la fenêtre de découpe, utilisez les flèches : ←/→ déplacent la zone "
+            "de 50 px vers la gauche/droite, ↑ l’élargit de 50 px et ↓ la réduit de 50 px. "
+            "1 utilise les pages entières, Entrée valide et ! signale une erreur."
+            f"{personnal_binding} "
             "Une copie précise peut être ciblée.",
             (python("default", "Découpe", "crop-labels"),),
             arguments=(