folioci/mod-feesfines

FOLIO - mod-feesfines 镜像文档

镜像概述

mod-feesfines是FOLIO图书馆服务平台的核心模块之一，专注于提供费用和罚款的集中管理功能。该模块支持费用的创建、记录、查询与管理，是FOLIO系统中处理财务相关业务的关键组件。
代码仓库：https://github.com/folio-org/mod-feesfines

核心功能与特性

• 集中管理能力：实现费用和罚款全生命周期的集中化管理，包括规则配置、费用计算、记录追踪等
• 模块标准化：作为FOLIO生态的标准模块，遵循统一的接口规范，可与其他FOLIO模块无缝集成
• 资源配置优化：预设模块端口、内存及JVM参数，确保运行稳定性

技术规格

使用场景

适用于基于FOLIO构建的图书馆管理系统，主要应用场景包括：

• 图书借阅逾期罚款的计算与记录
• 图书损坏、丢失等赔偿费用的管理
• 图书馆各类服务相关费用（如打印费、复印费）的集中追踪

部署与配置指南

环境依赖

• 数据库：需外部数据库支持（如PostgreSQL），需提前配置数据库连接信息
• 网络：模块通过8081端口提供服务，需确保端口可访问

核心配置参数

Docker部署示例

基础运行命令

bash
docker run -d \
  --name mod-feesfines \
  -p 8081:8081 \
  -e DB_HOST=folio-db \
  -e DB_PORT=5432 \
  -e DB_NAME=folio_feesfines \
  -e DB_USER=folio_user \
  -e DB_PASSWORD=secure_password \
  -e JAVA_OPTIONS="-XX:MaxRAMPercentage=66.0" \
  folioorg/mod-feesfines:latest

注意事项

• 数据库连接信息需与实际环境匹配，确保数据库服务可访问且权限正确
• 容器内存配置为357913941字节（约341MB），生产环境可根据并发量和数据量调整资源分配
• JVM参数-XX:MaxRAMPercentage=66.0表示JVM可使用容器内存的66%，需根据容器实际内存限制调整比例

模块集成

该模块需与FOLIO系统的其他核心模块（如用户管理、 circulation 等）协同工作，具体集成方式请参考FOLIO官方文档及代码仓库说明。