Athlete Message (Communication) - Soigneur FHIR Implementation Guide v0.1.0

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

Resource Profile: Athlete Message (Communication)

Official URL: https://fhir.soigneur.coach/fhir/StructureDefinition/cc-athlete-message				Version: 0.1.0
Draft as of 2026-11-14				Computable Name: CcAthleteMessage
Copyright/Legal: Copyright (c) Soigneur. Licensed under CC0-1.0 (public domain dedication). FHIR(R) is the registered trademark of HL7 and is used with permission.

An athlete-facing message: outbound email delivery (invitation/reminder) or an in-app coach-ask turn / chat-notice / open HITL card / hand-off kickoff divider (category cc-comm:llm-turn / chat-notice / chat-card / handoff-kickoff, ADR 0044/0116/0115). category is required; medium is email for outbound delivery and in-app for chat capture; partOf may carry an idempotency parent for email sends.

Usages:

This Profil is not used by any profiles in this Specification

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

Key Elements Table
Differential Table
Snapshot Table
Statistics/References
All

Name	Flags	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
Communication		0..*	Communication	A record of information transmitted from a sender to a receiver
Communication.implicitRules	This element is a modifier element. This element is included in summaries.	0..1	uri	A set of rules under which this content was created
Communication.Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
Communication.Slices for extension.extension:messageRole		0..1	code	Optional Extensions Element URL: https://fhir.soigneur.coach/fhir/StructureDefinition/cc-ext-message-role Binding: In-app chat message role (required)
Communication.Slices for extension.extension:llmUsage		0..1	(Complex)	Billed OpenRouter usage that produced this coach turn (ADR 0088) URL: https://fhir.soigneur.coach/fhir/StructureDefinition/cc-ext-llm-usage
Communication.modifierExtension	This element is a modifier element.	0..*	Extension	Extensions that cannot be ignored
Communication.identifier	This element is included in summaries.	0..*	Identifier	Conversation thread + per-turn idempotency keys (ADR 0044)
Communication.partOf	This element is included in summaries.	0..*	Reference(Resource)	Idempotency parent — the send this turn belongs to (email de-dup)
Communication.status	This element is a modifier element. This element is included in summaries.	1..1	code	preparation \| in-progress \| not-done \| on-hold \| stopped \| completed \| entered-in-error \| unknown Binding: EventStatus (required): The status of the communication.
Communication.category		1..*	CodeableConcept	Message kind — llm-turn / chat-notice / chat-card / handoff-kickoff / invitation / reminder; headers also carry conversation-header + thread-* Binding: Athlete communication category (required)
Communication.Slices for medium		1..*	CodeableConcept	A channel of communication Slice: Unordered, Open by pattern:$this Binding: ParticipationMode (example): Codes for communication mediums such as phone, fax, email, in person, etc.
Communication.Slices for medium.medium:email		0..1	CodeableConcept	Email delivery channel (outbound ACS path) Binding: ParticipationMode (example): Codes for communication mediums such as phone, fax, email, in person, etc. Required Pattern: `{ "coding" : [ { "system" : "http://terminology.hl7.org/CodeSystem/v3-ParticipationMode", "code" : "EMAILWRIT" } ] }`
Communication.Slices for medium.medium:inApp		0..1	CodeableConcept	In-app coach chat (no ACS) Binding: ParticipationMode (example): Codes for communication mediums such as phone, fax, email, in person, etc. Required Pattern: `{ "coding" : [ { "system" : "https://fhir.soigneur.coach/fhir/CodeSystem/cc-comm", "code" : "in-app" } ] }`
Communication.subject	This element is included in summaries.	1..1	Reference(Soigneur Athlete (Patient))	The athlete
Communication.recipient		0..*	Reference(Soigneur Athlete (Patient))	Message recipient
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Communication.status	Base	required	EventStatus	📍4.0.1	FHIR Std.
Communication.category	Base	required	Athlete communication category	📦0.1.0	This IG
Communication.medium	Base	example	ParticipationMode	📦3.0.0	THO v7.5
Communication.medium:email	Base	example	ParticipationMode	📦3.0.0	THO v7.5
Communication.medium:inApp	Base	example	ParticipationMode	📦3.0.0	THO v7.5

Constraints

Grade

Path(s)

Beschreibung

Expression

This structure is derived from Communication

Name	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
Communication	0..*	Communication	A record of information transmitted from a sender to a receiver
Communication.Slices for extension	0..*	Extension	Extension Slice: Unordered, Open by value:url
Communication.Slices for extension.extension:messageRole	0..1	code	Optional Extensions Element URL: https://fhir.soigneur.coach/fhir/StructureDefinition/cc-ext-message-role Binding: In-app chat message role (required)
Communication.Slices for extension.extension:llmUsage	0..1	(Complex)	Billed OpenRouter usage that produced this coach turn (ADR 0088) URL: https://fhir.soigneur.coach/fhir/StructureDefinition/cc-ext-llm-usage
Communication.identifier	0..*	Identifier	Conversation thread + per-turn idempotency keys (ADR 0044)
Communication.partOf	0..*	Reference(Resource)	Idempotency parent — the send this turn belongs to (email de-dup)
Communication.category	1..*	CodeableConcept	Message kind — llm-turn / chat-notice / chat-card / handoff-kickoff / invitation / reminder; headers also carry conversation-header + thread-* Binding: Athlete communication category (required)
Communication.Slices for medium	1..*	CodeableConcept	A channel of communication Slice: Unordered, Open by pattern:$this
Communication.Slices for medium.medium:email	0..1	CodeableConcept	Email delivery channel (outbound ACS path) Required Pattern: `{ "coding" : [ { "system" : "http://terminology.hl7.org/CodeSystem/v3-ParticipationMode", "code" : "EMAILWRIT" } ] }`
Communication.Slices for medium.medium:inApp	0..1	CodeableConcept	In-app coach chat (no ACS) Required Pattern: `{ "coding" : [ { "system" : "https://fhir.soigneur.coach/fhir/CodeSystem/cc-comm", "code" : "in-app" } ] }`
Communication.subject	1..1	Reference(Soigneur Athlete (Patient))	The athlete
Communication.recipient	0..*	Reference(Soigneur Athlete (Patient))	Message recipient
Documentation for this format

Terminology Bindings (Differential)

Path	Status	Usage	ValueSet	Version	Source
Communication.category	Base	required	Athlete communication category	📦0.1.0	This IG

Description & Constraints Filter:

Communication 0..* Communication A record of information transmitted from a sender to a receiver

Communication.id This element is included in summaries. 0..1 id Logical id of this artifact

Communication.meta This element is included in summaries. 0..1 Meta Metadata about the resource

Communication.implicitRules This element is a modifier element. This element is included in summaries. 0..1 uri A set of rules under which this content was created

language

0..1

code

Language of the resource content
Binding: CommonLanguages (preferred): A human language.

Additional Bindings

Purpose

AllLanguages

Max Binding

Communication.text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements

Communication.contained 0..* Resource Contained, inline Resources

Communication.Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url

Communication.Slices for extension.extension:messageRole 0..1 code Optional Extensions Element
URL: https://fhir.soigneur.coach/fhir/StructureDefinition/cc-ext-message-role
Binding: In-app chat message role (required)

Communication.Slices for extension.extension:llmUsage 0..1 (Complex) Billed OpenRouter usage that produced this coach turn (ADR 0088)
URL: https://fhir.soigneur.coach/fhir/StructureDefinition/cc-ext-llm-usage

Communication.modifierExtension This element is a modifier element. 0..* Extension Extensions that cannot be ignored

Communication.identifier This element is included in summaries. 0..* Identifier Conversation thread + per-turn idempotency keys (ADR 0044)

Communication.instantiatesCanonical This element is included in summaries. 0..* canonical(PlanDefinition | ActivityDefinition | Measure | OperationDefinition | Questionnaire) Instantiates FHIR protocol or definition

Communication.instantiatesUri This element is included in summaries. 0..* uri Instantiates external protocol or definition

Communication.basedOn This element is included in summaries. 0..* Reference(Resource) Request fulfilled by this communication

Communication.partOf This element is included in summaries. 0..* Reference(Resource) Idempotency parent — the send this turn belongs to (email de-dup)

Communication.inResponseTo 0..* Reference(Communication) Reply to

Communication.statusReason This element is included in summaries. 0..1 CodeableConcept Reason for current status
Binding: CommunicationNotDoneReason (example): Codes for the reason why a communication did not happen.

Communication.category 1..* CodeableConcept Message kind — llm-turn / chat-notice / chat-card / handoff-kickoff / invitation / reminder; headers also carry conversation-header + thread-*
Binding: Athlete communication category (required)

Communication.priority This element is included in summaries. 0..1 code routine | urgent | asap | stat
Binding: RequestPriority (required): Codes indicating the relative importance of a communication.

Communication.Slices for medium 1..* CodeableConcept A channel of communication
Slice: Unordered, Open by pattern:$this
Binding: ParticipationMode (example): Codes for communication mediums such as phone, fax, email, in person, etc.

medium:email

0..1

CodeableConcept

Email delivery channel (outbound ACS path)
Binding: ParticipationMode (example): Codes for communication mediums such as phone, fax, email, in person, etc.

Required Pattern:

{
  "coding" : [
    {
      "system" : "http://terminology.hl7.org/CodeSystem/v3-ParticipationMode",
      "code" : "EMAILWRIT"
    }
  ]
}

medium:inApp

0..1

CodeableConcept

In-app coach chat (no ACS)
Binding: ParticipationMode (example): Codes for communication mediums such as phone, fax, email, in person, etc.

Required Pattern:

{
  "coding" : [
    {
      "system" : "https://fhir.soigneur.coach/fhir/CodeSystem/cc-comm",
      "code" : "in-app"
    }
  ]
}

Communication.subject This element is included in summaries. 1..1 Reference(Soigneur Athlete (Patient)) The athlete

Communication.topic 0..1 CodeableConcept Description of the purpose/content
Binding: CommunicationTopic (example): Codes describing the purpose or content of the communication.

Communication.about 0..* Reference(Resource) Resources that pertain to this communication

Communication.encounter This element is included in summaries. 0..1 Reference(Encounter) Encounter created as part of

Communication.sent 0..1 dateTime When sent

Communication.received 0..1 dateTime When received

Communication.recipient 0..* Reference(Soigneur Athlete (Patient)) Message recipient

Communication.reasonCode This element is included in summaries. 0..* CodeableConcept Indication for message
Binding: SNOMEDCTClinicalFindings (example): Codes for describing reasons for the occurrence of a communication.

Communication.reasonReference This element is included in summaries. 0..* Reference(Condition | Observation | DiagnosticReport | DocumentReference) Why was communication done?

Communication.payload 0..* BackboneElement Message payload

Communication.payload.id 0..1 string Unique id for inter-element referencing

Communication.payload.extension 0..* Extension Additional content defined by implementations

Communication.payload.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized

Communication.payload.content[x] 1..1 Message part content

Communication.payload.content[x].contentString string

Communication.payload.content[x].contentAttachment Attachment

Communication.payload.content[x].contentReference Reference(Resource)

Communication.note 0..* Annotation Comments made about the communication

Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Communication.language	Base	preferred	Common Languages	📍4.0.1	FHIR Std.
Communication.status	Base	required	EventStatus	📍4.0.1	FHIR Std.
Communication.statusReason	Base	example	CommunicationNotDoneReason	📍4.0.1	FHIR Std.
Communication.category	Base	required	Athlete communication category	📦0.1.0	This IG
Communication.priority	Base	required	Request priority	📍4.0.1	FHIR Std.
Communication.medium	Base	example	ParticipationMode	📦3.0.0	THO v7.5
Communication.medium:email	Base	example	ParticipationMode	📦3.0.0	THO v7.5
Communication.medium:inApp	Base	example	ParticipationMode	📦3.0.0	THO v7.5
Communication.topic	Base	example	CommunicationTopic	📍4.0.1	FHIR Std.
Communication.reasonCode	Base	example	SNOMED CT Clinical Findings	📍4.0.1	FHIR Std.

Constraints

Grade

Path(s)

Beschreibung

Expression

This structure is derived from Communication

Summary

Mandatory: 3 elements

Structures

This structure refers to these other structures:

Soigneur Athlete (Patient) (https://fhir.soigneur.coach/fhir/StructureDefinition/cc-patient)

Extensions

This structure refers to these extensions:

Slices

This structure defines the following Slices:

The element 1 is sliced based on the value of Communication.medium

Key Elements View

Name	Flags	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
Communication		0..*	Communication	A record of information transmitted from a sender to a receiver
Communication.implicitRules	This element is a modifier element. This element is included in summaries.	0..1	uri	A set of rules under which this content was created
Communication.Slices for extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
Communication.Slices for extension.extension:messageRole		0..1	code	Optional Extensions Element URL: https://fhir.soigneur.coach/fhir/StructureDefinition/cc-ext-message-role Binding: In-app chat message role (required)
Communication.Slices for extension.extension:llmUsage		0..1	(Complex)	Billed OpenRouter usage that produced this coach turn (ADR 0088) URL: https://fhir.soigneur.coach/fhir/StructureDefinition/cc-ext-llm-usage
Communication.modifierExtension	This element is a modifier element.	0..*	Extension	Extensions that cannot be ignored
Communication.identifier	This element is included in summaries.	0..*	Identifier	Conversation thread + per-turn idempotency keys (ADR 0044)
Communication.partOf	This element is included in summaries.	0..*	Reference(Resource)	Idempotency parent — the send this turn belongs to (email de-dup)
Communication.status	This element is a modifier element. This element is included in summaries.	1..1	code	preparation \| in-progress \| not-done \| on-hold \| stopped \| completed \| entered-in-error \| unknown Binding: EventStatus (required): The status of the communication.
Communication.category		1..*	CodeableConcept	Message kind — llm-turn / chat-notice / chat-card / handoff-kickoff / invitation / reminder; headers also carry conversation-header + thread-* Binding: Athlete communication category (required)
Communication.Slices for medium		1..*	CodeableConcept	A channel of communication Slice: Unordered, Open by pattern:$this Binding: ParticipationMode (example): Codes for communication mediums such as phone, fax, email, in person, etc.
Communication.Slices for medium.medium:email		0..1	CodeableConcept	Email delivery channel (outbound ACS path) Binding: ParticipationMode (example): Codes for communication mediums such as phone, fax, email, in person, etc. Required Pattern: `{ "coding" : [ { "system" : "http://terminology.hl7.org/CodeSystem/v3-ParticipationMode", "code" : "EMAILWRIT" } ] }`
Communication.Slices for medium.medium:inApp		0..1	CodeableConcept	In-app coach chat (no ACS) Binding: ParticipationMode (example): Codes for communication mediums such as phone, fax, email, in person, etc. Required Pattern: `{ "coding" : [ { "system" : "https://fhir.soigneur.coach/fhir/CodeSystem/cc-comm", "code" : "in-app" } ] }`
Communication.subject	This element is included in summaries.	1..1	Reference(Soigneur Athlete (Patient))	The athlete
Communication.recipient		0..*	Reference(Soigneur Athlete (Patient))	Message recipient
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Communication.status	Base	required	EventStatus	📍4.0.1	FHIR Std.
Communication.category	Base	required	Athlete communication category	📦0.1.0	This IG
Communication.medium	Base	example	ParticipationMode	📦3.0.0	THO v7.5
Communication.medium:email	Base	example	ParticipationMode	📦3.0.0	THO v7.5
Communication.medium:inApp	Base	example	ParticipationMode	📦3.0.0	THO v7.5

Constraints

Grade

Path(s)

Beschreibung

Expression

Differential View

This structure is derived from Communication

Name	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
Communication	0..*	Communication	A record of information transmitted from a sender to a receiver
Communication.Slices for extension	0..*	Extension	Extension Slice: Unordered, Open by value:url
Communication.Slices for extension.extension:messageRole	0..1	code	Optional Extensions Element URL: https://fhir.soigneur.coach/fhir/StructureDefinition/cc-ext-message-role Binding: In-app chat message role (required)
Communication.Slices for extension.extension:llmUsage	0..1	(Complex)	Billed OpenRouter usage that produced this coach turn (ADR 0088) URL: https://fhir.soigneur.coach/fhir/StructureDefinition/cc-ext-llm-usage
Communication.identifier	0..*	Identifier	Conversation thread + per-turn idempotency keys (ADR 0044)
Communication.partOf	0..*	Reference(Resource)	Idempotency parent — the send this turn belongs to (email de-dup)
Communication.category	1..*	CodeableConcept	Message kind — llm-turn / chat-notice / chat-card / handoff-kickoff / invitation / reminder; headers also carry conversation-header + thread-* Binding: Athlete communication category (required)
Communication.Slices for medium	1..*	CodeableConcept	A channel of communication Slice: Unordered, Open by pattern:$this
Communication.Slices for medium.medium:email	0..1	CodeableConcept	Email delivery channel (outbound ACS path) Required Pattern: `{ "coding" : [ { "system" : "http://terminology.hl7.org/CodeSystem/v3-ParticipationMode", "code" : "EMAILWRIT" } ] }`
Communication.Slices for medium.medium:inApp	0..1	CodeableConcept	In-app coach chat (no ACS) Required Pattern: `{ "coding" : [ { "system" : "https://fhir.soigneur.coach/fhir/CodeSystem/cc-comm", "code" : "in-app" } ] }`
Communication.subject	1..1	Reference(Soigneur Athlete (Patient))	The athlete
Communication.recipient	0..*	Reference(Soigneur Athlete (Patient))	Message recipient
Documentation for this format

Terminology Bindings (Differential)

Path	Status	Usage	ValueSet	Version	Source
Communication.category	Base	required	Athlete communication category	📦0.1.0	This IG

Snapshot View