Documentation developpeur Review

Les Reviews sont des modeles structures pour collecter, moderer et rendre des retours publics dans FaceFlow.

Elles permettent aux equipes techniques de gerer un contenu sensible a la reputation comme une sortie gouvernee du site plutot que comme des temoignages libres et non maitrises.

Responsabilite centrale

Un modele de Review est responsable de :

• modeles de review configurables
• champs de notation structures
• capture des soumissions publiques
• politique de moderation et de verification
• sortie d'affichage embarquable
• controle de publication

Cela rend les Reviews adaptees aux sections de site basees sur la confiance qui ont besoin a la fois de visibilite publique et de controle operationnel.

Modele central de Review

Un modele de Review combine en general :

• des champs d'identite centraux pour la review
• des champs de notation
• des dimensions de notation personnalisees optionnelles
• des reglages de moderation
• un comportement de verification
• des reglages de presentation et de sortie

En pratique, la couche Review definit a la fois ce qui peut etre collecte et ce qui peut etre republie sur le site une fois approuve.

Conceptuellement :

{
  "name": "customer-success-reviews",
  "fields": [
    { "name": "author_name", "type": "text", "required": true },
    { "name": "rating", "type": "rating", "required": true },
    { "name": "review_title", "type": "text", "required": true },
    { "name": "review_content", "type": "textarea", "required": true }
  ],
  "settings": {
    "moderation": "required",
    "verification": "optional"
  }
}

Flux de soumission et de publication

Au plus haut niveau :

1. un modele de Review est defini centralement
2. il est embarque dans une Page via un Component
3. les visiteurs soumettent leur retour
4. les regles de moderation et de verification sont appliquees
5. les entrees approuvees sont rendues dans l'experience du site

Conceptuellement :

rendu du widget review
  -> soumission visiteur
  -> etat de review en attente
  -> moderation / verification
  -> review approuvee publiee

C'est pourquoi les Reviews doivent etre traitees comme un contenu public gouverne, pas comme un simple formulaire de saisie.

Structure de notation

Les modeles de Review peuvent prendre en charge :

• une note globale
• un titre de review
• un contenu de review
• des dimensions de notation personnalisees pour des retours plus structures

Exemple :

overall_rating
service_rating
communication_rating
value_rating

N'utilisez des dimensions supplementaires que lorsqu'elles ameliorent reellement la confiance et l'interpretation.

Exemple de modele de Review

Une revue technique doit pouvoir inspecter clairement la forme du modele :

{
  "name": "service-review",
  "fields": [
    { "name": "author_name", "type": "text", "required": true },
    { "name": "rating", "type": "rating", "required": true },
    { "name": "review_title", "type": "text", "required": true },
    { "name": "review_content", "type": "textarea", "required": true }
  ],
  "settings": {
    "moderation": "required",
    "verification": "optional"
  }
}

Cela aide les equipes a revoir ce qui est collecte, ce qui est obligatoire et la charge de moderation probable du modele.

Moderation et verification

La moderation et la verification sont centrales dans la conception des Reviews.

Les equipes techniques doivent decider :

• si les entrees necessitent une approbation
• si une verification supplementaire est necessaire
• qui possede les decisions de publication
• comment un contenu sensible a la reputation doit etre traite

Plus le risque reputionnel est eleve, plus les controles doivent generalement etre forts.

Embedding des Reviews

Les Reviews sont generalement embarquees dans des sections de page via des Components.

Un marqueur d'embed courant est :

<div data-review-embed="service-review"></div>

Exemple de section :

<section class="customer-proof">
  <header>
    <h2>What customers say</h2>
  </header>
  <div data-review-embed="customer-success-reviews"></div>
</section>

Cela garde la collecte et l'affichage des reviews reutilisables tout en laissant la Page placer le contenu de confiance la ou il a le plus d'impact.

Embeds fixes vs pilotes par champ

Il existe deux patterns d'embed courants.

Utilisez un id de modele de Review fixe quand le template doit toujours rendre un modele precis :

<div data-review-embed="customer-success-reviews"></div>

Utilisez un embed pilote par champ quand un Component expose un champ reviewSelect et que les auteurs doivent choisir le modele de Review gere au moment de l'edition :

<div data-review-embed="{serviceReview}"></div>

Regle de decision :

• embed fixe -> un workflow de confiance stable possede par le template
• embed pilote par champ -> Component reutilisable avec workflow de review selectionnable par l'auteur

Pattern d'integration

Le chemin runtime propre est :

modele de Review
-> embed dans un Component via reviewSelect ou marqueur data-review-embed explicite
-> composition de Page
-> soumission publique, moderation et affichage approuve

Cela garde la logique sensible a la reputation centralisee au lieu de l'eparpiller dans du markup ponctuel.

Conseils operationnels

Une bonne conception de Review favorise en general :

• un modele de Review par contexte metier
• une propriete claire de la moderation
• des dimensions structurees seulement lorsqu'elles ajoutent une vraie valeur
• une experience de soumission assez courte pour preserver la qualite
• un modele de publication qui soutient la confiance plutot que le bruit

Si un modele de Review devient trop large, la qualite et la moderation deviennent en general plus difficiles a gerer.

Conseils sur le contrat de notation

Gardez le modele de notation proportionne au workflow public.

Patterns typiques :

• section simple de confiance -> note globale + titre + corps de review
• workflow qualite de service -> note globale plus un petit nombre de dimensions comme service, communication ou valeur

Si un parcours public court demande trop d'entrees de notation, la qualite des soumissions et le taux de completion baissent en general.

Conseils techniques

• separez les modeles de Review par contexte metier
• alignez la politique de moderation et de verification sur la sensibilite reputionnelle
• gardez la collecte publique assez courte pour maintenir la qualite des soumissions
• traitez le contenu de review publie comme une sortie gouvernee
• revoyez ensemble collecte, moderation et affichage comme un seul workflow

Anti-patterns

Evitez :

• un enorme modele de Review utilise pour des contextes metier sans rapport
• trop de dimensions de notation pour un flux public court
• publier sans propriete claire de moderation
• traiter les Reviews comme des temoignages libres colles dans des Components
• concevoir le flux de saisie sans revoir le modele d'affichage et d'approbation

Exemple de pattern de construction

Review model:
  customer-success-reviews

Component:
  review-strip

Embed:
  <div data-review-embed="customer-success-reviews"></div>

Ce pattern garde le contenu de confiance reutilisable et gouverne.

Related

• Vue produit Reviews
• Guide Review
• Components
• Pages
• Users