Skip to content

Latest commit

 

History

History
31 lines (22 loc) · 2.01 KB

File metadata and controls

31 lines (22 loc) · 2.01 KB

🌙 مولد دعوات قفة رمضان (Ramadan Bag Invitation Generator)

English | العربية | ⵣⴰⵡⴰⵔⵉⵢⵏ

تطبيق بسيط لتوليد دعوات استلام قفة رمضان من ملف إكسيل مع دعم كامل للغة العربية وتنسيق PDF جاهز للطباعة.

📋 متطلبات الإعداد

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

  1. صيغة الملف: يجب أن يكون الملف بصيغة .xlsx. إذا كان لديك ملف بصيغة .xls قديمة، يرجى فتحه في Excel وحفظه بصيغة Excel Workbook (.xlsx).
  2. تنسيق الصفوف:
    • تأكد أن الصف الأول يحتوي على أسماء الأعمدة (العناوين).
    • إذا كان هناك صف أول فارغ، يرجى حذفه تماماً.
  3. بيانات التاريخ: يفضل أن يكون عمود "تاريخ الازدياد" منسقاً كـ Date في إكسيل، وسيقوم التطبيق تلقائياً بتحويله إلى صيغة YYYY-MM-DD.

🚀 كيفية الاستخدام

  1. قم بتشغيل التطبيق عبر bun run dev.
  2. افتح http://localhost:3000 في المتصفح.
  3. اختر ملف الإكسيل الجاهز.
  4. قم بربط الحقول المطلوبة (الاسم، البطاقة الوطنية، إلخ) بالأعمدة المقابلة لها في ملفك.
  5. اضغط على "توليد المعاينة".
  6. اضغط على "طباعة" لاستخدام الطباعة المباشرة من المتصفح.

🛠️ التقنيات المستخدمة

  • Bun & Hono: للخادم الأساسي (Backend).
  • Puppeteer: لتوليد ملفات PDF (Server-side PDF).
  • XLSX (SheetJS): لمعالجة ملفات الإكسيل.
  • Tajawal & Samir.Khouaja.Maghribi: خطوط عربية متميزة.