بناء نظام تقارير تلقائي للمدير التنفيذي (CEO Dashboard) بكلود AI

/* معمارية بيانات CEO Dashboard */ طبقة المصادر (Data Sources Layer): ├── CRM (HubSpot / Salesforce / Zoho) │ ├── عدد العملاء الجدد هذا الأسبوع │ ├── معدل إغلاق الصفقات (Win Rate) │ ├── متوسط قيمة الصفقة (Deal Value) │ ├── حجم pipeline المفتوح │ └── نسبة الاحتفاظ بالعملاء (Retention) │ ├── المحاسبة (Accounting: QuickBooks / Xero / Zoho Books) │ ├── الإيرادات (Revenue) اليومية والأسبوعية │ ├── المصروفات التشغيلية (OPEX) │ ├── التدفق النقدي (Cash Flow) │ ├── الحسابات المستحقة القبض (AR) │ └── هامش الربح الإجمالي (Gross Margin) │ ├── الموارد البشرية (HR: BambooHR / Workday / Sheets) │ ├── إجمالي عدد الموظفين │ ├── حالات التعيين والمغادرة هذا الشهر │ ├── معدل الدوران الوظيفي (Turnover Rate) │ ├── ساعات العمل الإضافية │ └── نتائج استبيانات الرضا الوظيفي │ └── التسويق (Marketing: Google Analytics / Meta Ads / Mailchimp) ├── عدد الزوار والعملاء المحتملين (Leads) ├── تكلفة اكتساب العميل (CAC) ├── معدل التحويل (Conversion Rate) ├── معدل فتح الإيميلات (Email Open Rate) └── عائد الإعلانات (ROAS) طبقة التجميع (Aggregation Layer): → Google Sheets كمستودع مركزي → Apps Script كمحرك جمع تلقائي (يعمل كل يوم 6 صباحاً) طبقة الذكاء (Intelligence Layer): → Claude API: تحليل + كتابة تقرير + رصد شذوذات طبقة التوزيع (Distribution Layer): → PDF جاهز لمجلس الإدارة → ملخص واتساب / إيميل للمدير التنفيذي → تنبيهات فورية عبر تليجرام

// Google Apps Script — CEO Dashboard Aggregator // يعمل تلقائياً كل يوم الساعة 6:00 صباحاً const CONFIG = { CLAUDE_API_KEY: PropertiesService.getScriptProperties().getProperty('CLAUDE_API_KEY'), CLAUDE_MODEL: 'claude-opus-4-5', HUBSPOT_TOKEN: PropertiesService.getScriptProperties().getProperty('HUBSPOT_TOKEN'), SHEET_ID: PropertiesService.getScriptProperties().getProperty('DASHBOARD_SHEET_ID'), TELEGRAM_TOKEN: PropertiesService.getScriptProperties().getProperty('TELEGRAM_TOKEN'), TELEGRAM_CHAT_ID: PropertiesService.getScriptProperties().getProperty('TELEGRAM_CHAT_ID'), EMAIL_RECIPIENT: 'ceo@yourcompany.com' }; // === الدالة الرئيسية — تُشغَّل بـ Trigger يومي === function runCEODashboard() { const data = {}; // 1. جمع بيانات CRM data.crm = fetchHubSpotKPIs(); // 2. جمع بيانات التسويق من Google Analytics data.marketing = fetchMarketingKPIs(); // 3. جمع بيانات المحاسبة (من Sheets يُحدّثه المحاسب أو Xero Export) data.finance = fetchFinanceKPIs(); // 4. جمع بيانات الموارد البشرية data.hr = fetchHRKPIs(); // 5. تحديث Google Sheet بالبيانات الخام updateDashboardSheet(data); // 6. فحص الشذوذات وإرسال تنبيهات فورية checkAnomaliesAndAlert(data); // 7. توليد التقرير الأسبوعي بكلود (كل أحد فقط) const today = new Date(); if (today.getDay() === 0) { // 0 = الأحد generateWeeklyReport(data); } } // === جمع KPIs من HubSpot CRM === function fetchHubSpotKPIs() { const baseUrl = 'https://api.hubapi.com'; const headers = { 'Authorization': `Bearer ${CONFIG.HUBSPOT_TOKEN}` }; // الصفقات المغلقة هذا الأسبوع const dealsUrl = `${baseUrl}/crm/v3/objects/deals?limit=100&properties=dealname,amount,closedate,dealstage`; const dealsResp = UrlFetchApp.fetch(dealsUrl, { headers }); const deals = JSON.parse(dealsResp.getContentText()).results; const thisWeekDeals = deals.filter(d => { const closeDate = new Date(d.properties.closedate); const weekAgo = new Date(Date.now() - 7 * 24 * 60 * 60 * 1000); return closeDate >= weekAgo; }); const wonDeals = thisWeekDeals.filter(d => d.properties.dealstage === 'closedwon'); const totalRevenue = wonDeals.reduce((sum, d) => sum + (parseFloat(d.properties.amount) || 0), 0); // Pipeline الإجمالي const openDeals = deals.filter(d => !['closedwon','closedlost'].includes(d.properties.dealstage)); const pipelineValue = openDeals.reduce((sum, d) => sum + (parseFloat(d.properties.amount) || 0), 0); return { new_deals_this_week: wonDeals.length, revenue_this_week: totalRevenue, open_pipeline_value: pipelineValue, win_rate: thisWeekDeals.length > 0 ? (wonDeals.length / thisWeekDeals.length * 100).toFixed(1) : 0, avg_deal_size: wonDeals.length > 0 ? (totalRevenue / wonDeals.length).toFixed(0) : 0 }; } // === جمع KPIs التسويق === function fetchMarketingKPIs() { // اقرأ من Sheet "Marketing" الذي يُحدّثه Zapier أو Google Analytics Export const ss = SpreadsheetApp.openById(CONFIG.SHEET_ID); const mktSheet = ss.getSheetByName('Marketing_Raw'); const lastRow = mktSheet.getLastRow(); const latestData = mktSheet.getRange(lastRow, 1, 1, 10).getValues()[0]; return { weekly_leads: latestData[1], website_visitors: latestData[2], conversion_rate: latestData[3], cac: latestData[4], roas: latestData[5], email_open_rate: latestData[6], top_traffic_source: latestData[7] }; } // === جمع KPIs المالية === function fetchFinanceKPIs() { const ss = SpreadsheetApp.openById(CONFIG.SHEET_ID); const finSheet = ss.getSheetByName('Finance_Raw'); const lastRow = finSheet.getLastRow(); const data = finSheet.getRange(lastRow, 1, 1, 12).getValues()[0]; return { monthly_revenue: data[1], weekly_revenue: data[2], gross_margin: data[3], net_margin: data[4], total_expenses: data[5], cash_balance: data[6], accounts_receivable: data[7], cash_runway_months: data[8], revenue_vs_target_pct: data[9] }; } // === جمع KPIs الموارد البشرية === function fetchHRKPIs() { const ss = SpreadsheetApp.openById(CONFIG.SHEET_ID); const hrSheet = ss.getSheetByName('HR_Raw'); const lastRow = hrSheet.getLastRow(); const data = hrSheet.getRange(lastRow, 1, 1, 8).getValues()[0]; return { total_headcount: data[1], new_hires_this_month: data[2], exits_this_month: data[3], turnover_rate_pct: data[4], open_positions: data[5], avg_satisfaction_score: data[6], overtime_hours: data[7] }; } // === فحص الشذوذات وإرسال تنبيهات فورية === function checkAnomaliesAndAlert(data) { const alerts = []; // فحص الإيرادات if (data.finance.revenue_vs_target_pct < -20) { alerts.push(`🔴 CRITICAL: الإيرادات أقل من الهدف بنسبة ${Math.abs(data.finance.revenue_vs_target_pct)}%`); } else if (data.finance.revenue_vs_target_pct < -10) { alerts.push(`🟡 WARNING: الإيرادات أقل من الهدف بنسبة ${Math.abs(data.finance.revenue_vs_target_pct)}%`); } // فحص التدفق النقدي if (data.finance.cash_runway_months < 3) { alerts.push(`🔴 CRITICAL: التدفق النقدي يكفي لأقل من 3 أشهر (${data.finance.cash_runway_months} شهر)`); } // فحص معدل الإغلاق if (parseFloat(data.crm.win_rate) < 15) { alerts.push(`🔴 CRITICAL: معدل إغلاق الصفقات منخفض جداً (${data.crm.win_rate}%)`); } // فحص معدل دوران الموظفين if (data.hr.turnover_rate_pct > 6) { alerts.push(`🔴 CRITICAL: معدل الدوران الوظيفي مرتفع (${data.hr.turnover_rate_pct}% هذا الشهر)`); } // فحص ROAS if (data.marketing.roas < 2) { alerts.push(`🟡 WARNING: عائد الإعلانات (ROAS) منخفض (${data.marketing.roas}x)`); } // إرسال التنبيهات إذا وُجدت if (alerts.length > 0) { const message = `⚠️ *تنبيهات CEO Dashboard*\n${new Date().toLocaleDateString('ar-EG')}\n\n${alerts.join('\n')}`; sendTelegramMessage(message); sendEmailAlert(alerts); } } // === توليد التقرير الأسبوعي بكلود === function generateWeeklyReport(data) { const prompt = buildWeeklyReportPrompt(data); const claudePayload = { model: CONFIG.CLAUDE_MODEL, max_tokens: 4096, messages: [{ role: 'user', content: prompt }] }; const response = UrlFetchApp.fetch('https://api.anthropic.com/v1/messages', { method: 'POST', headers: { 'Content-Type': 'application/json', 'x-api-key': CONFIG.CLAUDE_API_KEY, 'anthropic-version': '2023-06-01' }, payload: JSON.stringify(claudePayload) }); const result = JSON.parse(response.getContentText()); const report = result.content[0].text; // حفظ التقرير في Sheet مخصص saveReportToSheet(report, data); // إرسال التقرير عبر إيميل UrlFetchApp.fetch(`https://api.emailjs.com/api/v1.0/email/send`, { method: 'POST', contentType: 'application/json', payload: JSON.stringify({ service_id: 'your_service_id', template_id: 'ceo_weekly_report', user_id: 'your_user_id', template_params: { to_email: CONFIG.EMAIL_RECIPIENT, report_content: report, report_date: new Date().toLocaleDateString('ar-EG') } }) }); // إرسال ملخص عبر تليجرام const summary = report.substring(0, 800) + '\n\n[التقرير الكامل في البريد الإلكتروني]'; sendTelegramMessage(summary); } // === بناء البرومبت للتقرير الأسبوعي === function buildWeeklyReportPrompt(data) { return `أنت مستشار أعمال استراتيجي ومحلل مالي خبير. لديك بيانات الأداء الأسبوعي لشركة متوسطة الحجم. اكتب تقريراً تنفيذياً أسبوعياً شاملاً بالعربية يُرسَل للمدير التنفيذي ومجلس الإدارة. == بيانات هذا الأسبوع == المبيعات والإيرادات: - إيرادات هذا الأسبوع: ${data.finance.weekly_revenue.toLocaleString('ar-EG')} ريال/جنيه - إيرادات هذا الشهر حتى الآن: ${data.finance.monthly_revenue.toLocaleString('ar-EG')} - الانحراف عن الهدف الشهري: ${data.finance.revenue_vs_target_pct}% - هامش الربح الإجمالي: ${data.finance.gross_margin}% - هامش الربح الصافي: ${data.finance.net_margin}% - التدفق النقدي (Runway): ${data.finance.cash_runway_months} شهر CRM والمبيعات: - صفقات مُغلقة هذا الأسبوع: ${data.crm.new_deals_this_week} - إجمالي قيمتها: ${data.crm.revenue_this_week.toLocaleString('ar-EG')} - معدل إغلاق الصفقات: ${data.crm.win_rate}% - Pipeline المفتوح: ${data.crm.open_pipeline_value.toLocaleString('ar-EG')} - متوسط حجم الصفقة: ${data.crm.avg_deal_size.toLocaleString('ar-EG')} التسويق: - عملاء محتملون جدد (Leads): ${data.marketing.weekly_leads} - زوار الموقع: ${data.marketing.website_visitors.toLocaleString('ar-EG')} - معدل التحويل: ${data.marketing.conversion_rate}% - تكلفة اكتساب العميل (CAC): ${data.marketing.cac} - عائد الإعلانات (ROAS): ${data.marketing.roas}x - معدل فتح الإيميل: ${data.marketing.email_open_rate}% الموارد البشرية: - إجمالي الموظفين: ${data.hr.total_headcount} - تعيينات جديدة هذا الشهر: ${data.hr.new_hires_this_month} - مغادرات هذا الشهر: ${data.hr.exits_this_month} - معدل الدوران الوظيفي: ${data.hr.turnover_rate_pct}% - وظائف شاغرة: ${data.hr.open_positions} - رضا الموظفين: ${data.hr.avg_satisfaction_score}/10 == هيكل التقرير المطلوب == 1. ملخص تنفيذي (فقرة واحدة 5-7 جمل — أبرز ما حدث هذا الأسبوع وتقييمك الإجمالي) 2. أداء المبيعات والإيرادات (تحليل مع تفسير الأرقام لا مجرد سردها) 3. الصحة المالية (وضع التدفق النقدي والهوامش والتحذيرات إن وُجدت) 4. المبيعات والتسويق (فعالية القنوات والتحويل واكتساب العملاء) 5. الموارد البشرية والثقافة المؤسسية (مؤشرات الاستقرار التنظيمي) 6. الشذوذات والمخاوف (أي أرقام تستحق التحقيق الفوري مع اقتراح السبب المحتمل) 7. أبرز 3 أولويات للأسبوع القادم بصيغة قرارات قابلة للتنفيذ الأسلوب: تنفيذي محترف، واضح ومباشر، باللغة العربية الفصحى السلسة. لا تتجنب ذكر المشاكل — المدير التنفيذي يحتاج الحقيقة لا الطمأنة. الطول المثالي: 600 إلى 900 كلمة.`; } // === إرسال تليجرام === function sendTelegramMessage(text) { UrlFetchApp.fetch(`https://api.telegram.org/bot${CONFIG.TELEGRAM_TOKEN}/sendMessage`, { method: 'POST', contentType: 'application/json', payload: JSON.stringify({ chat_id: CONFIG.TELEGRAM_CHAT_ID, text: text, parse_mode: 'Markdown' }) }); } // === إرسال إيميل تنبيه === function sendEmailAlert(alerts) { const body = `تنبيهات CEO Dashboard\n\n${alerts.join('\n')}\n\nتاريخ التنبيه: ${new Date().toLocaleString('ar-EG')}`; GmailApp.sendEmail(CONFIG.EMAIL_RECIPIENT, '⚠️ تنبيه CEO Dashboard', body); } // === حفظ التقرير في Google Sheet === function saveReportToSheet(report, data) { const ss = SpreadsheetApp.openById(CONFIG.SHEET_ID); let reportSheet = ss.getSheetByName('Weekly_Reports'); if (!reportSheet) reportSheet = ss.insertSheet('Weekly_Reports'); reportSheet.appendRow([ new Date().toLocaleDateString('ar-EG'), data.finance.weekly_revenue, data.finance.revenue_vs_target_pct, data.crm.win_rate, data.marketing.weekly_leads, report ]); } // === تحديث Sheet المركزي === function updateDashboardSheet(data) { const ss = SpreadsheetApp.openById(CONFIG.SHEET_ID); let mainSheet = ss.getSheetByName('Dashboard_Main'); if (!mainSheet) mainSheet = ss.insertSheet('Dashboard_Main'); const timestamp = new Date().toLocaleString('ar-EG'); mainSheet.appendRow([ timestamp, data.crm.new_deals_this_week, data.crm.revenue_this_week, data.crm.win_rate, data.crm.open_pipeline_value, data.finance.weekly_revenue, data.finance.gross_margin, data.finance.net_margin, data.finance.cash_runway_months, data.finance.revenue_vs_target_pct, data.marketing.weekly_leads, data.marketing.cac, data.marketing.roas, data.hr.total_headcount, data.hr.turnover_rate_pct ]); }

// دالة تحليل الاتجاهات الشهرية بكلود function generateTrendAnalysis() { const ss = SpreadsheetApp.openById(CONFIG.SHEET_ID); const mainSheet = ss.getSheetByName('Dashboard_Main'); // استخراج آخر 12 أسبوع من البيانات const lastRow = mainSheet.getLastRow(); const startRow = Math.max(2, lastRow - 11); const historicalData = mainSheet.getRange(startRow, 1, 12, 15).getValues(); const trendPrompt = `أنت محلل بيانات مالي خبير في التنبؤ بأداء الأعمال. إليك بيانات الـ 12 أسبوع الماضية: التاريخ | صفقات مغلقة | إيراد أسبوعي | معدل إغلاق | Leads | CAC | ROAS ${historicalData.map(row => row.slice(0,7).join(' | ')).join('\n')} قدّم تحليلاً للاتجاهات يشمل: 1. اتجاه الإيراد الأسبوعي — هل هو تصاعدي أم تنازلي أم مستقر؟ وما معدل النمو الأسبوعي؟ 2. كفاءة المبيعات — هل تحسّن معدل الإغلاق أم تراجع؟ ما العوامل المحتملة؟ 3. كفاءة التسويق — هل ينخفض CAC أم يرتفع؟ كيف تتطور جودة الـ Leads؟ 4. تنبؤ الأشهر الثلاثة القادمة — بناءً على الاتجاه الحالي، ما الإيراد المتوقع؟ 5. نقاط الانكسار — هل هناك أسابيع شهدت انحرافاً كبيراً يستحق التحقيق؟ 6. توصية استراتيجية واحدة بناءً على هذا التحليل`; const claudePayload = { model: CONFIG.CLAUDE_MODEL, max_tokens: 2048, messages: [{ role: 'user', content: trendPrompt }] }; const response = UrlFetchApp.fetch('https://api.anthropic.com/v1/messages', { method: 'POST', headers: { 'Content-Type': 'application/json', 'x-api-key': CONFIG.CLAUDE_API_KEY, 'anthropic-version': '2023-06-01' }, payload: JSON.stringify(claudePayload) }); const trendReport = JSON.parse(response.getContentText()).content[0].text; // حفظ في Sheet الاتجاهات let trendSheet = ss.getSheetByName('Trend_Analysis'); if (!trendSheet) trendSheet = ss.insertSheet('Trend_Analysis'); trendSheet.appendRow([new Date().toLocaleDateString('ar-EG'), trendReport]); return trendReport; }

// برومبت توليد تقرير HTML جاهز للتحويل إلى PDF const boardReportPrompt = ` أنت خبير في إعداد تقارير مجلس الإدارة. اكتب التقرير التالي بصيغة HTML منسّقة احترافياً. متطلبات HTML: - اتجاه RTL كامل مع دعم اللغة العربية - ألوان مؤسسية: أزرق داكن #0a1745 وأحمر #E31E24 وذهبي #d4a017 - جداول واضحة للأرقام مع ترميز لوني للأداء (أخضر/أصفر/أحمر) - مربعات KPI بارزة في أعلى الصفحة - تذييل يحتوي التاريخ واسم الشركة وتسلسل الصفحة البيانات: [أدرج JSON البيانات هنا] التقرير النصي الذي كتبته سابقاً: [أدرج التقرير] هيكل التقرير: - صفحة الغلاف مع اسم الشركة والفترة الزمنية - ملخص تنفيذي مع مربعات KPI الرئيسية الأربعة - صفحة الأداء المالي مع جدول مقارنة بالهدف - صفحة المبيعات والتسويق مع جدول مؤشرات - صفحة الموارد البشرية - صفحة الأولويات والتوصيات - خاتمة موقّعة بالتاريخ`; // تحويل HTML إلى PDF باستخدام Google Docs API function convertHTMLtoPDF(htmlContent) { const blob = Utilities.newBlob(htmlContent, 'text/html', 'board_report.html'); const file = DriveApp.createFile(blob); const doc = DocumentApp.openById(file.getId()); const pdfBlob = doc.getAs('application/pdf'); pdfBlob.setName(`Board_Report_${new Date().toLocaleDateString('ar-EG')}.pdf`); // حفظ في Google Drive في مجلد مخصص const folder = DriveApp.getFolderById('YOUR_BOARD_REPORTS_FOLDER_ID'); folder.createFile(pdfBlob); // إرسال PDF بالإيميل GmailApp.sendEmail( CONFIG.EMAIL_RECIPIENT, `تقرير مجلس الإدارة — ${new Date().toLocaleDateString('ar-EG')}`, 'مرفق التقرير الشهري لمجلس الإدارة.', { attachments: [pdfBlob] } ); file.setTrashed(true); // حذف الملف المؤقت }