أتمتة التقارير اليومية والأسبوعية بكلود AI — وفّر 10 ساعات أسبوعياً

// البرومبت لكلود:
"أنت محلل مبيعات خبير. حلّل بيانات المبيعات اليومية:

البيانات:
- إجمالي المبيعات اليوم: ${todaySales} ريال
- إجمالي المبيعات أمس: ${yesterdaySales} ريال
- هدف اليوم: ${dailyTarget} ريال
- هدف الشهر: ${monthlyTarget} ريال
- مبيعات الشهر حتى اليوم: ${mtdSales} ريال
- أداء المندوبين:
  ${salesRepData}
- أفضل 5 منتجات اليوم:
  ${topProducts}
- عدد الصفقات المغلقة: ${dealsCount}
- أكبر صفقة اليوم: ${biggestDeal}

اكتب تقريراً بالعربي يشمل:
1. ملخص تنفيذي (3 جمل — مناسب للمدير المشغول)
2. تحليل الأداء (مقارنة بالأمس وبالهدف)
3. أبرز الإنجازات والتحديات
4. توصية واحدة عملية للغد
5. تنبيه إذا كانت المبيعات أقل من 85% من الهدف

اللغة: عربية مباشرة ومهنية. لا حشو. الأرقام مُنسَّقة."

// Python Script لجمع البيانات وإرسال التقرير:
"اكتب Python Script يعمل كل يوم الساعة 6 مساءً:

1. يجلب بيانات المبيعات من Google Sheets:
   - Sheet: 'Daily Sales'
   - يقرأ صف اليوم فقط (بالتاريخ)
   - يجمع بيانات المندوبين من Sheet 'Sales Reps'

2. يُرسل البيانات لـ Claude API مع البرومبت أعلاه

3. يُرسل التقرير:
   - بريد إلكتروني: للمدير ومدير المبيعات
   - واتساب: ملخص 3 جمل فقط لجوال المدير
   - Slack: للقناة #sales-daily

4. يُحفظ التقرير في Google Sheets في Sheet 'Reports Archive'
   مع التاريخ والنص الكامل"

// البرومبت لكلود:
"أنت مدير تسويق خبير. حلّل أداء التسويق الأسبوعي:

البيانات:
Google Analytics:
- زيارات الموقع هذا الأسبوع: ${visits}
- مقارنة بالأسبوع الماضي: ${visitsTrend}%
- معدل التحويل: ${conversionRate}%
- أعلى صفحات الزيارة: ${topPages}

Social Media:
- Instagram: ${igReach} وصول، ${igEngagement} تفاعل
- LinkedIn: ${liImpressions} مشاهدة، ${liClicks} نقرة
- Twitter/X: ${xMentions} ذكر، ${xFollowers} متابع

Paid Ads:
- Google Ads: ${adSpend} ريال إنفاق، ${adLeads} عميل محتمل
- تكلفة الاقتناء: ${cpa} ريال/عميل
- أفضل أداء: ${bestAd}

Email Marketing:
- معدل الفتح: ${openRate}%
- معدل النقر: ${clickRate}%
- إلغاء الاشتراك: ${unsubscribes}

اكتب تقرير أسبوعي يشمل:
1. ملخص الأداء العام (ممتاز/جيد/يحتاج تحسين + سبب)
2. أبرز نجاحات الأسبوع
3. أكثر 3 مشاكل تستحق المعالجة
4. 3 توصيات للأسبوع القادم بأولويات واضحة
5. ما يجب مضاعفته وما يجب إيقافه"

// البرومبت لكلود:
"أنت محلل مالي خبير. حلّل البيانات المالية الشهرية:

بيانات الإيرادات:
- إجمالي الإيرادات: ${revenue} ريال
- الهدف الشهري: ${target} ريال
- نسبة التحقيق: ${achievementPct}%
- مقارنة بنفس الشهر السنة الماضية: ${yoyGrowth}%

بيانات المصاريف:
- إجمالي المصاريف: ${expenses} ريال
- الميزانية: ${budget} ريال
- أكثر 3 بنود صرفاً: ${topExpenses}

الربحية:
- الربح الإجمالي: ${grossProfit} ريال
- هامش الربح: ${profitMargin}%

التدفق النقدي:
- نقد في البنك: ${cashBalance} ريال
- فواتير مستحقة (لم تُحصَّل): ${receivables} ريال
- مستحقات للموردين: ${payables} ريال

اكتب تقريراً مالياً شهرياً يشمل:
1. ملخص الصحة المالية (3 مؤشرات رئيسية مع حالة كل منها)
2. تحليل الإيرادات (ما الذي أثّر على النتيجة؟)
3. تحليل المصاريف (ما الذي تجاوز الميزانية ولماذا؟)
4. مخاوف تستحق الانتباه
5. توصيات الشهر القادم

أسلوب: مهني ومحدد. الأرقام بالريال السعودي. لا تعقيد غير ضروري."

// البرومبت لكلود:
"حلّل إنتاجية الفريق هذا الأسبوع:

البيانات (من أداة إدارة المشاريع):
- المهام المنجزة في الوقت المحدد: ${onTimeTasks}/{totalTasks}
- المهام المتأخرة: ${lateTasks}
- المهام المُلغاة أو المُرحَّلة: ${cancelledTasks}

تفصيل لكل موظف:
${teamData}
(الاسم - المهام المنجزة - المهام المتأخرة - ملاحظات)

ساعات العمل:
- متوسط ساعات العمل للفريق: ${avgHours}
- أعلى: ${maxHours} ساعة
- أقل: ${minHours} ساعة

اكتب تقرير إنتاجية أسبوعي:
1. صحة الفريق بشكل عام (مؤشر 1-10 مع مبرر)
2. أعضاء الفريق الأفضل أداءً هذا الأسبوع (بدون إحراج للآخرين)
3. مشكلات تعيق الإنجاز (بنية وليس شخصية)
4. توصيات لتحسين الإنتاجية الأسبوع القادم

ملاحظة مهمة: اكتب التقرير بأسلوب يُعزز الفريق لا يُضعفه.
لا تُسمّ أشخاصاً بشكل سلبي — عالج المشاكل بشكل بنّاء."

// البرومبت لكلود:
"اكتب تقرير تقدم شهري للعميل ${clientName}:

الخدمة المُقدَّمة: ${serviceType}
الفترة: ${reportPeriod}

المنجزات:
${accomplishments}
(قائمة بكل ما أُنجز مع الأرقام إن وُجدت)

الأهداف المتفق عليها:
${agreedGoals}
نسبة تحقيق كل هدف: ${goalAchievement}

التحديات:
${challenges}

الخطوات القادمة:
${nextSteps}

اكتب التقرير بأسلوب يُبرز القيمة المُقدَّمة للعميل:
1. مقدمة قصيرة تُذكّر بالهدف الرئيسي لهذا الشهر
2. أبرز إنجاز واحد بتفاصيل مقنعة (ليس قائمة جافة)
3. الأرقام والمؤشرات مع مقارنة بالشهر الماضي
4. ما سيختلف في الشهر القادم وكيف سيُفيد العميل
5. خلاصة تُعزز الثقة والشراكة

أسلوب: مهني وودي. ليس دفاعياً. يُظهر أننا نهتم بنتائجهم."

// البرومبت لكلود:
"ابنِ Report Delivery System:

المنطق:
1. التقارير اليومية القصيرة → واتساب
   - ملخص 3-5 جمل فقط
   - الرقم الأهم في أول جملة
   - رابط للتقرير الكامل (Google Docs أو PDF)

2. التقارير الأسبوعية التفصيلية → بريد إلكتروني
   - Subject: 'تقرير [الأسبوع] — [أبرز رقم]'
   - HTML Email منسق بجميل
   - PDF مرفق للأرشفة

3. التقارير الفريق الداخلية → Slack
   - رسالة في القناة المخصصة
   - مع mention للمعنيين فقط

4. تقارير العملاء → بريد + Google Docs
   - بريد رسمي مع link للـ Doc
   - الـ Doc قابل للتعليق للعميل

Python Implementation:
- smtplib للبريد مع HTML template جاهز
- WhatsApp Business API لرسائل واتساب
- Slack SDK لإرسال Slack
- Google Docs API لإنشاء/تحديث Documents"

// البرومبت لكلود:
"ابنِ Data Pipeline للتقارير:

المصادر:
1. Google Sheets:
   - Sales Daily Sheet
   - Team Tasks Sheet
   - Client Progress Sheet

2. CRM (HubSpot/Salesforce/Custom):
   - API لجلب Deals الجديدة
   - API لأداء المندوبين

3. Google Analytics 4:
   - Data API لجلب إحصاءات الموقع

4. Facebook/Google Ads:
   - Marketing API لأرقام الحملات

الـ Pipeline:
كل يوم الساعة 5:30 مساءً:

Step 1: Data Collection
  - جلب كل المصادر بالتوازي (asyncio + aiohttp)
  - معالجة الأخطاء: إذا مصدر فشل → استخدام بيانات أمس مع تنبيه

Step 2: Data Processing
  - توحيد التنسيق (كل الأرقام بالريال السعودي)
  - حساب المقارنات (يوم/أسبوع/شهر)
  - كشف الانحرافات

Step 3: Claude Analysis
  - إرسال البيانات المُعالجة لـ Claude API
  - استقبال التحليل المكتوب

Step 4: Report Generation
  - دمج البيانات + التحليل في Template HTML
  - تحويل لـ PDF بـ WeasyPrint

Step 5: Distribution
  - إرسال للمستلمين المناسبين
  - أرشفة في Google Drive"