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 (一个工具，用于帮助处理大型前端项目)

安装

克隆仓库：

git clone https://github.com/cfu288/mere-medical.git

设置 NPM 并安装依赖：

nvm install v20.11.0
nvm use
npm install

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

npx nx migrate --run-migrations

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

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

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

生成本地 ssl 证书：

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

分别启动每个服务：

npx nx serve web
npx nx serve api

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

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

运行端到端测试：

npx nx run web-e2e:e2e

在 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