folioci/mod-circulation

FOLIO - mod-circulation

镜像概述

mod-circulation是FOLIO图书馆服务平台的核心功能模块，专注于处理图书馆日常流通业务，包括借阅、归还、续借、馆藏状态管理等核心操作。该模块支持灵活的配置选项，可与Kafka消息系统集成，满足不同图书馆的流通规则需求。

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

核心功能与特性

• 流通业务处理：支持图书借阅、归还、续借等基础流通操作的全流程管理
• 浮动馆藏管理：通过ENABLE_FLOATING_COLLECTIONS配置启用/禁用浮动馆藏功能
• 使用地点控制：通过ENABLE_FOR_USE_AT_LOCATION参数控制使用地点相关权限
• Kafka集成：支持与Kafka消息系统对接，实现流通事件的异步处理与消息传递
• 计划化**：通过SCHEDULED_ANONYMIZATION_NUMBER_OF_LOANS_TO_CHECK配置借阅记录**化检查数量
• 资源优化：默认配置JAVA_OPTIONS=-XX:MaxRAMPercentage=66.0，优化JVM内存使用

使用场景与适用范围

适用于基于FOLIO平台构建的各类图书馆管理系统，包括：

• 高校图书馆的日常流通业务管理
• 公共图书馆的借阅流程自动化
• 需要自定义流通规则（如浮动馆藏、使用地点限制）的图书馆
• 需集成消息队列处理流通事件的场景

使用方法与配置说明

基础运行信息

• 模块端口：9801（容器内服务监听端口）
• 容器内存：***字节（1GB）
• 数据库连接：false（无需独立数据库，依赖FOLIO平台共享数据库）

环境变量配置

Docker部署示例

基本运行命令

bash
docker run -d \
  --name mod-circulation \
  -p 9801:9801 \
  -e SCHEDULED_ANONYMIZATION_NUMBER_OF_LOANS_TO_CHECK=50000 \
  -e ENABLE_FLOATING_COLLECTIONS=true \
  -e ENABLE_FOR_USE_AT_LOCATION=false \
  -e KAFKA_HOST=kafka \
  -e KAFKA_PORT=9092 \
  -e REPLICATION_FACTOR=1 \
  -e ENV=folio \
  -e JAVA_OPTIONS="-XX:MaxRAMPercentage=66.0" \
  folio/mod-circulation

Docker Compose配置示例

yaml
version: '3'
services:
  mod-circulation:
    image: folio/mod-circulation
    container_name: mod-circulation
    ports:
      - "9801:9801"
    environment:
      - SCHEDULED_ANONYMIZATION_NUMBER_OF_LOANS_TO_CHECK=50000
      - ENABLE_FLOATING_COLLECTIONS=true
      - ENABLE_FOR_USE_AT_LOCATION=false
      - KAFKA_HOST=kafka
      - KAFKA_PORT=9092
      - REPLICATION_FACTOR=1
      - ENV=folio
      - JAVA_OPTIONS=-XX:MaxRAMPercentage=66.0
    depends_on:
      - kafka
    restart: unless-stopped