first commit

docs/Mvp Tools Specs.md

@@ -0,0 +1,110 @@
+### الملف التقني التنفيذي: الأدوات الأساسية لموقع SaaS مجاني لتحقيق أرباح من AdSense (MVP)
+
+---
+
+## الأدوات الخمس الأولى (بأعلى أولوية)
+
+### 1. أداة تحويل PDF إلى Word والعكس (pdf2doc / doc2pdf)
+
+* **الوظيفة:** رفع ملف PDF وتحويله إلى ملف Word قابل للتعديل والعكس
+* **التقنيات المقترحة:**
+
+  * Python + Flask / Node.js + Express
+  * مكتبات:
+
+    * LibreOffice (headless) للتحويل
+    * أو usecase unoconv backend
+* **نقطة API:**
+
+  * POST `/convert/pdf-to-word`
+  * POST `/convert/word-to-pdf`
+* **الزمن المتوقع للمعالجة:** 2–8 ثوانٍ (حسب حجم الملف)
+* **التخزين المؤقت:** يتم مسح الملف بعد 30 دقيقة (أو بعد التنزيل)
+* **AdSense placement:** إعلان داخل صفحة التحويل + إعلان في صفحة التنزيل بعد التحويل
+
+### 2. أداة ضغط PDF
+
+* **الوظيفة:** تقليل حجم PDF لسهولة الإرسال
+* **المكتبات:**
+
+  * Ghostscript
+  * pdfsizeopt (اختياري)
+* **نقطة API:**
+
+  * POST `/compress/pdf`
+* **الزمن المتوقع:** 2–5 ثوانٍ
+* **المخرجات:** رابط تحميل جديد بصيغة PDF
+* **AdSense:** صفحة الضغط = إعلان جانبي + CTA لأداة أخرى (cross-tool traffic)
+
+### 3. أداة تحويل صورة WebP/PNG/JPG إلى JPG أو العكس
+
+* **الوظيفة:** تحويل سريع بين أنواع الصور
+* **المكتبات:**
+
+  * Python PIL / Pillow
+  * أو ImageMagick
+* **نقطة API:**
+
+  * POST `/convert/image`
+* **أمان:** تأكد من فحص الملفات المرفوعة ضد scripts/malware
+* **AdSense:** صفحة التحويل + بعد التنزيل
+
+### 4. أداة إنشاء GIF من فيديو
+
+* **الوظيفة:** رفع فيديو قصير واستخراج جزء منه وتحويله إلى صورة متحركة GIF
+* **المكتبات:** ffmpeg + gifify أو imageio-ffmpeg
+* **المدخلات:** MP4, WebM ≤ 20MB
+* **نقطة API:**
+
+  * POST `/create/gif`
+  * params: start_time, duration
+* **AdSense:** إعلان في صفحة المعاينة قبل التحميل
+* **نموذج مدفوع لاحقاً:** "إزالة العلامة المائية" أو "سرعة أعلى"
+
+### 5. أدوات نصية صغيرة:
+
+* **أداة عد الكلمات/الحروف**
+
+  * إدخال نص → إظهار عدد الكلمات، الحروف، الجُمل، الفقرات
+  * JavaScript فقط (client-side)
+  * إعلان سفلي + CTA: "جرب التدقيق النحوي"
+
+* **أداة إزالة المسافات المكررة / تحويل الحروف الكبيرة والصغيرة**
+
+  * client-side بالكامل
+  * API غير ضروري
+  * تعظيم SEO عبر Long-tail keywords
+
+---
+
+## الاستضافة والتكلفة التقريبية:
+
+* **المرحلة الأولى:** VPS (RAM 4GB، CPU 2 core)
+
+  * تكلفة: ~$20–30 شهريًا (Hetzner, Contabo)
+* **المرحلة الثانية (نمو):** نقل إلى AWS (EC2 + S3 + CloudFront)
+
+  * ميزانية تشغيل أولية: ~$50–70 شهريًا (يشمل خادم + مساحة تخزين + CDN)
+
+---
+
+## المميزات الإضافية المقترحة (MVP+)
+
+* سجل استخدام محلي (localStorage)
+* زر "مشاركة النتيجة"
+* زر نسخ/تنزيل مباشر بعد المعالجة
+* شريط "جرب الأدوات الأخرى" في صفحة النتيجة
+
+---
+
+## الملخص:
+
+* MVP = 5 أدوات (3 backend + 2 frontend فقط)
+* يمكن إطلاقها خلال 6 أسابيع بفريق صغير
+* قابلة للتوسيع
+* مبنية للـ SEO والـCTR
+* مستعدة لتحقيق ربح من AdSense منذ الأسبوع الأول للإطلاق
+
+الخطوة التالية: إعداد roadmap أسبوعي بكل sprint حسب الأولويات.
+
+هل ترغب بإعداد خارطة الطريق الزمنية الآن؟