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

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 仓库查看更多帮助信息。