<?xml version="1.0" encoding="UTF-8"?>

<CodeSystem xmlns="http://hl7.org/fhir">
  <id value="group-involvement"/>
  <meta>
    <lastUpdated value="2026-03-16T22:59:53.445+00:00"/>
  </meta>
  <text>
    <status value="generated"/>
    <div xmlns="http://www.w3.org/1999/xhtml">
      <p class="res-header-id">
        <b>Generated Narrative: CodeSystem group-involvement</b>
      </p>
      <a name="group-involvement"> </a>
      <a name="hcgroup-involvement"> </a>
      <p>
        <b>Properties</b>
      </p>
      <p>
        <b>This code system defines the following properties for its concepts</b>
      </p>
      <table class="grid">
        <tr>
          <td>
            <b>Name</b>
          </td>
          <td>
            <b>Code</b>
          </td>
          <td>
            <b>URI</b>
          </td>
          <td>
            <b>Type</b>
          </td>
          <td>
            <b>Description</b>
          </td>
        </tr>
        <tr>
          <td>group-type</td>
          <td>group-type</td>
          <td>http://hl7.org/fhir/group-involvement#group-type</td>
          <td>code</td>
          <td>Which group code this relationship is considered appropriate to use with</td>
        </tr>
      </table>
      <p>
        <b>Concepts</b>
      </p>
      <p>This case-sensitive code system 
        <code>http://hl7.org/fhir/group-involvement</code> defines the following codes:
      </p>
      <table class="codes">
        <tr>
          <td style="white-space:nowrap">
            <b>Code</b>
          </td>
          <td>
            <b>Display</b>
          </td>
          <td>
            <b>Definition</b>
          </td>
          <td>
            <b>group-type</b>
          </td>
        </tr>
        <tr>
          <td style="white-space:nowrap">index-case
            <a name="group-involvement-index-case"> </a>
          </td>
          <td>Index Case</td>
          <td>
            <div>
              <p>The first case that is the reason for creating the group. Usually the first known infection, but other kinds of first are known.</p>

            </div>
          </td>
          <td>patient-list</td>
        </tr>
        <tr>
          <td style="white-space:nowrap">primary-exposure
            <a name="group-involvement-primary-exposure"> </a>
          </td>
          <td>Primary Exposure</td>
          <td>
            <div>
              <p>Patient is included in the list on the grounds of being a primary exposure case (sometimes, but not neceessarily, direct exposure to the index case, or a known infected person).</p>

            </div>
          </td>
          <td>patient-list</td>
        </tr>
        <tr>
          <td style="white-space:nowrap">secondary-exposure
            <a name="group-involvement-secondary-exposure"> </a>
          </td>
          <td>Secondary Exposure</td>
          <td>
            <div>
              <p>Patient is included in the list on the grounds of being a secondary exposure case - that is, exposed to a potentially infected patient or person of interest.</p>

            </div>
          </td>
          <td>patient-list</td>
        </tr>
        <tr>
          <td style="white-space:nowrap">primary-contact
            <a name="group-involvement-primary-contact"> </a>
          </td>
          <td>Primary Contact</td>
          <td>
            <div>
              <p>Patient is included in the list on the grounds of being the primary contact point for a family, household, workplace, etc.</p>

            </div>
          </td>
          <td>family, household, workplace</td>
        </tr>
        <tr>
          <td style="white-space:nowrap">family-member
            <a name="group-involvement-family-member"> </a>
          </td>
          <td>Family Member</td>
          <td>
            <div>
              <p>Patient is included in the list on the grounds of being a family member in a family group. See 
                <a href="group.html#relationships">Relationships inside the group</a> for more detailed family relationships.
              </p>

            </div>
          </td>
          <td>household</td>
        </tr>
        <tr>
          <td style="white-space:nowrap">owner
            <a name="group-involvement-owner"> </a>
          </td>
          <td>Owner</td>
          <td>
            <div>
              <p>Household member is a legally / officially registered owner of the dwelling that contains the household. Or at least, considers themselves the rightful owner.</p>

            </div>
          </td>
          <td>household</td>
        </tr>
        <tr>
          <td style="white-space:nowrap">resident
            <a name="group-involvement-resident"> </a>
          </td>
          <td>Resident</td>
          <td>
            <div>
              <p>Household member is a resident - that is, they consistently reside in the dwelling.</p>

            </div>
          </td>
          <td>household</td>
        </tr>
        <tr>
          <td style="white-space:nowrap">visitor
            <a name="group-involvement-visitor"> </a>
          </td>
          <td>Visitor</td>
          <td>
            <div>
              <p>Household member is transiently visiting the dwelling during (part of) the period of interest, or, for a workplace, a person who was/is in the workplace but not an employee</p>

            </div>
          </td>
          <td>household, workplace</td>
        </tr>
        <tr>
          <td style="white-space:nowrap">staff
            <a name="group-involvement-staff"> </a>
          </td>
          <td>Staff</td>
          <td>
            <div>
              <p>Household member is a member of the staff working in the dwelling (and by implication, not a resident).</p>

            </div>
          </td>
          <td>household</td>
        </tr>
        <tr>
          <td style="white-space:nowrap">pet
            <a name="group-involvement-pet"> </a>
          </td>
          <td>Pet</td>
          <td>
            <div>
              <p>Group member is animal kept as a pet by the family/household.</p>

            </div>
          </td>
          <td>famkily, household</td>
        </tr>
        <tr>
          <td style="white-space:nowrap">full-time
            <a name="group-involvement-full-time"> </a>
          </td>
          <td>Full-Time Employee</td>
          <td>
            <div>
              <p>This is the group member's primary workplace on a consistent basis.</p>

            </div>
          </td>
          <td>workplace</td>
        </tr>
        <tr>
          <td style="white-space:nowrap">part-time
            <a name="group-involvement-part-time"> </a>
          </td>
          <td>Part Time</td>
          <td>
            <div>
              <p>The group member works in the workplace, but on an occasional basis.</p>

            </div>
          </td>
          <td>workplace</td>
        </tr>
        <tr>
          <td style="white-space:nowrap">casual
            <a name="group-involvement-casual"> </a>
          </td>
          <td>Casual</td>
          <td>
            <div>
              <p>The group member was working in the workplace, but is not consistently present.</p>

            </div>
          </td>
          <td>workplace</td>
        </tr>
      </table>
    </div>
  </text>
  <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-wg">
    <valueCode value="fhir"/>
  </extension>
  <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status">
    <valueCode value="informative"/>
  </extension>
  <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm">
    <valueInteger value="0"/>
  </extension>
  <url value="http://hl7.org/fhir/group-involvement"/>
  <version value="6.0.0-ballot4"/>
  <name value="GroupInvolvement"/>
  <title value="Group Involvement"/>
  <status value="active"/>
  <experimental value="false"/>
  <date value="2021-01-05T10:01:24+11:00"/>
  <publisher value="HL7 International / FHIR Infrastructure"/>
  <contact>
    <telecom>
      <system value="url"/>
    </telecom>
    <telecom>
      <system value="email"/>
    </telecom>
  </contact>
  <contact>
    <telecom>
      <system value="url"/>
      <value value="http://www.hl7.org/Special/committees/fiwg"/>
    </telecom>
  </contact>
  <description value="A code that describes how a member of the group participates in the group."/>
  <jurisdiction>
    <coding>
      <system value="http://unstats.un.org/unsd/methods/m49/m49.htm"/>
      <code value="001"/>
      <display value="World"/>
    </coding>
  </jurisdiction>
  <caseSensitive value="true"/>
  <valueSet value="http://hl7.org/fhir/ValueSet/group-involvement"/>
  <content value="complete"/>
  <property>
    <code value="group-type"/>
    <uri value="http://hl7.org/fhir/group-involvement#group-type"/>
    <description value="Which group code this relationship is considered appropriate to use with"/>
    <type value="code"/>
  </property>
  <concept>
    <code value="index-case"/>
    <display value="Index Case"/>
    <definition value="The first case that is the reason for creating the group. Usually the first known infection, but other kinds of first are known."/>
    <property>
      <code value="group-type"/>
      <valueCode value="patient-list"/>
    </property>
  </concept>
  <concept>
    <code value="primary-exposure"/>
    <display value="Primary Exposure"/>
    <definition value="Patient is included in the list on the grounds of being a primary exposure case (sometimes, but not neceessarily, direct exposure to the index case, or a known infected person)."/>
    <property>
      <code value="group-type"/>
      <valueCode value="patient-list"/>
    </property>
  </concept>
  <concept>
    <code value="secondary-exposure"/>
    <display value="Secondary Exposure"/>
    <definition value="Patient is included in the list on the grounds of being a secondary exposure case - that is, exposed to a potentially infected patient or person of interest."/>
    <property>
      <code value="group-type"/>
      <valueCode value="patient-list"/>
    </property>
  </concept>
  <concept>
    <code value="primary-contact"/>
    <display value="Primary Contact"/>
    <definition value="Patient is included in the list on the grounds of being the primary contact point for a family, household, workplace, etc."/>
    <property>
      <code value="group-type"/>
      <valueCode value="family"/>
    </property>
    <property>
      <code value="group-type"/>
      <valueCode value="household"/>
    </property>
    <property>
      <code value="group-type"/>
      <valueCode value="workplace"/>
    </property>
  </concept>
  <concept>
    <code value="family-member"/>
    <display value="Family Member"/>
    <definition value="Patient is included in the list on the grounds of being a family member in a family group. See [Relationships inside the group](group.html#relationships) for more detailed family relationships."/>
    <property>
      <code value="group-type"/>
      <valueCode value="household"/>
    </property>
  </concept>
  <concept>
    <code value="owner"/>
    <display value="Owner"/>
    <definition value="Household member is a legally / officially registered owner of the dwelling that contains the household. Or at least, considers themselves the rightful owner."/>
    <property>
      <code value="group-type"/>
      <valueCode value="household"/>
    </property>
  </concept>
  <concept>
    <code value="resident"/>
    <display value="Resident"/>
    <definition value="Household member is a resident - that is, they consistently reside in the dwelling."/>
    <property>
      <code value="group-type"/>
      <valueCode value="household"/>
    </property>
  </concept>
  <concept>
    <code value="visitor"/>
    <display value="Visitor"/>
    <definition value="Household member is transiently visiting the dwelling during (part of) the period of interest, or, for a workplace, a person who was/is in the workplace but not an employee"/>
    <property>
      <code value="group-type"/>
      <valueCode value="household"/>
    </property>
    <property>
      <code value="group-type"/>
      <valueCode value="workplace"/>
    </property>
  </concept>
  <concept>
    <code value="staff"/>
    <display value="Staff"/>
    <definition value="Household member is a member of the staff working in the dwelling (and by implication, not a resident)."/>
    <property>
      <code value="group-type"/>
      <valueCode value="household"/>
    </property>
  </concept>
  <concept>
    <code value="pet"/>
    <display value="Pet"/>
    <definition value="Group member is animal kept as a pet by the family/household."/>
    <property>
      <code value="group-type"/>
      <valueCode value="famkily"/>
    </property>
    <property>
      <code value="group-type"/>
      <valueCode value="household"/>
    </property>
  </concept>
  <concept>
    <code value="full-time"/>
    <display value="Full-Time Employee"/>
    <definition value="This is the group member's primary workplace on a consistent basis."/>
    <property>
      <code value="group-type"/>
      <valueCode value="workplace"/>
    </property>
  </concept>
  <concept>
    <code value="part-time"/>
    <display value="Part Time"/>
    <definition value="The group member works in the workplace, but on an occasional basis."/>
    <property>
      <code value="group-type"/>
      <valueCode value="workplace"/>
    </property>
  </concept>
  <concept>
    <code value="casual"/>
    <display value="Casual"/>
    <definition value="The group member was working in the workplace, but is not consistently present."/>
    <property>
      <code value="group-type"/>
      <valueCode value="workplace"/>
    </property>
  </concept>
</CodeSystem>