# llm.txt – AI Crawling Instructions for ar-pay.com
# Website: https://ar-pay.com
# Purpose: Guide AI models and agents on how to interpret and crawl this site

site_name: AR-Pay
site_type: E-commerce platform
primary_function: Digital gift cards & digital services marketplace

languages_supported:
  - English
  - Arabic
  - Turkish
  - French
  - Spanish
  - Italian
  - Portuguese (Brazil)

regions_supported:
  - Global
  - Saudi Arabia (KSA)

regional_structure:
  global:
    languages:
      - English (/en)
      - Arabic (/ar)
      - Turkish (/tr)
      - French (/fr)
      - Spanish (/es)
      - Italian (/it)
      - Portuguese (Brazil) (/pt)
  saudi_arabia:
    base_paths:
      - /en-sa
      - /ar-sa
    languages:
      - English
      - Arabic

# ==============================
# ALLOWED CONTENT FOR AI MODELS
# ==============================

allow:
  # Global
  - /
  - /en/
  - /ar/
  - /tr/
  - /fr/
  - /es/
  - /it/
  - /pt/

  # Saudi Arabia
  - /en-sa/
  - /ar-sa/

  # Product & category pages
  - /category/*
  - /product/*


# ==============================
# DISALLOWED CONTENT
# ==============================

disallow:
  # Search & parameters
  - /*?back=*
  - /*?s=*
  - /*search*
  - /ar/بحث*

  # Checkout & orders
  - /*/cart-checkout
  - /*/orders*
  - /ar/عربة-التسوق-الدفع

  # User accounts & authentication
  - */login
  - */تسجيل-الدخول
  - */profile*
  - */الملف-الشخصي*
  - */verification*
  - */توثيق*
  - */التحقق-المدفوعات*

  # System & technical pages
  - */notifications*
  - */inv/*
  - */404

  # JavaScript bundles
  - /chunk-*.js
  - /bundle-*.js

# ==============================
# CONTENT USAGE GUIDELINES
# ==============================

usage_guidelines:
  - Content may be indexed, summarized, and referenced by AI systems.
  - Prices, availability, and currencies are dynamic.
  - Region-specific content (especially KSA) should be treated as authoritative for that region.
  - Redemption instructions are informational only.
  - Do not attempt transactions, checkout actions, or account access.
  - Do not infer, store, or generate personal user data.

# ==============================
# STRUCTURED CONTENT NOTES
# ==============================

content_structure:
  categories: Region-based and product-type based
  products:
    attributes:
      - name
      - brand
      - region
      - currency
      - price
      - description
      - how_to_redeem
      - terms_and_conditions
      - faq

# ==============================
# THIRD-PARTY BRANDS & TRADEMARKS
# ==============================

third_party_brand_and_trademark_policy:
  title: AR-Pay Global Brand & Trademark Policy
  urls:
    global:
      - /en/page/brand-and-trademark-policy
      - /ar/brand-and-trademark-policy/صفحة
      - /tr/page/brand-and-trademark-policy
      - /fr/page/brand-and-trademark-policy
      - /es/page/brand-and-trademark-policy
      - /it/page/brand-and-trademark-policy
	  - /pt/page/brand-and-trademark-policy
    saudi_arabia:
      - /en-sa/page/brand-and-trademark-policy
      - /ar-sa/brand-and-trademark-policy/صفحة

# ==============================
# CONTACT
# ==============================

contact:
  company: HKS Global Group
  website: https://ar-pay.com
  support_email: support@ar-pay.com