Menu Cross · منيو كروس

روابط مطاعمك → منيو مرتب، مقارنة أسعار، وصور أصلية بملف ZIP واحد.

واجهة عربية لجمع منيو بلي فود وطلبات العراق من روابط الفروع، مع مقارنة المنتجات والأسعار بين الفروع والتطبيقات. مبنية بـ Next.js وTailwind CSS، والتحميل يتم مباشرة على جهازك.

افتح الأداة

English documentation · دليل الاستخدام · Architecture · Contributing

شنو تسوي الأداة؟

منيو كروس يحوّل روابط المنيو المنشورة على بلي وطلبات العراق إلى ملفات تقدر تراجعها وتستخدمها خارج تطبيق التوصيل. يلزمك رابط فرع واحد أو أكثر؛ الأداة تحدد التطبيق من الرابط، تقرأ المنتجات والخيارات والأسعار والصور المتاحة، وترتب النتائج حسب المطعم والفرع.

تقدر تحمل المنيو مع الصور، أو الصور فقط. وتقدر تقارن نفس المطعم بين عدة فروع وبين بلي وطلبات، أو تشتغل على مطاعم مختلفة بدفعة واحدة مع إبقاء بيانات كل مطعم مستقلة.

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

شلون تستخدمه؟

1. الصق رابط المطعم من بلي أو طلبات مباشرة؛ الأداة تتعرّف على التطبيق تلقائياً وتعرض اسمه بجانب الرابط.
2. إذا عنده فروع إضافية أو رابط على التطبيق الثاني، فعّل أكو فروع أو رابط بالتطبيق الثاني والصق كل رابط بسطر. فعّل الكروس أوفر للمقارنة، واختار المنيو والصور أو الصور فقط.
3. اضغط تحميل. يجهز ZIP حسب اختياراتك مباشرة على جهازك.

تريد مطاعم مختلفة؟ اضغط إضافة مطعم مختلف. كل مطعم يحتفظ بمجلده وإكسله، حتى لو تشابهت أسماء المنتجات بين المطاعم.

المطعم مو هو التطبيق: حط روابط نفس المطعم في بطاقة واحدة، سواء كانت من بلي أو طلبات. افتح بطاقة جديدة لمطعم مختلف. الأداة تتعرّف على مصدر الرابط، لكنها لا تبحث عن روابط الفروع أو عن المطعم بالتطبيق الثاني نيابة عنك.

سيناريوهات استخدام عملية

1. مراجعة أسعار نفس المطعم بين بلي وطلبات

حط رابط بلي بالحقل الرئيسي، وأضف رابط طلبات لنفس المطعم ضمن الروابط الإضافية. فعّل الكروس أوفر واختار المنيو والصور. تحصل على تبويب لكل مصدر وجدول يقارن أسعار المنتجات ذات الخيارات القابلة للمقارنة؛ مثلاً نصف كيلو مع 500 غرام، وليس مع كيلو كامل. الصور المختلفة من التطبيقين تبقى محفوظة.

2. تجهيز صور المنيو لمصمم أو فريق محتوى

أضف روابط المطعم واختار الصور فقط ← كل مطعم بمجلد. فعّل إزالة التشابه لتحتفظ بالنسخة الأعلى دقة من الصورة نفسها. تحصل على ملفات بأسماء المنتجات، من غير إكسل. الدقة هي أعلى أبعاد متاحة بين الصور المحمّلة من المصدر؛ الأداة لا تكبّر الصور اصطناعياً.

3. تسليم صور مستقلة لكل فرع

اختار الصور فقط ← كل فرع بمجلد. كل فرع يأخذ مجلداً داخل مجلد مطعمه، حتى لو يشترك بصور مع فرع آخر. إزالة التشابه تحصل داخل مجلد الفرع فقط، حتى تبقى صور كل فرع مكتملة.

4. جمع مكتبة صور من عدة مطاعم

أضف بطاقة لكل مطعم، ثم اختار الصور فقط ← كل الصور سوه. مع إزالة التشابه، تُقارن الصور بين كل المطاعم والتطبيقات حتى إذا اختلف اسم المنتج. الصور المختلفة تبقى حتى لو اسم المنتج متكرر. أوقف الخيار إذا تريد كل نسخة من كل مصدر. دليل الصور يحفظ أسماء المنتجات وروابط المصادر التي جُمعت في كل صورة.

5. أرشفة المنيو أو متابعة تغيّراته يدوياً

اختار المنيو + الصور، واحفظ ZIP بتاريخ الجمع. الإكسل يناسب المراجعة والفرز، وJSON يناسب المطورين وتحويل البيانات لأدوات أخرى. تقدر تعيد الجمع لاحقاً وتقارن الملفات بنفسك؛ الأداة حالياً لا توفر مراقبة مجدولة أو تقرير تغيّرات تلقائي.

ماذا تحصل عليه؟

• تبويب إكسل لكل فرع: اسم المنتج، الوصف، القسم، كل خيار وسعره، سعره قبل الخصم، التوفر، التطبيق، وروابط المصدر والصور.
• تبويب عام يوحّد الأسماء المتطابقة عند تفعيل الكروس أوفر، وتبويب لمقارنة أسعار الخيارات المتطابقة بين الفروع والتطبيقات.
• صور باسم المنتج، داخل مجلد بلي أو طلبات. الصور المختلفة تبقى كلها؛ النسخ القريبة جداً من الصورة نفسها تُوحّد تلقائياً، مع الاحتفاظ بأعلى دقة متاحة.
• معاينات صور داخل الإكسل، وملفات الصور الأصلية كاملة داخل ZIP.
• ملف JSON للمطورين يحفظ البيانات، مصادر الصور المطابقة، والخيارات الخام، مع تقرير للنواقص.
• مراجعة اقتراحات الأسماء المتشابهة ودمجها أو فصلها يدوياً، ثم إعادة التصدير.
• تقدم فعلي لجمع الفروع والصور وتجهيز الملف، وإعادة محاولة الفروع التي فشلت.
• واجهة RTL، خط عربي محلي، موشن يحترم تفضيل تقليل الحركة، ومشهد Three.js خفيف يتوقف خارج الشاشة.

Menu-Cross_YYYY-MM-DD.zip
├── تقرير_التحميل.txt
└── اسم المطعم_1/
    ├── المنيو.xlsx
    ├── بيانات_المنيو.json
    └── الصور/
        ├── بلي/اسم المنتج.webp
        └── طلبات/اسم المنتج_2.jpg

من صفحة النتائج تقدر تبحث عن منتج، تراجع اقتراحات التشابه وتعدّل الدمج، أو تحمل الإكسل وحده. بعد تعديل المطابقة أعد التصدير حتى يدخل التعديل بالملف.

تحميل الصور فقط

اختار الصور فقط قبل التحميل، وحدّد ترتيب ZIP:

الترتيب	النتيجة عند تفعيل إزالة التشابه
كل مطعم بمجلد	توحيد الصور المتشابهة بين فروع المطعم داخل مجلده
كل فرع بمجلد	مجلد مستقل لكل فرع، كامل بصوره؛ التوحيد داخل مجلد الفرع
كل الصور سوه	مجلد واحد، ومقارنة الصور بين جميع المطاعم والفروع والتطبيقات

إزالة التشابه هنا تعتمد على محتوى الصورة، مهما اختلف اسم المنتج. الصورة المختلفة تبقى حتى لو اسم المنتج نفسه. عند إيقاف الخيار تُحفظ كل نسخة بحسب مصدرها، مع أسماء ملفات فريدة. النسخة الأعلى دقة هي التي تبقى عند الدمج. ZIP الصور لا يحتوي إكسل؛ يحتوي الصور الأصلية مع دليل بمصادرها وتقرير النواقص.

Menu-Cross_Photos_YYYY-MM-DD.zip
├── تقرير_التحميل.txt
├── دليل_الصور.json
└── الصور/
    └── ... المجلدات حسب الترتيب الذي اخترته

الكروس أوفر للمنتجات وإزالة تشابه الصور خياران مختلفان: الأول ينظم صفوف المنتجات ومقارنة الأسعار داخل المطعم. الثاني يقارن محتوى الصور وينظم ملفاتها؛ اسم المنتج وحده لا يكفي لحذف صورة مختلفة.

تثبيت التطبيق

استخدم زر ثبّت التطبيق في أعلى الصفحة. المتصفحات التي تتيح التثبيت تعرض نافذتها، وتظهر تعليمات الجهاز عند الحاجة. الـPWA يدعم أيقونة الشاشة الرئيسية ونافذة مستقلة على الأجهزة الداعمة، مع صفحة واضحة عند انقطاع الاتصال. جمع المنيو والصور يحتاج إنترنت. لا تُخزّن المنيوات والأسعار في كاش الـservice worker؛ التحديثات لا تقطع ملفاً قيد التحميل.

قواعد المقارنة

نفس المطعم يجمع في بطاقة واحدة. التطبيق لا يخمّن أن مطعمين منفصلين يعودان لنفس العلامة. المنتجات تُطابق بعد توحيد الكتابة العربية فقط؛ النكهات والكميات والتغليف لا تُحذف من الاسم. الأسماء المتشابهة تحتاج مراجعتك.

نصف كيلو و500 غرام يتقارنان. الحجم غير المحدد والاختيارات المركبة يبقيان منفصلين، ولا يُعرض فرق سعر مضلل. السعر المفقود يبقى فارغاً؛ الصفر الحقيقي محفوظ. أسعار الإضافات المتعددة موضحة كأساس مع إضافة واحدة، ولا تمثل كل التركيبات الممكنة.

توحيد الصور محافظ لكنه ليس إثباتاً أنها متطابقة؛ راجع الروابط الأصلية في الإكسل أو JSON عند الحاجة. الصور المتحركة تتطلب تطابق البايتات. أعلى دقة تعني أكبر أبعاد من النسخ التي نشرها المصدر، دون تكبير اصطناعي.

تشغيل محلي

يلزم Node.js 22.13+ وnpm.

git clone https://github.com/HostX0/menu-cross.git
cd menu-cross
npm ci
npm run dev

افتح http://localhost:3000. لا تحتاج مفاتيح API أو قاعدة بيانات أو Google Drive.

npm run check       # lint + TypeScript + deterministic tests
npm run build
npm start
npm run test:live   # اختياري: يحتاج سيرفر شغال ومصادر متاحة

النشر على Vercel

استورد الريبو في Vercel، اختار Next.js وNode.js 22، واترك أوامر البناء الافتراضية. لا توجد متغيرات بيئة مطلوبة. ربط GitHub يفعّل النشر عند تحديث الفرع الرئيسي. راجع دليل التشغيل لحدود الاستضافة والمصادر.

الحدود الحالية

• الأداة تقرأ البيانات العامة المتاحة من الروابط التي تزودها بها؛ لا تعدّل قوائم المطاعم ولا تنشرها على تطبيقات التوصيل، ولا تنفذ طلبات طعام.
• بلي وطلبات العراق فقط، ومن روابط الفروع المدخلة فقط؛ لا يكتشف جميع فروع المطعم تلقائياً.
• 30 رابطاً في الدفعة، وثلاث عمليات جمع متزامنة. الصور والملفات تُجهز في ذاكرة المتصفح؛ استخدم دفعات أصغر للمنيو الكبير.
• صور المصدر الأصلية حتى 15MB للصورة، و120MB من الصور المحمّلة لكل مطعم، و150MB من الصور المحتفظ بها للدفعة، و180MB لملفات الإكسل والصور في ZIP. قد تفرض الاستضافة حدوداً إضافية.
• لا يوجد تسجيل دخول للمستخدم أو تخزين دائم لنتائجه. الطلبات تمر عبر سيرفر الأداة وقد تظهر في سجلات الاستضافة؛ احفظ الملف قبل إغلاق الصفحة.
• القوائم والأسعار تعكس وقت الجمع، ولا تشمل رسوم التوصيل أو الضرائب أو خصومات السلة. طلبات قد يعرض عناصر متاحة فقط.
• تغيّر المصادر أو حجب الطلبات قد يمنع الجمع. الأداة لا تتجاوز تسجيل الدخول أو CAPTCHA؛ الفشل يظهر بوضوح ويُحفظ في التقرير.

المشاركة والترخيص

الكود تحت MIT. صور المطاعم وأسماء العلامات وبيانات المنيو تعود لأصحابها، ولا يشملها ترخيص الكود. المشروع مستقل وغير تابع لبلي أو طلبات.

ساهم بإصلاح مصدر، اختبار بيانات مصطنعة، تحسين العربية أو إمكانية الوصول. اقرأ CONTRIBUTING.md وSECURITY.md قبل إرسال التغييرات.