Developer Reference
Technical specifications, entity schemas, architectural decisions, and integration details for the REV.health platform. These pages are the developer counterpart to the module walkthroughs.
Cross-Cutting Documentation
Data Model
Patient=User identity, Short GUID, global vs org-scoped classification, read-access audit.
View data model →IC Reference
Shared generation template, naming conventions, environment cascade.
View IC reference →PMR Deep Exemplar
29 AMI noun-app schemas, provenance model + trust tiers, RBAC matrix, and worked Reminder / Allergy-versioning examples.
View PMR deep exemplar →Style Guide
Live component gallery — typography, buttons, forms, cards, priority tags, AMI tables, callouts, and color swatches.
View style guide →Infinite Cabinet
Upstream "jig" that produced IC — AMI model, codegen orchestrator, RBAC engine, L1/L2/JTable, with adopt/adapt/inspire/drop verdicts per artifact.
View Infinite Cabinet →Roadmap & Gantt Charts
Platform-level, per-module, regulatory, and integration timelines as Mermaid Gantt diagrams.
View roadmap →Security & Compliance
Threat model, HIPAA / ONC / EPCS / SOC 2 posture, identity, encryption, audit, SDLC, IR, AI safeguards, trust center.
View security & compliance →Database Schema Index
Every Cosmos DB entity across all 10 modules. Click a module to see full field definitions, RBAC, trust tiers, FK diagrams, and functional requirements.
| Module | Entities | Scope | Dev Page |
|---|---|---|---|
| Scheduling | Schedule, Slot, Appointment, Resource, VisitType, VisitStage, WaitlistEntry |
Org-scoped | scheduling |
| Eligibility | InsurancePlan, Coverage, EligibilityCheck, BenefitDetail, PriorAuth |
Org-scoped | eligibility |
| Clinical Documentation | Encounter, EncounterNote, Problem*, ProblemList*, ScribeSession, ScribeUtterance, ScribeStructuredOutput, ScribeReviewState |
Mixed (*)=Global | clinical-doc |
| Coding & CDS | Diagnosis*, Procedure*, OrderSet, CdsRule, CodeSet*, CodeSetVersion*, CodeMapping*, CdsHookEvent |
Mixed (*)=Global | coding-cds |
| eRx & EPCS | Prescription*, ControlledSubstanceAuth, PdmpQuery, FormularyCheck |
Mixed (*)=Global | erx-epcs |
| Labs | (planned — no v1 schema yet) | — | — |
| Imaging | (planned — no v1 schema yet) | — | — |
| Patient Portal | PortalMessage, PatientDocument*, Payment, SensitiveClassGating* |
Mixed (*)=Global | patient-portal |
| Referrals | Referral, ReferralResponse, ReferralStatusHistory, SpecialistDirectory, StandingReferral |
Org-scoped | referrals |
| RCM | Claim, ClaimLine, Payment, Denial, PatientStatement |
Org-scoped | rcm |
| Task Management | WorkTask, TaskStatusHistory, TaskMacro, TaskTimeLog |
Org-scoped | task-mgmt |
| Payer Optimization | PayerOptimizationConfig, PayerRule, CodingOptimizationSuggestion, OptimizationAuditEntry |
Org-scoped | payer-opt |
PatientID, carries SourceOrganizationID). All others are org-scoped (partitioned by OrganizationID). See Data Model for the full classification.
Global Entities (cross-module)
These entities belong to the patient, not the organization. They appear in the module that creates them but are readable by any authorized viewer across organizations. See Data Model and DEC-RH-001, DEC-RH-002.
| Entity | Created By Module | Partition Key | Notes |
|---|---|---|---|
User |
Platform | PatientID |
PatientID = UserID (DEC-RH-005) |
Patient |
Platform | PatientID |
Global identity, no OrganizationID |
Problem |
Clinical Doc | PatientID |
SNOMED + ICD-10 dual-coded |
ProblemList |
Clinical Doc | PatientID |
1:1 with Patient |
Diagnosis |
Coding & CDS | PatientID |
ICD-10 + SNOMED, HCC tracking |
Procedure |
Coding & CDS | PatientID |
CPT/HCPCS with up to 4 modifiers |
Prescription |
eRx & EPCS | PatientID |
RxNorm/NDC coded |
PatientDocument |
Patient Portal | PatientID |
Exception to IC rule #11 |
SensitiveClassGating |
Patient Portal | PatientID |
Exception to IC rule #11 |
CodeSet |
Coding & CDS | — | Reference data, no partition |
CodeSetVersion |
Coding & CDS | — | Reference data |
CodeMapping |
Coding & CDS | — | Reference data |