محمود عبدالنبي
التقارير والتحليلات · مخطط مشروع · 3

دليل المستودع: مواصفات أتمتة التقرير الشهري لنمو العملاء ومتطلبات العرض

صفحة تعريفية مستقلة بمستودع مواصفات أتمتة التقرير الشهري لنمو العملاء ومتطلبات العرض. توضّح ما الذي يحاول حله، ولمن يناسب، وما الملفات التي ستجدها قبل الانتقال إلى المصدر.

المشكلة التي يعالجها

يوضح التوثيق الأصلي نطاق المشكلة بهذا الوصف:

Build an open-source client monthly growth reporting system: 1) System architecture PRD detailing automated ETL data aggregation from Meta, Google, and GA4, 2) 12-slide executive deck narrative framework (Executive Summary, Blended ROAS, Channel Breakdown, Top Winning Creatives, What Worked / What Didn't, Next Month Action Plan), 3) Python summary compiler (compile_report.py).

لمن صُمم؟

الجمهور المحدد في README: PRO operating in high-growth e-commerce, digital publishing, and direct-response marketing across Saudi Arabia, UAE, and Egypt.

محتويات المستودع

الملفات الأساسية التي يسردها قسم بنية المستودع في README:

  • ARCHITECTURE.md
  • DATA_MODEL.md
  • LICENSE
  • MONETIZATION.md
  • prd/reporting-automation-architecture.md
  • PRD.md
  • PROBLEM.md
  • README.md
  • reports/sample_client_executive_summary.md
  • ROADMAP.md
  • sample_data/monthly_ad_exports.csv
  • src/compile_report.py

طريقة مراجعته واستخدامه

  1. ابدأ بقراءة README وتأكد أن المشكلة المذكورة تطابق احتياجك الفعلي.
  2. افحص الملفات المذكورة أعلاه؛ أسماء الملفات توضح مكان البيانات والأدوات والقوالب والاختبارات.
  3. اتبع Quick Start الموجود في README، وتحقق من المتطلبات قبل تشغيل أي أمر.
  4. قارن المخرجات بعينة موثقة، وراجع القيود قبل استخدامها في قرار أو عمل عميل.

أمثلة أوامر البدء من README: python -m unittest discover -s tests · python src/compile_report.py --help

النطاق والقيود

  • Multi-Source API Merging: Spec outlines programmatic ingestion and reconciliation across Google Ads, Meta Ads, TikTok, and GA4.
  • Executive Deck Generation: Mandates high-level North Star metrics (MER, Blended ROAS, Contribution Margin) before granular channel tables.
  • Currency Normalization: Formats blended reports across GCC currencies using central bank monthly exchange rate benchmarks.

هذه الصفحة تلخص التوثيق المتاح ولا تثبت أداءً أو نتيجة تجارية. تحقق من صلاحية البيانات والمتطلبات قبل الاستخدام.

مستودعات مرتبطة