folioorg/mod-invoice

FOLIO - mod-invoice

概述

mod-invoice是FOLIO项目的核心模块之一，主要负责处理发票相关的业务逻辑。该模块为FOLIO生态系统提供发票管理的基础功能支持。

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

核心功能与特性

基础信息

• 模块端口：8081（容器内服务端口）
• 容器内存限制：838860800字节（800MB）
• 数据库连接：支持（需配置数据库参数）

配置参数

• JAVA_OPTIONS：-XX:MaxRAMPercentage=66.0（JVM内存配置，最大使用可用内存的66%）

环境变量

• KAFKA_HOST：Kafka服务主机地址，默认值为10.0.2.15
• KAFKA_PORT：Kafka服务端口，默认值为9092
• dataimport.consumer.verticle.mandatory：数据导入消费者Verticle是否强制模式，默认值为false
• dataimport.max-active-threads：数据导入最大活动线程数，默认值为1

使用场景与适用范围

适用于FOLIO生态系统中涉及发票管理的业务场景，包括发票数据处理、流转及集成等相关业务逻辑实现，需配合FOLIO其他模块及基础设施（如数据库、Kafka）使用。

使用方法与配置说明

Docker运行示例

bash
docker run -d \
  -p 8081:8081 \
  -e DB_HOST=your-db-host \
  -e DB_PORT=5432 \
  -e DB_NAME=folio_mod_invoice \
  -e DB_USER=folio_user \
  -e DB_PASSWORD=folio_password \
  -e KAFKA_HOST=kafka-service \
  -e KAFKA_PORT=9092 \
  -e dataimport.consumer.verticle.mandatory=false \
  -e dataimport.max-active-threads=1 \
  -e JAVA_OPTIONS="-XX:MaxRAMPercentage=66.0" \
  folio/mod-invoice

配置说明

1. 端口映射：需将容器内8081端口映射至宿主机端口（示例中映射为8081）。
2. 数据库配置：需通过环境变量配置数据库连接参数（DB_HOST、DB_PORT、DB_NAME、DB_USER、DB_PASSWORD等，具体参数需根据实际数据库环境调整）。
3. Kafka配置：根据实际Kafka服务地址调整KAFKA_HOST和KAFKA_PORT。
4. 性能调优：可通过JAVA_OPTIONS调整JVM参数，默认配置为-XX:MaxRAMPercentage=66.0。