Review-Entwicklerdokumentation

Reviews sind strukturierte Modelle zum Sammeln, Moderieren und Darstellen öffentlicher Rückmeldungen in FaceFlow.

Sie ermöglichen technischen Teams, reputationsrelevante Inhalte als gesteuerte Website-Ausgabe zu verwalten, statt als ungeprüfte freie Testimonials.

Kernverantwortung

Ein Review-Modell ist verantwortlich für:

• konfigurierbare Review-Modelle
• strukturierte Bewertungsfelder
• Erfassung öffentlicher Einreichungen
• Moderations- und Verifizierungsrichtlinien
• einbettbare Anzeigeausgabe
• Veröffentlichungssteuerung

Das macht Reviews geeignet für vertrauensbasierte Website-Bereiche, die sowohl öffentliche Sichtbarkeit als auch operative Kontrolle benötigen.

Kern-Review-Modell

Ein Review-Modell kombiniert üblicherweise:

• zentrale Identitätsfelder der Review
• Bewertungsfelder
• optionale benutzerdefinierte Bewertungsdimensionen
• Moderationseinstellungen
• Verifizierungsverhalten
• Präsentations- und Ausgabeeinstellungen

In der Praxis definiert die Review-Ebene sowohl, welche Rückmeldungen gesammelt werden können, als auch welche genehmigten Rückmeldungen an die Website veröffentlicht werden können.

Konzeptionell:

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

Einreichungs- und Veröffentlichungsablauf

Auf hoher Ebene:

1. Ein Review-Modell wird zentral definiert
2. Es wird über eine Component in eine Seite eingebettet
3. Besucher reichen Feedback ein
4. Moderations- und Verifizierungsregeln werden angewandt
5. Genehmigte Einträge werden wieder in die Website-Erfahrung gerendert

Konzeptionell:

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

Deshalb sollten Reviews als gesteuerte öffentliche Inhalte behandelt werden und nicht nur als ein weiteres Eingabeformular.

Bewertungsstruktur

Review-Modelle können unterstützen:

• Gesamtbewertung
• Rezensionstitel
• Bewertungstext
• benutzerdefinierte Bewertungsdimensionen für strukturierteres Feedback

Beispiel:

overall_rating
service_rating
communication_rating
value_rating

Verwenden Sie zusätzliche Dimensionen nur, wenn sie Vertrauen und Interpretation verbessern.

Beispiel für ein Review-Modell

Ein technisches Team sollte die Modellstruktur klar einsehen können:

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

Das hilft Teams zu prüfen, was gesammelt wird, was erforderlich ist und wie hoch die Moderationsbelastung durch das Modell wahrscheinlich sein wird.

Moderation und Verifizierung

Moderation und Verifizierung sind zentral für das Design von Reviews.

Technische Teams sollten entscheiden:

• ob Einträge eine Genehmigung benötigen
• ob zusätzliche Verifizierung erforderlich ist
• wer Veröffentlichungsentscheidungen trifft
• wie reputationsrelevante Inhalte gehandhabt werden sollen

Je höher das Reputationsrisiko, desto stärker sollten in der Regel die Kontrollen sein.

Reviews einbetten

Reviews werden typischerweise mittels Components in Seitenabschnitte eingebettet.

Ein gängiges Embed-Marker ist:

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

Beispielabschnitt:

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

Das hält die Sammlung und Anzeige von Reviews wiederverwendbar und ermöglicht gleichzeitig der Seite, vertrauensbildende Inhalte dort zu platzieren, wo sie die größte Wirkung entfalten.

Feste vs. feldgestützte Einbettungen

Es gibt zwei gängige Einbettungsmuster.

Verwenden Sie eine feste verwaltete Review-Modell-ID, wenn die Vorlage immer genau ein bestimmtes Review-Modell rendern soll:

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

Verwenden Sie eine feldgestützte Einbettung, wenn ein Component ein Feld reviewSelect bereitstellt und Autoren das verwaltete Review-Modell zur Authoring-Zeit auswählen sollen:

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

Entscheidungsregel:

• feste Einbettung -> ein stabiler Vertrauens-Workflow, der der Vorlage gehört
• feldgestützte Einbettung -> wiederverwendbarer Component mit vom Autor auswählbarem Review-Workflow

Integrationsmuster

Der saubere Laufzeitpfad ist:

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

Das hält die Workflow-Logik für reputationsrelevante Inhalte zentralisiert, statt sie über einmaliges Seiten-Markup zu verstreuen.

Betriebliche Empfehlungen

Gutes Review-Design bevorzugt in der Regel:

• ein Review-Modell pro Geschäftskontext
• klare Moderationsverantwortung
• strukturierte Bewertungsdimensionen nur dort, wo sie echten Mehrwert bringen
• eine Einreichungserfahrung, die kurz genug ist, um Qualität zu erhalten
• ein Veröffentlichungsmodell, das Vertrauen fördert statt Lärm zu erzeugen

Wenn ein Review-Modell zu breit wird, werden Qualität und Moderation in der Regel schwerer zu handhaben.

Leitlinien zur Bewertungsstruktur

Halten Sie das Bewertungsmodell proportional zum öffentlichen Ablauf.

Typische Muster:

• einfacher Vertrauensbereich -> Gesamtbewertung + Titel + Rezensionstext
• Service-Qualitäts-Workflow -> Gesamtbewertung plus eine kleine Anzahl von Dimensionen wie Service, Kommunikation oder Preis-Leistungs-Verhältnis

Wenn ein kurzer öffentlicher Ablauf zu viele Bewertungsfelder benötigt, fallen in der Regel Einreichungsqualität und Abschlussrate.

Technische Hinweise

• Trennen Sie Review-Modelle nach Geschäftskontext
• Stimmen Sie Moderations- und Verifizierungsrichtlinien mit der Reputationssensitivität ab
• Halten Sie die öffentliche Review-Erfassung kurz genug, um die Einreichungsqualität zu erhalten
• Behandeln Sie veröffentlichte Review-Inhalte als gesteuerte Ausgabe
• Betrachten Sie Sammlung, Moderation und Anzeige gemeinsam als einen Workflow

Anti-Patterns

Vermeiden Sie:

• ein riesiges Review-Modell für nicht zusammenhängende Geschäftskontexte
• zu viele Bewertungsdimensionen für einen kurzen öffentlichen Ablauf
• Veröffentlichung ohne klare Moderationsverantwortung
• Reviews wie unverwaltete Testimonials zu behandeln, die in Components eingefügt werden
• den Eingabeablauf zu entwerfen, ohne Anzeige- und Genehmigungsmodell zu prüfen

Beispielhafter Aufbau

Review model:
  customer-success-reviews

Component:
  review-strip

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

Dieses Muster hält vertrauensbildende Inhalte wiederverwendbar und gesteuert.

Verwandte

• Produktübersicht zu Reviews
• Review-Leitfaden
• Komponenten
• Seiten
• Benutzer