اعرف ليش مبيعات متجرك تغيّرت

ابدأ بالسؤال: أي جزء من المعادلة تغيّر؟ ثم ابحث عن السبب، لا العكس.

سير العمل

1. اقرأ references/diagnostic-method.md وreferences/source-register.md.
2. ثبّت فترتين قابلتين للمقارنة وتعريف الطلب المكتمل والإيراد الصافي ومصدر كل رقم.
3. افحص اكتمال الأحداث، المنطقة الزمنية، تغير المواسم والمخزون والحملات والقالب.
4. شغّل node scripts/compare-store-periods.mjs <periods.json> لحساب التحويل وقيمة الطلب والفروق وتفكيك Shapley الذي يوزع الأثر المشترك ويجمع إلى فرق الإيراد.
5. فكك التغير إلى: حجم الزيارات، التحويل، قيمة الطلب، الخصم/المسترد الناضج، ثم المساهمة والتشغيل وفق المعادلات المعلنة.
6. لكل تغير مهم، اكتب حقيقة وفرضيتين بديلتين ودليلًا يفصل بينهما.
7. لا تجمع القنوات أو المنتجات إذا كان المتوسط يخفي عكس الاتجاه؛ قسّم فقط عندما يوجد حجم كافٍ ومصدر متسق.
8. سلّم assets/output-template.md بقرار تحليل واحد تالٍ، لا قائمة مشاريع.

الحد الأدنى من المدخلات

• بداية ونهاية كل فترة والمنطقة الزمنية وعدد الأيام.
• الجلسات والطلبات المكتملة وإيراد العناصر قبل الخصم، والخصومات، والمستردات الناضجة للفوج نفسه، وإيراد الشحن والضريبة وعملة التقرير.
• تعريف أساس كل حقل: هل يشمل الشحن أو الضريبة، وكيف عولجت الإلغاءات والمرتجعات.
• تكاليف البضاعة ورسوم الدفع ودعم الشحن والتغليف وبقية التكاليف المتغيرة، أو بيان أنها غير متاحة.
• فوج الطلبات ونهاية نافذة القياس وعدد أيام نضج المستردات.
• measurement_end لكل فترة، بحيث يكون الفاصل عن cohort_end مساويًا على الأقل لنافذة نضج المستردات.
• المخزون ونسبة الإلغاء/المرتجع وتأخير التنفيذ.
• الحملات والقنوات والتغييرات الكبيرة مع تواريخها.
• تعريفات القياس ومصدر كل رقم.

قواعد القرار

• لا تقارن فترتين مختلفتي الطول دون تطبيع وشرح.
• لا تعتبر ارتفاع الإيراد تحسنًا إذا هبطت المساهمة أو زادت المرتجعات/التأخيرات.
• لا تفسر متوسط قيمة الطلب وحده؛ قد يتغير بسبب مزيج المنتجات أو الخصم.
• لا تنسب الأثر لحملة من التزامن؛ يلزم إسناد أو تجربة أو دليل إضافي.
• إذا تغير تعريف حدث أو مصدر بيانات، علّم المقارنة غير صالحة قبل تحليلها.
• لا تستخدم كلمة «ربح» عند غياب التكاليف الثابتة؛ استخدم مساهمة أو إيراد صافي حسب المتاح.
• لا تقل «تحسن الأداء» إذا كان المتاح اتجاهات أو مؤشرات بلا قيم مطلقة وتعريفات وفترات قابلة للمقارنة؛ قل «غير كافٍ للحكم».
• لا تقارن المستردات لفوج حديث قبل نضج نافذته بفوج أقدم، ولا تجمع عملات مختلفة بلا تحويل موثق.
• لا تقارن مصدرين أو نافذتي نضج مختلفتين قبل مصالحة موثقة؛ المدقق يرفضهما افتراضيًا.
• غياب التكاليف المتغيرة لا يعني صفرًا. اجعلها null مع variable_costs_status: unavailable، وعندها تكون المساهمة غير قابلة للحساب.
• الإيراد الصافي التشغيلي في هذا البرومبت = إيراد العناصر قبل الخصم − الخصومات − المستردات الناضجة + إيراد الشحن، مع استبعاد الضريبة المحصلة لحساب جهة أخرى. المساهمة = الصافي التشغيلي − التكاليف المتغيرة المحددة أعلاه.
• لا تحوّل موضع فقد القمع إلى سبب تحسين؛ يحتاج فرضية ودليلًا فاصلًا.
• لا تعرض شرائح صغيرة كحقيقة مستقرة. استخدم حدًا أدنى معتمدًا من مالك التحليل أو اعرض الشريحة «استكشافية/غير مستقرة» مع الأعداد وعدم اليقين.

عقد المخرجات

1. صلاحية المقارنة والفجوات.
2. بطاقة المقاييس للفترتين والفروق المطلقة والنسبية ومصدر كل رقم وتعريفه.
3. شجرة تفسير: زيارات × تحويل × قيمة طلب مع توزيع أثر يجمع إلى الفرق، ثم الخصومات/المستردات الناضجة/المساهمة.
4. الوقائع المؤكدة.
5. الفرضيات البديلة والدليل الفاصل لكل منها.
6. الشرائح أو المنتجات التي تفسر التغير إن أمكن.
7. قرار التحليل التالي ومالكه وموعده.

مثال

راجع examples/example-request.md وexamples/example-output.md.