首页
/ Mere Medical 使用教程

Mere Medical 使用教程

2025-04-20 05:00:39作者:尤辰城Agatha

1. 项目介绍

Mere Medical 是一个个人健康记录的自托管网络应用程序,用于从多个患者门户聚合和同步您的所有医疗记录。目前支持数千家医院和诊所以及主要的电子医疗记录系统。它是自托管的、注重隐私且具备离线优先的特点。

2. 项目快速启动

以下是快速启动 Mere Medical 的步骤:

Docker Compose

首先,确保您的系统中已安装 Docker 和 Docker Compose。

version: '3.9'
services:
  app:
    image: cfu288/mere-medical:latest
    ports:
      - '4200:80'
    environment:
      - ONPATIENT_CLIENT_ID=${ONPATIENT_CLIENT_ID}
      - ONPATIENT_CLIENT_SECRET=${ONPATIENT_CLIENT_SECRET}
      - EPIC_CLIENT_ID=${EPIC_CLIENT_ID}
      - EPIC_SANDBOX_CLIENT_ID=${EPIC_SANDBOX_CLIENT_ID}
      - CERNER_CLIENT_ID=${CERNER_CLIENT_ID}
      - VERADIGM_CLIENT_ID=${VERADIGM_CLIENT_ID}
      - PUBLIC_URL=https://localhost:4200

将以上内容保存为 docker-compose.yml 文件,然后运行以下命令以启动服务:

docker-compose up

本地开发

先决条件

确保已经安装以下软件:

  • npm
  • nvm (Node.js 版本管理器)
  • Docker
  • nx (一个工具,用于帮助处理大型前端项目)

安装

  1. 克隆仓库:
git clone https://github.com/cfu288/mere-medical.git
  1. 设置 NPM 并安装依赖:
nvm install v20.11.0
nvm use
npm install

如果提示运行迁移,执行以下命令:

npx nx migrate --run-migrations
  1. 为每个项目创建 .env 文件并填充值:
cp apps/api/.example.env apps/api/.env

编辑 apps/web/src/environments/config.json 文件。

  1. 生成本地 ssl 证书:
mkdir -p .dev/certs
mkcert -key-file .dev/certs/localhost-key.pem -cert-file .dev/certs/localhost.pem localhost
mkcert -install
  1. 分别启动每个服务:
npx nx serve web
npx nx serve api

或者一起作为完整应用启动:

npx nx run-many --target=serve --projects=api,web
  1. 运行端到端测试:
npx nx run web-e2e:e2e
  1. 在 Docker 容器中构建和运行服务:
docker build -t mere-medical .
docker run -p 4200:80 -i -t \
  --name mere-medical \
  -e ONPATIENT_CLIENT_ID=<ID_HERE> \
  -e ONPATIENT_CLIENT_SECRET=<SECRET_HERE> \
  -e EPIC_CLIENT_ID=<ID_HERE> \
  -e EPIC_SANDBOX_CLIENT_ID=<ID_HERE> \
  -e CERNER_CLIENT_ID=<ID_HERE> \
  -e VERADIGM_CLIENT_ID=<ID_HERE> \
  -e PUBLIC_URL=https://localhost:4200 \
  mere-medical:latest

3. 应用案例和最佳实践

  • 自托管:在个人服务器上部署 Mere Medical,以完全控制数据存储和处理。
  • 数据加密:确保所有敏感数据在传输和存储时都是加密的。
  • 离线访问:利用 Mere Medical 的离线优先特性,在没有互联网连接的情况下也能访问医疗记录。

4. 典型生态项目

  • Fasten Health:另一个开源的个人健康记录项目,与 Mere Medical 类似,但具有不同的功能和设计理念。
登录后查看全文
热门项目推荐