alf.io

阿爾夫io

開源門票預訂系統。

Alf.io ([ˈalfjo]) 是一個免費開源的活動出席管理系統，專為關心客戶隱私、安全和公平定價政策的活動組織者而開發。

目錄

1. 先決條件
2. 彈簧型材
3. 在開發模式下運行
4. 為 alf.io 做出貢獻
5. 檢查要更新的依賴項
6. 運行 Docker 容器
7. 貢獻者

先決條件

您應該安裝 Java 版本17 （例如 Oracle、OpenJDK 或任何其他發行版）來建置和執行 alf.io。請注意，建置過程需要 JDK。

Postgresql 版本 10 或更高版本。

此外，建立和使用表的資料庫使用者不應該是“SUPERUSER”，否則將不會套用行安全性原則檢查。

筆記

由於 Alf.io v2 的工作已經開始，該分支可能包含不穩定且未經測試的程式碼。如果您想自行建置和部署 alf.io，請從已發布版本開始。

彈簧型材

彈簧型材有以下幾種

• dev ：啟用開發模式
• spring-boot ： spring-boot 啟動時加入
• demo ：啟用演示模式，管理員帳戶將即時建立
• disable-jobs ：停用作業
• jdbc-session ：將使用者會話儲存在資料庫中

在開發模式下運行

搖籃構建

此建置包含 Gradle 包裝器的副本。您不必在系統上安裝 Gradle 來建置專案。例如，只需執行包裝器以及適當的任務

 ./gradlew clean

使用多個設定檔運行

您必須在命令列中指定項目屬性，例如

 ./gradlew -Pprofile=dev :bootRun

本機「bootRun」任務有以下先決條件：

• 在 localhost:5432 上啟動並執行的 PostgreSQL（版本 10 或更高版本）實例
• 具有密碼的postgres用戶： password
• 名為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 存取。您可以使用預設使用者名稱admin和控制台上列印的密碼登入。

您可以透過執行取得所有支援的 Gradle 任務的列表

 ./gradlew tasks --all

您可以透過建立以下文件並在其中每行放入一個屬性來配置其他系統屬性（如果需要）：

 vi custom.jvmargs

請注意，由於此文件可能包含敏感資訊（例如 Google 地圖私人 API 金鑰），因此 git 會自動忽略它。

用於偵錯

在 custom.jvmargs 中新增行： -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005

為 alf.io 做出貢獻

將 Gradle 專案導入 Intellij 和 Eclipse 都可以。

注意事項：

• 該項目使用龍目島項目。您需要安裝對應的 Lombok 插件才能整合到您的 IDE 中。
• 該專案使用 TestContainers 針對真實的 PostgreSQL 資料庫執行整合測試。請確保您的配置符合他們的要求

如何使用 Podman 設定 TestContainers (Fedora 34)

由於 TestContainers 期望使用 docker 套接字來管理容器，因此您需要執行以下操作（有關詳細信息，請參閱原​​始問題）：

定義 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 容器

容器映像可在 https://hub.docker.com/r/alfio/alf.io/tags 上取得。

alf.io 也可以使用 Docker Compose 運作（開發模式）：

 docker-compose up

官方不支援使用 Docker compose 在生產環境中運行 alf.io。但是，如果您決定這樣做，那麼您需要進行一些更改：

• 取消docker-compose.yml檔案中alfio服務的註釋
• 檢查.env檔案中服務的使用者和密碼
• 處理 SSL 終止（例如使用tutum/haproxy之類的東西）443 -> 8080

測試 alf.io 應用程式

• 檢查 alfio 日誌： docker logs alfio
• 將管理員密碼複製到安全的地方
• 取得您的 docker 容器的 IP：（僅在 Mac/Windows 上，在 Linux 上，代理程式將直接綁定到您的公用 IP）
  • Mac/Windows 上的boot2docker IP
• 開啟瀏覽器： https://DOCKER_IP/admin
• 輸入使用者admin和剛複製的密碼

產生新版本的 alfio/alf.io docker 映像

建置應用程式和 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 功能。該證書將於 2030 年 10 月 12 日（YYYY-MM-DD - 截至 https://www.apple.com/certificateauthority/）到期。

貢獻者

程式碼貢獻者

這個項目的存在要感謝所有做出貢獻的人。

翻譯貢獻者 (POEditor)

也要向我們的翻譯人員表示深深的“感謝”，他們在 POEditor 上為我們提供了幫助：

（只有在獲得明確同意的情況下，我們才會顯示完整的姓名/個人資料）

語言	姓名	吉圖布	嘰嘰喳喳
荷蘭語 (nl)	馬特吉斯
土耳其語 (tr)	迪萊克
西班牙語（西班牙文）	馬裡奧·瓦羅納	@姆瓦羅納	@馬裡奧瓦羅納
西班牙語（西班牙文）	塞爾吉·阿爾瑪	@薩爾瑪	@sergialmar
西班牙語（西班牙文）	傑瑞米亞斯
保加利亞語 (bg)	馬丁·哲可夫	@馬丁03	@MartensZone
葡萄牙語（點）	雨果
瑞典語 (sv)	約翰
羅馬尼亞語 (ro)	丹尼爾
波蘭語（pl）	帕維爾
丹麥語 (da)	蘇內

翻譯已完成但尚未整合（WIP）

語言	姓名	吉圖布	嘰嘰喳喳
日文 (jp)	馬丁
中文（台灣）(cn_TW)	林玉成

贊助商

此計畫由以下機構贊助：

開源程式

財務貢獻者

成為財務貢獻者並幫助我們維持我們的社區。 [貢獻]

個人

組織機構

與您的組織一起支持該專案。您的徽標將顯示在此處，並帶有指向您網站的連結。 [貢獻]