Plans de gestion¶
Un plan de gestion (PlanGestion, clé id_pg) couvre un ou plusieurs sites, porte des référents et des membres, un statut et une place dans une chaîne de versions (rang et version). Son contenu (enjeux, objectifs, indicateurs, actions) est décrit dans Arborescence et Actions et suivi.
Endpoints principaux¶
| Endpoint | Rôle |
|---|---|
GET/POST /api/plans/plans/ |
Liste (25 filtres : statut, site, organisme, années, rang…) et création |
GET/PUT/PATCH/DELETE /api/plans/plans/{id_pg}/ |
Détail (avec version_chain, peut_etre_etendu…), modification, suppression |
GET /api/plans/plans/by-slug/{slug}/ |
Détail par slug (adresse utilisée par l'application) |
GET /api/plans/plans/for-sites/?site_ids=1,2 |
Plans existants sur des sites, tous statuts, groupés par site et par rang |
GET /api/plans/plans/recherche-acces/?q= |
Recherche d'un plan à rédiger (rédacteur externe uniquement, métadonnées seules) |
GET /api/plans/plans/stats/, …/geojson_list/, …/{id_pg}/geojson/, …/export_geojson/ |
Statistiques et géométries |
POST /api/plans/plans/{id_pg}/assign_site/, …/remove_site/, …/replace_site/, POST …/bulk_assign_sites/ |
Sites du plan |
POST /api/plans/plans/{id_pg}/assign_referent/, …/remove_referent/, …/assign_member/, …/remove_member/ |
Référents et membres |
POST /api/plans/plans/{id_pg}/assign-redacteur-externe/, GET …/redacteurs-externes/ |
Rattacher un rédacteur externe ; liste des rédacteurs externes de l'instance, tous organismes confondus (référents du plan et gestionnaires) |
GET /api/plans/plans/{id_pg}/mindmap/, …/mindmap-inverse/ |
Arbre complet du plan (tableau d'arborescence), dans les deux sens |
GET /api/plans/plans/{id_pg}/operation-codes/, …/operation-code-preview/ |
Codes d'affichage des actions (CS1, IP2…) |
GET/POST /api/plans/fichiers/, GET …/{id}/download/ |
Documents joints au plan (type, téléchargement, suppression) |
GET/POST /api/plans/responsabilites/ |
Responsabilités d'un site (indépendantes du cycle de vie) |
Cycle de vie¶
Les statuts : draft (seul statut modifiable), avis_csrpn, comite_consultatif, arrete_pref (workflow CSRPN), valide, modifie, archive. Trois attributs orthogonaux s'ajoutent : annees_extension, en_revision, is_mi_parcours.
| Endpoint | Rôle |
|---|---|
POST …/{id_pg}/change-status/ |
{ "new_status": "valide" \| "draft" \| "archive" \| …, "is_mi_parcours"?: bool }. draft → valide est routé automatiquement vers modifie quand le parent est validé |
POST …/{id_pg}/csrpn-step/, …/admin-validation/ |
Étapes CSRPN (avis, comité, arrêté) et validations administratives indépendantes |
POST …/{id_pg}/duplicate/ |
Nouvelle version en brouillon, copie sélective du contenu |
POST …/{id_pg}/create-evaluation/ |
Brouillon d'évaluation mi-parcours (plan source validé) |
POST …/{id_pg}/create-next-rang/ |
Brouillon du rang suivant, version 1 |
POST …/{id_pg}/extend-duration/ { "years": 1 \| 2 }, …/remove-extension/ |
Prolongation : crée un brouillon de version étendue (cumul maximal de 2 ans) |
POST …/{id_pg}/start-revision/, …/end-revision/ |
Marquer en cours de révision, éventuellement lié à un brouillon du rang suivant |
POST …/{id_pg}/delete-version/ |
Suppression définitive d'une version, renumérotation des suivantes |
Règles : un seul brouillon enfant par parent ; un brouillon ne se crée que sur un plan valide, modifie ou archive ; le retour en brouillon n'est possible que sur la feuille de la chaîne ; valider un brouillon valide en cascade ses parents encore en brouillon. Ces actions sont réservées aux référents du plan, à l'administrateur d'organisme, au rédacteur général et au super administrateur ; les autres écritures exigent le statut draft.
Imports Excel¶
| Endpoint | Rôle |
|---|---|
GET …/example-arborescence-xlsx/, …/example-actions-xlsx/, GET …/import-arborescence-schema/ |
Modèles et exemples, description des onglets et colonnes |
POST …/{id_pg}/import-arborescence/validate/ puis …/import-arborescence/ |
Validation sans écriture (anomalies par onglet, ligne, colonne) puis import transactionnel |
POST …/{id_pg}/import-arborescence/validate-data/, …/import-data/ |
Même chose à partir des données corrigées à l'écran (JSON, sans fichier) |
GET …/{id_pg}/import-arborescence/existing-summary/ |
Contenu existant, pour confirmer un remplacement |
POST …/{id_pg}/import-actions/validate/, …/import-actions/ |
Classeur des actions (actions, budget, ressources humaines) |
POST …/read-xlsx/ |
Lecture brute d'un classeur quelconque |
L'import n'est possible que sur un plan en brouillon.
Exports¶
Tous les exports renvoient un fichier (Content-Disposition: attachment) et sont réservés aux référents du plan et aux gestionnaires.
| Endpoint | Format |
|---|---|
GET …/{id_pg}/export-plan-docx/ |
Fiche plan de gestion (Word) |
GET …/{id_pg}/export-arborescence-xlsx/, …/export-arborescence-presentation-xlsx/ |
Arborescence au format d'import (réimportable) ou de présentation |
GET …/{id_pg}/export-fiches-actions-xlsx/, …/export-actions-xlsx/ |
Fiches action ; classeur des actions au format d'import |
GET …/{id_pg}/export-budget-previsionnel-xlsx/, …/export-budget-suivi-xlsx/, …/export-rh-previsionnel-xlsx/, …/export-rh-suivi-xlsx/ |
Budget et ressources humaines, prévisionnel et suivi |
POST …/{id_pg}/export-tableau-de-bord-xlsx/, …/export-suivi-actions-xlsx/ |
Tableau de bord et suivi des actions, selon la vue et les filtres passés dans le corps |
Exemple : créer un plan rattaché au rang précédent¶
curl -X POST https://<instance>/api/plans/plans/ \
-H "Authorization: Bearer <access>" -H "Content-Type: application/json" \
-d '{
"nom_pg": "Plan de gestion 2027-2037 - Camargue",
"annee_debut": 2027, "annee_fin": 2037, "rang": 3,
"site_ids": [12], "plan_parent_id": 41
}'
Le lien plan_parent_id n'est retenu que si le parent est de rang strictement inférieur et partage au moins un site ; sinon il est ignoré silencieusement. L'appelant devient référent du plan créé, sauf s'il est super administrateur ou rédacteur général (il a déjà tous les droits sur le plan).