⚙️ Platform Architecture

Core product infrastructure — all systems that power the Stratum platform

Active Last Updated: 2026-04-06

Overview

Stratum's platform is a hosted, multi-tenant precedent-based denial intelligence system. This architecture documents:

Strategic Context

Decision made (2026-03-31): Hosted model over export. Precedent objects are durable + transferable only through a living platform, not static exports. This requires ongoing infrastructure, SaaS operations, and multi-tenant isolation.

⚠️ Critical Compliance Note

Current authentication is Phase 1 placeholder (X-User-Id header lookup, not production-ready). Rated Critical in HIPAA audit. Phase 2 will implement Auth0/Clerk.

Registry API Endpoints

15 read-only public endpoints (no auth required). Base: https://stratum-platform-api.fly.dev/api/registries

Payer Intelligence

GET
/payers
Full payer registry with filters: ?family=UnitedHealthcare&year=PY2026&state=WA
GET
/payers/:family/profile
Aggregated payer profile (e.g., /payers/UnitedHealthcare/profile?year=PY2026)
GET
/ma-payers
Medicare Advantage payers (KFF 2024, filter: ?family=Humana)

Denial & Appeal Patterns

GET
/denial-reasons
Registry with filter: ?year=PY2026
GET
/appeals
Appeal outcomes (filters: ?family=Aetna&state=CA&year=PY2026)
GET
/inappropriate-denial-patterns
OIG findings (filter: ?source_type=OIG)

State & Regulatory

GET
/states
Top BH denial states (query: ?year=PY2026&limit=31)
GET
/states/:state
Single state profile (e.g., /states/WA)
GET
/parity-tracker
DOL parity violations (filter: ?state=CA)
GET
/nqtl-violations
Treatment limitation violations (filter: ?violation_type=Prior%20Auth)

Clinical & Medical Necessity

GET
/criteria
State/payer criteria (filters: ?state=IL&payer=Magellan)
GET
/cms-coverage
CMS NCDs/LCDs (filters: ?type=NCD&service=psychotherapy)
GET
/x12-denial-codes
X12 codes (filter: ?category=Medical%20Necessity)

Research & Precedents

GET
/research
Academic findings (filters: ?category=Appeal%20Success%20Rates&confidence=High)
GET
/precedents
Appeal precedents (filters: ?payer=UnitedHealthcare&treatment=Residential&status=REVERSAL)

Implementation

15 endpoints loaded from stratum-corpus-data/registries/ (14 JSON files). Read-only, no tenant isolation (public intelligence). Aggregated metrics for payer/state/treatment analysis.

Documentation: See /src/routes/registries.ts in stratum-platform repo for full response schemas and query options.

Architecture Sections

Full documentation includes the following sections:

1. System Overview

High-level diagrams and flows

2. API Layer

Express architecture, routes, authentication, rate limiting

3. Data Layer

Postgres schema, multi-tenancy, data isolation

4. Precedent Object Model

Structure, versioning, immutability patterns

5. Health Plan Analysis Engine

Classification, precedent matching, payer intelligence

6. Marketplace & Cluster Architecture

2+ tenant minimum, denial/LOC grouping, maturity tiers, credit minting

7. Search & Indexing

Precedent discovery, query performance, registry endpoints

8. Intelligence & Analytics

Corpus metrics, dashboards, payer drift detection

9. Logging, Audit & Observability

Compliance tracking, system monitoring

10. HIPAA Compliance Architecture

PHI handling, encryption, retention, regulatory

11. Data Pipeline & Orchestration

Cluster processing, batch operations

12. Deployment Architecture

Fly.io, Cloudflare Pages, CI/CD

Implementation Details (Quick Reference)

Quick Links

📄 Full Notion Page 🔗 Repository 🌐 API (Live)