{
  "metadata": {
    "system": "SHEIKHA Market & Supply Chain Digital Twin",
    "version": "1.0",
    "purpose": "نمذجة شاملة للأسواق وسلاسل الإمداد والتوريد برقمنة إسلامية",
    "islamic_foundation": "رقمنة الكتاب والسنة - العدل، الأمانة، الشفافية، التوثيق الكامل",
    "markets": ["السعودية", "الأسواق الدولية", "التصنيفات التنظيمية"],
    "last_updated": "2026-07-08"
  },

  "hs_codes_classification": {
    "description": "تصنيف المنتجات حسب الأرقام الجمركية الدولية",
    "sections": {
      "chapter_01_27": {
        "name": "المعادن والموارد الطبيعية",
        "codes": [
          {
            "code": "2601",
            "description": "خام الحديد والتركيزات",
            "subcategories": ["خام أحمر", "خام مغناطيسي", "خام محسّن"],
            "origin_locations": ["مناجم", "محاجر", "مصاهر"]
          },
          {
            "code": "2603",
            "description": "خام النحاس والتركيزات",
            "subcategories": ["نحاس خام", "تركيزات نحاسية", "نحاس مصهور"],
            "origin_locations": ["مناجم", "مصاهر"]
          },
          {
            "code": "2604",
            "description": "خام الفضة والذهب والمعادن الثمينة",
            "subcategories": ["ذهب خام", "فضة خام", "معادن نادرة"],
            "origin_locations": ["مناجم", "مصاهر متخصصة", "مراكز معالجة"]
          },
          {
            "code": "2606",
            "description": "خام الألمنيوم والتركيزات",
            "subcategories": ["بوكسيت", "ألمنيوم مصهور", "تركيزات"]
          }
        ]
      },
      "chapter_72_83": {
        "name": "المعادن وسبائكها المصنعة",
        "codes": [
          {
            "code": "7207",
            "description": "حديد مصهور ومنتجات حديدية",
            "subcategories": ["حديد ملفوف", "حديد مسطح", "أنابيب حديدية"],
            "processing_stages": ["صهر أولي", "معالجة حرارية", "تشكيل", "تنهية"]
          },
          {
            "code": "7408",
            "description": "نحاس مصنع ومشغول",
            "subcategories": ["أسلاك نحاسية", "ألواح نحاسية", "أنابيب نحاسية"]
          },
          {
            "code": "7610",
            "description": "منتجات ألمنيوم",
            "subcategories": ["الألمنيوم الملفوف", "الهياكل الألمنيومية", "الأنابيب"]
          }
        ]
      }
    }
  },

  "supply_chain_nodes": {
    "description": "نقاط ومراحل سلسلة الإمداد والتوريد الكاملة",
    "primary_sources": {
      "mining_sites": {
        "type": "مواقع التعدين",
        "description": "المصادر الأولية للمواد الخام",
        "attributes": [
          "الموقع الجغرافي",
          "نوع المعدن أو المورد",
          "الطاقة الإنتاجية الشهرية",
          "معايير الجودة",
          "التصريحات البيئية والقانونية"
        ],
        "islamic_requirements": [
          "الاستخراج الأخلاقي دون إفساد",
          "توثيق كامل للموارد المستخرجة",
          "العدل في توزيع الثروة المستخرجة",
          "حماية البيئة والأرض"
        ],
        "examples": [
          {
            "id": "MINE-SA-001",
            "name": "منجم ذهب الرياض",
            "location": "الرياض، السعودية",
            "primary_resources": ["ذهب", "فضة", "نحاس"],
            "monthly_capacity_kg": 50000,
            "certifications": ["ISO 14001", "OHSAS 18001"]
          }
        ]
      },
      "smelter_refineries": {
        "type": "المصاهر والمصافي",
        "description": "مرافق معالجة وتصهير الخام الأولي",
        "attributes": [
          "الموقع الجغرافي",
          "أنواع المعالجة المدعومة",
          "درجة النقاء المحققة",
          "الطاقة الإنتاجية",
          "شهادات الجودة"
        ],
        "islamic_requirements": [
          "شفافية كاملة في عمليات التصهير",
          "معايير بيئية عالية",
          "توثيق كل دفعة معالجة",
          "الأمانة في المقاييس والأوزان"
        ],
        "examples": [
          {
            "id": "SMELT-SA-001",
            "name": "مصهر النعيم للمعادن",
            "location": "جدة، السعودية",
            "processing_types": ["صهر أساسي", "تحسين نقاء", "تشكيل أولي"],
            "purity_levels": ["99.5%", "99.9%", "99.99%"],
            "capacity_monthly_kg": 100000
          }
        ]
      },
      "factories_manufacturing": {
        "type": "المصانع والتصنيع",
        "description": "مرافق تصنيع المنتجات النهائية",
        "attributes": [
          "نوع المنتج",
          "الطاقة الإنتاجية",
          "معايير الجودة",
          "التخصصات الصناعية",
          "الشهادات الدولية"
        ],
        "islamic_requirements": [
          "جودة عالية وثقة في الإنتاج",
          "معاملة عادلة للعمال",
          "توثيق شامل لكل مرحلة إنتاج",
          "البراءة من الغش والتدليس"
        ]
      }
    },
    "distribution_network": {
      "warehouses": {
        "type": "مستودعات التخزين",
        "description": "مرافق تخزين المنتجات",
        "attributes": [
          "الموقع الاستراتيجي",
          "السعة التخزينية",
          "أنظمة التحكم في المناخ",
          "نظام التتبع الرقمي",
          "نوع المنتجات المخزنة"
        ],
        "islamic_requirements": [
          "الحفظ الأمين للسلع",
          "توثيق دقيق للمخزون",
          "منع الهدر والتلف",
          "العدل في التوزيع والتخصيص"
        ]
      },
      "distribution_centers": {
        "type": "مراكز التوزيع",
        "description": "نقاط توزيع إقليمية ودولية",
        "attributes": [
          "الموقع الجغرافي",
          "الأسواق المخدومة",
          "السعة التوزيعية",
          "وسائل النقل المستخدمة",
          "أوقات الاستجابة"
        ]
      },
      "logistics_partners": {
        "type": "شركاء اللوجستيات",
        "description": "شركات النقل والشحن والتوزيع",
        "attributes": [
          "نوع الخدمة",
          "الأسواق المغطاة",
          "وسائل النقل",
          "سياسات التتبع",
          "معايير الأمان"
        ]
      }
    },
    "end_customer_nodes": {
      "online_platforms": {
        "type": "المنصات الإلكترونية",
        "description": "متاجر إلكترونية وأسواق رقمية",
        "attributes": [
          "رابط المتجر",
          "فئات المنتجات",
          "حجم المبيعات الشهري",
          "قاعدة العملاء",
          "معايير الخدمة"
        ]
      },
      "physical_stores": {
        "type": "المتاجر الفيزيائية",
        "description": "متاجر تجزئة فيزيائية",
        "attributes": [
          "الموقع",
          "مساحة المتجر",
          "فئات المنتجات",
          "حجم المخزون",
          "العاملين"
        ]
      },
      "b2b_customers": {
        "type": "عملاء B2B",
        "description": "شركات وموردون آخرون",
        "attributes": [
          "نوع الشركة",
          "حجم الطلبات",
          "شروط الدفع",
          "العلاقة التجارية",
          "الاتفاقيات"
        ]
      },
      "individual_customers": {
        "type": "المستهلكون الأفراد",
        "description": "العملاء الأفراد",
        "attributes": [
          "موقع السكن",
          "نوع الشراء",
          "تفضيلات المنتج",
          "سجل الشراء",
          "درجة الرضا"
        ]
      }
    }
  },

  "market_segmentation": {
    "saudi_market": {
      "code": "SA",
      "name": "السوق السعودية",
      "regions": [
        {
          "code": "RD",
          "name": "منطقة الرياض",
          "cities": ["الرياض"],
          "population": 7000000,
          "market_size": "كبير جداً",
          "primary_sectors": ["معادن", "مواد بناء", "سلاسل توريد"]
        },
        {
          "code": "WC",
          "name": "المنطقة الغربية",
          "cities": ["جدة", "مكة", "المدينة"],
          "population": 5000000,
          "market_size": "كبير"
        },
        {
          "code": "EP",
          "name": "المنطقة الشرقية",
          "cities": ["الدمام", "الخبر", "القطيف"],
          "population": 3500000,
          "market_size": "متوسط-كبير"
        }
      ],
      "regulatory_body": "وزارة التجارة والاستثمار السعودية",
      "islamic_principles_applied": "الشريعة الإسلامية السعودية"
    },
    "international_markets": {
      "description": "الأسواق الدولية والعالمية",
      "regions": [
        {
          "code": "MENA",
          "name": "منطقة الشرق الأوسط وشمال أفريقيا",
          "countries": ["الإمارات", "الكويت", "قطر", "البحرين", "عمان", "مصر", "المغرب"],
          "market_characteristics": "نمو اقتصادي، زيادة الاستهلاك، تكامل إقليمي"
        },
        {
          "code": "ASIA",
          "name": "آسيا",
          "countries": ["الهند", "باكستان", "بنغلاديش", "إندونيسيا", "ماليزيا"],
          "market_characteristics": "أسواق كبيرة، قوة شرائية عالية، طلب متزايد"
        },
        {
          "code": "EUROPE",
          "name": "أوروبا",
          "countries": ["ألمانيا", "بريطانيا", "فرنسا", "إيطاليا"],
          "market_characteristics": "معايير جودة عالية، تنظيم صارم، أسعار متنافسة"
        }
      ]
    },
    "regulatory_classifications": {
      "description": "التصنيفات التنظيمية والقانونية",
      "categories": [
        {
          "code": "REG-01",
          "name": "موارد استراتيجية",
          "description": "موارد تخضع للتحكم الحكومي",
          "regulations": "تصاريح حكومية، حد أدنى للملكية المحلية، إبلاغ دوري"
        },
        {
          "code": "REG-02",
          "name": "موارد عامة",
          "description": "موارد متاحة للتجارة العامة",
          "regulations": "تراخيص عامة، معايير جودة، ضرائب مستقرة"
        },
        {
          "code": "REG-03",
          "name": "موارد مقيدة",
          "description": "موارد محمية أو محدودة",
          "regulations": "حصص محددة، متطلبات بيئية صارمة، موافقات خاصة"
        }
      ]
    }
  },

  "customer_environment_modeling": {
    "description": "نمذجة بيئة العميل من المصدر إلى الاستهلاك",
    "source_types": {
      "mining_source": {
        "type": "منجم",
        "characteristics": ["موقع جغرافي، طاقة استخراج، نوع معدن، تصاريح بيئية"],
        "digital_identity": "SOURCE-MINE-{REGION}-{SERIAL}"
      },
      "smelter_source": {
        "type": "مصهر",
        "characteristics": ["موقع، معالجة، نقاء، شهادات"],
        "digital_identity": "SOURCE-SMELT-{CITY}-{SERIAL}"
      },
      "factory_source": {
        "type": "مصنع",
        "characteristics": ["تخصص، إنتاجية، جودة، موظفون"],
        "digital_identity": "SOURCE-FACTORY-{TYPE}-{SERIAL}"
      },
      "online_source": {
        "type": "موقع إلكتروني",
        "characteristics": ["منصة، نوع منتج، حجم مبيعات، سمعة"],
        "digital_identity": "SOURCE-ONLINE-{PLATFORM}-{SERIAL}"
      },
      "company_source": {
        "type": "شركة",
        "characteristics": ["حجم، تخصص، موقع، سجل تجاري"],
        "digital_identity": "SOURCE-COMPANY-{NAME}-{SERIAL}"
      },
      "transport_source": {
        "type": "نقل",
        "characteristics": ["نوع نقل، أسطول، مسارات، سعات"],
        "digital_identity": "SOURCE-TRANSPORT-{TYPE}-{SERIAL}"
      }
    },
    "product_classification": {
      "attributes": [
        {
          "name": "الرقم الجمركي (HS Code)",
          "format": "4-10 أرقام",
          "example": "260100"
        },
        {
          "name": "التصنيف الداخلي",
          "format": "CAT-{TYPE}-{SUBTYPE}-{VARIANT}",
          "example": "CAT-METAL-PRECIOUS-GOLD"
        },
        {
          "name": "الرقم التسلسلي",
          "format": "PROD-{SOURCE}-{DATE}-{SEQUENCE}",
          "example": "PROD-MINE-20260708-001"
        }
      ]
    }
  },

  "supply_chain_traceability": {
    "description": "نظام التتبع والمراقبة الكاملة",
    "tracking_stages": [
      {
        "stage_id": "STAGE-01",
        "name": "المصدر والاستخراج",
        "records": ["الموقع، الكمية، التاريخ، التصاريح، الجودة الأولية"]
      },
      {
        "stage_id": "STAGE-02",
        "name": "المعالجة والتصهير",
        "records": ["مرفق المعالجة، درجة النقاء، الخسائر، الوقت، التكاليف"]
      },
      {
        "stage_id": "STAGE-03",
        "name": "التصنيع",
        "records": ["المصنع، نوع المنتج، الكمية، الجودة، المواصفات"]
      },
      {
        "stage_id": "STAGE-04",
        "name": "التخزين والتوزيع",
        "records": ["المستودع، المدة، الشروط، المسؤول، التحديثات"]
      },
      {
        "stage_id": "STAGE-05",
        "name": "النقل واللوجستيات",
        "records": ["الشركة، المسار، المدة، الحالة، التأمين"]
      },
      {
        "stage_id": "STAGE-06",
        "name": "التسليم والاستقبال",
        "records": ["المتلقي، المكان، التاريخ، الحالة، التوقيع"]
      }
    ],
    "islamic_documentation": {
      "principles": [
        "العدل والشفافية الكاملة في كل مرحلة",
        "الأمانة والحفاظ على جودة المنتج",
        "توثيق شامل يمنع الغش والتدليس",
        "حماية حقوق جميع الأطراف",
        "المسؤولية والمحاسبية في كل مرحلة"
      ],
      "required_documentation": [
        "شهادة المصدر والاستخراج",
        "شهادة المعالجة والنقاء",
        "شهادة الجودة",
        "وثائق النقل الآمنة",
        "توقيع المسؤولين بالأمانة"
      ]
    }
  },

  "islamic_digitization_framework": {
    "description": "رقمنة النظام بالكتاب والسنة",
    "quranic_principles": [
      {
        "reference": "سورة المائدة: 5",
        "principle": "الوفاء بالعقود والأمانات",
        "application": "توثيق شامل للعقود والاتفاقيات بين جميع الأطراف"
      },
      {
        "reference": "سورة النحل: 90",
        "principle": "العدل والإحسان",
        "application": "توزيع عادل للأرباح والموارد، معاملة حسنة لجميع الأطراف"
      },
      {
        "reference": "سورة المطففين: 1-3",
        "principle": "الوزن والكيل بالعدل",
        "application": "دقة قياس المنتجات والأوزان بأدوات معايرة موثوقة"
      },
      {
        "reference": "سورة البقرة: 283",
        "principle": "الشهادة والتوثيق",
        "application": "شهود موثوقين في العمليات الحساسة"
      }
    ],
    "sunnah_principles": [
      {
        "reference": "حديث الكيل والوزن",
        "principle": "الدقة والأمانة في المعاملات",
        "application": "استخدام تقنيات قياس عالية الدقة"
      },
      {
        "reference": "حديث التاجر الأمين",
        "principle": "الصدق والأمانة في التجارة",
        "application": "تدريب العاملين على الصدق والأمانة"
      },
      {
        "reference": "حديث الرقم واللوحة",
        "principle": "التنظيم والتوثيق",
        "application": "نظام رقمي منظم يوثق كل شيء"
      }
    ],
    "implementation_standards": [
      "شفافية كاملة في جميع العمليات",
      "عدم إخفاء أي معلومات أساسية",
      "الأمانة في التخزين والنقل",
      "العدل في التسعير والتوزيع",
      "الحفاظ على البيئة والموارد الطبيعية",
      "حماية حقوق العمال والموظفين",
      "منع الغش والتدليس والاحتيال",
      "المساءلة والمحاسبية الكاملة"
    ]
  },

  "market_integration_matrix": {
    "description": "مصفوفة تكامل الأسواق المختلفة",
    "saudi_local_integration": {
      "source_to_customer": "منجم السعودية → مصهر السعودية → متجر سعودي → عميل سعودي",
      "regulations": "تنظيم كامل من وزارة التجارة",
      "taxation": "ضرائب محلية موحدة",
      "documentation": "توثيق محلي كامل"
    },
    "saudi_to_regional": {
      "source_to_customer": "منجم السعودية → مصهر السعودية → موزع إقليمي → أسواق الخليج",
      "regulations": "اتفاقيات تجارية خليجية",
      "taxation": "ضرائب جمركية",
      "documentation": "وثائق شحن دولية"
    },
    "saudi_to_international": {
      "source_to_customer": "منجم السعودية → مصهر السعودية → شركة شحن دولية → أسواق عالمية",
      "regulations": "معايير دولية (ISO, HS Codes)",
      "taxation": "رسوم جمركية دولية",
      "documentation": "وثائق شحن بحرية/جوية/برية"
    }
  },

  "statistics_and_metrics": {
    "description": "نظام الإحصاءات والمقاييس الشامل",
    "key_metrics": [
      {
        "metric": "إجمالي الإنتاج الشهري",
        "unit": "كيلوجرام",
        "tracking": "تلقائي من كل مصدر"
      },
      {
        "metric": "معدل الجودة",
        "unit": "نسبة مئوية",
        "tracking": "من كل مرحلة معالجة"
      },
      {
        "metric": "سرعة الدوران",
        "unit": "أيام",
        "tracking": "من الاستخراج إلى التسليم"
      },
      {
        "metric": "معدل الرضا",
        "unit": "نسبة مئوية",
        "tracking": "من استطلاعات العملاء"
      },
      {
        "metric": "الخسائر والهدر",
        "unit": "نسبة مئوية",
        "tracking": "في كل مرحلة"
      }
    ]
  }
}