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.Ownerreviews-platformMapView 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.Ownerreviews-platformMapView 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.Ownerreviews-platformMapView 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.Ownerreviews-platformMapView 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.