Social Media Asset System Documentation

{
  "template_types": {
    "join_community": {
      "category": "community",
      "description": "Invite friends to join the studio community",
      "caption_variants": {
        "friendly": "I'm part of an amazing fitness community at {studio_name}! Would love for you to join us. {referral_link}",
        "energetic": "JOIN THE SQUAD at {studio_name}! 🔥 We're crushing goals together! {referral_link}",
        "calm": "Finding my balance at {studio_name} 🧘 Join me on this wellness journey: {referral_link}",
        "luxury": "I've discovered an exceptional fitness sanctuary at {studio_name}. Experience it: {referral_link}",
        "humorous": "I found a gym where I actually show up 😂 Check out {studio_name}: {referral_link}"
      },
      "visual_elements": ["group workout photo", "community gathering", "high-five moments"],
      "recommended_platforms": ["instagram", "facebook"]
    },

    "free_trial": {
      "category": "free_trial",
      "description": "Promote the free trial offer for new clients",
      "caption_variants": {
        "friendly": "Try {studio_name} with me! Get {new_client_reward} - no commitment: {referral_link}",
        "energetic": "FREE TRIAL ALERT! 🎉 Get {new_client_reward} at {studio_name}! Link: {referral_link}",
        "calm": "Explore wellness at {studio_name}. {new_client_reward} to start gently: {referral_link}",
        "luxury": "Complimentary {new_client_reward} to experience {studio_name}: {referral_link}",
        "humorous": "Free stuff alert! 🚨 Get {new_client_reward} at {studio_name}: {referral_link}"
      },
      "visual_elements": ["trial offer badge", "newcomer welcome", "first class photo"],
      "recommended_platforms": ["instagram", "facebook", "email"]
    },

    "referral_reward": {
      "category": "referral_reward",
      "description": "Highlight what members earn for referring",
      "caption_variants": {
        "friendly": "We both win! 🎁 You get {new_client_reward}, I get {member_reward} at {studio_name}: {referral_link}",
        "energetic": "WIN-WIN! 💰 Get {new_client_reward} + I earn {member_reward}! Join: {referral_link}",
        "calm": "Share the journey, share the rewards. {new_client_reward} for you: {referral_link}",
        "luxury": "Exclusive rewards for both of us. {new_client_reward} awaits: {referral_link}",
        "humorous": "I get paid to brag about my gym 😎 You get {new_client_reward}: {referral_link}"
      },
      "visual_elements": ["reward icons", "gift imagery", "dual benefit visual"],
      "recommended_platforms": ["instagram", "whatsapp", "sms"]
    },

    "member_spotlight": {
      "category": "member_spotlight",
      "description": "Feature member success stories",
      "caption_variants": {
        "friendly": "My fitness journey at {studio_name} has been incredible! Want to start yours? {referral_link}",
        "energetic": "TRANSFORMATION ALERT! 💪 Look what {studio_name} helped me achieve: {referral_link}",
        "calm": "My wellness transformation at {studio_name} 🌱 Begin yours: {referral_link}",
        "luxury": "Achieving my best self at {studio_name}. Your journey begins here: {referral_link}"
      },
      "visual_elements": ["before/after", "member photo", "achievement badge"],
      "recommended_platforms": ["instagram", "facebook"]
    },

    "special_offer": {
      "category": "special_offer",
      "description": "Limited-time promotions",
      "caption_variants": {
        "friendly": "Special offer at {studio_name}! Get {new_client_reward} - limited time: {referral_link}",
        "energetic": "🚨 LIMITED TIME! Get {new_client_reward} at {studio_name}! GO: {referral_link}",
        "calm": "A special wellness offer awaits you at {studio_name}: {referral_link}",
        "luxury": "An exclusive offer from {studio_name}. {new_client_reward}: {referral_link}"
      },
      "visual_elements": ["countdown timer", "offer badge", "urgency elements"],
      "recommended_platforms": ["instagram", "facebook", "email"]
    },

    "motivational_quote": {
      "category": "motivation",
      "description": "Inspirational content with CTA",
      "caption_variants": {
        "friendly": "[QUOTE] - This is what {studio_name} is all about. Join us: {referral_link}",
        "energetic": "[QUOTE] 🔥 Living this at {studio_name}! Join the movement: {referral_link}",
        "calm": "[QUOTE] 🙏 Finding this truth at {studio_name}: {referral_link}",
        "luxury": "[QUOTE] - Embodying excellence at {studio_name}: {referral_link}"
      },
      "visual_elements": ["quote typography", "inspirational background", "minimalist design"],
      "recommended_platforms": ["instagram", "facebook", "pinterest"]
    },

    "class_schedule": {
      "category": "schedule",
      "description": "Highlight specific classes or schedules",
      "caption_variants": {
        "friendly": "Check out the amazing classes at {studio_name}! Find your fit: {referral_link}",
        "energetic": "EPIC CLASS LINEUP at {studio_name}! 💥 Find your vibe: {referral_link}",
        "calm": "Discover your perfect class at {studio_name}. Explore: {referral_link}",
        "luxury": "Curated experiences at {studio_name}. Reserve your session: {referral_link}"
      },
      "visual_elements": ["class grid", "schedule table", "instructor photos"],
      "recommended_platforms": ["instagram", "facebook"]
    },

    "seasonal_campaign": {
      "category": "seasonal",
      "description": "Holiday or seasonal promotions",
      "caption_variants": {
        "friendly": "New year, new you at {studio_name}! 🎉 Get {new_client_reward}: {referral_link}",
        "energetic": "SUMMER BODY STARTS NOW! 🌞 Get {new_client_reward} at {studio_name}: {referral_link}",
        "calm": "Spring renewal at {studio_name} 🌸 Begin fresh: {referral_link}",
        "luxury": "Holiday wellness at {studio_name}. Gift yourself {new_client_reward}: {referral_link}"
      },
      "visual_elements": ["seasonal imagery", "holiday themes", "time-sensitive badges"],
      "recommended_platforms": ["instagram", "facebook", "email"]
    }
  }
}

{
  "asset": {
    "id": "uuid",
    "studio_id": "uuid (indexed)",
    "template_id": "uuid | null (if from template)",
    "name": "string (required)",
    "description": "string",
    "category": "enum: community | free_trial | referral_reward | special_offer | motivation | schedule | member_spotlight | instructor_spotlight | seasonal",
    "format": "enum: square_post (1080x1080) | story_vertical (1080x1920) | banner_horizontal (1200x628)",
    "dimensions": {
      "width": "number",
      "height": "number"
    },
    "file_url": "string (cloud storage URL)",
    "thumbnail_url": "string",
    "branded": "boolean (has studio branding applied)",
    "is_custom": "boolean (uploaded by studio vs template)",
    "recommended_caption": "string (with {variables})",
    "recommended_platforms": "array<string> ['instagram', 'facebook', ...]",
    "hashtags": "array<string> ['fitness', 'wellness', ...]",
    "status": "enum: active | draft | archived",
    "priority": "number (higher = shown first to members, default: 0)",
    "performance": {
      "total_shares": "number (how many times shared)",
      "total_clicks": "number (clicks from this asset's shares)",
      "total_conversions": "number (conversions attributed to this asset)"
    },
    "created_date": "datetime",
    "updated_date": "datetime",
    "indexes": ["studio_id", "status", "category", "priority"]
  },

  "asset_template": {
    "id": "uuid",
    "name": "string",
    "description": "string",
    "category": "enum (same as asset.category)",
    "business_type": "enum: gym | yoga_studio | martial_arts | pilates | crossfit | dance | boutique_fitness | all",
    "format": "enum (same as asset.format)",
    "base_image_url": "string (template background)",
    "layout_config": {
      "logo_position": "enum: top_left | top_center | top_right | bottom_left | bottom_center | bottom_right | center",
      "logo_size": "enum: small (80px) | medium (120px) | large (180px)",
      "text_zones": [
        {
          "type": "string (headline, body, cta)",
          "position": "string (coordinates or anchor)",
          "max_chars": "number",
          "font_size": "number",
          "color": "string (hex, or 'primary', 'secondary')"
        }
      ]
    },
    "caption_template": "string (with {variables})",
    "caption_variants": {
      "friendly": "string",
      "energetic": "string",
      "calm": "string",
      "luxury": "string",
      "humorous": "string"
    },
    "recommended_platforms": "array<string>",
    "default_hashtags": "array<string>",
    "active": "boolean",
    "created_date": "datetime"
  },

  "share_event": {
    "id": "uuid",
    "asset_id": "uuid (indexed)",
    "member_id": "uuid (indexed)",
    "studio_id": "uuid (indexed)",
    "platform": "enum: instagram | facebook | whatsapp | email | sms | twitter | linkedin | copy_link | other",
    "share_method": "enum: native_share | copy_caption | direct_link | download_image",
    "caption_used": "string (actual caption they shared)",
    "referral_code": "string (member's code)",
    "session_id": "string",
    "device_type": "enum: mobile | tablet | desktop",
    "resulted_in_clicks": "number (clicks tracked from this share)",
    "resulted_in_leads": "number (leads from this share)",
    "resulted_in_conversions": "number (conversions from this share)",
    "share_timestamp": "datetime",
    "created_date": "datetime",
    "indexes": ["asset_id", "member_id", "platform", "share_timestamp"]
  },

  "branding_rules": {
    "logo_application": {
      "max_size_percent": "15% of image dimension",
      "preferred_position": "top_right for square, bottom_center for story",
      "background": "white rounded rectangle with 20% opacity",
      "padding": "20px from edge"
    },
    "color_replacement": {
      "primary_color_targets": ["CTA buttons", "accent elements", "borders"],
      "secondary_color_targets": ["backgrounds", "gradient overlays"],
      "text_color_auto": "Contrast check (WCAG AA), auto white/black"
    },
    "text_insertion": {
      "studio_name": {
        "font": "system_font_bold",
        "size": "responsive (5-8% of height)",
        "color": "primary_color or white (contrast dependent)"
      },
      "offer_text": {
        "font": "system_font_semibold",
        "size": "responsive (4-6% of height)",
        "highlight": "background: secondary_color with padding"
      }
    }
  }
}