| name | abridge-reference-architecture |
| description | Implement Abridge reference architecture for clinical AI integration.
Use when designing a new Abridge deployment, reviewing project structure,
or planning multi-site health system rollouts with EHR integration.
Trigger: "abridge architecture", "abridge project structure",
"abridge system design", "abridge multi-site".
|
| allowed-tools | Read, Write, Edit |
| version | 1.4.0 |
| license | MIT |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
| tags | ["saas","healthcare","ai","abridge","architecture"] |
| compatibility | Designed for Claude Code |
Abridge Reference Architecture
Overview
Reference architecture for Abridge clinical AI integration in a multi-site health system. Covers data flow, component design, EHR integration patterns, and HIPAA-compliant infrastructure.
System Architecture
Health System Network
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ โ
โ โโโโโโโโโโโ โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโ โ
โ โ Provider โโโโโถโ Abridge App โโโโโถโ Integration โ โ
โ โ Device โ โ (Ambient AI) โ โ Service โ โ
โ โ (mobile/ โ โ โ โ (your code) โ โ
โ โ desktop) โ โโโโโโโโฌโโโโโโโโ โโโโโโโโฌโโโโโโโโ โ
โ โโโโโโโโโโโ โ โ โ
โ โ โ โ
โ โโโโโโโโโโโผโโโโโโโโโโ โ โ
โ โ Abridge Cloud API โ โ โ
โ โ (Partner API) โ โ โ
โ โ - Session mgmt โ โ โ
โ โ - Note generation โ โ โ
โ โ - Patient summary โ โ โ
โ โโโโโโโโโโโฌโโโโโโโโโโ โ โ
โ โ โ โ
โ โโโโโโโโโโโผโโโโโโโโโโ โโโโโโโโผโโโโโโโโ โ
โ โ Webhook Events โ โ EHR System โ โ
โ โ - Note completed โโโโ (Epic/Athena)โ โ
โ โ - Quality alerts โ โ FHIR R4 API โ โ
โ โโโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโ โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Project Structure
abridge-integration/
โโโ src/
โ โโโ config/
โ โ โโโ abridge.ts # Abridge API configuration
โ โ โโโ ehr.ts # EHR/FHIR endpoint config
โ โ โโโ index.ts # Environment-based config loader
โ โโโ abridge/
โ โ โโโ client.ts # API client singleton
โ โ โโโ errors.ts # HIPAA-safe error handling
โ โ โโโ retry.ts # Retry with backoff
โ โ โโโ session-manager.ts # Encounter session lifecycle
โ โโโ ehr/
โ โ โโโ fhir-client.ts # FHIR R4 API wrapper
โ โ โโโ epic-adapter.ts # Epic-specific mappings
โ โ โโโ athena-adapter.ts # Athena-specific mappings
โ โ โโโ note-pusher.ts # DocumentReference creation
โ โโโ webhooks/
โ โ โโโ handler.ts # Express webhook endpoint
โ โ โโโ signature.ts # HMAC signature verification
โ โ โโโ event-router.ts # Event type โ handler mapping
โ โ โโโ idempotency.ts # Duplicate event prevention
โ โโโ security/
โ โ โโโ audit-logger.ts # HIPAA audit trail
โ โ โโโ phi-redactor.ts # PHI detection and redaction
โ โ โโโ rbac.ts # Role-based access control
โ โ โโโ tls-config.ts # TLS 1.3 enforcement
โ โโโ monitoring/
โ โ โโโ health.ts # Health check endpoint
โ โ โโโ metrics.ts # Performance metrics collector
โ โ โโโ alerts.ts # Quality and latency alerts
โ โโโ server.ts # Express server entry point
โโโ tests/
โ โโโ unit/ # Unit tests (no API calls)
โ โโโ integration/ # Sandbox API tests
โ โโโ fhir-validation/ # FHIR resource schema tests
โโโ fixtures/
โ โโโ transcripts/ # Synthetic encounter transcripts
โโโ scripts/
โ โโโ deploy-cloud-run.sh # GCP Cloud Run deployment
โ โโโ readiness-check.ts # Production readiness validation
โ โโโ diagnostic.sh # Debug data collection
โโโ Dockerfile # HIPAA-compliant container
โโโ .env.example # Environment template (no secrets)
โโโ package.json
