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

2025-04-20 01:48:10作者：钟日瑜

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

详细安装步骤

克隆项目仓库：

打开命令行工具，执行以下命令克隆项目：
```
git clone https://github.com/cfu288/mere-medical.git
```
安装 Node.js：

使用 NVM 安装项目推荐的 Node.js 版本：
```
nvm install v20.11.0
nvm use
```
安装依赖：

进入项目目录，安装项目依赖：
```
cd mere-medical
npm install
```
安装 Nx（如果未安装）：
```
npm i nx -g
```
配置环境变量：

复制 .example.env 文件并命名为 .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

启动服务：

可以分别启动 Web 服务和 API 服务：
```
npx nx serve web
npx nx serve api
```
或者，一起启动整个应用：
```
npx nx run-many --target=serve --projects=api,web
```

构建和运行 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 仓库查看更多帮助信息。

登录后查看全文