chore(doc): more information about many maintenance tasks

app/tasks/maintenance/backfill_bulk_messages_with_procedure_id_task.rb

@@ -2,6 +2,9 @@
 
 module Maintenance
   class BackfillBulkMessagesWithProcedureIdTask < MaintenanceTasks::Task
+    # Périmètre: envoi d’un email groupé aux usagers ayant dossiers en brouillon.
+    # Change la manière dont ces messages sont liés aux démarches.
+    # 2024-03-12-01 PR #10071
     def collection
       BulkMessage
         .where(procedure: nil)

app/tasks/maintenance/backfill_city_name_task.rb

@@ -2,6 +2,9 @@
 
 module Maintenance
   class BackfillCityNameTask < MaintenanceTasks::Task
+    # corrige des données du champ adresse suite à un bug
+    # introduit pendant quelques jours début mars
+    # 2024-04-09-02 PR #10290
     attribute :champ_ids, :string
     validates :champ_ids, presence: true
 

app/tasks/maintenance/backfill_cloned_champs_private_piece_justificatives_task.rb

@@ -2,6 +2,9 @@
 
 module Maintenance
   class BackfillClonedChampsPrivatePieceJustificativesTask < MaintenanceTasks::Task
+    # Supprime les PJ d’annotations privées
+    # qui étaient conservées par erreur lorsqu’un dossier était cloné
+    # 2024-05-27-01 PR #10435
     def collection
       Dossier.en_brouillon.where.not(parent_dossier_id: nil)
     end

app/tasks/maintenance/backfill_closing_reason_in_closed_procedures_task.rb

@@ -2,6 +2,9 @@
 
 module Maintenance
   class BackfillClosingReasonInClosedProceduresTask < MaintenanceTasks::Task
+    # Remet les messages de cloture d'une démarche proprement (sinon affichage KO).
+    # Suite de UpdateClosingReasonIfNoReplacedByIdTask
+    # 2024-05-27-01 PR #9930
     def collection
       Procedure
         .with_discarded

app/tasks/maintenance/backfill_commune_code_from_name_task.rb

@@ -2,6 +2,9 @@
 
 module Maintenance
   class BackfillCommuneCodeFromNameTask < MaintenanceTasks::Task
+    # corrige structure champs commune pour une démarche donnée. Suite à un bug ?
+    # 2024-05-31-01 PR #10469
+
     attribute :procedure_id, :string
     validates :procedure_id, presence: true
 

app/tasks/maintenance/backfill_departement_services_task.rb

@@ -2,6 +2,9 @@
 
 module Maintenance
   class BackfillDepartementServicesTask < MaintenanceTasks::Task
+    # Fait le lien service – département pour permettre
+    # le filtrage des démarches par département
+    # 2023-10-30-01 PR #9647
     def collection
       Service.where.not(etablissement_infos: nil)
     end

app/tasks/maintenance/backfill_depose_at_on_deleted_dossiers_task.rb

@@ -2,6 +2,8 @@
 
 module Maintenance
   class BackfillDeposeAtOnDeletedDossiersTask < MaintenanceTasks::Task
+    # Améliore les stats à propos des dates de dépôts pour les dossiers supprimés
+    # 2024-04-05-01 PR #10259
     def collection
       DeletedDossier.where(depose_at: nil)
     end

app/tasks/maintenance/backfill_effectif_annuel_annee_task.rb

@@ -2,6 +2,8 @@
 
 module Maintenance
   class BackfillEffectifAnnuelAnneeTask < MaintenanceTasks::Task
+    # API entreprise: rattrape les informations d'effectif
+    # 2024-05-27-01 PR #10053
     def collection
       Etablissement.where.not(entreprise_effectif_annuel: nil).where(entreprise_effectif_annuel_annee: nil)
     end

app/tasks/maintenance/backfill_invalid_dossiers_for_tiers_task.rb

@@ -2,6 +2,8 @@
 
 module Maintenance
   class BackfillInvalidDossiersForTiersTask < MaintenanceTasks::Task
+    # Corrige les dossiers declarés pour un tiers mais sans avoir renseigné les infos du tiers
+    # 2024-05-22-01
     def collection
       Dossier.where(for_tiers: true).where(mandataire_first_name: nil)
     end

app/tasks/maintenance/create_previews_for_pj_of_latest_dossiers_task.rb

@@ -2,6 +2,9 @@
 
 module Maintenance
   class CreatePreviewsForPjOfLatestDossiersTask < MaintenanceTasks::Task
+    # Génère les vignettes de PJ existantes pour les dossiers déposés entre 2 dates (facultatif)
+    # Elles sont affichées dans le nouvel onglet "Pièces jointes" des instructeurs.
+    # 2024-07-11-01
     attribute :start_text, :string
     validates :start_text, presence: true
 

app/tasks/maintenance/create_variants_for_pj_of_latest_dossiers_task.rb

@@ -2,6 +2,9 @@
 
 module Maintenance
   class CreateVariantsForPjOfLatestDossiersTask < MaintenanceTasks::Task
+    # Génère les vignettes de fichiers PDF pour les dossiers déposés entre 2 dates (facultatif)
+    # Elles sont affichées dans le nouvel onglet "Pièces jointes" des instructeurs.
+    # 2024-07-11-01
     attribute :start_text, :string
     validates :start_text, presence: true
 

app/tasks/maintenance/delete_draft_revision_type_de_champs_task.rb

@@ -2,10 +2,10 @@
 
 module Maintenance
   class DeleteDraftRevisionTypeDeChampsTask < MaintenanceTasks::Task
-    csv_collection
-
+    # Modifie le form d’une démarche à partir d’un CSV (dev spécifique Fonds Verts).
     # See UpdateDraftRevisionTypeDeChampsTask for more information
-    # Just add delete_flag with "true" to effectively remove the type de champ from the draft.
+    # Just add delete_flag with "true" in CSV to effectively remove the type de champ from the draft.
+    csv_collection
 
     def process(row)
       return unless row["delete_flag"] == "true"

app/tasks/maintenance/destroy_incomplete_bulk_messages_task.rb

@@ -2,6 +2,10 @@
 
 module Maintenance
   class DestroyIncompleteBulkMessagesTask < MaintenanceTasks::Task
+    # Périmètre: envoi d’un email groupé aux usagers ayant dossiers en brouillon.
+    # Change la manière dont ces messages sont liés aux démarches.
+    # Suite de BackfillBulkMessagesWithProcedureIdTask
+    # 2024-03-12-01 PR #10071
     def collection
       BulkMessage.where(procedure: nil).where.missing(:groupe_instructeurs)
     end

app/tasks/maintenance/destroy_procedure_without_administrateur_and_without_dossier_task.rb

@@ -2,6 +2,8 @@
 
 module Maintenance
   class DestroyProcedureWithoutAdministrateurAndWithoutDossierTask < MaintenanceTasks::Task
+    # suppression de procédures closes sans admin et sans dossier
+    # 2024-03-18-01 PR #10125
     def collection
       Procedure.with_discarded.where.missing(:administrateurs, :dossiers)
     end

app/tasks/maintenance/disable_remaining_invalid_mon_avis_task.rb

@@ -2,6 +2,8 @@
 
 module Maintenance
   class DisableRemainingInvalidMonAvisTask < MaintenanceTasks::Task
+    # Supprime les codes d’intégration « mon avis » invalides
+    # 2024-03-18-01 PR #10120
     def collection
       # rubocop:disable DS/Unscoped
       Procedure.unscoped.where.not(monavis_embed: nil)

app/tasks/maintenance/fix_decimal_number_with_spaces_task.rb

@@ -2,6 +2,9 @@
 
 module Maintenance
   class FixDecimalNumberWithSpacesTask < MaintenanceTasks::Task
+    # normalise les champs nombres en y supprimant les éventuels espaces
+    # 2024-07-01-01 PR #10554
+
     ANY_SPACES = /[[:space:]]/
     def collection
       Champs::DecimalNumberChamp.where.not(value: nil)

app/tasks/maintenance/fix_duree_conservation_greater_than_max_duree_conservation_task.rb

@@ -2,6 +2,10 @@
 
 module Maintenance
   class FixDureeConservationGreaterThanMaxDureeConservationTask < MaintenanceTasks::Task
+    # Corrige la durée de conservation des dossiers :
+    # pour toutes les démarches dont la durée de conservation est supérieure
+    # à celle de l'instance, on prend la durée max de DS (12 mois)
+    # 2024-05-27-01 PR #10107
     def collection
       Procedure.where('duree_conservation_dossiers_dans_ds > max_duree_conservation_dossiers_dans_ds')
     end

app/tasks/maintenance/fix_open_procedures_with_closing_reason_task.rb

@@ -2,6 +2,8 @@
 
 module Maintenance
   class FixOpenProceduresWithClosingReasonTask < MaintenanceTasks::Task
+    # Corrige des démarches avec un motif de fermerture alors qu’elles ont été publiées
+    # 2024-05-27-01 PR #10181
     def collection
       Procedure
         .with_discarded

app/tasks/maintenance/move_dol_to_cold_storage_task.rb

@@ -2,6 +2,10 @@
 
 module Maintenance
   class MoveDolToColdStorageTask < MaintenanceTasks::Task
+    # Opération de rattrapage suite à un cron qui ne fonctionnait plus.
+    # Permet de déplacer toutes les traces fonctionnelles (DossierOperationLog)
+    # vers le stockage object plutot que de les conserver en BDD
+    # 2024-04-15-01
     attribute :start_text, :string
     validates :start_text, presence: true
 

app/tasks/maintenance/recompute_blob_checksum_task.rb

@@ -2,6 +2,11 @@
 
 module Maintenance
   class RecomputeBlobChecksumTask < MaintenanceTasks::Task
+    # Avant février 2024, les filigranes ont corrompu les hash des fichiers.
+    # Régulièrement, des dossiers en brouillon étaient déposés avec ce problème
+    # (on retrouve les fichiers corrompu dans l'onglet retry de sidekiq).
+    # Cette tache recalcule les hashes.
+    # 2024-05-27-01
     attribute :blob_ids, :string
     validates :blob_ids, presence: true
 

app/tasks/maintenance/samsung_browser_is_supported_task.rb

@@ -2,6 +2,9 @@
 
 module Maintenance
   class SamsungBrowserIsSupportedTask < MaintenanceTasks::Task
+    # Corrige une donnée si le navigateur utilisé
+    # dans l’historique des Traitements des dossiers
+    # 2024-02-21-01
     def collection
       Traitement.where(browser_name: 'Samsung Browser', browser_version: 12..)
     end

app/tasks/maintenance/spread_dossier_deletion_task.rb

@@ -2,6 +2,8 @@
 
 module Maintenance
   class SpreadDossierDeletionTask < MaintenanceTasks::Task
+    # Contourne un égorgement de suppression de millions de dossiers qui aurait eu lieu le même jour
+    # 2024-05-27-01 PR #10062
     ERROR_OCCURED_AT = Date.new(2024, 2, 14)
     ERROR_OCCURED_RANGE = ERROR_OCCURED_AT.at_midnight..(ERROR_OCCURED_AT + 1.day)
     SPREAD_DURATION_IN_DAYS = 150

app/tasks/maintenance/update_closing_reason_if_no_replaced_by_id_task.rb

@@ -2,6 +2,9 @@
 
 module Maintenance
   class UpdateClosingReasonIfNoReplacedByIdTask < MaintenanceTasks::Task
+    # Remet les messages de cloture d'une démarche proprement (sinon affichage KO).
+    # Avant BackfillClosingReasonInClosedProceduresTask
+    # 2024-03-21-01 PR #10158
     def collection
       Procedure
         .with_discarded

app/tasks/maintenance/update_conditions_based_on_commune_or_epci_champ_task.rb

@@ -2,6 +2,10 @@
 
 module Maintenance
   class UpdateConditionsBasedOnCommuneOrEpciChampTask < MaintenanceTasks::Task
+    # Met à jour les conditions et règles de routage
+    # pour les champs communes et ECPI suite à l'ajout de nouveaux opérateurs
+    # Voir aussi UpdateRoutingRulesBasedOnCommuneOrEpciChampTask
+    # 2023-12-20-01 PR #9850
     include Logic
 
     def collection

app/tasks/maintenance/update_draft_revision_type_de_champs_task.rb

@@ -2,6 +2,8 @@
 
 module Maintenance
   class UpdateDraftRevisionTypeDeChampsTask < MaintenanceTasks::Task
+    # Modifie le form d’une démarche à partir d’un CSV (dev pour les Fonds Verts)
+
     csv_collection
 
     # CSV structure:

app/tasks/maintenance/update_routing_rules_based_on_commune_or_epci_champ_task.rb

@@ -2,6 +2,10 @@
 
 module Maintenance
   class UpdateRoutingRulesBasedOnCommuneOrEpciChampTask < MaintenanceTasks::Task
+    # Ces 2 tâches mettent à jour les conditions et règles de routage
+    # pour les champs communes et ECPI suite à l'ajout de nouveaux opérateurs
+    # Voir aussi UpdateConditionsBasedOnCommuneOrEpciChampTask
+    # 2023-12-20-01 PR #9850
     include Logic
 
     def collection

app/tasks/maintenance/update_service_etablissement_infos_task.rb

@@ -2,6 +2,9 @@
 
 module Maintenance
   class UpdateServiceEtablissementInfosTask < MaintenanceTasks::Task
+    # Géocode les services à partir des établissements
+    # 2024-05-27-01 PR #10106
+
     # No more 20 geocoding by 10 seconds window
     THROTTLE_LIMIT = 20
     THROTTLE_PERIOD = 10.seconds

app/tasks/maintenance/update_zones_task.rb

@@ -2,6 +2,8 @@
 
 module Maintenance
   class UpdateZonesTask < MaintenanceTasks::Task
+    # Synchronise les zones en base à partir du fichier de config zones.yml
+    # 2024-05-27-01 PR #10077
     def collection
       config = Psych.safe_load(Rails.root.join("config", "zones.yml").read)
       config['ministeres']