Admin Portal — Overview

What is the Admin Portal?

The ChartChat Admin Portal is the internal management interface for the ChartChat platform. It is used by ChartChat staff and system administrators to configure hospitals, manage users, monitor system health, and maintain the underlying FHIR data platform.

Patients never use this portal. It is exclusively for internal operations.

---

Who Is It For?

Role	What they do
System Administrators	Full access — manage everything including super admin tools
Project Administrators	Manage users, clients, bots, secrets, and project settings within their project
Support Staff	View and respond to patient support tickets, monitor engagement reports
Operations Team	Monitor EHR integration health, invite patients, manage hospital connections

---

How to Access

Environment	URL
Development	https://devadmin.chartchathealth.com
Local	http://localhost:3000 (after running npm run dev in packages/chartchat-admin)

---

What You Can Do in the Admin Portal

Hospital & EHR Management

• Register and configure hospital EHR integrations (Epic, eClinicalWorks, MEDITECH)
• Monitor EHR sync health across all connected patients

User & Access Management

• Invite admin users and assign them roles and access policies
• Edit user memberships — change their access level or remove them from the project
• Create and manage Access Policies to control exactly what each user or system can read/write
• Store encrypted secrets (API keys, credentials) used by automation bots

Patient Operations

• Invite new patients to the member portal
• View all patients registered in the system
• View and respond to patient support tickets

Automation (Bots)

• Create server-side automation bots that run when FHIR data changes
• Register OAuth client applications that connect to the FHIR API

Reports & Analytics

• Patient engagement analytics (logins, activity)
• AI chat usage analytics (questions asked, categories, safety events)
• EHR integration health dashboard (sync success/failure per patient)

System Administration

• Rebuild FHIR resource definitions and search indexes
• Reindex data, purge old audit logs, reset passwords
• Browse, create, edit, and delete any FHIR resource directly
• Run database diagnostics and performance queries

---

Navigation Structure

Integrations
  └── Hospital Integrations

Support
  └── Support Tickets

Reports
  ├── Patient Engagement
  ├── AI Chat Analytics
  ├── EHR Integration Health
  └── Audit Log

Patients
  ├── Patient List
  └── Invite Patient

Admin
  ├── Users
  ├── Bots
  ├── OAuth Clients
  ├── Secrets
  ├── Project Details
  └── Sites

Super Admin (super admins only)
  ├── Structure Definitions
  ├── Search Parameters
  ├── Value Sets
  ├── Reindex / Purge
  ├── Force Set Password
  ├── Database Tools
  └── Async Job Monitor

Settings
  └── Security

FHIR Browser
  └── Any resource type (Patient, Observation, AccessPolicy, etc.)

---

Technology

Layer	Technology
Frontend	React + Vite + Mantine UI
FHIR Platform	Medplum
Auth	Medplum Auth (email/password)
Data	FHIR R4 over the ChartChat server API