Reviews & ratings

$product->addReview($user)
    ->rating(5)
    ->title('Great')
    ->content('Love it')
    ->approved()
    ->create();

$product->reviews();              // MorphMany<Review>
$product->approvedReviews();      // MorphMany<Review>
$product->reviewsCount();         // int
$product->approvedReviewsCount(); // int
$product->averageRating();        // ?float — approved reviews only
$product->ratingDistribution();   // [5 => 12, 4 => 3, ...]
$product->ratingSummary();        // RatingSummary {average, count, distribution}

// Pre-flags the review as a verified purchase via the bound resolver:
$product->review($user)
    ->rating(5)
    ->title('Excellent')
    ->content('Exactly as described.')
    ->create();   // Review — verified set automatically

// config/shops.php
'reviews' => [
    'verified_purchase_resolver' => \RoundlyConsulting\Shops\Reviews\DatabaseVerifiedPurchaseResolver::class,
],

use Illuminate\Database\Eloquent\Model;
use RoundlyConsulting\Shops\Products\Product;
use RoundlyConsulting\Shops\Reviews\Contracts\VerifiedPurchaseResolver;

final class CrmVerifiedPurchaseResolver implements VerifiedPurchaseResolver
{
    public function verified(Model $author, Product $product): bool
    {
        // your own purchase lookup, e.g. against an external order system
        return false;
    }
}