folioorg/mod-notify

镜像概述

mod-notify是FOLIO项目的核心模块之一，专注于为用户提供通知服务功能。该模块负责处理FOLIO系统中的用户通知生成与分发，是图书馆服务平台中连接系统与用户的重要通信组件。

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

核心功能和特性

• 用户通知管理：支持向FOLIO系统用户发送各类通知信息
• 系统集成能力：与FOLIO平台其他模块无缝协同工作
• 数据持久化：依赖数据库连接实现通知数据的存储与管理
• 资源可控性：可通过环境变量配置Java运行参数及容器资源分配

使用场景和适用范围

适用于FOLIO图书馆服务平台环境，主要应用场景包括：

• 图书馆用户借阅到期提醒通知
• 账户状态变更（如权限调整、欠费提醒）
• 系统公告（如功能更新、维护通知）
• 个性化消息（如新到资源推荐、预约到馆通知）

使用方法和配置说明

基础配置参数

Docker部署示例

1. 基础运行命令

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

2. 环境变量说明

• 数据库连接参数（必需）：
  • DB_HOST: 数据库主机地址
  • DB_PORT: 数据库服务端口
  • DB_NAME: 数据库名称
  • DB_USER: 数据库访问用户名
  • DB_PASSWORD: 数据库访问密码
• Java配置参数（可选）：
  • JAVA_OPTIONS: 可自定义JVM参数，如调整内存分配：-XX:MaxRAMPercentage=70.0 -Xms256m

3. docker-compose配置示例

yaml
version: '3.8'
services:
  mod-notify:
    image: folio/mod-notify:latest
    container_name: mod-notify
    ports:
      - "8081:8081"
    environment:
      - DB_HOST=postgres
      - DB_PORT=5432
      - DB_NAME=folio
      - DB_USER=folio_app
      - DB_PASSWORD=strong_password
      - JAVA_OPTIONS=-XX:MaxRAMPercentage=66.0
    depends_on:
      - postgres
    restart: unless-stopped

  postgres:
    image: postgres:13
    environment:
      - POSTGRES_DB=folio
      - POSTGRES_USER=folio_app
      - POSTGRES_PASSWORD=strong_password

注意事项

• 数据库服务需提前部署并确保网络可达
• 生产环境建议通过Docker Secrets或环境变量管理敏感信息（如数据库密码）
• 根据实际负载可调整JAVA_OPTIONS中的内存参数，避免资源不足或浪费
• 模块升级前建议备份数据库中与通知相关的业务数据