Mere Medical 使用教程

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

2. 设置 NPM 并安装依赖：

nvm install v20.11.0
nvm use
npm install

如果提示运行迁移，执行以下命令：

npx nx migrate --run-migrations

3. 为每个项目创建 .env 文件并填充值：

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

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

4. 生成本地 ssl 证书：

mkdir -p .dev/certs
mkcert -key-file .dev/certs/localhost-key.pem -cert-file .dev/certs/localhost.pem localhost
mkcert -install

5. 分别启动每个服务：

npx nx serve web
npx nx serve api

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

npx nx run-many --target=serve --projects=api,web

6. 运行端到端测试：

npx nx run web-e2e:e2e

7. 在 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 类似，但具有不同的功能和设计理念。