Overview

The Review API is the front door to the Reviews & Ratings domain. It validates incoming Submit ReviewSubmit ReviewCommand•v1.0.0Command issued by a customer to submit a review and rating for a product. Ownerreviews-platformSchemaMapView docs commands, persists reviews to the Review DatabaseReview DatabaseContainer•v1.0.0PostgreSQL database that is the system of record for reviews and their moderation state.MapView docs, and publishes Review SubmittedReview SubmittedEvent•v1.0.0Published when a customer submits a review. The review is stored but not yet visible — it awaits moderation. Ownerreviews-platformSchemaMapView docs. It also serves Get Product ReviewsGet Product ReviewsQuery•v1.0.0Query to fetch the published reviews and aggregate rating for a product. Ownerreviews-platformSchemaMapView docs, reading published reviews from the Review DatabaseReview DatabaseContainer•v1.0.0PostgreSQL database that is the system of record for reviews and their moderation state.MapView docs and aggregate ratings from the Rating CacheRating CacheContainer•v1.0.0Redis cache that serves each product's aggregate star rating with low latency.MapView docs.

Responsibilities

Area	Description
Command handling	Validates and applies Submit ReviewSubmit ReviewCommand•v1.0.0Command issued by a customer to submit a review and rating for a product. Ownerreviews-platformSchemaMapView docs.
Reads	Serves Get Product ReviewsGet Product ReviewsQuery•v1.0.0Query to fetch the published reviews and aggregate rating for a product. Ownerreviews-platformSchemaMapView docs from the review database and rating cache.
Eventing	Publishes Review SubmittedReview SubmittedEvent•v1.0.0Published when a customer submits a review. The review is stored but not yet visible — it awaits moderation. Ownerreviews-platformSchemaMapView docs for moderation.
Persistence	Writes to the Review DatabaseReview DatabaseContainer•v1.0.0PostgreSQL database that is the system of record for reviews and their moderation state.MapView docs; reads from the Review DatabaseReview DatabaseContainer•v1.0.0PostgreSQL database that is the system of record for reviews and their moderation state.MapView docs and Rating CacheRating CacheContainer•v1.0.0Redis cache that serves each product's aggregate star rating with low latency.MapView docs.

Architecture diagram

Messages for this service

Sends messages (3)

Quickly find the message you need by searching for the name, type, or summary.

Events (3)

Name	Version	Type	Summary
Review Submitted	v1.0.0	event	Published when a customer submits a review. The review is stored but not yet visible — it awaits moderation.
Review Flagged	v1.0.0	event	Published when a published review is flagged and needs to be screened again.
Review Helpful Voted	v1.0.0	event	Published when a review's helpful count changes as a result of a customer vote.

Receives messages (4)

Quickly find the message you need by searching for the name, type, or summary.

Queries (1)Commands (3)

Name	Version	Type	Summary
Submit Review	v1.0.0	command	Command issued by a customer to submit a review and rating for a product.
Flag Review	v1.0.0	command	Command issued by a customer or moderator to flag a published review for re-moderation.
Vote Review Helpful	v1.0.0	command	Command issued by a customer to mark a published review as helpful (or remove their vote).
Get Product Reviews	v1.0.0	query	Query to fetch the published reviews and aggregate rating for a product.