openlmis/report-ui

OpenLMIS Report UI Docker镜像文档

镜像概述

OpenLMIS Report UI Docker镜像是OpenLMIS（Open Logistics Management Information System）开源物流管理系统的前端报表用户界面组件。该镜像基于现代前端技术栈构建，通过集成OpenLMIS后端服务数据，为供应链管理人员提供直观的报表可视化、数据交互及报表管理功能，支持***资源库存、分发、消耗等关键业务数据的高效分析与决策支持。

核心功能与特性

1. 报表可视化展示

• 支持多种报表类型展示，包括表格、折线图、柱状图、饼图等数据可视化形式
• 提供自定义报表视图配置，满足不同用户的数据展示需求
• 支持报表数据实时更新与动态加载

2. 数据交互功能

• 提供报表数据筛选、排序、钻取功能，支持用户深入分析数据细节
• 支持报表导出功能（如CSV、PDF格式），便于离线数据分析
• 集成数据过滤组件，支持按时间范围、地理区域、产品类型等维度筛选数据

3. 报表管理能力

• 支持用户自定义报表模板创建与保存
• 提供报表权限管理，基于角色控制报表访问范围
• 支持报表收藏与历史访问记录功能

4. 系统集成与兼容性

• 无缝集成OpenLMIS后端API服务，获取实时业务数据
• 采用响应式设计，适配桌面端与移动端设备
• 支持多语言国际化配置，满足不同地区使用需求

使用场景与适用范围

适用场景

• ***供应链库存报表管理：展示药品、***耗材的库存水平、库存周转率等关键指标
• 分发报表分析：跟踪***资源从仓库到服务点的分发流程与效率
• 消耗趋势报表：分析特定区域或时间段内***资源的消耗模式与趋势预测
• 供应链绩效报表：评估供应链各环节（如订单处理、运输、接收）的运行效率

适用用户

• ***物流管理人员：监控供应链运行状态与关键指标
• 公共卫生决策者：基于报表数据制定***资源分配策略
• 仓库管理人员：跟踪库存变化与补货需求
• 系统管理员：配置与管理报表模板及权限

使用方法与配置说明

前提条件

• 已安装Docker Engine（20.10+版本推荐）
• 已部署OpenLMIS后端服务（需提供API访问地址）
• 网络环境可访问后端API服务与必要的前端资源

Docker镜像获取

bash
docker pull openlmis/openlmis-report-ui:latest
# 或指定特定版本
docker pull openlmis/openlmis-report-ui:vX.Y.Z

基础运行命令

bash
docker run -d \
  --name openlmis-report-ui \
  -p 8080:80 \
  -e API_URL=http://openlmis-backend:8080/api \
  -e AUTH_SERVER_URL=http://openlmis-auth:8080 \
  openlmis/openlmis-report-ui:latest

访问 http://localhost:8080 即可打开报表UI界面。

环境变量配置

Docker Compose配置示例

yaml
version: '3.8'
services:
  openlmis-report-ui:
    image: openlmis/openlmis-report-ui:latest
    container_name: openlmis-report-ui
    ports:
      - "8080:80"
    environment:
      - API_URL=http://openlmis-backend:8080/api
      - AUTH_SERVER_URL=http://openlmis-auth:8080
      - LOCALE=zh-CN
      - TIMEZONE=Asia/Shanghai
      - ENABLE_EXPORT=true
    depends_on:
      - openlmis-backend
      - openlmis-auth
    restart: unless-stopped

持久化配置

如需持久化自定义报表模板或用户偏好设置，可挂载数据卷（具体路径需参考OpenLMIS Report UI应用配置）：

bash
docker run -d \
  --name openlmis-report-ui \
  -p 8080:80 \
  -e API_URL=http://openlmis-backend:8080/api \
  -v ./custom-reports:/usr/share/nginx/html/custom-reports \
  openlmis/openlmis-report-ui:latest

注意事项

• 确保后端API服务（API_URL）可被容器访问，网络配置需正确（如使用Docker网络或端口映射）
• 认证服务地址（AUTH_SERVER_URL）需与OpenLMIS认证组件配置一致，否则可能导致登录失败
• 生产环境中建议通过HTTPS部署，可结合Nginx反向代理配置SSL证书
• 报表数据性能受后端API响应速度影响，大规模数据报表建议优化后端数据查询性能

相关资源

• OpenLMIS官方文档
• https://github.com/OpenLMIS/openlmis-report-ui
• https://github.com/OpenLMIS/openlmis-backend