Archiver et restaurer les unités

Les églises se réorganisent. Un campus ferme. Deux cellules fusionnent. Une région se divise en trois. Le module Structure organisationnelle distingue trois états pour une unité afin que les rapports historiques restent précis pendant que l'arbre en direct reflète la réalité d'aujourd'hui.

État	Ce que cela signifie	Où il apparaît
Active	Le défaut — l'unité est en direct.	Arbre, sélecteurs, tableaux de bord, carte.
Archivée	archived_at est défini. L'unité est cachée de l'usage quotidien mais ses lignes dans org_units, member_unit_assignments, présence et dons sont intactes.	Onglet Archivées sur la page de structure organisationnelle.
Supprimée	deleted_at est défini. L'unité est supprimée en douceur de la base de données.	Nulle part visible. Restaurable uniquement par le support.

Vous utiliserez Archiver dix fois plus souvent que Supprimer. C'est le défaut sûr.

Archiver une seule unité

Dans l'arbre organisationnel, cliquez sur le menu trois-points sur la ligne d'une unité et choisissez Archiver. Une boîte de dialogue de confirmation s'ouvre avec trois informations :

• Le nom de l'unité.
• Un avertissement indiquant que toutes les unités enfants seront également archivées s'il y en a. La cascade est automatique et calculée via collectAllDescendants — chaque descendant obtient archived_at défini dans la même opération.
• Une note indiquant que les unités archivées restent hors des comptages et des sélecteurs mais restent restaurables.

Confirmez pour exécuter. Un toast apparaît avec le nombre d'unités archivées.

Archiver en masse

Cochez les cases sur plusieurs unités dans l'arbre, cliquez sur Archiver dans la barre d'outils collante qui apparaît. La même règle de cascade s'applique — les descendants de chaque unité sélectionnée sont entraînés automatiquement. Le toast affiche le nombre total.

C'est le flux de travail que vous voulez quand vous fermez un campus : sélectionnez le campus et chaque enfant se replie en un clic.

Ce que "archivée" fait dans l'application

Après l'archivage :

• L'unité disparaît de l'onglet actif de l'arbre organisationnel.
• L'unité disparaît de chaque sélecteur dans membres, présence, dons et rapports.
• Le comptage de membres et l'agrégation des dons de l'unité cessent de contribuer aux tableaux de bord (c'est-à-dire que le total des membres de l'organisation sur la page d'accueil baisse du nombre qui était dans le sous-arbre archivé).
• L'unité cesse d'apparaître comme cible de workflow.
• L'unité conserve ses lignes member_unit_assignments. Les membres sont toujours liés à l'unité archivée — ils ne sont pas auto-désaffectés. Si vous réactivez plus tard, tout se réassemble.
• Les lignes historiques de présence et de dons qui référencent l'unité au moment de l'enregistrement se résolvent toujours — elles cherchent par id, et l'id existe toujours.

Archivez avant de supprimer, toujours

Il n'y a pas de "corbeille avec purge automatique" dans GCM. Les unités archivées restent éternellement jusqu'à ce que vous agissiez. C'est délibéré — vos données sont plus en sécurité là où vous pouvez les voir.

L'onglet Archivées

Basculez vers l'onglet Archivées sur /org-structure pour voir chaque unité archivée dans une liste plate, triée par nom. Chaque ligne affiche :

• Le nom de l'unité (atténué).
• Le badge de niveau.
• La date d'archivage ("Archivée le 14 janv. 2026").
• Un menu trois-points avec les options Désarchiver et Supprimer définitivement.

Cliquer sur une ligne ouvre une modale de détails en lecture seule avec le nom, le niveau, l'adresse et le dernier responsable connu. Depuis là, vous pouvez aussi désarchiver.

Désarchiver (restaurer)

Ouvrez la ligne de l'unité dans l'onglet Archivées, cliquez sur Désarchiver depuis le menu trois-points (ou depuis la modale de détails). GCM efface archived_at sur cette unité spécifique.

Désarchiver ne cascade pas. Si vous avez archivé une branche avec trois centres et quatre cellules, désarchiver la branche ramène la branche mais laisse les centres et les cellules archivés. Vous pouvez :

• Les sélectionner un par un dans l'onglet Archivées.
• Utiliser la sélection en masse pour désarchiver un groupe d'un coup.

Cette conception scindée importe quand seule une partie d'une restructuration se renverse — disons que vous fermez un campus mais décidez plus tard de rouvrir le bâtiment principal sans les cellules satellites.

Désarchiver en masse

Dans l'onglet Archivées, cochez les cases sur les lignes que vous voulez, cliquez sur Désarchiver dans la barre d'outils collante. Toutes les unités sélectionnées ont archived_at effacé en une seule mise à jour.

L'ordre n'importe pas — la restauration de l'arbre est purement basée sur parent_unit_id, donc tant que le parent est aussi désarchivé (ou n'a jamais été archivé) l'enfant se rend correctement.

Suppression définitive

Si vous êtes certain qu'une unité ne reviendra jamais — disons que vous avez tapé par erreur une branche de test pendant l'intégration — vous pouvez supprimer définitivement depuis l'onglet Archivées.

Deux chemins :

• Par unité : Menu trois-points → Supprimer définitivement.
• En masse : Sélectionnez plusieurs lignes archivées, cliquez sur Supprimer dans la barre d'outils collante.

Les deux chemins définissent deleted_at sur les unités. Les lignes existent toujours dans la base de données à des fins forensiques mais l'application les traite comme parties.

La suppression définitive ne peut pas être annulée depuis l'interface

Une fois deleted_at défini, l'unité tombe hors de chaque surface d'interface — y compris l'onglet Archivées. Il n'y a pas de bouton "restaurer depuis la corbeille". Si vous supprimez une unité dont vous aviez besoin, contactez le support avec l'id de l'unité depuis votre journal d'audit.

Suppression depuis l'onglet actif (avec réaffectation)

Il y a aussi une action Supprimer sur les unités actives. Contrairement à Archiver, celle-ci supprime immédiatement en douceur — et elle vous force à décider ce qu'il advient des membres et des enfants d'abord.

L'assistant demande :

• Que doit-il advenir des unités enfants ? Les supprimer aussi (suppression douce récursive) ou Déplacer vers une unité sœur que vous choisissez.
• Que doit-il advenir des membres affectés ? Les désaffecter (supprimer les lignes member_unit_assignments) ou Les réaffecter à une unité sœur que vous choisissez.

Le flux s'exécute en séquence : reparentage des enfants → réaffectation des membres → nettoyage de la portée utilisateur → suppression douce sur les cibles.

Tournez-vous vers ceci quand vous êtes sûr de vouloir supprimer l'unité mais que vous ne voulez pas que la cascade efface aussi les données qui vous importent. La plupart des équipes utilisent Archiver à la place et sautent l'assistant.

Piste d'audit

Chaque archivage, désarchivage et suppression écrit dans le journal de données avec l'id utilisateur de l'acteur, l'horodatage et l'unité cible. Vous pouvez le trouver sous Journaux de données → Unités organisationnelles. La piste survit à la suppression de l'unité — vous pouvez répondre à "qui a supprimé la Cellule Nord ?" des mois plus tard.

Questions courantes

Archiver une unité désaffecte-t-il ses membres ? Non. Leurs lignes member_unit_assignments restent. Ils n'apparaîtront simplement pas dans les vues filtrées par unité jusqu'à ce que l'unité soit restaurée.

Que se passe-t-il si j'archive une unité dont le responsable est défini ? Le leader_member_id est préservé. Quand vous restaurez, le responsable est toujours attaché. Restaurer réactive aussi le nom du responsable dans les rapports.

Puis-je désarchiver en masse un sous-arbre entier en un clic ? Pas en un clic. Vous devez sélectionner les lignes que vous voulez — mais dans l'onglet Archivées, tout sélectionner et cliquer sur Désarchiver fait le travail en une seule opération.

Pourquoi les unités archivées sont-elles exclues des tableaux de bord mais pas des rapports de présence historiques ? Les tableaux de bord comptent l'état en direct — "combien de branches actives avons-nous en ce moment". Les rapports comptent les événements — "combien ont assisté à ce service en mars 2024". Les événements réfèrent toujours à l'unité par id même après que l'unité soit archivée, donc le rapport se résout toujours.

Étapes suivantes

• Migrer depuis une structure plate — pour les organisations qui passent d'un modèle à un seul palier.
• Définir vos niveaux — recommencer ou renommer ce qui est là.