首页
/ 开源项目安装与配置指南:Mere Medical

开源项目安装与配置指南:Mere Medical

2025-04-20 22:02:42作者:钟日瑜

1. 项目基础介绍

Mere Medical 是一个开源的个人健康记录项目,旨在将用户在不同医院和诊所的医疗记录聚合到一个平台上,便于用户查看和管理。它是一个自托管、注重隐私且离线优先的Web应用程序,目前支持数千家医院和诊所以及主要的电子病历系统。

本项目主要使用 TypeScript 编写,辅以 JavaScript、CSS、HTML 和 Shell 脚本等。

2. 项目使用的关键技术和框架

  • TypeScript: 一种由微软开发的开源编程语言,它是 JavaScript 的一个超集,添加了静态类型选项。
  • Nx: 一个用于帮助构建大型应用的工具,它支持monorepos,并提供了很多工具来帮助开发者构建、测试和部署应用。
  • Docker: 一种开源的应用容器引擎,可以打包、发布和运行应用。
  • NVM (Node Version Manager): 用于管理多个 Node.js 版本的工具。
  • npm: Node.js 的包管理工具。

3. 项目安装和配置的准备工作

在开始安装和配置 Mere Medical 之前,请确保您的系统中已经安装以下工具:

  • Git
  • Docker
  • NVM (Node Version Manager)
  • npm

详细安装步骤

  1. 克隆项目仓库:

    打开命令行工具,执行以下命令克隆项目:

    git clone https://github.com/cfu288/mere-medical.git
    
  2. 安装 Node.js:

    使用 NVM 安装项目推荐的 Node.js 版本:

    nvm install v20.11.0
    nvm use
    
  3. 安装依赖:

    进入项目目录,安装项目依赖:

    cd mere-medical
    npm install
    
  4. 安装 Nx(如果未安装):

    npm i nx -g
    
  5. 配置环境变量:

    复制 .example.env 文件并命名为 .env,然后在文件中填写相应的环境变量:

    cp apps/api/.example.env apps/api/.env
    

    使用文本编辑器打开 apps/web/src/environments/config.json 文件,并配置相应的环境变量。

  6. 生成本地 SSL 证书:

    mkdir -p .dev/certs
    mkcert -key-file .dev/certs/localhost-key.pem -cert-file .dev/certs/localhost.pem localhost
    mkcert -install
    
  7. 启动服务:

    可以分别启动 Web 服务和 API 服务:

    npx nx serve web
    npx nx serve api
    

    或者,一起启动整个应用:

    npx nx run-many --target=serve --projects=api,web
    
  8. 构建和运行 Docker 容器(可选):

    构建项目镜像:

    docker build -t mere-medical .
    

    运行 Docker 容器:

    docker run -p 4200:80 -i -t \
    --name mere-medical \
    -e ONPATIENT_CLIENT_ID=<your_client_id> \
    -e ONPATIENT_CLIENT_SECRET=<your_client_secret> \
    -e EPIC_CLIENT_ID=<your_client_id> \
    -e EPIC_SANDBOX_CLIENT_ID=<your_client_id> \
    -e CERNER_CLIENT_ID=<your_client_id> \
    -e VERADIGM_CLIENT_ID=<your_client_id> \
    -e PUBLIC_URL=https://localhost:4200 \
    mere-medical:latest
    

    请替换 <your_client_id><your_client_secret> 为实际的值。

以上步骤将帮助您成功安装和配置 Mere Medical 项目。在操作过程中,请确保每一步骤正确无误。如果遇到问题,可以查看项目的 README.md 文件或访问项目的 GitHub 仓库查看更多帮助信息。

登录后查看全文
热门项目推荐