▲ v13 UPDATES
IRIS → HAPI FHIR (open-source)
·
Leadingdots → Redox + Airflow
·
Added: APCD Module · Delta Analytics · Score Archive · FastAPI
·
Infra: Docker · Desktop→Enterprise path
·
Architecture: Shell-and-iframe · ADR Phased Build Strategy
Platform v13
⬡ ADR-001 · Architecture Decision Record — Data Layer Selection: Phased Build Strategy
Hypersphere Health, Inc. · March 2026 · Internal — Architecture Decision Record · Status: DECIDED
● DECIDED
PHASE 1A · ACTIVE
Decision
Adopt a phased build strategy. Begin with an open-source AWS stack for initial development and contract execution. Migrate to an InterSystems IRIS for Health data layer post-contract and pre-launch, when live scoring capability is required. The application layer — scoring engine, APIs, care management interface — is fully portable across both data layer implementations.
Key Constraint
The Hypersphere scoring engine requires live queries against longitudinal patient data — clinical, claims, and RPM — with sub-second response times. This is not achievable with ETL-dependent architectures at 250K–1M patient scale. The current AWS stack introduces 5–15 minute minimum latency between a clinical event and scoring engine awareness.
Phased Build Strategy
Phase 1A — AWS Stack ● NOW ACTIVE
IngestHealth Connect
StorageHAPI FHIR + PostgreSQL
AnalyticsBatch pipeline (Airflow)
ScoringBatch-approximated
MPIAWS Entity Resolution
Latency5–15 min (ETL lag)
Adequate for 120-day contract window. Batch scoring acceptable for GROW RFP submission.
Phase 1B — IRIS Migration ◎ PRE-LAUNCH
IngestHealth Connect (unchanged)
StorageIRIS for Health
AnalyticsFHIR SQL Builder — zero-copy
ScoringNear real-time live queries
MPIAWS Entity Resolution
LatencySub-second (no ETL)
Migration trigger: go-live milestone requiring live scoring. App code does not change — IRIS exposes standard FHIR R4 REST + JDBC/ODBC.
Phase 2 — Full Scale ⬡ FUTURE
IngestHealth Connect (scaled throughput)
StorageIRIS for Health — HA cluster
AnalyticsFHIR SQL Builder + APCD delta
ScoringSub-second, multi-tenant
MPIAWS Entity Resolution
LatencySub-second at 1M+ patients
Portability guarantee: app code unchanged. Only base URL (env variable) changes at each migration stage.
Why the AWS Stack Cannot Support Live Scoring
| Failure Mode |
AWS Stack (Phase 1A) |
IRIS Stack (Phase 1B+) |
| ETL Pipeline | 2-hop ETL: HealthLake → PostgreSQL → DuckDB → scoring engine | Zero-copy — scoring engine queries live FHIR directly via SQL |
| Latency | 5–15 min minimum between clinical event and score awareness | Sub-second — no pipeline, no lag |
| Silent failure | Pipeline failures produce stale scores without alerting care team | Direct query — failure is immediate and visible |
| Schema rigidity | PostgreSQL requires schema engineering for sparse hierarchical data | IRIS Globals — native sparse storage, no padding required |
| FHIR SQL | ✗ Not available — no direct SQL against live FHIR resources | ✓ FHIR SQL Builder — direct SQL against live FHIR R4 |
| Multi-model | ✗ Claims, clinical, RPM across 3 separate systems | ✓ Single engine — HL7v2, FHIR, claims, RPM in one store |
| Scale ceiling | ✗ Sub-second scoring at 1M patients not achievable | ✓ Sub-second at 1M+ patients — core requirement met |
Risk Register
| Risk | Level | Description | Mitigation |
| Vendor lock-in |
HIGH |
IRIS becomes critical path at Phase 1B |
Maintain portable app layer; FHIR R4 REST interfaces are standard; data export to FHIR R4 always possible |
| License cost |
MEDIUM |
IRIS for Health license > Health Connect pricing |
BYOL on EC2 vs. SaaS; HealthLake cost eliminated at Phase 1B partially offsets delta |
| Migration timing |
MEDIUM |
Phase 1A → 1B window may compress under contract pressure |
Phase 1A app development accelerates timeline; IRIS deployment is parallel workstream |
| Phase 1A scoring gap |
LOW |
Batch scoring insufficient for some live use cases |
GROW RFP timeline: Phase 1A acceptable for initial submission; live scoring required at client go-live |
Self-Build Assessment — ~70% Hypersphere-Owned Regardless of Data Layer
| Component | Primary Tooling | Portability |
| Scoring Engine | Python / FastAPI | Queries IRIS via FHIR SQL — no change at Phase 1B |
| FHIR R4 API Layer | FastAPI + IRIS FHIR REST | Standard FHIR endpoints — fully portable |
| Care Management Interface | React + REST calls | No data layer dependency |
| APCD Delta Analytics | Python on IRIS FHIR SQL | Replaces DuckDB ETL — simpler at Phase 1B |
| Reporting Dashboards | React / Recharts / D3 | Fully portable — no data layer dependency |
| Pipeline Orchestration | Python / Airflow | Simplified at Phase 1B — fewer ETL jobs required |
| API Gateway & Auth | FastAPI / OAuth2 / SMART | Unchanged — tenant context in JWT |
| InterSystems-owned (not self-buildable) | ObjectScript / DTL / BPL transforms · IRIS namespace config · DB engine · HA cluster tuning — licensed, not built (~15–20% of platform footprint) |
Immediate Next Steps
1
Submit InterSystems questionnaireScoped to transformation + native multi-model clinical data platform capabilities
2
Request IRIS for Health pricingBYOL on EC2 r6i — 4 vCPU Phase 1B, 16 vCPU Phase 2 HA cluster
3
Continue Phase 1A self-buildHAPI FHIR + PostgreSQL open-source stack — in progress, v13 delivered
4
Define Phase 1B migration triggerIdentify the specific go-live milestone that requires live scoring to activate migration
5
Validate FHIR SQL BuilderRequest InterSystems technical demo against multi-tenant namespace with live FHIR R4 data
📥 Zone 1 — Data Sources All inbound streams normalize to FHIR R4 before entering the platform
EHR
EHR Systems
Epic · Cerner · athenahealth · Any FHIR
Primary clinical data source. FHIR R4 REST API primary; HL7 v2 for legacy. Redox normalizes all to FHIR before platform ingestion.
FHIR R4HL7 v2Via Redox
EoB
Medical Claims
FHIR ExplanationOfBenefit (Medical)
837P/I claims normalized to FHIR R4 EoB. ICD-10 diagnoses, CPT/HCPCS procedures, NPI, financials. Ingested via fhir_eob_parser.py.
FHIR R4 EoB837P/INEW
Rx
Pharmacy Claims
FHIR EoB (Pharmacy) / NCPDP D.0
NDC codes, days supply, ingredient cost, dispensing fee, plan paid. NCPDP D.0 normalized to FHIR EoB pharmacy profile at ingestion.
FHIR R4 EoBNCPDPNEW
834
Eligibility / Enrollment
FHIR Coverage + Patient / 834
Member demographics, plan enrollment dates, coverage type, dual-eligible flag. 834 normalized to FHIR R4 Coverage + Patient resources.
FHIR Coverage834NEW
NPI
Provider Master
FHIR Practitioner / Organization
NPI registry, taxonomy codes, network status, rural designation, ACO participation. FHIR R4 Practitioner and PractitionerRole resources.
FHIR R4NPI RegistryNEW
RPM
RPM Device Telemetry
Alpha Omega IoT365 · Aware Biometrics
Daily weight, BP, O₂ saturation, glucose, activity. FHIR Observation push. C3S™ Wᵢ 0.85. ACTIVE integration.
ACTIVEFHIR R4IoT
↓ All sources → Redox Engine (payer connectivity) → normalized to FHIR R4 → HAPI FHIR Server
⚙️ Zone 2 — Ingestion Pipeline Phase 1A · HAPI FHIR + PostgreSQLTransforms at Phase 1B → IRIS for Health
RDX
Redox Engine
Payer + EHR Connectivity Partner
Credentialed payer connections for 837/834/NCPDP feeds. Normalizes to FHIR R4 before handing off. Eliminates the hardest data acquisition problem.
FHIR R4HIPAA12,200+ Orgs
H⊕
HAPI FHIR Server
Open-Source · Self-Hosted · Docker
Full FHIR R4 compliant server. Replaces InterSystems IRIS for Health. Runs in Docker container. Native EoB, Coverage, Practitioner resource support. Apache 2.0 license.
FHIR R4Open-SourceReplaces IRIS
PG
PostgreSQL 16
Primary Data Store · Open-Source
HPDM Score Archive, claims tables, members, enrollments, APCD config, ingestion logs. Migrates to AWS RDS or Azure Database with zero code changes.
PostgreSQLOpen-SourceReplaces IRIS DB
IRIS
IRIS for Health
Native Multi-Model Clinical Platform
Replaces HAPI FHIR + PostgreSQL. Native FHIR R4 with Globals sparse storage. FHIR SQL Builder enables direct SQL against live FHIR R4 resources — zero-copy, zero ETL, zero pipeline lag. Scoring engine queries live data directly.
- FHIR SQL Builder: Direct SQL against live FHIR R4 — scoring engine primary interface at Phase 1B+
- Globals: Native sparse multi-dimensional storage — no schema padding for clinical data
- Multi-model: HL7v2, FHIR, claims, RPM in one engine — eliminates cross-system joins
FHIR SQLGlobalsZero-CopyPhase 1B+
HC
Health Connect
HL7v2 / X12 / RPM Transform · InterSystems
Transformation and ingest layer within the IRIS namespace. DTL/BPL templates normalize HL7v2, X12 (837/834), and RPM device streams. Redox retained for external payer feed connectivity. ObjectScript/DTL/BPL config is InterSystems-owned (∼15–20% of platform).
- DTL/BPL: Configured within IRIS — licensed, not self-built
- Streams: HL7 v2, X12 837/834, NCPDP D.0, RPM telemetry
HL7v2X12DTL/BPLPhase 1B+
AF
Apache Airflow
Pipeline Orchestration · Open-Source
5 DAGs: daily EoB ingestion, enrollment sync, nightly HPDM scoring, weekly delta computation, monthly APCD generation. Replaces Leadingdots-managed pipelines.
Open-Source5 DAGsNEW
🐳
Docker Compose
Full Stack Containerization
Entire platform starts with one command. Same containers deploy from laptop to VPS to enterprise cloud. OCI standard — runs on any infrastructure.
Open-SourceOCI StandardDesktop Ready
↓ Normalized FHIR R4 longitudinal record stored in HAPI FHIR + PostgreSQL → Airflow batch pipeline triggers HPDM scoring
🔮 Zone 3 — HPDM Engine — Hypersphere Proprietary IP · Patent-Pending · Python 3.11 The only component not replicable through third-party licensing
Hyperspherical Patient Data Model
3-Axis Compounding Intelligence · 221 Conditions · 205 SDoH Factors · 510 Real-Time KPIs · 59 Clinical Instruments
X — Axis
Classification
Condition subtype, drug class, SDoH domain, test type. Not just "diabetes" — "Type 2 DM with end-organ damage, A1C 9.4%, declining trend."
Y — Axis
Prevalence
Epidemiological context — population prevalence, community exposure, adherence benchmarks. Rural ≠ Urban. Geography changes the risk picture.
Z — Axis
Severity / Compounding
Clinically validated severity PLUS multiplicative interaction effects across all active conditions, SDoH, medications, and engagement. 59 instruments · 203 severity tiers · 177 compounding examples.
221 Conditions205 SDoH Factors510 KPIs59 Instruments5 Risk Tiers65 Z-InteractionsRAF/HCC Mapped100K Indiana ValidationAPCD-ReadyDelta Analytics Engine
↓ HPDM computation → Score Archive (immutable) + 12 FHIR R4 output types → Delta Engine + APCD Module
🆕 Zone 4 — New Platform Components (Phase 2 Additions) Self-validating feedback loop · APCD compliance · Evidence generation
🗄️
HPDM Score Archive
Immutable · Timestamped · PostgreSQL
Every HPDM computation archived at the moment of scoring — before any claims outcome is known. Non-negotiable foundation for Delta Analytics validation integrity.
- Fields: composite score, z/x/y axes, active domains, instrument scores, interaction weights, engine version
- Policy: Immutable — corrections create new records with supersession pointer
- Retention: Indefinite — this is the historical validation dataset
PostgreSQLImmutableNEW
📋
APCD Submission Module
State-Configurable · JSON-Driven
Generates state-spec-compliant APCD flat files from HPDM data store. Adding a state is a JSON config record — zero code changes.
- Files: Medical claims, pharmacy claims, eligibility, provider master, manifest
- States configured: Indiana (IDOH) · Connecticut (OHS)
- Validation: Referential integrity, NPI format, ICD-10 format, amount sign checks
IndianaConnecticutNEW
Δ
Delta Analytics Engine
Prediction vs. Reality · Self-Validating
Joins Score Archive predictions against realized claims outcomes. Proves HPDM predicts hospitalization before claims show it. The evidence-generation engine.
- Outputs: Tier accuracy, cost validation, latent risk patients, ROI quantification, weight calibration signals
- Validation: 25.8× cost separation (Imminent vs Stable), all 5 tiers calibrated
- ROI: $2.05M net benefit at 35% efficacy — Imminent + Critical tiers
Python/DuckDBValidatedNEW
API
FastAPI REST Layer
20 Endpoints · OpenAPI 3.0
Lightweight REST API exposing HPDM engine, FHIR store, APCD formatter, and Delta Engine to the React frontend and partner integrations.
- Endpoints: POST /score, GET /score/{id}, POST /apcd/generate, POST /delta/run, GET /delta/summary
- Docs: Auto-generated OpenAPI at /docs
FastAPIOpenAPINEW
↓ HPDM outputs consumed by plug-in components · All plug-ins connect via FHIR R4, HL7 v2, or REST API
🔌 Zone 5 — Plug-In Component Framework Optional · No plug-in is required · All connect via FHIR R4 or REST
Care Management Operations
Alpha Omega Health
Native: HPDM outputs available via API to any care management system
Hx360 CCM/RPM billing · IoT365 device telemetry writes to FHIR · 24/7 virtual care. ACTIVE integration at Wᵢ = 0.85.
ACTIVEFHIR R4RPM/RTM
Virtual Care Delivery
Cromford Health
Native: HPDM outputs routed to any virtual care platform
Care Captain™ dispatch hub · ICT workflow · HealthPursuits™ · 23+ countries · d.b.a. Telemedicine.com
NationalVirtual ICURTM/CCM
Care Pathway Engine
Individuallytics
Native: HPDM ACIs routed to care team via API output
N-of-1 pathway micro-adjustment · HealthPursuits™ 2-week sub-goal generation · Patient longitudinal data
Patent-PendingN-of-1
CDS Layer (CT-Specific)
AkēLex
Native: ACIs formatted for physician consumption via API
Role-aware real-time CDS at point of care · FHIR CDS Hooks R4 · CT/ME markets · Integration pending
PENDINGCDS Hooks
Patient Engagement (CT-Specific)
Prosumer Health
Native: Patient-facing FHIR R4 API for any patient app
Human-guided health coaching · AI symptom triage · Patient-reported SDoH Z-code collection · CT/ME
CT/MEPatient App
⚠ Reduced Dependency
InterSystems IRIS
Now optional — only where state HIE already runs IRIS
If client/state HIE already runs InterSystems, IRIS feeds HAPI FHIR as an inbound data pipe — not the store. Core platform runs without IRIS.
OptionalHIE Connector Only
↕ Enterprise migration path · Zero code changes at each stage · FHIR R4 standard maintained throughout
🚀 Zone 6 — Infrastructure Migration Path Zero code changes at every stage · Same Docker containers · FHIR R4 standard throughout
STAGE 1 · NOW
Docker on local machine
HAPI FHIR + PostgreSQL
Synthetic data only
$0/month
Running Today
Desktop: localhost:3000
STAGE 2 · PILOT
Docker on VPS ($50–80/mo)
TLS via Let's Encrypt
BAA with host provider
First health plan data
DigitalOcean / Hetzner
Config change only
STAGE 3 · SCALED
Cloud VM (AWS EC2 / Azure)
HIPAA eligible
Encrypted storage
Audit logging
2–3 health plan partners
Container migration
STAGE 4 · ENTERPRISE
Azure Health Data Services
or AWS HealthLake
HITRUST CSF
SOC 2 Type II
Full ITSM
Large contract / federal award
FHIR R4 — no rebuild
Zero-code-change guarantee: Every component is built to the FHIR R4 standard and containerized with Docker. The application code that calls http://localhost:8080/fhir in development calls the same paths at the managed FHIR endpoint in production. Only the base URL changes.