Rating Review Format Component

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Standardized Rating and Review Format",
  "description": "Reusable schema component for ratings and reviews across all entity types",
  "type": "object",
  "aimlVersion": "2.0.1",
  "schemaVersion": "2.0.1",
  "properties": {
    "ratingsSummary": {
      "type": "object",
      "description": "Summary of ratings for this entity",
      "properties": {
        "averageRating": {
          "type": "number",
          "description": "Average rating value",
          "minimum": 0
        },
        "totalRatings": {
          "type": "integer",
          "description": "Total number of ratings",
          "minimum": 0
        },
        "distributionMethod": {
          "type": "string",
          "enum": ["star", "percentage", "points", "custom"]
        },
        "ratingDistribution": {
          "type": "object",
          "description": "Distribution of ratings by value"
        },
        "recommendationPercentage": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "sentimentBreakdown": {
          "type": "object",
          "properties": {
            "positive": { "type": "number", "minimum": 0, "maximum": 100 },
            "neutral": { "type": "number", "minimum": 0, "maximum": 100 },
            "negative": { "type": "number", "minimum": 0, "maximum": 100 }
          }
        }
      },
      "required": ["averageRating", "totalRatings"]
    },
    "dimensionalRatings": {
      "type": "object",
      "description": "Ratings broken down by specific dimensions or attributes"
    },
    "reviews": {
      "type": "array",
      "description": "Collection of reviews for this entity",
      "items": {
        "type": "object",
        "properties": {
          "reviewId": { "type": "string" },
          "rating": { "type": "number", "minimum": 0 },
          "title": { "type": "string" },
          "content": { "type": "string" },
          "author": {
            "type": "object",
            "properties": {
              "name": { "type": "string" },
              "verified": { "type": "boolean" }
            },
            "required": ["name"]
          },
          "createdAt": { "type": "string", "format": "date-time" }
        },
        "required": ["reviewId", "rating", "content", "author", "createdAt"]
      }
    }
  }
}

{
  "ratingsSummary": {
    "averageRating": 4.3,
    "minRating": 1,
    "maxRating": 5,
    "totalRatings": 127,
    "totalReviews": 89,
    "distributionMethod": "star",
    "ratingDistribution": {
      "1": 3,
      "2": 8,
      "3": 15,
      "4": 35,
      "5": 66
    },
    "recommendationPercentage": 86.5,
    "sentimentBreakdown": {
      "positive": 72.5,
      "neutral": 15.8,
      "negative": 11.7
    },
    "confidenceScore": 0.92,
    "trendDirection": "improving",
    "ratingBadge": "good",
    "lastUpdated": "2025-07-09T10:30:00Z"
  },
  "dimensionalRatings": {
    "food_quality": {
      "name": "Food Quality",
      "description": "Quality and taste of food items",
      "averageRating": 4.5,
      "totalRatings": 124,
      "importance": 0.9
    },
    "service": {
      "name": "Service",
      "description": "Quality of customer service",
      "averageRating": 4.1,
      "totalRatings": 118,
      "importance": 0.8
    },
    "atmosphere": {
      "name": "Atmosphere",
      "description": "Restaurant ambiance and environment",
      "averageRating": 4.3,
      "totalRatings": 102,
      "importance": 0.6
    }
  },
  "reviews": [
    {
      "reviewId": "rev_001",
      "rating": 5,
      "title": "Excellent dining experience!",
      "content": "Amazing food quality and friendly service. The atmosphere was perfect for our anniversary dinner.",
      "author": {
        "name": "Sarah M.",
        "id": "user_12345",
        "verified": true,
        "verificationMethod": "reservation",
        "numberOfReviews": 23
      },
      "createdAt": "2025-07-05T19:30:00Z",
      "isVerified": true,
      "sentiment": "positive",
      "sentimentScore": 0.85,
      "helpfulVotes": 12,
      "recommendsProduct": true,
      "pros": ["Excellent food", "Great service", "Beautiful atmosphere"],
      "experienceDate": "2025-07-03",
      "dimensionalRatings": {
        "food_quality": 5,
        "service": 5,
        "atmosphere": 5
      }
    }
  ],
  "reviewSummaries": {
    "positiveHighlights": [
      "Consistently excellent food quality",
      "Outstanding customer service",
      "Beautiful and comfortable atmosphere"
    ],
    "negativeHighlights": [
      "Occasional wait times during peak hours"
    ],
    "keyThemes": [
      {
        "theme": "food_quality",
        "frequency": 0.89,
        "sentiment": "positive",
        "sentimentScore": 0.82
      }
    ],
    "overallSummary": "Highly rated restaurant with excellent food and service",
    "generatedAt": "2025-07-09T10:00:00Z",
    "reviewSampleSize": 89,
    "confidenceScore": 0.91
  }
}