Domain Workflow Narratives
Conversational guides to understanding the MedAIus EHR Platform - perfect for listening while you work.
What Are These Documents?
These are narrative-style explanations of each domain in the system. Unlike technical documentation filled with tables and diagrams, these are written as flowing text that reads like a conversation. They're designed to be easy to listen to (via text-to-speech) while you're working on other things.
Each document covers:
- What the domain does and why it exists
- Core workflows and how data flows
- Integration points with other domains
- Key business logic and design decisions
- Performance and security considerations
The Domains
Core Clinical Domains
| # | Domain | Description |
|---|---|---|
| 01 | Patient | Patient registration, search, and management |
| 02 | Encounter | Clinical visits and documentation |
| 03 | Appointment | Scheduling and availability |
| 04 | Billing | Invoices, payments, and financial tracking |
| 14 | Sponsor Codes | NGO, government, insurance, and employer coverage |
Communication & Intelligence
| # | Domain | Description |
|---|---|---|
| 05 | Notification & Activity | Event tracking and push notifications |
| 06 | AI | Clinical intelligence and Gemini integration |
| 07 | Documents & Storage | File management and Cloudflare R2 |
Coordination & Dynamic Data
| # | Domain | Description |
|---|---|---|
| 08 | Care Team | Multi-provider care coordination |
| 09 | Custom Forms | Dynamic form templates and resource mapping |
| 10 | Announcements | Internal staff communication |
| 13 | Group Therapy | Multi-participant therapy sessions and guests |
Security & Administration
| # | Domain | Description |
|---|---|---|
| 11 | Access Control | RBAC and patient-level ACL |
| 12 | Organization & Practitioner | Multi-tenancy and provider management |
Reading Order
If you're new to the system, start with these in order:
- Organization & Practitioner - Understand multi-tenancy first
- Patient - The central clinical entity
- Encounter - Where clinical work happens
- Appointment - How visits get scheduled
- Notification & Activity - How events flow through the system
- Access Control - How security is enforced
Then explore the rest based on your interest.
Related Documentation
For technical details with diagrams and code samples, see:
- System Architecture Overview
- Architecture Narrative - High-level system overview
Created December 2024 for the MedAIus EHR Platform