Skip to content

System Context

Overview

The VitalBridge Platform operates as a multi-tenant healthcare ecosystem that connects healthcare organizations, providers, patients, and external systems through a unified platform.

This document describes the external actors and systems that interact with VitalBridge and the boundaries of the platform itself.

Purpose

The System Context Diagram provides a high-level view of:

  • Who uses the platform
  • External systems integrated with the platform
  • Information exchanged between actors and the platform
  • The boundary between VitalBridge and the outside world

The diagram intentionally excludes internal implementation details such as microservices, databases, event streams, and infrastructure components.

System Context Diagram

flowchart LR

    subgraph ExternalActors["Users"]
        SA["Super Administrator"]
        TA["Tenant Administrator"]
        PR["Healthcare Provider"]
        PT["Patient"]
    end

    subgraph VitalBridge["VitalBridge Platform"]
        VB["Multi-Tenant Healthcare Platform"]
    end

    subgraph ExternalSystems["External Systems"]

        KC["Identity Provider\n(Keycloak)"]

        JITSI["Video Conferencing\n(Jitsi)"]

        EMAIL["Email Provider"]

        SMS["SMS Provider"]

    end

    SA -->|"Manage tenants"| VB

    TA -->|"Manage organization"| VB

    PR -->|"Manage schedules\nConduct consultations"| VB

    PT -->|"Book appointments\nAttend consultations"| VB

    VB -->|"Authenticate users"| KC

    VB -->|"Create video sessions"| JITSI

    VB -->|"Email notifications"| EMAIL

    VB -->|"SMS notifications"| SMS
Hold "Alt" / "Option" to enable pan & zoom

Primary Actors

Super Administrator

Responsible for managing the overall platform.

Typical responsibilities include:

  • Tenant onboarding
  • Tenant lifecycle management
  • Platform administration
  • Operational oversight

Tenant Administrator

Responsible for managing a specific healthcare organization.

Typical responsibilities include:

  • Managing providers
  • Managing patients
  • Managing organization settings
  • Administrative operations

Healthcare Provider

Represents doctors and healthcare professionals using the platform.

Typical responsibilities include:

  • Managing availability
  • Viewing appointments
  • Conducting consultations
  • Managing leave requests

Patient

Represents individuals receiving healthcare services.

Typical responsibilities include:

  • Managing profiles
  • Booking appointments
  • Viewing appointments
  • Attending virtual consultations

External Systems

Identity Provider

VitalBridge delegates authentication and authorization to an external identity provider.

Responsibilities include:

  • User authentication
  • Access token issuance
  • Role management
  • Identity federation

Current implementation:

  • Keycloak

Video Conferencing Provider

Used to facilitate virtual consultations.

Responsibilities include:

  • Meeting creation
  • Participant access control
  • Secure video communication

Current implementation:

  • Jitsi

Notification Providers

Used to deliver transactional communications.

Examples include:

  • Appointment confirmations
  • Appointment reminders
  • Password reset notifications
  • Provider onboarding notifications

Delivery channels include:

  • Email
  • SMS

Platform Boundary

The VitalBridge Platform is responsible for:

  • Multi-tenant healthcare operations
  • Provider management
  • Patient management
  • Scheduling
  • Appointment management
  • Consultation workflows

External systems provide supporting capabilities such as:

  • Authentication
  • Video conferencing
  • Notifications

These capabilities are consumed through integration boundaries rather than being implemented directly within the platform.