alf.io

alf.io

Sistem reservasi tiket open source.

Alf.io ([ˈalfjo]) adalah sistem manajemen kehadiran acara gratis dan bersumber terbuka, dikembangkan untuk penyelenggara acara yang peduli dengan privasi, keamanan, dan kebijakan harga yang adil bagi pelanggannya.

Daftar isi

1. Prasyarat
2. Profil musim semi
3. Jalankan dalam mode pengembangan
4. Berkontribusi pada alf.io
5. Periksa dependensi untuk diperbarui
6. Menjalankan kontainer Docker
7. Kontributor

Prasyarat

Anda harus menginstal Java versi 17 (misalnya Oracle, OpenJDK, atau distribusi lainnya) untuk membangun dan menjalankan alf.io. Harap dicatat bahwa untuk proses pembangunan JDK diperlukan.

Postgresql versi 10 atau lebih baru.

Selain itu, pengguna database yang membuat dan menggunakan tabel tidak boleh menjadi "SUPERUSER", atau pemeriksaan kebijakan keamanan baris tidak akan diterapkan.

Catatan

Saat pekerjaan untuk Alf.io v2 telah dimulai, cabang ini mungkin berisi kode yang tidak stabil dan belum teruji . Jika Anda ingin membangun dan menerapkan alf.io sendiri, silakan mulai dari versi Dirilis.

Profil musim semi

Ada profil pegas berikut

• dev : mengaktifkan mode pengembang
• spring-boot : ditambahkan saat diluncurkan oleh spring-boot
• demo : aktifkan mode demo, akun untuk admin akan dibuat dengan cepat
• disable-jobs : menonaktifkan pekerjaan
• jdbc-session : mempertahankan sesi pengguna di database

Jalankan dalam mode pengembangan

Pembangunan Gradle

Build ini menyertakan salinan pembungkus Gradle. Anda tidak perlu menginstal Gradle di sistem Anda untuk membangun proyek. Cukup jalankan wrapper bersama dengan tugas yang sesuai, misalnya

 ./gradlew clean

Berjalan dengan banyak profil

Anda harus menentukan properti proyek di baris perintah, seperti

 ./gradlew -Pprofile=dev :bootRun

Tugas "bootRun" lokal memiliki prasyarat berikut:

• instance PostgreSQL (versi 10 atau lebih baru) aktif dan berjalan di localhost:5432
• pengguna postgres memiliki kata sandi: kata sandi
• database bernama alfio

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

setelah dimulai, alf.io akan membuat semua tabel yang diperlukan dalam database, dan tersedia di http://localhost:8080/admin. Anda dapat masuk menggunakan Nama Pengguna default admin dan kata sandi yang dicetak di konsol.

Anda bisa mendapatkan daftar semua tugas Gradle yang didukung dengan menjalankan

 ./gradlew tasks --all

Anda dapat mengonfigurasi properti Sistem tambahan (jika Anda membutuhkannya) dengan membuat file berikut dan memasukkan satu properti per baris ke dalamnya:

 vi custom.jvmargs

Perlu diketahui bahwa karena file ini mungkin berisi informasi sensitif (seperti kunci API pribadi Google Maps), maka file ini akan diabaikan secara otomatis oleh git.

Untuk debug

Tambahkan baris baru dengan: -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005 di custom.jvmargs

Berkontribusi pada alf.io

Mengimpor proyek Gradle ke Intellij dan Eclipse keduanya berfungsi.

Catatan :

• proyek ini menggunakan Proyek Lombok. Anda perlu menginstal plugin Lombok yang sesuai untuk diintegrasikan ke dalam IDE Anda.
• proyek ini menggunakan TestContainers untuk menjalankan tes integrasi terhadap database PostgreSQL yang sebenarnya. Harap pastikan bahwa konfigurasi Anda memenuhi persyaratan mereka

Cara mengkonfigurasi TestContainers dengan Podman (Fedora 34)

Karena TestContainers mengharapkan soket buruh pelabuhan untuk mengelola kontainer, Anda perlu melakukan hal berikut (lihat masalah asli untuk detailnya):

Tentukan 2 lingkungan. variabel:

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

Dan jalankan di konsol lain:

 podman system service -t 0

Yang perlu diperhatikan:

• untuk alasan yang tidak diketahui, saat pertama kali podman mengunduh gambar yang hilang, wadah pengujian akan gagal. Jalankan lain kali dan itu akan berhasil.
• secara teori, dengan aktivasi systemd+socket, layanan akan dimulai secara otomatis, tetapi saat ini saya tidak dapat membuatnya berfungsi.

Periksa dependensi untuk diperbarui

./gradlew dependencyUpdates

Menjalankan kontainer Docker

Gambar kontainer tersedia di https://hub.docker.com/r/alfio/alf.io/tags.

alf.io juga dapat dijalankan dengan Docker Compose ( mode pengembangan ):

 docker-compose up

Menjalankan alf.io dalam produksi menggunakan penulisan Docker tidak didukung secara resmi. Namun, jika Anda memutuskan untuk melakukannya, Anda perlu melakukan beberapa perubahan:

• Batalkan komentar pada layanan alfio di file docker-compose.yml
• Periksa pengguna dan kata sandi untuk layanan di file .env
• Tangani penghentian SSL (misalnya dengan sesuatu seperti tutum/haproxy ) 443 -> 8080

Uji aplikasi alf.io

• Periksa log alfio: docker logs alfio
• Salin kata sandi admin di tempat yang aman
• Dapatkan IP container buruh pelabuhan Anda: (hanya di Mac/Windows, di Linux proxy akan mengikat langsung ke IP publik Anda)
  • boot2docker IP di Mac/Windows
• Buka browser di: https://DOCKER_IP/admin
• Masukkan admin pengguna dan kata sandi yang baru saja Anda salin

Buat versi baru image buruh pelabuhan alfio/alf.io

Bangun aplikasi dan Dockerfile

 ./gradlew distribution

Alternatifnya, Anda dapat menggunakan Docker ( eksperimental ):

 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

Harap dicatat bahwa saat ini perintah di atas menjalankan pembangunan tanpa menjalankan pengujian otomatis. Gunakan dengan risiko Anda sendiri.

Buat gambar buruh pelabuhan:

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

Tentang AppleWWDRCAG4.cer yang disertakan

Sertifikat di src/main/resources/alfio/certificates/AppleWWDRCAG4.cer telah diimpor untuk fungsi https://github.com/ryantenney/passkit4j#usage. Masa berlakunya akan berakhir pada 12-10-2030 (YYYY-MM-DD - mulai https://www.apple.com/certificateauthority/).

Kontributor

Kontributor Kode

Proyek ini ada berkat semua orang yang berkontribusi.

Kontributor Terjemahan (POEditor)

Ucapan terima kasih yang sebesar-besarnya juga ditujukan kepada penerjemah kami, yang membantu kami di POEditor:

(kami menampilkan nama/profil lengkap hanya jika kami telah menerima persetujuan eksplisit untuk melakukannya)

Bahasa	Nama	Github	Twitter
Belanda (nl)	Matijis
Turki (tr)	Dilek
Spanyol (es)	Mario Varona	@mvarona	@MarioVarona
Spanyol (es)	Sergi Almar	@salmar	@sergiamar
Spanyol (es)	Yeremia
Bulgaria (bg)	Martin Zhekov	@ Martin03	@MartensZone
Portugis (pt)	Hugo
Swedia (sv)	Johan
Rumania (ro)	Daniel
Polandia (jamak)	Pawel
Denmark (da)	Matahari

terjemahan selesai tetapi belum terintegrasi (WIP)

Bahasa	Nama	Github	Twitter
Jepang (jp)	Martin
Cina (Taiwan) (cn_TW)	Yu-cheng, Lin

Sponsor

Proyek ini disponsori oleh:

Program Sumber Terbuka

Kontributor Keuangan

Menjadi kontributor keuangan dan membantu kami mempertahankan komunitas kami. [Menyumbang]

Individu

Organisasi

Dukung proyek ini dengan organisasi Anda. Logo Anda akan muncul di sini dengan tautan ke situs web Anda. [Menyumbang]