Aller au contenu

Actions et suivi

Une action (Operation, clé id_operation) est rattachée à un ou plusieurs indicateurs et métriques, porte un type GestRef, une programmation par année (jours, budget, mois, sites, opérateurs, financeurs) selon un mode de ventilation, et, pour un inventaire ou un suivi, un protocole. Le suivi enregistre, par année, la réalisation, les jours et budgets consommés.

Actions

Endpoint Rôle
GET/POST /api/plans/operations/ Liste (filtres : plan, enjeu, type, priorité, année, organisme, statut de réalisation…) et création
GET/PUT/PATCH/DELETE /api/plans/operations/{id_operation}/ Détail (programmation complète, geom en GeoJSON), modification, suppression
GET …/by-plan/{plan_id}/, …/by-indicateur/{indicateur_id}/ Actions d'un plan (groupées par type) ou d'un indicateur
POST …/{id}/add-metrique/, …/remove-metrique/, …/create-indicator/ Liens avec les métriques ; création d'un indicateur de réponse
POST …/{id}/move/, …/copy/, POST …/reorder/ Déplacer, copier, réordonner
GET …/ventilation-defaults/{plan_id}/ Mode de ventilation et réglages budgétaires de la dernière action saisie, proposés par défaut à une nouvelle action
GET …/{id}/export-fiche-xlsx/ La fiche de cette seule action (Excel)
GET/POST /api/plans/postes/, GET …/by-plan/{plan_id}/, GET/POST /api/plans/fonctions/ Postes (ressources humaines) du plan et fonctions types

Mode de ventilation

ventilation_mode fixe le niveau de détail de la programmation : none, by_org, by_type, by_org_type, by_type_poste, by_org_type_poste. Dès que le mode intègre le type de budget, deux réglages s'ajoutent : declinaison_par_type_cout (détail salarial, stage, prestataire, autres) et cout_salarial_auto (coût salarial = jours × coût jour des postes, proposé par les deux modes « par type de poste »). Les totaux d'un plan sont identiques quel que soit le mode : seule la finesse du stockage change.

Brouillon d'action

Une action peut être enregistrée sans validation des champs obligatoires (statut_saisie: brouillon) puis complétée par PATCH.

Suivi

Endpoint Rôle
GET/POST /api/plans/realisations/, POST …/upsert/ Réalisation annuelle d'une action : niveau, opérateurs et financeurs effectifs, jours et budget réalisés, commentaire, emprise
GET …/by-operation/{operation_id}/, …/by-plan/{plan_id}/ Réalisations d'une action ou de tout un plan
POST …/effacer/ Revenir à l'état « non renseigné » pour une année
GET/POST/DELETE …/global-realisation/{operation_id}/ Réalisation globale sur la période, calculée ou forcée manuellement
/api/plans/realisations-organismes/, …/upsert/ Ventilation par organisme du réalisé
GET …/bilan/{plan_id}/, …/bilan-indicateurs/{plan_id}/, …/bilan-series/{plan_id}/ Agrégations du Bilan de la gestion : budget et jours prévus / réalisés, taux de réalisation, répartition des scores, séries par année ; filtrables par ?enjeu_id= et par portée (global, mi-parcours, annuel)

Le suivi n'est saisissable que sur un plan valide ou modifie, par ses référents et les gestionnaires. Les membres du plan et les utilisateurs rattachés à l'un de ses sites le consultent en lecture seule (méthodes GET). Le détail du plan l'indique avec peut_voir_suivis, peut_saisir_suivis et peut_exporter. Un rédacteur externe n'y accède jamais.

Inventaires et suivis scientifiques

Endpoint Rôle
GET/POST /api/inventaires/suivis/ Suivis et inventaires, inscrits ou non dans un plan : type, objectifs, cibles, statut, fréquence, protocoles (standardisés ou libres), bancarisation
GET/PUT/PATCH/DELETE /api/inventaires/suivis/{id_suivi_inventaire}/ Détail et modification

Un suivi créé ici peut ensuite être rattaché à une action de suivi d'un plan (id_suivi_inventaire sur l'action). Les protocoles standardisés viennent du catalogue CAMPanule (Référentiels).

Référence interactive