openlmis/reference-ui

镜像概述

OpenLMIS Reference-UI 是 OpenLMIS（Open Logistics Management Information System for Healthcare）开源库存管理信息系统的官方参考用户界面，版本 3。作为 OpenLMIS 生态的核心前端组件，该镜像提供了用户友好的交互界面，用于与 OpenLMIS 后端系统对接，实现库存的全流程管理。

核心功能与特性

• 直观的操作界面：设计简洁，支持***库存核心操作，包括接收、分发、盘点、调拨等流程
• 后端集成能力：通过标准化 API 与 OpenLMIS 后端服务无缝通信，确保数据实时同步
• 响应式设计：适配桌面、平板及移动设备，支持多场景下的操作需求
• 权限控制：基于角色的访问控制（RBAC），实现不同用户的权限隔离与安全管理
• 数据可视化：提供库存状态、操作历史等关键数据的报表与图表展示，辅助决策
• 开源可定制：遵循开源协议，支持根据实际业务需求进行界面定制和功能扩展

使用场景

• ***设施（医院、诊所）的日常库存管理，记录药品、耗材的接收、存储与分发
• 卫生部门对区域内***资源的集中监控、调配与数据分析
• 非组织（NGO）在援助项目中的库存跟踪与供应链管理
• ***供应链培训或演示环境中的前端交互示例

使用方法与配置说明

前提条件

• 已安装 Docker 或 Docker Compose
• 已部署兼容的 OpenLMIS 后端服务（建议使用 OpenLMIS 3.x 版本）

获取镜像

从指定仓库拉取镜像（示例镜像名）：

bash
docker pull openlmis/reference-ui:3  

基本部署（Docker Run）

通过 docker run 启动容器，需配置后端 API 地址等核心参数：

bash
docker run -d \  
  --name openlmis-reference-ui \  
  -p 80:80 \  
  -e BACKEND_API_URL="http://openlmis-backend:8080/api" \  
  -e PORT=80 \  
  -e LOG_LEVEL="info" \  
  openlmis/reference-ui:3  

Docker Compose 部署

创建 docker-compose.yml 集成 UI 与后端服务：

yaml
version: '3'  
services:  
  reference-ui:  
    image: openlmis/reference-ui:3  
    ports:  
      - "80:80"  
    environment:  
      - BACKEND_API_URL="http://backend:8080/api"  # 后端 API 地址  
      - PORT=80  # 容器内服务端口  
      - LOG_LEVEL="info"  # 日志级别（debug/info/warn/error）  
    depends_on:  
      - backend  # 依赖后端服务  

  backend:  
    image: openlmis/backend:3  # 后端服务镜像  
    # 后端配置（参考 OpenLMIS 后端部署文档）  

核心配置参数

访问与验证

部署成功后，通过浏览器访问 http://<主机IP或域名>:<映射端口>（如 http://localhost:80），使用后端系统的用户凭证登录验证功能。

自定义配置

如需修改界面样式或配置，可挂载本地配置文件覆盖容器内默认配置：

bash
docker run -d \  
  --name openlmis-reference-ui \  
  -p 80:80 \  
  -e BACKEND_API_URL="[***]" \  
  -v /local/custom-config:/usr/share/nginx/html/config  # 挂载自定义配置目录  
  openlmis/reference-ui:3