Properties
| Name | Type | Description |
|---|---|---|
| id | string | Unique identifier for the recommendation |
| severity | string | Severity level of the recommendation |
| category | string | Category of the optimization |
| title | string | Short title summarizing the recommendation |
| description | string | Detailed explanation of the issue and recommended fix |
| affectedQueries | array | Query IDs that this recommendation applies to |
| suggestedAction | string | Specific code or schema change to implement |
| estimatedImpact | string | Expected performance improvement |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "#/components/schemas/Recommendation",
"title": "Recommendation",
"type": "object",
"description": "An AI-powered optimization recommendation for a query pattern",
"properties": {
"id": {
"type": "string",
"description": "Unique identifier for the recommendation"
},
"severity": {
"type": "string",
"description": "Severity level of the recommendation",
"enum": [
"critical",
"warning",
"info"
]
},
"category": {
"type": "string",
"description": "Category of the optimization",
"enum": [
"indexing",
"query_structure",
"caching",
"select_optimization",
"n_plus_one",
"batch_operation",
"connection_management"
]
},
"title": {
"type": "string",
"description": "Short title summarizing the recommendation",
"examples": [
"Add index on User.email for faster lookups"
]
},
"description": {
"type": "string",
"description": "Detailed explanation of the issue and recommended fix"
},
"affectedQueries": {
"type": "array",
"description": "Query IDs that this recommendation applies to",
"items": {
"type": "string"
}
},
"suggestedAction": {
"type": "string",
"description": "Specific code or schema change to implement"
},
"estimatedImpact": {
"type": "string",
"description": "Expected performance improvement",
"enum": [
"high",
"medium",
"low"
]
}
},
"required": [
"id",
"severity",
"category",
"title",
"description"
]
}