chore: pre-phase-1 cleanup - OpenRouter config fallback and PLAN.md

docs/PLAN.md

@@ -0,0 +1,43 @@
+# خطة رفع SaaS-PDF إلى مستوى المنافسة
+
+## Summary
+- اعتماد مسار نمو واضح: `B2C SEO-first` أولاً، ثم `Freemium monetization`، ثم `B2B API expansion`.
+- الحفاظ على المعمارية الحالية `Flask + React + Celery` لأنها سليمة وتغطي المنتج الحالي جيداً.
+- تنفيذ الخطة على 4 مراحل متتابعة، لا بالتوازي، لتجنب التشتت.
+
+## Key Changes
+- المرحلة 1: تثبيت الجاهزية الإنتاجية خلال 2-3 أسابيع.
+  - استبدال كل قيم `yourdomain.com` وإغلاق إعدادات SEO النهائية.
+  - تحويل صفحة التواصل إلى backend endpoint مع تخزين وتتبّع ورسائل بريد حقيقية.
+  - تفعيل Stripe وربط خطتي `Free/Pro` فعلياً بدل صفحة تسويقية فقط.
+  - نقل قاعدة البيانات من SQLite إلى PostgreSQL في الإنتاج مع إبقاء SQLite للتطوير فقط.
+  - إضافة مراقبة تشغيل: Sentry أو بديل، وقياسات للمهام والصفوف والفشل.
+- المرحلة 2: سد فجوة المنافسين خلال 4-6 أسابيع.
+  - تنفيذ `Sign PDF`, `PDF to PowerPoint`, `Excel to PDF`, `PowerPoint to PDF`.
+  - تنفيذ `Crop PDF`, `Flatten PDF`, `Repair PDF`, `PDF Metadata Editor`.
+  - تنفيذ `Image Crop`, `Image Rotate/Flip`, `Barcode Generator`.
+  - توسيع `v1 API` لتشمل الأدوات الجديدة والأدوات الحالية غير المغطاة مثل OCR وRemove BG وPDF AI وPDF to Excel وHTML to PDF وQR.
+- المرحلة 3: تحويل SEO من “جاهز تقنياً” إلى “محرك نمو” خلال 3-4 أسابيع.
+  - استبدال صفحة `Blog` الثابتة بنظام نشر فعلي مع صفحات مقالات قابلة للفهرسة.
+  - اعتماد `hreflang` حقيقي للغات الثلاث.
+  - إنشاء cluster pages وcomparison pages وprogrammatic pages لأزواج التحويل الأعلى طلباً.
+  - إضافة internal search و“suggested next tool” بعد كل عملية لرفع الصفحات/جلسة.
+- المرحلة 4: رفع الثقة والتحويل خلال 3-4 أسابيع.
+  - إضافة dashboard إداري بسيط لمتابعة الاستخدام، الأدوات الأعلى طلباً، والأخطاء.
+  - عرض social proof: عدد الملفات المعالجة، التقييمات، والسرعة.
+  - تحسين الأداء في الحزم الثقيلة وتقليل أثر `pdf.worker` والحزم الكبيرة على LCP.
+  - إضافة onboarding أوضح للحسابات وAPI docs وصفحة مطورين مستقلة.
+
+## Test Plan
+- تشغيل suite الاختبارات الكامل للخلفية والواجهة قبل كل إصدار.
+- إضافة smoke tests لكل أداة جديدة: web flow + task status + download.
+- اختبار أوضاع التخزين `local` و`S3`.
+- اختبار فروقات الخطط: anonymous مقابل free مقابل pro.
+- اختبار funnel الدفع والترقية وقيود الحصص ومفاتيح API.
+- التحقق من SEO عبر sitemap, canonical, robots, hreflang, schema, Lighthouse.
+
+## Assumptions
+- الأولوية التجارية هي النمو العضوي والمنتج العام قبل بيع API على نطاق واسع.
+- الخطة تبقي المشروع متعدد اللغات `AR/EN/FR` كميزة تنافسية رئيسية.
+- الأدوات الحالية لا تُعاد كتابتها؛ يتم التطوير فوق البنية الحالية تدريجياً.
+- المعيار المستهدف للمنافسة هو: ثبات إنتاجي، funnel مدفوع فعلي، تغطية أدوات أوسع، وSEO تشغيلي حقيقي لا شكلي.