عن المشروع

Worship Presenter Web هو مركز مستضاف ذاتيًا مصمم لتحويل جدول خدمة العبادة إلى شرائح جاهزة. تم بناؤه لجماعة السبتيين لكنه قابل للتكيف مع أي كنيسة تتبع ترتيب خدمة مشابهًا، لأن قوالب الشرائح هي بيانات وليست كودًا. سير العمل الأساسي يأخذ جدول الخدمة—الذي يُلصق في نموذج ويب أو يُرسل عبر webhook محمي بسر من روبوت محادثة—وينتج ثلاثة مخرجات من خطة شرائح واحدة مكتملة: عرض PowerPoint قابل للتنزيل للاستخدام دون اتصال، وعرض شرائح في المتصفح بملء الشاشة، ووضع مقدم بشاشتين مع نافذة بروجكتر منفصلة. هذا يعني أن نفس التخطيط يحرك جميع المخرجات الأربعة (PowerPoint، عرض الويب، البروجكتر، والمعاينة المباشرة) دون أي كود تخطيط خاص بكل صيغة. تشمل الميزات الرئيسية: - استقبال جدول الخدمة عبر نموذج ويب أو webhook، مع إظهار الأسطر غير المعروفة بدلاً من تجاهلها بصمت. - حل الترانيم من مجموعة محلية تضم 695 ترنيمة، تُبحث بالرقم وتُوسع إلى شرائح عنوان وكلمات مع تكرار اللازمة بعد كل مقطع. - 28 قالب شرائح قابل للتحرير مخزنة في سجل SQLite مع محرر لوحة لتحريك العناصر وتغيير حجمها وتنسيقها، بالإضافة إلى إمكانية إضافة مربعات نصية وأشكال مخصصة. - وضع المقدم مع الشريحة الحالية والتالية، وشريط صور مصغرة، وقائمة شرائح، وشبكة للانتقال إلى أي شريحة، وورقة التشغيل، ونافذة ثانية حقيقية يمكن سحبها إلى البروجكتر. - وظيفة شاشة فارغة لتعتيم البروجكتر واستعادته دون فقدان الموضع. - انتقالات قابلة للاختيار (بدون، قص، تلاشي، ذوبان، دفع) تُطبق بشكل متطابق على العرض والمتصفح. - استعلام عن الكتاب المقدس لجلب مقاطع KJV إلى البروجكتر أثناء الخدمة. - نشرات إعلانية مع رفع صور أو عناوين URL من قائمة مسموحة. - حسابات وأدوار مع حسابات إدارة وتشغيل لكل شخص، وتسجيل دخول محدود المعدل، وجلسات قابلة للإلغاء. يأتي التطبيق مع مجموعتين افتراضيتين: مجموعة ترانيم (695 ترنيمة من ترنيمة السبتيين) ومجموعة كتاب مقدس KJV (66 سفرًا، 1,189 إصحاحًا، 31,102 آية). كلاهما مضمّن في المستودع بحيث يحل استنساخ الأرقام والمراجع دون اتصال بالشبكة عند الإقلاع. تتم مطابقة المجموعات من ملفاتها المضمّنة عند كل إقلاع. المتطلبات التقنية هي Go 1.24 وNode.js 22 أو أحدث. يستخدم التخزين SQLite دون خادم قاعدة بيانات منفصل. تشمل الحزمة واجهة Go API، وتطبيق React SPA مبني بـ Vite، وعامل PPTX. يتضمن البدء السريع استنساخ المستودع، وتشغيل npm install، وnpm run setup (الذي يولّد .env بأسرار جديدة، وينشئ قاعدة البيانات، ويزرع سجل الشرائح، ويطبع كلمة مرور المسؤول)، وnpm run dev لبدء Go API على المنفذ 3000 وتطبيق React SPA على المنفذ 5173. يتضمن المشروع دليل دستور مع إرشادات للتعامل مع البيانات الخاصة، ووثائق نشر، وسجلات قرارات. يفشل اختبار إذا وصلت بيانات الجماعة إلى ملف متتبع، مما يحمي من النشر العرضي للمعلومات الحساسة. يبدأ المستودع من التزام أولي واحد مع جماعة مثال اصطناعية، لأن المستودع الخاص الأصلي احتوى على أسماء أعضاء حقيقية، وصور أشخاص يمكن التعرف عليهم بما في ذلك قاصرين، ولقطات شاشة لرسائل خاصة، ورمز دفع حي. الرمز مرخص تحت MIT، لكن اسم Worship Presenter Web، والاختصار WDI، والأيقونة أو الشعار غير مشمولة بترخيص MIT. المحتوى الخارجي بما في ذلك مجموعة الترانيم مغطى بشكل منفصل في ATTRIBUTIONS.md. يشجع المشروع على التكيف مع التقاليد والترانيم الأخرى، مع دعم إضافة مجموعات ترانيم إضافية بجانب المجموعة المرفقة.