OpenLMIS参考数据用户界面镜像文档

1. 镜像概述

本镜像为OpenLMIS（Open Logistics Management Information System）项目的参考数据用户界面（UI）组件，基于现代Web技术构建，用于供应链管理系统中参考数据的可视化管理。作为OpenLMIS生态的前端模块，该镜像提供直观的交互界面，实现与后端参考数据服务的无缝集成，支持用户对供应链核心参考数据（如产品信息、地理位置、设施类型等）进行全生命周期管理。

2. 核心功能与特性

2.1 核心功能

• 参考数据管理界面：提供统一的操作入口，支持参考数据的录入、查询、编辑、删除等CRUD操作
• 数据可视化展示：通过表格、表单等组件直观呈现参考数据，支持筛选、排序及分页功能
• 后端API集成：与OpenLMIS参考数据服务（backend）通过RESTful API通信，实现数据交互
• 用户权限控制：集成OpenLMIS认证授权机制，根据用户角色限制数据操作权限

2.2 技术特性

• 响应式设计：适配桌面及移动设备，支持多终端访问
• 模块化架构：基于组件化开发模式，便于功能扩展与维护
• 前端状态管理：内置状态管理机制，优化数据交互体验
• 容器化部署：轻量级Docker镜像，支持快速部署与版本控制

3. 使用场景与适用范围

3.1 主要应用场景

• ***供应链管理系统的参考数据维护（如医院、仓库、产品目录等基础数据管理）
• OpenLMIS生态系统本地化部署中的前端组件集成
• ***物流信息化项目的参考数据管理模块快速搭建

3.2 适用用户

• ***供应链系统管理员（负责基础数据配置）
• ***机构后勤管理人员（维护设施与资源数据）
• OpenLMIS系统集成与运维人员（部署与配置前端服务）

4. 使用方法与配置说明

4.1 快速启动（Docker Run）

docker run -d \
  --name openlmis-referencedata-ui \
  -p 8080:80 \
  -e REACT_APP_API_URL=[***] \
  -e REACT_APP_AUTH_SERVER_URL=[***] \
  openlmis/openlmis-referencedata-ui:latest

4.2 Docker Compose配置示例

version: '3'
services:
  referencedata-ui:
    image: openlmis/openlmis-referencedata-ui:latest
    container_name: openlmis-referencedata-ui
    ports:
      - "8080:80"
    environment:
      - REACT_APP_API_URL=[***]  # 后端参考数据服务地址
      - REACT_APP_AUTH_SERVER_URL=[***]  # 认证服务地址
      - REACT_APP_I18N_DEFAULT_LOCALE=en  # 默认语言（支持en/fr等）
      - REACT_APP_PORT=80  # 容器内服务端口
    depends_on:
      - referencedata-service  # 依赖后端服务

4.3 关键环境变量配置

5. 注意事项

• 部署前需确保OpenLMIS参考数据后端服务已正常运行，且API地址可被UI容器访问
• 生产环境建议通过HTTPS协议部署，可结合Nginx等反向代理配置SSL证书
• 镜像版本需与后端服务版本匹配，避免API兼容性问题
• 自定义配置（如Logo、样式）可通过挂载卷（volume）替换容器内静态资源实现