domain-reviews — IMP FORGE

Ratings and reviews with multi-source support and cached aggregates

Tier	domain
Role	unclassified (baselined)
Path	`crates/domain/reviews`
Edition	2021
Targets	domain_reviews
Public items	79 across 6 modules
Tests	14

What it is for

domain-reviews: Ratings and Reviews Library crate

A universal ratings and reviews system that can be attached to any entity via the EntityRef pattern. Supports multiple sources (Google, Yelp, etc.), cached aggregates with auto-refresh triggers, and AI sentiment analysis.

# Features

Multi-source reviews: Collect from Google, Yelp, BBB, etc. with deduplication
EntityRef pattern: Attach reviews to any entity type (Organization, Product, etc.)
Cached aggregates: ReviewSummary with auto-refresh via database triggers
Sentiment analysis: Fields for AI-powered sentiment classification
Standard 1-5 rating: Familiar rating scale with distribution tracking

# Example

use domain_reviews::{Review, ReviewSource, EntityRef, Sentiment};
use rust_decimal_macros::dec;
use uuid::Uuid;

// Create a review for an organization
let entity = EntityRef::organization(Uuid::new_v4());
let review = Review::new(
tenant_id,
&entity,
ReviewSource::Google,
"google_review_123",
dec!(4.5),
)
.with_title("Great service!")
.with_text("They fixed my pipes quickly.")
.with_reviewer("John D.")
.as_verified()
.with_sentiment(Sentiment::Positive, Some(dec!(0.95)));

Capabilities

`ReviewError`

Review errors.

Item
`pub enum ReviewError`
`ReviewError :: fn storage(msg : impl Into <String>) -> Self`
`ReviewError :: fn validation(msg : impl Into <String>) -> Self`

`ReviewEvent`

Review domain events.

Item
`pub enum ReviewEvent`
`ReviewEvent :: fn created(review_id : Uuid, tenant_id : Uuid, entity : & EntityRef, source : & ReviewSource, rating : Decimal,) -> Self`
`ReviewEvent :: fn updated(review_id : Uuid, tenant_id : Uuid, entity : & EntityRef, old_rating : Option <Decimal>, new_rating : Decimal,) -> Self`
`ReviewEvent :: fn deleted(review_id : Uuid, tenant_id : Uuid, entity : & EntityRef) -> Self`
`ReviewEvent :: fn sentiment_analyzed(review_id : Uuid, tenant_id : Uuid, sentiment : Sentiment, score : Option <Decimal>,) -> Self`
`ReviewEvent :: fn summary_refreshed(tenant_id : Uuid, entity : & EntityRef, review_count : i32, avg_rating : Option <Decimal>,) -> Self`

`jsonld (other)`

schema.org/Review JSON-LD payload builder.

Item
`fn build_jsonld_third_party_only(reviews : & Review, business_name : & str) -> Option <Value>`

`EntityRef`

Core review models.

Item
`pub struct EntityRef`
`EntityRef :: fn new(entity_type : impl Into <String>, entity_id : Uuid) -> Self`
`EntityRef :: fn organization(id : Uuid) -> Self`
`EntityRef :: fn catalog_item(id : Uuid) -> Self`
`EntityRef :: fn person(id : Uuid) -> Self`

`Review:Review`

Core review models.

Item
`pub struct Review`

`Review:as`

Core review models.

Item
`Review :: fn as_verified(mut self) -> Self`
`Review :: fn as_inactive(mut self) -> Self`

`Review:entity`

Core review models.

Item
`Review :: fn entity_ref(& self) -> EntityRef`

`Review:is`

Core review models.

Item
`Review :: fn is_positive(& self) -> bool`
`Review :: fn is_negative(& self) -> bool`
`Review :: fn is_third_party(& self) -> bool`

`Review:new`

Core review models.

Item
`Review :: fn new(tenant_id : Uuid, entity : & EntityRef, source : ReviewSource, source_id : impl Into <String>, rating : Decimal,) -> Self`

`Review:with`

Core review models.

Item
`Review :: fn with_source_url(mut self, url : impl Into <String>) -> Self`
`Review :: fn with_title(mut self, title : impl Into <String>) -> Self`
`Review :: fn with_text(mut self, text : impl Into <String>) -> Self`
`Review :: fn with_reviewer(mut self, name : impl Into <String>) -> Self`
`Review :: fn with_reviewer_id(mut self, id : impl Into <String>) -> Self`
`Review :: fn with_review_date(mut self, date : DateTime <Utc>) -> Self`
`Review :: fn with_sentiment(mut self, sentiment : Sentiment, score : Option <Decimal>) -> Self`
`Review :: fn with_body_short(mut self, short : impl Into <String>) -> Self`
`Review :: fn with_sequence(mut self, sequence : i32) -> Self`

`ReviewFilter`

Core review models.

Item
`pub struct ReviewFilter`
`ReviewFilter :: fn new() -> Self`
`ReviewFilter :: fn source(mut self, source : ReviewSource) -> Self`
`ReviewFilter :: fn min_rating(mut self, rating : Decimal) -> Self`
`ReviewFilter :: fn max_rating(mut self, rating : Decimal) -> Self`
`ReviewFilter :: fn sentiment(mut self, sentiment : Sentiment) -> Self`
`ReviewFilter :: fn verified_only(mut self) -> Self`
`ReviewFilter :: fn active_only(mut self) -> Self`
`ReviewFilter :: fn with_text_only(mut self) -> Self`
`ReviewFilter :: fn date_range(mut self, from : DateTime <Utc>, to : DateTime <Utc>) -> Self`
`ReviewFilter :: fn paginate(mut self, limit : i64, offset : i64) -> Self`

`ReviewSource`

Core review models.

Item
`pub enum ReviewSource`
`ReviewSource :: fn as_str(& self) -> & str`
`ReviewSource :: fn fmt(& self, f : & mut std::fmt::Formatter <'_>) -> std::fmt::Result`
`ReviewSource :: fn from_str(s : & str) -> Result <Self, Self::Err>`

`ReviewSummary`

Core review models.

Item
`pub struct ReviewSummary`
`ReviewSummary :: fn entity_ref(& self) -> EntityRef`
`ReviewSummary :: fn five_star_percentage(& self) -> f64`
`ReviewSummary :: fn positive_percentage(& self) -> f64`
`ReviewSummary :: fn rating_tier(& self) -> & 'static str`

`Sentiment`

Core review models.

Item
`pub enum Sentiment`
`Sentiment :: fn as_str(& self) -> & 'static str`
`Sentiment :: fn from_str(s : & str) -> Result <Self, Self::Err>`

`BulkResult`

Review repository trait.

Item
`pub struct BulkResult`
`BulkResult :: fn new() -> Self`
`BulkResult :: fn total(& self) -> i64`
`BulkResult :: fn all_succeeded(& self) -> bool`

`ReviewRepository`

Review repository trait.

Item
`pub trait ReviewRepository`