entity

Review

A customer's review and rating of a product, including its moderation lifecycle.

Entity(Aggregate Root)

Overview

The Review is the core aggregate of the Reviews & Ratings domain. It captures a customer’s rating and written feedback for a product, along with the moderation status that controls whether it is visible on the storefront.

A review moves through three states:

  1. submitted — stored by 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, awaiting moderation.
  2. published — passed moderation and visible (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 folds it into the product’s rating).
  3. rejected — failed moderation and never shown, but kept for audit.