API Analytics

Objectif

Exposer des statistiques utiles au pilotage produit, aux acteurs, communes et administrateurs, sans devenir intrusif.

Périmètre

Statistiques globales, acteur, commune et usage push.

Applications consommatrices

• Backoffice.
• Espaces acteurs.
• Mairie.
• Support/administration.

Authentification requise

Toutes les routes visibles utilisent identify.app + auth:sanctum.

Permissions/RBAC

• Global et commune sont réservés aux admins selon commentaire code, avec vérification dans le contrôleur.
• Acteur limité aux gestionnaires ou admins selon règles à confirmer.
• Les analytics doivent rester agrégées et non intrusives.

Endpoints confirmés visibles

Méthode	Route	Auth	Notes
GET	/api/v1/analytics/global	auth:sanctum	Admin selon commentaire code.
GET	/api/v1/analytics/acteurs/{id}/push	auth:sanctum	Usage push acteur.
GET	/api/v1/analytics/acteurs/{id}	auth:sanctum	Stats acteur.
GET	/api/v1/analytics/communes/{id}	auth:sanctum	Admin selon commentaire code.

Paramètre visible :

• mois=YYYY-MM, défaut mois courant selon commentaire code.

Endpoints cibles si nécessaire

• Export analytics agrégé à confirmer.
• Dashboard mairie spécifique à confirmer.

Exemples génériques de requête/réponse

GET /api/v1/analytics/acteurs/acteur-id?mois=2026-05
Authorization: Bearer <token>
X-App-Source: backoffice

{
  "data": {
    "period": "2026-05",
    "views": 120,
    "publications": 6
  }
}

Erreurs principales

{
  "error": "analytics_scope_denied",
  "message": "Vous ne pouvez pas consulter ces statistiques."
}

Audit/logs si applicable

Recommandé pour accès aux statistiques globales, communes et exports.

Sécurité

• Agréger les données autant que possible.
• Ne pas exposer de parcours individuels non nécessaires.
• Respecter la minimisation RGPD.
• L’IA ne doit consommer les analytics que via services Laravel filtrés.

État actuel vs cible

Sujet	État actuel	Cible
Routes analytics	Confirmées.	Matrice d’accès explicite.
Paramètre mois	Confirmé par commentaire code.	Filtres période stabilisés.
Données	Non détaillées.	Agrégats non intrusifs.

Points à confirmer

• Payload exact des métriques.
• Droits acteur vs admin.
• Rétention analytics.
• Export et anonymisation.