0.1.0 - ci-build

collabreefhirdocumentation - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Collabree FHIR Data Model

Official URL: https://fhir.collabree.com/fhir/ImplementationGuide/com.collabree.fhir Version: 0.1.0
Draft as of 2025-11-04 Computable Name: collabreefhirdocumentation

Collabree FHIR Data Model

Collabree is an adherence-as-a-service platform built on FHIR. It is built as a B2B2C service, enabling healthcare organizations to integrate Collabree's adherence system into their own patient apps. Collabree uses its own services via Collabree's own adherence app, so Collabree acts as a customer of its own service.

High-level overview

All data exchange happens via FHIR GraphQL through a single, published endpoint. All requests must be authenticated via Collabree's OAuth server. A built-in RBAC layer controls access to FHIR documents.

  • End users (patients) are represented by Patient resources.
  • Collabree customer organizations are represented by Organization resources. A patient is associated with an organization through the managingOrganization property.
  • Each organization points to one or more PlanDefinition resources that parameterize the adherence/reward scheme for the organization's patients.
  • Clients can instantiate a desired PlanDefinition via applyPlanDefinition and execute the resulting CarePlan.
  • Collabree's backend tracks the completion of all care plans by tracking MedicationStatement resources, generating Observation and Claim entities to document adherence over time and rewards per period.

Customer organizations are free to use their own medication catalog. Patients may be represented by ID only, no logic inside Collabree requires PII/PHI.

Features

  • Medication Catalog: Unified medication profile supporting multiple data providers (HCI, CHI_GOV_SAUDI_ARABIA)
  • Medication Plan System: Complete patient journey from Azure authentication through organization enrollment to active adherence tracking with primary and fallback plan management
  • Adherence Calculation System: Sophisticated engine for processing patient medication adherence data, generating scores, streaks, and reward balances through both scheduled and real-time processing
  • Payout Processor System: Automated financial claim generation system that processes adherence observations and creates FHIR Claim resources for monetary rewards based on patient performance
  • Quiz System: Interactive daily quizzes to engage patients and enhance medication adherence knowledge, with automatic scoring, feedback, and scheduling features
  • Trophy System: Gamification of medication adherence rewarding patients with achievements for progress across various care dimensions, stored as FHIR Goal resources with completed lifecycle status