alf.io

อัลฟ์.io

ระบบจองตั๋วโอเพ่นซอร์ส

Alf.io ([ˈalfjo]) เป็นระบบการจัดการการเข้าร่วมกิจกรรมแบบโอเพ่นซอร์สฟรี พัฒนาขึ้นสำหรับผู้จัดงานที่ใส่ใจเกี่ยวกับนโยบายความเป็นส่วนตัว ความปลอดภัย และการกำหนดราคาที่ยุติธรรมสำหรับลูกค้า

สารบัญ

1. ข้อกำหนดเบื้องต้น
2. โปรไฟล์สปริง
3. ทำงานในโหมดการพัฒนา
4. การมีส่วนร่วมใน alf.io
5. ตรวจสอบการพึ่งพาเพื่ออัปเดต
6. ใช้งานคอนเทนเนอร์ Docker
7. ผู้ร่วมให้ข้อมูล

ข้อกำหนดเบื้องต้น

คุณควรติดตั้ง Java เวอร์ชัน 17 (เช่น Oracle's, OpenJDK หรือการแจกจ่ายอื่นๆ) เพื่อสร้างและรัน alf.io โปรดทราบว่าสำหรับกระบวนการสร้างนั้นจำเป็นต้องใช้ JDK

PostgreSQL เวอร์ชัน 10 หรือใหม่กว่า

นอกจากนี้ ผู้ใช้ฐานข้อมูลที่สร้างและใช้ตารางไม่ควรเป็น "SUPERUSER" ไม่เช่นนั้น การตรวจสอบนโยบายความปลอดภัยของแถวจะไม่ถูกนำมาใช้

บันทึก

เมื่องานสำหรับ Alf.io v2 เริ่มต้นขึ้น สาขานี้อาจมีโค้ด ที่ไม่เสถียร และ ยังไม่ผ่านการทดสอบ หากคุณต้องการสร้างและปรับใช้ alf.io ด้วยตัวเอง โปรดเริ่มจากเวอร์ชันที่เผยแพร่

โปรไฟล์สปริง

There are the following spring profiles

• dev : เปิดใช้งานโหมด dev
• spring-boot : เพิ่มเมื่อเปิดใช้งานโดย spring-boot
• demo : เปิดใช้งานโหมดสาธิต บัญชีสำหรับผู้ดูแลระบบจะถูกสร้างขึ้นทันที
• disable-jobs : ปิดการใช้งานงาน
• jdbc-session : คงเซสชันผู้ใช้ไว้ในฐานข้อมูล

ทำงานในโหมดการพัฒนา

สร้าง Gradle

โครงสร้างนี้มีสำเนาของ wrapper Gradle คุณไม่จำเป็นต้องติดตั้ง Gradle บนระบบของคุณเพื่อสร้างโปรเจ็กต์ เพียงดำเนินการ wrapper พร้อมกับงานที่เหมาะสม เป็นต้น

 ./gradlew clean

ทำงานด้วยหลายโปรไฟล์

คุณต้องระบุคุณสมบัติโครงการที่บรรทัดคำสั่ง เช่น

 ./gradlew -Pprofile=dev :bootRun

งาน "bootRun" ในเครื่องมีข้อกำหนดเบื้องต้นดังต่อไปนี้:

• อินสแตนซ์ PostgreSQL (เวอร์ชัน 10 หรือใหม่กว่า) ที่ใช้งานบน localhost:5432
• ผู้ใช้ postgres มีรหัสผ่าน: รหัสผ่าน
• ฐานข้อมูลชื่อ alfio

 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 คุณสามารถเข้าสู่ระบบโดยใช้ชื่อผู้ใช้เริ่มต้น ผู้ดูแลระบบ และรหัสผ่านที่พิมพ์บนคอนโซล

คุณสามารถรับรายการงาน Gradle ที่รองรับทั้งหมดได้โดยการรัน

 ./gradlew tasks --all

คุณสามารถกำหนดค่าคุณสมบัติระบบเพิ่มเติมได้ (หากต้องการ) โดยสร้างไฟล์ต่อไปนี้และใส่คุณสมบัติหนึ่งรายการต่อบรรทัด:

 vi custom.jvmargs

โปรดทราบว่าเนื่องจากไฟล์นี้อาจมีข้อมูลที่ละเอียดอ่อน (เช่น คีย์ API ส่วนตัวของ Google Maps) จึงจะถูกละเว้นโดย git โดยอัตโนมัติ

สำหรับการดีบัก

เพิ่มบรรทัดใหม่ด้วย: -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005 ใน custom.jvmargs

การมีส่วนร่วมใน alf.io

การนำเข้าโครงการ Gradle ไปยัง Intellij และ Eclipse ใช้งานได้ทั้งคู่

หมายเหตุ :

• โครงการนี้ใช้โครงการลอมบอก คุณจะต้องติดตั้งปลั๊กอินลอมบอกที่เกี่ยวข้องเพื่อรวมเข้ากับ IDE ของคุณ
• โปรเจ็กต์นี้ใช้ TestContainers เพื่อรันการทดสอบการรวมกับฐานข้อมูล PostgreSQL จริง โปรดตรวจสอบให้แน่ใจว่าการกำหนดค่าของคุณตรงตามข้อกำหนด

วิธีกำหนดค่า TestContainers ด้วย 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 ดาวน์โหลดอิมเมจที่หายไป testcontainers จะล้มเหลว เรียกใช้อีกครั้งและมันจะทำงาน
• ตามทฤษฎีแล้ว ด้วยการเปิดใช้งาน systemd+socket บริการควรเริ่มโดยอัตโนมัติ แต่ตอนนี้ฉันไม่สามารถทำงานได้

ตรวจสอบการพึ่งพาเพื่ออัปเดต

./gradlew dependencyUpdates

ใช้งานคอนเทนเนอร์ Docker

Container images are available on 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

• ตรวจสอบบันทึก alfio: 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 (ปปปป-ดด-วว - ณ https://www.apple.com/certificateauthority/)

ผู้ร่วมให้ข้อมูล

ผู้ร่วมเขียนโค้ด

โครงการนี้เกิดขึ้นได้ต้องขอบคุณทุกคนที่มีส่วนร่วม

ผู้ร่วมแปล (POEditor)

ขอขอบคุณนักแปลของเราที่ช่วยเราใน POEditor เป็นอย่างยิ่ง:

(เราแสดงชื่อเต็ม/โปรไฟล์เฉพาะในกรณีที่เราได้รับความยินยอมอย่างชัดแจ้งเท่านั้น)

ภาษา	ชื่อ	Github	ทวิตเตอร์
Dutch (nl)	แมทจิส
ตุรกี (tr)	ดิเล็ก
สเปน (es)	มาริโอ วาโรน่า	@mvarona	@มาริโอ้วาโรน่า
สเปน (es)	เซอร์กี อัลมาร์	@ซัลมาร์	@เซอร์จิอัลมาร์
สเปน (es)	เจเรเมียส
บัลแกเรีย (บีจี)	มาร์ติน เจคอฟ	@มาร์ติน03	@MartensZone
โปรตุเกส (pt)	ฮิวโก้
ภาษาสวีเดน (sv)	โยฮัน
โรมาเนีย (ro)	แดเนียล
โปแลนด์ (pl)	พาเวล
เดนมาร์ก (ดา)	ซูเน่

การแปลเสร็จสมบูรณ์แต่ยังไม่ได้บูรณาการ (WIP)

ภาษา	ชื่อ	Github	ทวิตเตอร์
Japanese (jp)	มาร์ติน
จีน (ไต้หวัน) (cn_TW)	หยูเฉิง, หลิน

สปอนเซอร์

โครงการนี้ได้รับการสนับสนุนโดย:

โปรแกรมโอเพ่นซอร์ส

ผู้มีส่วนร่วมทางการเงิน

ร่วมเป็นผู้บริจาคทางการเงินและช่วยเรารักษาชุมชนของเรา [มีส่วนช่วย]

บุคคล

องค์กร

สนับสนุนโครงการนี้กับองค์กรของคุณ โลโก้ของคุณจะแสดงที่นี่พร้อมลิงก์ไปยังเว็บไซต์ของคุณ [มีส่วนช่วย]