folioci/mod-patron

FOLIO - mod-patron 镜像文档

镜像概述和主要用途

mod-patron是FOLIO（图书馆开放源代码基础设施）项目的核心模块之一，专注于图书馆读者（patron）相关业务逻辑处理。作为FOLIO服务生态的组成部分，该模块提供读者信息管理基础功能，适用于图书馆管理系统的读者服务场景。

代码仓库：https://github.com/folio-org/mod-patron

元数据信息：

• 模块端口：8081
• 容器内存：357913941字节（约341MB）
• 数据库连接：false（无需数据库依赖）
• JAVA_OPTIONS：-XX:MaxRAMPercentage=66.0（JVM内存配置参数）

核心功能和特性

• 读者信息处理：提供图书馆读者数据的基础处理能力，支持读者相关业务流程
• 无数据库依赖：元数据标识database connection: false，模块运行无需数据库支持，可独立部署
• JVM资源优化：通过JAVA_OPTIONS=-XX:MaxRAMPercentage=66.0配置JVM最大内存使用率，适配容器化环境资源管理
• 标准端口服务：默认使用8081端口对外提供服务，符合FOLIO模块通信规范，便于集成到平台架构中

使用场景和适用范围

适用于基于FOLIO平台构建的图书馆管理系统，可作为独立读者服务模块部署，支撑读者注册、信息查询、权限验证等基础读者业务。主要面向图书馆技术团队，用于搭建或扩展FOLIO服务架构中的读者管理能力。

详细使用方法和配置说明

基本部署命令

通过Docker运行模块，需映射8081端口以提供外部访问：

bash
docker run -d \
  -p 8081:8081 \
  --name mod-patron \
  folio/mod-patron

关键配置参数

高级配置示例

调整JVM内存参数并限制容器资源：

bash
docker run -d \
  -p 8081:8081 \
  --name mod-patron \
  --memory=341m \
  -e JAVA_OPTIONS="-XX:MaxRAMPercentage=70.0 -XX:+UseContainerSupport" \
  folio/mod-patron

FOLIO平台集成

作为FOLIO模块，需确保与平台其他服务（如Okapi网关、用户认证模块）网络互通。部署时建议通过Docker Compose与其他FOLIO服务协同编排，具体可参考FOLIO官方部署文档中的模块集成指南。