Skip to content

Platform architecture for a connected wellness device

We designed a three-tier platform and mobile app that lets clinics allocate, track and manage therapy sessions on a connected wellness device.

  • 3

    User tiers, each with its own permissions

  • 6

    Platform components designed

  • 2

    Scope-defining risks isolated early

The problem

The company manufactures a non-invasive wellness device delivered through certified partner clinics, with a take-home version distributed to selected patients. Every part of the operation ran manually: a practitioner connected each patient to the device in person, and there was no software layer between the manufacturer, the clinics and the patients. We were engaged to design the platform that would let the model scale.

  • Clinics allocated therapy sessions to patients by hand, with no system to enforce session counts or expiry dates.

  • Take-home devices were distributed to patients with no way to track which unit sat with which patient.

  • The manufacturer had no central visibility of device activity, session completion or clinic performance across the network.

  • Patient progress and session outcomes were not captured in any structured form.

  • There was no mechanism to deactivate a device remotely or transfer it between patients.

What we designed

We designed a three-tier platform separating the manufacturer, the clinic and the patient, each with its own permissions and interface, delivered as a single cross-platform mobile application over a microservices backend. Because clinics would store patient health information, we treated HIPAA as a design constraint from the outset rather than a later addition. We deliberately scoped the partner-app ecosystem into a later phase after establishing it was comparable in size to the core platform itself.

Three-tier permission model

Tier 1

Manufacturer

  • Network-wide reporting
  • Clinic management
  • Override any device or session

Tier 2

Clinic

  • Allocate sessions with expiry
  • Patient profiles
  • Usage monitoring

Tier 3

Patient

  • Start and pause sessions
  • Track progress
  • Request more sessions
  • Administrator console

    Network-wide reporting, clinic management, global settings, and override of any device or session

  • Clinic portal

    Session allocation with time-bound expiry, patient profiles, usage monitoring, and follow-up scheduling

  • Patient application

    Session initiation, countdown and pause control, progress tracking, and session requests

  • Session engine

    Allocation, expiry, preset session packages, and override rules

  • Device management

    Unit registration by serial number, patient assignment, status monitoring, custody transfer, and remote deactivation

  • Notification service

    Session reminders, expiry warnings, and approval alerts

How it works

From trigger to result.

How the system works

7 stages

  1. 01Clinic portal

    Trigger

    Creates the patient record and allocates a session package with an expiry window.

  2. 02Session engine

    Data

    The single source of truth for what each patient is entitled to.

  3. 03Patient app

    Result

    Biometric login. Shows remaining sessions and expiry.

  4. 04Device session

    Logic

    Entitlement validated, then a timed session with pause limits.

  5. 05Write-back

    Logic

    Balance decremented, clinic notified, history updated.

  6. 06Device management

    Data

    Telemetry, custody transfer and remote deactivation.

  7. 07Administrator console

    Person

    Network-wide reporting. Can override any device or session.

A significant part of our work was separating what the device could genuinely support from what the wish list assumed. We flagged that automatic session control over the device depends entirely on the hardware exposing a documented connectivity protocol, and scoped that as a decision point rather than an assumption.

Our approach

How we worked.

  1. Discovery

    Mapped the three user tiers, the device layer, and the regulatory boundary between a wellness device and the health data the platform would hold.

  2. Architecture

    Designed the microservices backend, session engine and permission model across administrator, clinic and patient roles.

  3. Scope definition

    Separated the core platform from the partner-app ecosystem, which we assessed as comparable in size to the core build.

  4. Delivery planning

    Defined the roles and skills the build would require.

  5. Risk assessment

    Identified device connectivity and EHR integration depth as the two variables that materially change scope.

The outcome

What the client received.

  • The client received a delivery plan with defined roles and skills.

  • We identified that device connectivity was the largest unresolved variable and scoped it as a decision point instead of an assumption.

  • We separated the partner-app ecosystem into a later phase after establishing it was comparable in size to the core platform, preventing significant scope inflation.

  • We established that the device's wellness classification and the platform's HIPAA obligations are distinct questions, which clarified the compliance scope.

Questions

What people ask.

Does a wellness device platform need to be HIPAA compliant if the device itself is not a regulated medical device?

Usually yes, and the two questions are separate. A device can be classified as a low-risk general wellness product and still sit inside a platform that stores patient names, health notes and treatment history. It is the handling of that health information that triggers HIPAA obligations, not the regulatory classification of the hardware. This is general guidance. Confirm the position for your own product with qualified counsel.

What determines whether an app can control a connected device directly?

It depends entirely on whether the hardware exposes a documented connectivity protocol or SDK. If it does, the app can start sessions, set parameters and read device status. If it does not, the app can still manage entitlements, scheduling and tracking, but the device is operated separately. This is the first question to settle, because it changes both scope and team composition.

What does EHR integration actually involve?

It varies enormously. A generic FHIR export is a contained piece of work. Integrating with a specific electronic health record system involves vendor onboarding, certification and domain-specific data mapping, and is a much larger piece of work. Establishing which of the two is required comes first.

Related work

See all work

Energy & IoT

Cloud backend and AI for an IoT heating system

We designed the backend, AI optimisation layer, web and mobile applications for an internet-connected thermal management system, and authored the technical case for a government innovation grant.

3Energy sources coordinated by one engine

Manufacturing

Internal AI assistant built for accuracy, not confidence

We designed an enterprise knowledge assistant that answers technical support questions in Slack from scattered documentation and undocumented expertise, with citations and escalation instead of guesses.

5Layers of accuracy safeguards

Have a problem like this one?