Medplum

<h1 align="center">Medplum Managed Service Organization (MSO) Demo App</h1> <p align="center">A starter application for building a MSO platform on Medplum. It shows how to control clinician access where clinicians and patients can be enrolled at multiple clinics.</p> <p align="center"> <a href="https://github.com/medplum/medplum-mso-demo/blob/main/LICENSE.txt"> <img src="https://img.shields.io/badge/license-Apache-blue.svg" /> </a> </p> ## Overview - Operations to enroll and unenroll clinicians and patients across different clinics with automatic access policy updates - see [src/components/utils/enrollment.ts](./src/utils/enrollment.ts) - Fetching all patients and clinicians enrolled in a clinic - see [src/components/utils/enrollment.ts](./src/utils/enrollment.ts) - Clinician and Patient management interface - see [src/components/ClinicianList.tsx](./src/components/ClinicianList.tsx) and [src/components/PatientList.tsx](./src/components/PatientList.tsx) - MSO Access Policy - see [src/data/access-policy.ts](./src/data/access-policy.ts) ## Getting Started It is recommended that you create a new Medplum project to run this demo. Follow the instructions in [this tutorial](https://www.medplum.com/docs/tutorials/register). Clone the repo to your local machine. If you want to change any environment variables from the defaults, copy the `.env.defaults` file to `.env` ```bash cp .env.defaults .env ``` And make the changes you need. Next, install the dependencies. ```bash npm install ``` Then, run the app ```bash npm run dev ``` This app will run on `http://localhost:3000` and connect to a hosted Medplum project at `https://api.medplum.com/` by default. The server url can be changed in [main.tsx](./src/main.tsx) ## Background What is a Managed Service Organization (MSO)? A Managed Service Organization (MSO) is a healthcare organization that provides services to multiple different healthcare organizations. <img src="./public/mso-diagram.png" alt="MSO Diagram" /> For Managed Service Organizations (MSOs), complexity stems from practitioners potentially working across multiple tenants and patients potentially receiving care from multiple healthcare partners. This demo implements a solution where: - Tenants are separated as Organizations (clinics) within a single Medplum Project - Patients and clinicians can each be enrolled in multiple clinics - AccessPolicy controls limit clinician access to resources only within shared clinics <img src="./public/how-it-works.png" alt="How it works" /> ## Features ### Admin Features - Create new clinics (Organizations) - Create new clinicians (Practitioners) - Enroll practitioners in one or more clinics - Enroll patients in one or more clinics - Manage access policies ### Clinician Features - View patients, observations, diagnostic reports, encounters, and communications affiliated with their clinics - simulating what they would see in their EHR ## Code Organization This repo is organized into several main directories: - `src/pages`: Contains the React components for each page in the application - `src/components`: Contains reusable UI components - `src/data`: Contains the AccessPolicy definition and other core FHIR resources that can be uploaded - `src/utils`: Contains utility functions for MSO enrollment methods and admin status checking ## Key Workflows 1. **Creating a new clinic**: Admins can create new Clinics to represent clinics 2. **Creating a new clinician**: Admins can create new Practitioners and assign them to Clinics 3. **Enrolling a practitioner in a clinic**: Configures access policies for that Practitioner to be able to read/write to all Patients in that Clinic 4. **Enrolling a patient in a clinic**: Configures access policies for Clinicians in that Clinic to be able to read/write to that Patient 5. **Viewing patient data**: Practitioners can only see patients and their clinical data if they share an organizational affiliation ## Resources Used This demo uses the following FHIR and Medplum resources: - **AccessPolicy**: Defines the access rules for clinicians to resources across the project - **Organization**: Represents a clinic - **Practitioner**: Represents a clinician - **ProjectMembership**: Stores references to the clinics that the clinician can access - **Patient**: Represents an individual receiving care - **Observation**: Represents clinical measurements and findings - **DiagnosticReport**: Represents diagnostic test results - **Encounter**: Represents patient visits - **Communication**: Represents communications between clinicians ## About Medplum [Medplum](https://www.medplum.com/) is an open-source, API-first EHR. Medplum makes it easy to build healthcare apps quickly with less code. Medplum supports self-hosting and provides a [hosted service](https://app.medplum.com/). Medplum MSO Demo uses the hosted service as a backend. - Read our [documentation](https://www.medplum.com/docs) - Browse our [react component library](https://storybook.medplum.com/) - Join our [Discord](https://discord.gg/medplum)