flow

Review Submission

How a customer's product review travels from submission, through moderation, to being published and folded into the product's aggregate rating.

Flow

Overview

Review Submission documents the journey of a customer review from submission through moderation to publication. A review is only ever folded into a product’s rating once it has been approved.

How it works

  1. A customer submits a review via the Review APIReview APIServicev1.0.0The public-facing API for product reviews. Accepts review submissions, serves published reviews, and is the entry point ...Publishesreview-submitted, review-flagged +1Subscribessubmit-review, flag-review +2Ownerreviews-platformMapRepoView docs, which stores it in the Review DatabaseReview DatabaseContainerv1.0.0PostgreSQL database that is the system of record for reviews and their moderation state.MapView docs and publishes Review SubmittedReview SubmittedEventv1.0.0Published when a customer submits a review. The review is stored but not yet visible — it awaits moderation. Ownerreviews-platformSchemaMapView docs.
  2. The Review Moderation WorkerReview Moderation WorkerServicev1.0.0Asynchronous worker that screens submitted reviews for spam, abuse and policy violations, then publishes or rejects them...Publishesreview-published, review-rejectedSubscribesreview-submitted, review-flaggedOwnerreviews-platformMapRepoView docs screens the review and publishes either Review PublishedReview PublishedEventv1.0.0Published when a submitted review passes moderation and becomes visible on the storefront. Ownerreviews-platformSchemaMapView docs or Review RejectedReview RejectedEventv1.0.0Published when a submitted review fails moderation (spam, abuse or policy violation) and will not be shown. Ownerreviews-platformSchemaMapView docs.
  3. On approval, the Rating AggregatorRating AggregatorServicev1.0.0Keeps each product's aggregate star rating up to date as reviews are published, and serves it fast from a cache. Publishesrating-updatedSubscribesreview-publishedOwnerreviews-platformMapRepoView docs updates the product’s aggregate rating in the Rating CacheRating CacheContainerv1.0.0Redis cache that serves each product's aggregate star rating with low latency.MapView docs and the review goes live.
Edit this page