临床能力计算器前端镜像文档

1. 镜像概述

本镜像为临床competencycalculator项目的前端应用组件，基于Web技术栈构建，负责用户界面的渲染、交互逻辑处理以及与后端服务的数据通信，是临床能力评估系统的用户交互入口。

2. 核心功能与特性

• 用户界面渲染：提供直观、易用的临床能力评估表单及结果展示界面
• 交互逻辑处理：支持用户输入、数据验证、评估流程引导等交互操作
• 数据可视化：以图表等形式展示临床能力评估结果及趋势分析
• 后端通信：通过API接口与临床能力计算器后端服务进行数据交互
• 跨浏览器兼容：支持主流现代浏览器，确保多环境下的使用一致性

3. 使用场景与适用范围

• 医疗教育机构：用于医学生、住院医师等临床人员的能力评估流程管理
• 医院科室：辅助科室主任或带教老师对下级医师进行定期能力考核
• 医疗质量管理部门：收集和分析临床人员能力数据，支持质量改进决策
• 临床培训项目：作为培训效果评估的数字化工具，跟踪学员能力发展轨迹

4. 使用方法与配置说明

4.1 前提条件

• 已安装Docker Engine（20.10+版本推荐）
• 临床能力计算器后端服务已部署并可访问
• 网络环境允许容器访问后端API服务及外部资源

4.2 镜像获取

通过Docker Hub或私有仓库拉取镜像：

docker pull clinicalcompetencycalculator/frontend:<镜像标签>

注：<镜像标签>需替换为具体版本号，如latest（最新稳定版）或特定版本号

4.3 运行容器

4.3.1 基础运行命令

docker run -d \
  --name clinical-competency-frontend \
  -p 80:80 \
  -e REACT_APP_API_BASE_URL=<后端API地址> \
  clinicalcompetencycalculator/frontend:<镜像标签>

4.3.2 核心参数说明

4.4 高级配置（docker-compose）

创建docker-compose.yml文件：

version: '3.8'
services:
  frontend:
    image: clinicalcompetencycalculator/frontend:<镜像标签>
    container_name: clinical-competency-frontend
    ports:
      - "80:80"
    environment:
      - REACT_APP_API_BASE_URL=<后端API地址>
      - REACT_APP_ENV=production  # 环境标识（production/test/development）
    restart: unless-stopped
    networks:
      - clinical-competency-network

networks:
  clinical-competency-network:
    driver: bridge

启动服务：

docker-compose up -d

5. 注意事项

• 确保环境变量REACT_APP_API_BASE_URL正确配置为后端服务的可访问地址，否则前端将无法正常获取数据
• 生产环境建议使用HTTPS协议，可配合Nginx等反向代理实现SSL终止
• 容器运行用户权限建议遵循最小权限原则，避免使用root用户运行
• 定期更新镜像以获取最新功能及安全补丁

6. 故障排除

• 前端无法访问后端API：检查REACT_APP_API_BASE_URL配置是否正确，验证后端服务是否正常运行且网络互通
• 界面显示异常：清除浏览器缓存或尝试使用不同浏览器，检查容器日志（docker logs clinical-competency-frontend）获取错误信息
• 端口冲突：若主机80端口已被占用，修改-p参数中的主机端口部分（如-p 8080:80将前端服务映射到主机8080端口）