{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "Energy Ritual",
  "description": "Schema for energy ritual data used in SisiTheFox.com ritual API",
  "type": "object",
  "required": [
    "id",
    "name",
    "nameZh",
    "type",
    "category",
    "purpose",
    "difficulty",
    "timeRequired"
  ],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^ritual_[0-9]{3}$",
      "description": "Unique ritual identifier (e.g., ritual_001)"
    },
    "name": {
      "type": "string",
      "description": "English name of the ritual"
    },
    "nameZh": {
      "type": "string",
      "description": "Chinese name of the ritual"
    },
    "type": {
      "type": "string",
      "enum": [
        "western-celestial",
        "western-fire",
        "cleansing",
        "modern-manifestation",
        "healing",
        "eastern",
        "daily-practice",
        "special-purpose"
      ],
      "description": "Primary type/origin of the ritual"
    },
    "category": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "release",
          "manifestation",
          "cleansing",
          "healing",
          "protection",
          "love",
          "abundance",
          "confidence",
          "grounding",
          "emotional",
          "career",
          "home",
          "relationships"
        ]
      },
      "description": "Categories this ritual belongs to (can be multiple)"
    },
    "purpose": {
      "type": "string",
      "description": "Main purpose and benefits of the ritual"
    },
    "difficulty": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5,
      "description": "Difficulty level from 1 (easiest) to 5 (most complex)"
    },
    "timeRequired": {
      "type": "string",
      "description": "Time needed to complete (e.g., '15-20 minutes')"
    },
    "bestTime": {
      "type": "string",
      "description": "Optimal timing for performing the ritual"
    },
    "materials": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "item": {
            "type": "string"
          },
          "optional": {
            "type": "boolean"
          }
        },
        "required": ["item"]
      },
      "description": "List of materials needed"
    },
    "steps": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "stepNumber": {
            "type": "integer"
          },
          "title": {
            "type": "string"
          },
          "instruction": {
            "type": "string"
          }
        },
        "required": ["stepNumber", "instruction"]
      },
      "description": "Step-by-step instructions"
    },
    "affirmations": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Affirmations or mantras to use during the ritual"
    },
    "safetyNotes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": ["warning", "tip"]
          },
          "note": {
            "type": "string"
          }
        },
        "required": ["type", "note"]
      },
      "description": "Safety warnings and helpful tips"
    },
    "scientificExplanation": {
      "type": "string",
      "description": "Evidence-based explanation of why the ritual works"
    },
    "userTestimonials": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "quote": {
            "type": "string"
          },
          "author": {
            "type": "string"
          }
        }
      },
      "description": "Real user experiences and testimonials"
    },
    "sources": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          }
        }
      },
      "description": "Reference sources and links"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Search and filtering tags"
    },
    "culture": {
      "type": "string",
      "enum": ["western", "eastern", "modern", "cross-cultural"],
      "description": "Cultural origin of the ritual"
    },
    "freeTier": {
      "type": "boolean",
      "description": "Whether this ritual is available in free tier"
    },
    "premiumContent": {
      "type": "boolean",
      "description": "Whether this ritual has premium audio/video content"
    },
    "relatedRituals": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^ritual_[0-9]{3}$"
      },
      "description": "IDs of related rituals to recommend"
    },
    "seoKeywords": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "SEO keywords for search optimization"
    },
    "dateCreated": {
      "type": "string",
      "format": "date",
      "description": "Date when ritual was added to database"
    },
    "lastUpdated": {
      "type": "string",
      "format": "date",
      "description": "Date of last update"
    }
  }
}