محمود عبدالنبي
الأتمتة · قالب وإطار عمل · 1

دليل المستودع: مواصفات تنظيف قوائم البريد وإيقاف الاشتراك آليًا

صفحة تعريفية مستقلة بمستودع مواصفات تنظيف قوائم البريد وإيقاف الاشتراك آليًا. توضّح ما الذي يحاول حله، ولمن يناسب، وما الملفات التي ستجدها قبل الانتقال إلى المصدر.

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

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

Build an open-source email list hygiene and sunsetting toolkit: 1) 3-stage sunset policy (Engagement Warning, Last-Chance Re-engagement, Automated Suppression), 2) example copy templates for the 'Goodbye / Are you still there?' re-engagement sequence, 3) Python audit script (audit_inactives.py) parsing subscriber activity exports, 4) Executive business case slide template justifying list pruning.

لمن صُمم؟

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

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

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

  • docs/executive-business-case.md
  • examples/clean_output.csv
  • examples/scrubbed_contacts_sample.csv
  • LICENSE
  • playbooks/automated-sunset-policy.md
  • policies/enterprise-sunsetting-policy.md
  • README.md
  • src/audit_inactives.py
  • src/list_scrubber.py
  • templates/last-chance-reengagement-copy.md
  • templates/re-engagement-campaign-ar.md
  • tests/test_audit.py

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

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

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

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

  • Inactivity Thresholds: Automatically flags contacts with 0 opens and 0 clicks over 90, 120, or 180 days for progressive re-engagement and sunsetting.
  • Hard Bounce vs Soft Bounce Handling: Automatically purges fatal hard bounces (code 5.X.X) while allowing transient soft bounces up to 3 attempts.
  • Spam Trap Avoidance: Recovers sender domain reputation by suppressing unengaged subscribers before inbox providers convert dormant addresses into spam traps.

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

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