تنزيل alf.io - تنزيل كود المصدر alf.io

alf.io

جافا كود المصدر

2.0-M5

تنزيل

alf.io

نظام حجز التذاكر مفتوح المصدر.

Alf.io ([ˈalfjo]) هو نظام مجاني ومفتوح المصدر لإدارة حضور الأحداث، تم تطويره لمنظمي الأحداث الذين يهتمون بالخصوصية والأمان وسياسة التسعير العادل لعملائهم.

جدول المحتويات

المتطلبات الأساسية
لمحات عن الربيع
تشغيل في وضع التطوير
المساهمة في alf.io
تحقق من التبعيات للتحديث
تشغيل حاويات Docker
المساهمين

المتطلبات الأساسية

ينبغي عليك تثبيت الإصدار 17 من Java (مثل Oracle's أو OpenJDK أو أي توزيعة أخرى) لإنشاء alf.io وتشغيله. يرجى ملاحظة أن عملية البناء مطلوبة JDK.

Postgresql الإصدار 10 أو الأحدث.

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

ملحوظة

مع بدء العمل على Alf.io v2، قد يحتوي هذا الفرع على تعليمات برمجية غير مستقرة وغير مختبرة . إذا كنت ترغب في إنشاء ونشر alf.io بنفسك، فيرجى البدء من الإصدار الذي تم إصداره.

لمحات عن الربيع

هناك ملفات تعريف الربيع التالية

dev : تمكين وضع ديف
spring-boot : تتم إضافته عند إطلاقه بواسطة Spring-boot
demo : قم بتمكين الوضع التجريبي، وسيتم إنشاء حسابات المشرف بسرعة
disable-jobs : تعطيل الوظائف
jdbc-session : استمرار جلسة المستخدم في قاعدة البيانات

تشغيل في وضع التطوير

بناء جرادل

يتضمن هذا الإصدار نسخة من برنامج Gradle. ليس من الضروري تثبيت Gradle على نظامك لإنشاء المشروع. ما عليك سوى تنفيذ برنامج التضمين مع المهمة المناسبة، على سبيل المثال

 ./gradlew clean

تشغيل مع ملفات تعريف متعددة

يجب عليك تحديد خاصية المشروع في سطر الأوامر، مثل

 ./gradlew -Pprofile=dev :bootRun

تحتوي مهمة "bootRun" المحلية على المتطلبات الأساسية التالية:

مثيل PostgreSQL (الإصدار 10 أو الأحدث) قيد التشغيل على المضيف المحلي:5432
مستخدم Postgres لديه كلمة مرور: كلمة المرور
قاعدة بيانات اسمها ألفيو

 docker run -d --name alfio-db -p 5432:5432 -e POSTGRES_PASSWORD=password -e POSTGRES_DB=alfio --restart unless-stopped postgres

بمجرد البدء، سيقوم alf.io بإنشاء جميع الجداول المطلوبة في قاعدة البيانات، وسيكون متاحًا على http://localhost:8080/admin. يمكنك تسجيل الدخول باستخدام اسم المستخدم الافتراضي admin وكلمة المرور التي تمت طباعتها على وحدة التحكم.

يمكنك الحصول على قائمة بجميع مهام Gradle المدعومة عن طريق التشغيل

 ./gradlew tasks --all

يمكنك تكوين خصائص النظام الإضافية (إذا كنت في حاجة إليها) عن طريق إنشاء الملف التالي ووضع خاصية واحدة فيه في كل سطر:

 vi custom.jvmargs

يرجى العلم أنه نظرًا لأن هذا الملف قد يحتوي على معلومات حساسة (مثل مفتاح API الخاص لخرائط Google)، فسيتم تجاهله تلقائيًا بواسطة git.

لتصحيح الأخطاء

أضف سطرًا جديدًا باستخدام: -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005 في custom.jvmargs

المساهمة في alf.io

يعمل استيراد مشروع Gradle إلى Intellij وEclipse.

ملحوظات :

يستخدم هذا المشروع مشروع لومبوك. سوف تحتاج إلى تثبيت البرنامج المساعد Lombok المقابل للتكامل في IDE الخاص بك.
يستخدم هذا المشروع TestContainers لإجراء اختبارات التكامل مع قاعدة بيانات PostgreSQL حقيقية. يرجى التأكد من أن التكوين الخاص بك يلبي متطلباتهم

كيفية تكوين حاويات الاختبار باستخدام Podman (Fedora 34)

نظرًا لأن TestContainers تتوقع وجود مقبس عامل إرساء لإدارة الحاويات، فستحتاج إلى القيام بما يلي (راجع الإصدار الأصلي للحصول على التفاصيل):

تحديد البيئة 2. عامل:

 export TESTCONTAINERS_RYUK_DISABLED=true
export DOCKER_HOST=unix:///run/user/1000/podman/podman.sock

وتشغيل في وحدة تحكم أخرى:

 podman system service -t 0

تجدر الإشارة إلى:

لسبب غير معروف، في المرة الأولى التي يقوم فيها Podman بتنزيل الصور المفقودة، ستفشل حاويات الاختبار. تشغيل مرة أخرى وسوف تعمل.
من الناحية النظرية، مع تنشيط systemd+socket، يجب أن تبدأ الخدمة تلقائيًا، لكنني لم أتمكن حاليًا من تشغيلها.

تحقق من التبعيات للتحديث

./gradlew dependencyUpdates

تشغيل حاويات Docker

صور الحاوية متاحة على https://hub.docker.com/r/alfio/alf.io/tags.

يمكن أيضًا تشغيل alf.io باستخدام Docker Compose ( وضع التطوير ):

 docker-compose up

تشغيل alf.io في الإنتاج باستخدام Docker compose غير مدعوم رسميًا. ومع ذلك، إذا قررت القيام بذلك، فأنت بحاجة إلى إجراء بعض التغييرات:

قم بإلغاء التعليق على خدمة alfio في ملف docker-compose.yml
تحقق من المستخدم وكلمة المرور للخدمات الموجودة في ملف .env
التعامل مع إنهاء SSL (على سبيل المثال بشيء مثل tutum/haproxy ) 443 -> 8080

اختبار تطبيق alf.io

تحقق من سجلات ألفيو: docker logs alfio
انسخ كلمة مرور المسؤول في مكان آمن
احصل على عنوان IP الخاص بحاوية الإرساء الخاصة بك: (فقط على أنظمة Mac/Windows، وعلى Linux، سيرتبط الوكيل مباشرةً بعنوان IP العام الخاص بك)
- boot2docker IP على نظام التشغيل Mac/Windows
افتح المتصفح على: https://DOCKER_IP/admin
أدخل مسؤول المستخدم وكلمة المرور التي نسختها للتو

قم بإنشاء نسخة جديدة من صورة عامل الإرساء alfio/alf.io

بناء التطبيق وDockerfile

 ./gradlew distribution

وبدلاً من ذلك، يمكنك استخدام Docker ( تجريبي ):

 docker run --rm -u gradle -v "$PWD":/home/gradle/project -w /home/gradle/project gradle:7.0.0-jdk11 gradle --no-daemon distribution -x test

يرجى ملاحظة أنه في الوقت الحالي يقوم الأمر أعلاه بالإنشاء دون تشغيل الاختبارات الآلية. استخدامه على مسؤوليتك الخاصة.

إنشاء صورة عامل الإرساء:

 docker build -t alfio/alf.io ./build/dockerize

حول AppleWWDRCAG4.cer المضمن

تم استيراد الشهادة الموجودة على src/main/resources/alfio/certificates/AppleWWDRCAG4.cer لوظيفة https://github.com/ryantenney/passkit4j#usage. ستنتهي صلاحيتها في 12-10-2030 (YYYY-MM-DD - اعتبارًا من https://www.apple.com/certificateauthority/).

المساهمين

المساهمين في الكود

هذا المشروع موجود بفضل جميع الأشخاص الذين ساهموا فيه.

المساهمون في الترجمة (POEditor)

شكرًا جزيلًا أيضًا لمترجمينا الذين يساعدوننا في POEditor:

(نعرض الاسم/الملف الشخصي الكامل فقط إذا تلقينا موافقة صريحة للقيام بذلك)

لغة	اسم	جيثب	تغريد
الهولندية (nl)	ماتجيس
التركية (تر)	ديليك
الاسبانية (بالإسبانية)	ماريو فارونا	@mvarona	@ ماريو فارونا
الاسبانية (بالإسبانية)	سيرجي ألمار	@salmar	@sergiamar
الاسبانية (بالإسبانية)	ارميا
البلغارية (بج)	مارتن جيكوف	@ مارتن03	@مارتنززون
البرتغالية (نقطة)	هوغو
السويدية (سفيت)	يوهان
الرومانية (ريال عماني)	دانيال
البولندية (ر)	باول
الدنماركية (دا)	سوني