Review submission
How product reviews are submitted, moderated, published and aggregated into ratings.
Review SubmissionReview SubmissionFlowv1.0.0How a customer's product review travels from submission, through moderation, to being published and folded into the prod...Ownerreviews-platformView flowView docs captures the lifecycle of customer product feedback.
Flow map
Flow stages
- A customer submits a review through Review APIReview APIServicev1.0.0
The 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 using Submit ReviewSubmit ReviewCommandv1.0.0Command issued by a customer to submit a review and rating for a product.
Ownerreviews-platformSchemaMapView docs. - 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 stores the review in Review DatabaseReview DatabaseContainerv1.0.0
PostgreSQL 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. - 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 evaluates the review.
- The worker publishes 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.
- Rating AggregatorRating AggregatorServicev1.0.0
Keeps 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 consumes published reviews and updates Rating CacheRating CacheContainerv1.0.0Redis cache that serves each product's aggregate star rating with low latency.MapView docs. - 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 serves Get Product ReviewsGet Product ReviewsQueryv1.0.0Query to fetch the published reviews and aggregate rating for a product.
Ownerreviews-platformSchemaMapView docs for storefront reads.
Moderation boundary
Moderation is asynchronous so submission remains responsive and moderation rules can evolve independently.
Rating boundary
Ratings are a read model. Rating CacheRating CacheContainerv1.0.0Redis cache that serves each product's aggregate star rating with low latency.MapView docs is optimised for product pages, while Review DatabaseReview DatabaseContainerv1.0.0PostgreSQL database that is the system of record for reviews and their moderation state.MapView docs remains the durable review store.
Follow-up interactions
After publication, customers can use Vote Review HelpfulVote Review HelpfulCommandv1.0.0Command issued by a customer to mark a published review as helpful (or remove their vote). Ownerreviews-platformSchemaMapView docs or Flag ReviewFlag ReviewCommandv1.0.0Command issued by a customer or moderator to flag a published review for re-moderation. Ownerreviews-platformSchemaMapView docs. These interactions publish Review Helpful VotedReview Helpful VotedEventv1.0.0Published when a review's helpful count changes as a result of a customer vote. Ownerreviews-platformSchemaMapView docs and Review FlaggedReview FlaggedEventv1.0.0Published when a published review is flagged and needs to be screened again. Ownerreviews-platformSchemaMapView docs.