Overview
Architecture
Section titled “Architecture”Platform Overview
Section titled “Platform Overview”Health Data Safe (HDS) is a decentralized health data platform built on Pryv.io. Patients own their data and share it with healthcare providers and researchers through secure, consent-based connections.
The platform consists of:
- Patient & Doctor apps — web applications for data entry, visualization, and management
- Core libraries — shared TypeScript libraries for data model, forms, styling, and Pryv integration
- Data services — medication datasets, data model definitions
- Bridges — integrations with external systems (Chartneo, Mira, Tempdrop, REDCap)
Data residency
Section titled “Data residency”At registration, each user chooses the region where their health data is hosted:
- 🇨🇭 Switzerland — Exoscale
- 🇺🇸 United States — Amazon Web Services (us-east-1)
Health data (events, streams, time-series, attachments, and audit logs) is region-pinned to the chosen core and stays in that region. The cores form a single platform cluster, across which only a small directory replicates — username→region routing and account-uniqueness reservations — so registration and cross-region lookups stay consistent. Those directory identifiers replicate as one-way pseudonyms (keyed HMAC), so no recoverable email or username leaves a user’s home region.
Component Status
Section titled “Component Status”| Component | Type | Demo | Production | Links |
|---|---|---|---|---|
| Patient App Patient-facing mobile-first web app for health data management. | Application | 625abc9 Nov 8, 2026 | 625abc9 Nov 8, 2026 | Demo |
| Doctor Dashboard Doctor-facing dashboard for patient management and data collection forms. | Application | 91588a8 Nov 6, 2026 | 91588a8 Nov 6, 2026 | Demo |
| Account & Auth HDS account management + authentication: sign-in, register, reset, MFA, account pages, and the CMC consent hand-off. Successor to app-web-auth3-hds. | Application | 530753a Nov 8, 2026 | 530753a Nov 8, 2026 | Demo · GitHub |
| Support Console The HDS team's console for "Help & support" conversations: agents join the support team as CMC members, then claim, answer and close conversations. | Application | a54a376 Nov 3, 2026 | a54a376 Nov 3, 2026 | Demo |
| Onboarding Pages Static "About HDS" / Welcome site shown from the patient-invite splash before login. | Application | 3517f1c Oct 14, 2026 | 3517f1c Oct 14, 2026 | Demo |
| Data Model Browser Searchable React browser for the HDS data-model (items, streams, event types). Replaces the static index on model.datasafe.dev. | Application | 4821b3a Oct 2, 2026 | — | Demo · GitHub |
| Download My Data Self-service data portability — subjects sign in, download their full account as ZIP files. Implements GDPR Art. 15/20, HIPAA §164.524, Swiss nLPD Art. 25/28. | Application | bb341b6 Nov 4, 2026 | bb341b6 Nov 4, 2026 | Demo · GitHub |
| Cervical Fluid Model Evaluate and define a unified conversion layer between cervical fluid observation methods. | Application | abd78d3 Nov 6, 2026 | — | Demo · GitHub |
| hds-lib Core HDS library: data model, Pryv integration, settings, appTemplates. | Library | — | — | GitHub |
| hds-forms-js React form components for HDS data items: fields, sections, form builder. | Library | deployed | — | Demo · GitHub |
| hds-react-timeline React timeline visualization component for HDS event data. | Library | deployed | — | Demo · GitHub |
| hds-feminine-cycle-ui Custom UI for cervical-fluid / cycle-tracking events: FEMM, Billings (BOM), Creighton, Mira charts + cervical-position glyph. Layout-agnostic cell renderer reused across timeline, forms, calendar, and pickers. | Library | — | — | GitHub |
| hds-style CSS theme package: Tailwind 4 palettes (patient/doctor/dark), typography, icons. | Library | deployed | — | Demo · GitHub |
| lib-bridge-js Shared bridge framework: Express server, partner auth, user onboarding. | Library | — | — | |
| hds-support-js "Help & support" for HDS apps: headless SupportClient + React <SupportChat> (chat-only CMC relationship with the Health Data Safe team, presence, email notification). | Library | — | — | GitHub |
| Data Model YAML definitions: items, streams, event types, datasources. | Data | deployed | — | Browse · GitHub |
| Datasets Service REST API serving medication datasets (SQLite+FTS5, WHO-ATC/RxNorm/SNOMED) and Swiss / French products by brand name. | Service | deployed | — | |
| Support Service Server side of the support channel: reply relay for agents, presence, the one offline email, close + revoke, and publication of the support group's open link. | Service | deployed | deployed | |
| Bridge Chartneo Push bridge: partner pushes cycle tracking data to HDS. | Bridge | deployed | — | |
| Bridge Mira Pull bridge: fetches hormone/cycle data from Mira API into HDS. | Bridge | — | deployed | |
| Bridge Tempdrop Pull bridge: fetches basal body temperature from the Tempdrop API into HDS. Production only (no Tempdrop sandbox). | Bridge | — | deployed | |
| Bridge Cycles Files Multi-format cycle-data file importer. Hosts per-format adapters (FEMM, Cyclefeminin, Read Your Body) at /<adapter> routes. Replaces standalone bridge-femm and bridge-cyclefeminin-net. | Bridge | a642803 Nov 6, 2026 | a642803 Nov 6, 2026 | |
| Bridge FEMM Client-side bridge: imports FEMM Health App JSON exports into HDS via browser upload. Archived 2026-05-29 — superseded by the /femm route in bridge-cycles-files. | Bridge | — | — | |
| Bridge Athenahealth SAML bridge: embeds HDS doctor dashboard inside athenahealth EHR via SSO. A mock IdP for testing the SAML flow is deployed separately at demo-athena-test-idp.datasafe.dev. | Bridge | deployed | deployed | |
| Bridge REDCap Bidirectional bridge: syncs HDS patient data with REDCap projects. | Bridge | — | — | |
| Sample Datasets Generate, load, and reset sample data on Pryv accounts for testing and demos. | Data | — | — | |
| User Docs End-user documentation: privacy policy, data deletion, legal compliance pages. | Application | — | deployed | GitHub |
| Compliance Matrix Public, browsable compliance & regulation matrix — how HDS is compliant (Pryv platform → HDS → implementer layers) across HIPAA, GDPR, and Swiss nLPD, plus downloadable agreement templates. | Application | — | 278f743 Nov 6, 2026 | GitHub |