Beoordelingen — Ontwikkelaarsdocumentatie

Beoordelingen zijn gestructureerde modellen voor het verzamelen, modereren en weergeven van publieke feedback in FaceFlow.

Ze stellen technische teams in staat reputatiegevoelige inhoud te beheren als gereguleerde website-uitvoer in plaats van als onbeheerde vrije getuigenissen.

Kernverantwoordelijkheid

Een beoordelingsmodel is verantwoordelijk voor:

• configureerbare beoordelingsmodellen
• gestructureerde waarderingsvelden
• opvang van publieke inzendingen
• moderatie- en verificatiebeleid
• insluitbare weergave-uitvoer
• publicatiecontrole

Dit maakt beoordelingen geschikt voor website-secties die op vertrouwen zijn gericht en zowel publieke zichtbaarheid als operationele controle nodig hebben.

Kernmodel voor beoordelingen

Een beoordelingsmodel combineert meestal:

• kernvelden voor identiteit van de beoordeling
• waarderingsvelden
• optionele aangepaste waarderingsdimensies
• moderatie-instellingen
• verificatiegedrag
• presentatie- en uitvoerinstellingen

In de praktijk definieert de beoordelingslaag zowel welke feedback kan worden verzameld als welke goedgekeurde feedback terug naar de website kan worden gepubliceerd.

Conceptueel:

{
  "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"
  }
}

Inzend- en publicatiestroom

Op hoofdlijnen:

1. er wordt centraal een beoordelingsmodel gedefinieerd
2. het wordt via een Component op een Pagina ingesloten
3. bezoekers dienen feedback in
4. moderatie- en verificatieregels worden toegepast
5. goedgekeurde inzendingen worden terug in de website-ervaring weergegeven

Conceptueel:

review widget render
  -> visitor submission
  -> pending review state
  -> moderation / verification
  -> approved review published

Daarom moeten beoordelingen worden behandeld als gereguleerde publieke inhoud, en niet slechts als een ander invoerformulier.

Waarderingsstructuur

Beoordelingsmodellen kunnen ondersteunen:

• algemene waardering
• titel van de beoordeling
• inhoud van de beoordeling
• aangepaste waarderingsdimensies voor meer gestructureerde feedback

Example:

overall_rating
service_rating
communication_rating
value_rating

Gebruik extra dimensies alleen wanneer ze het vertrouwen en de interpretatie verbeteren.

Voorbeeld beoordelingsmodel

Een technisch team moet de vorm van het model duidelijk kunnen inspecteren:

{
  "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"
  }
}

Dit helpt teams beoordelen wat wordt verzameld, wat vereist is en hoeveel moderatielast het model waarschijnlijk zal veroorzaken.

Moderatie en verificatie

Moderatie en verificatie zijn centraal in het ontwerp van beoordelingen.

Technische teams moeten beslissen:

• of inzendingen goedkeuring vereisen
• of extra verificatie nodig is
• wie verantwoordelijk is voor publicatiebeslissingen
• hoe reputatiegevoelige inhoud moet worden behandeld

Hoe groter het reputatierisico, hoe sterker doorgaans de controles moeten zijn.

Beoordelingen insluiten

Beoordelingen worden doorgaans via Componenten in paginasecties opgenomen.

A common embed marker is:

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

Example section:

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

Dit houdt de verzameling en weergave van beoordelingen herbruikbaar terwijl de Pagina vertrouwensinhoud op de meest impactvolle plek kan plaatsen.

Vaste versus veld-ondersteunde insluitingen

Er zijn twee veelvoorkomende insluitpatronen.

Gebruik een vast beheerd beoordelingsmodel-id wanneer de template altijd één specifiek beoordelingsmodel moet weergeven:

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

Gebruik een veld-ondersteunde insluiting wanneer een Component een reviewSelect-veld aanbiedt en auteurs het beheerde beoordelingsmodel tijdens het aanmaken moeten kiezen:

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

Beslissingsregel:

• vaste insluiting -> één stabiele vertrouwensworkflow die eigendom is van de template
• veld-ondersteunde insluiting -> herbruikbare Component met door auteur selecteerbare beoordelingsworkflow

Integratiepatroon

Het duidelijke runtime-pad is:

Review model
-> Component embed via reviewSelect or explicit data-review-embed marker
-> Page composition
-> public submission, moderation, and approved display output

Dat houdt reputatiegevoelige workflowlogica gecentraliseerd in plaats van verspreid over eenmalige paginamarkup.

Operationele richtlijnen

Goed beoordelingsontwerp geeft meestal de voorkeur aan:

• één beoordelingsmodel per zakelijke context
• duidelijke moderatieverantwoordelijkheid
• gestructureerde waarderingsdimensies alleen waar ze echte meerwaarde bieden
• een inzendervaring die kort genoeg is om de kwaliteit te behouden
• een publicatiemodel dat vertrouwen ondersteunt in plaats van ruis

Als een beoordelingsmodel te breed wordt, worden kwaliteit en moderatie meestal moeilijker te beheren.

Richtlijnen voor waarderingscontract

Houd het waarderingsmodel evenredig met de publieke workflow.

Typische patronen:

• eenvoudige vertrouwenssectie -> algemene waardering + titel + beoordelingsinhoud
• workflow voor servicekwaliteit -> algemene waardering plus een klein aantal dimensies zoals service, communicatie of waarde

Als een korte publieke flow te veel waarderingsinvoeren vereist, dalen doorgaans de inzendkwaliteit en het voltooiingspercentage.

Technische richtlijnen

• scheid beoordelingsmodellen per zakelijke context
• stem moderatie- en verificatiebeleid af op reputatiegevoeligheid
• houd de openbare verzameling van beoordelingen kort genoeg om de inzendkwaliteit te behouden
• behandel gepubliceerde beoordelingsinhoud als gereguleerde output
• verzameling van beoordelingen, moderatie en weergave samen als één workflow behandelen

Anti-patronen

Vermijd:

• één gigantisch beoordelingsmodel dat wordt gebruikt voor niet-gerelateerde zakelijke contexten
• te veel waarderingsdimensies voor een korte publieke flow
• publiceren zonder duidelijke moderatieverantwoordelijkheid
• behandelen van beoordelingen als ongereguleerde getuigenissen geplakt in Componenten
• het ontwerp van de invoerflow zonder het weergave- en goedkeuringsmodel te beoordelen

Voorbeeld bouwpatroon

Review model:
  customer-success-reviews

Component:
  review-strip

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

Dat patroon houdt vertrouwensinhoud herbruikbaar en gereguleerd.

Gerelateerd

• Overzicht van het Reviews-product
• Gids voor Reviews
• Componenten
• Pagina's
• Gebruikers