API Suivi & Évaluation

Toutes les routes sont sous /api/suivi-evaluation et renvoient { success, data }. La lecture demande suivi_evaluation.view ; chaque famille d'écriture a sa permission. La plupart des listes acceptent projet (UUID) pour se limiter à un projet.

Activités du PTBA

Méthode	Endpoint	Permission	Description
GET	/activites	view	Liste (projet, composante, sousComposante, statut, search, annee, page, limit)
POST	/activites	create	Créer une activité
GET	/activites/{id}	view	Détail
PUT, PATCH	/activites/{id}	edit	Modifier
DELETE	/activites/{id}	delete	Supprimer
POST	/activites/batch	edit	Mise à jour groupée
GET	/activites/{id}/historique	view	Historique d'une activité
GET	/historique	view	Historique global
GET	/stats	view	Compteurs, avancement moyen, exécution budgétaire
GET	/en-retard	view	Activités en retard
GET	/export	export	Export des activités

Statuts d'une activité : non_demarre, en_cours, en_retard, termine, annule.

Jalons

Méthode	Endpoint	Permission
GET	/activites/{id}/jalons	view
POST	/activites/{id}/jalons	edit
PUT, PATCH	/jalons/{id}	edit
DELETE	/jalons/{id}	edit

Structure (composantes)

Méthode	Endpoint	Permission
GET	/composantes, /sous-composantes	view
GET	/composantes/reference, /sous-composantes/reference	view
POST	/composantes/reference, /sous-composantes/reference	manage_structure
PUT, DELETE	/composantes/reference/{id}, /sous-composantes/reference/{id}	manage_structure

Vues transversales

Méthode	Endpoint	Description
GET	/dashboard	Avancement physique et financier, courbe en S
GET	/alertes	Activités en retard, indicateurs hors trajectoire, échéances proches
GET	/chronogramme	Données du diagramme de Gantt
GET	/rapport-periodique	Rapport de l'année (annee, défaut année en cours) ou d'un trimestre (trimestre 1 à 4) ; format=pdf renvoie un PDF, sinon du JSON

Un trimestre hors de 1 à 4 renvoie 400.

Cadre de résultats (indicateurs)

Méthode	Endpoint	Permission	Description
GET	/indicateurs	view	Liste (projet, niveau, composante, search, actifs)
GET	/indicateurs/cadre	view	Cadre de résultats complet avec statut de performance (annee)
GET	/indicateurs/sources	view	Sources de calcul automatique disponibles
POST	/indicateurs	indicateurs_edit	Créer
GET	/indicateurs/{id}	view	Détail
PUT, PATCH	/indicateurs/{id}	indicateurs_edit	Modifier
DELETE	/indicateurs/{id}	indicateurs_edit	Supprimer
GET	/indicateurs/{id}/valeurs	view	Valeurs périodiques
POST	/indicateurs/{id}/valeurs	indicateurs_edit	Saisir une valeur
POST	/indicateurs/{id}/calculer	indicateurs_edit	Calculer la valeur depuis les données du SIG
PUT, PATCH	/indicateurs/valeurs/{id}	indicateurs_edit	Modifier une valeur
DELETE	/indicateurs/valeurs/{id}	indicateurs_edit	Supprimer une valeur
POST	/indicateurs/valeurs/{id}/valider	indicateurs_validate	Valider une valeur saisie

Niveaux : odp, resultat_intermediaire, produit, processus. Types : nombre, pourcentage, montant, binaire. Sens : hausse ou baisse. Fréquences : mensuelle, trimestrielle, semestrielle, annuelle. Une valeur est saisi, valide ou rejete, de source manuel ou auto.

Sources de calcul automatique : beneficiaires, beneficiaires_femmes, paiements_montant, paiements_nombre, menages, plaintes_recues, plaintes_taux_resolution, activites_taux_achevement. Les sources de paiement ne comptent que les paiements aboutis (statut execute).

Statut de performance : réalisé rapporté à la cible de l'année. À 90 % ou plus l'indicateur est en bonne voie, entre 60 et 90 % à risque, en dessous hors trajectoire ; sans valeur, pas de donnée. Le sens baisse inverse le calcul.

Risques

Méthode	Endpoint	Permission	Description
GET	/risques	view	Liste (projet, categorie, composante, niveau, statut, search)
GET	/risques/matrice	view	Matrice probabilité × impact
POST	/risques	risques_edit	Créer
GET	/risques/{id}	view	Détail
PUT, PATCH	/risques/{id}	risques_edit	Modifier
DELETE	/risques/{id}	risques_edit	Supprimer

Niveaux : faible, modere, eleve, critique. Statuts : identifie, en_traitement, maitrise, materialise, clos.

Missions et recommandations

Méthode	Endpoint	Permission	Description
GET	/missions	view	Liste (projet, type, statut, annee, search)
POST	/missions	missions_edit	Créer
GET	/missions/{id}	view	Détail avec recommandations
PUT, PATCH	/missions/{id}	missions_edit	Modifier
DELETE	/missions/{id}	missions_edit	Supprimer
POST	/missions/{id}/recommandations	missions_edit	Ajouter une recommandation
GET	/recommandations	view	Suivi des recommandations (mission, statut, responsable, enRetard)
PUT, PATCH	/recommandations/{id}	missions_edit	Modifier
DELETE	/recommandations/{id}	missions_edit	Supprimer

Statuts d'une mission : planifiee, en_cours, terminee, annulee. Statuts d'une recommandation : ouverte, en_cours, mise_en_oeuvre, abandonnee.

Exemple

curl "https://sig.example.com/api/suivi-evaluation/rapport-periodique?annee=2026&trimestre=3&format=pdf" \
  -H "Authorization: Bearer TOKEN" \
  -o rapport-suivi-2026-T3.pdf

Les codes de permission complets sont préfixés par suivi_evaluation. (par exemple suivi_evaluation.indicateurs_validate).