first commit

docs/Mvp Tools Specs-1.md

@@ -0,0 +1,156 @@
+### الملف التقني التنفيذي: الأدوات الأساسية لموقع 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
+
+---
+
+## خارطة الطريق الأسبوعية (6 أسابيع)
+
+### الأسبوع 1: التحضير والهيكل الأساسي
+
+* إعداد بيئة التطوير (GitHub, CI/CD, VPS)
+* بناء التصميم العام للواجهة (Landing page, هيكل الأدوات)
+* تركيب LibreOffice و ffmpeg في بيئة السيرفر
+* الزمن التقريبي: 30 ساعة
+* التكلفة: ~$600 (مطور Backend + Frontend)
+
+### الأسبوع 2: أدوات PDF الأساسية
+
+* تطوير API لتحويل PDF↔Word
+* تطوير API لضغط PDF
+* واجهة المستخدم لهاتين الأداتين
+* الزمن التقريبي: 35 ساعة
+* التكلفة: ~$700
+
+### الأسبوع 3: أدوات الصور الأساسية
+
+* API لتحويل صيغ الصور (Pillow أو ImageMagick)
+* صفحات الإدخال والمعالجة والتحميل
+* الحماية من ملفات خبيثة + اختبار السرعة
+* الزمن: 25 ساعة
+* التكلفة: ~$500
+
+### الأسبوع 4: أداة تحويل الفيديو إلى GIF
+
+* إعداد ffmpeg + API + crop timeline
+* تطوير واجهة إدخال الوقت وتحميل النتيجة
+* تحسينات UX (معاينة + تعليمات)
+* الزمن: 30 ساعة
+* التكلفة: ~$600
+
+### الأسبوع 5: أدوات النصوص الخفيفة (Frontend only)
+
+* عدّاد الكلمات، إزالة المسافات، تغيير الحروف
+* صفحة شاملة تضم كل الأدوات النصية
+* إعلانات + CTA لأدوات أخرى
+* الزمن: 15 ساعة
+* التكلفة: ~$300
+
+### الأسبوع 6: تحسين + إطلاق مبدئي + SEO
+
+* إعداد sitemap، تحسين سرعة الموقع
+* إضافة Google Analytics + AdSense
+* إعداد صفحات السياسة والخصوصية
+* اختبار الوظائف وتحسين الإعلانات
+* الزمن: 25 ساعة
+* التكلفة: ~$500
+
+---
+
+## التكلفة الإجمالية المقدّرة: ~$3200
+
+* المدة الكاملة: 6 أسابيع
+* عدد الأدوات: 5 أدوات رئيسية + 3 أدوات نصية بسيطة
+* الفريق المقترح: 1 Backend, 1 Frontend, 1 DevOps (جزئي)
+
+---
+
+## المميزات الإضافية المقترحة (MVP+)
+
+* سجل استخدام محلي (localStorage)
+* زر "مشاركة النتيجة"
+* زر نسخ/تنزيل مباشر بعد المعالجة
+* شريط "جرب الأدوات الأخرى" في صفحة النتيجة
+
+---
+
+## الملخص:
+
+* MVP = 5 أدوات (3 backend + 2 frontend فقط)
+* يمكن إطلاقها خلال 6 أسابيع بفريق صغير
+* قابلة للتوسيع
+* مبنية للـ SEO والـCTR
+* مستعدة لتحقيق ربح من AdSense منذ الأسبوع الأول للإطلاق