Avis & évaluations

Le système d'avis permet aux membres de noter et commenter les professionnels directement depuis leur vitrine (/pro/{slug}).

Fonctionnement général

Un membre connecté peut laisser un seul avis par professionnel (note de 1 à 5 étoiles + commentaire optionnel)
Un professionnel ne peut pas s'évaluer lui-même
Les avis approuvés sont visibles publiquement sur la vitrine avec la note moyenne calculée automatiquement

Statuts d'un avis

Statut	Description
`pending`	En attente de validation (avis soumis mais non encore publié)
`approved`	Approuvé — visible publiquement sur la vitrine
`rejected`	Rejeté — non visible publiquement

Double modération

Modération par le professionnel

Depuis /profile → onglet Profil professionnel, le professionnel peut activer l'option Valider les avis avant qu'ils soient publiés.

Quand cette option est activée : - Chaque nouvel avis passe en statut pending jusqu'à validation manuelle - Le professionnel voit les avis en attente dans l'onglet Avis de sa vitrine et peut les approuver ou les rejeter

Quand l'option est désactivée : - Les nouveaux avis sont approuvés automatiquement à la soumission

Modération globale (admin)

Dans Admin → Paramètres → onglet Professionnels → Modération des avis :

Imposer la validation admin pour tous les avis — quand cette option est activée, tous les avis passent en pending quelle que soit la préférence individuelle du professionnel.

Cette option est utile pour contrôler la qualité sur l'ensemble du site avant que les professionnels n'aient accès à leur propre modération.

Gérer les avis depuis l'admin (`/admin/reviews`)

L'écran Admin → Avis liste l'ensemble des avis du site :

Colonne	Description
Évaluateur	Membre ayant laissé l'avis
Professionnel	Compte évalué
Note	Étoiles (1–5)
Commentaire	Texte de l'avis
Statut	`pending` / `approved` / `rejected` (filtre disponible)
Date	Date de soumission

Actions disponibles par ligne : - Approuver — passe le statut à approved - Rejeter — passe le statut à rejected - Supprimer — supprime définitivement l'avis

Un filtre par statut (Tous / Approuvés / En attente / Rejetés) permet de traiter rapidement les avis en attente.

API (développeurs)

Méthode	Endpoint	Description
`GET`	`/api/reviews?pro_id={id}`	Liste les avis d'un professionnel (approuvés pour tous ; tous les statuts pour le pro concerné ou un admin)
`POST`	`/api/reviews`	Soumettre un avis (`pro_user_id`, `rating`, `comment`)
`PUT`	`/api/reviews/{id}`	Approuver ou rejeter un avis (`status: approved	rejected`)
`DELETE`	`/api/reviews/{id}`	Supprimer un avis (reviewer, pro concerné ou admin)

Voir aussi

Vitrines professionnelles — où s'affichent les avis
Annuaire des professionnels — note moyenne visible dans l'annuaire