IDEA4RC FHIR Implementation Guide
0.1.0 - CI Build 150

IDEA4RC FHIR Implementation Guide, published by IDEA4RC Project. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/hl7-eu/idea4rc/ and changes regularly. See the Directory of published versions

Logical Model: PatientFollowUpI4rc - Detailed Descriptions

Draft as of 2025-07-25

Definitions for the PatientFollowUp logical model.

Guidance on how to interpret the contents of this table can be foundhere

0. PatientFollowUp
Definition

Patient Follow Up Maturity Level: 0 Draft

ShortPatient Follow Up
Control0..*
Is Modifierfalse
Logical ModelInstances of this logical model are not marked to be the target of a Reference
2. PatientFollowUp.patient
Definition

Patient element

ShortPatient (M)
Control1..*
Typehttp://hl7.eu/fhir/ig/idea4rc/StructureDefinition/Subject
Obligations
    ObligationsActor
    SHALL:handleHead and Neck
    SHALL:handleSarcoma
    4. PatientFollowUp.statusOfPatientAtLastFollowUp
    Definition

    Describes the status at last follow-up If DOD, DOC or DUC register the death in the DEATH table (with date of last contact as death date). If the death cause is specified use the cause_concept_id. If lost to follow up register an observation. All the other information can be derived from the other data.

    Maybe it should be moved to Patient entity

    ShortStatus of patient at last follow-up (M)
    Comments

    Alive, No Evidence of Disease (NED) - 2000100071 Dead of Disease (DOD) - 2000100072 Dead of Other Cause (DOC) - 2000100073 Dead of Unknown Cause (DUC) - 2000100074 Alive With Disease (AWD) - 2000100075 Lost to follow-up - 4163894

    Control1..*
    TypeCodeableConcept
    Obligations
      ObligationsActor
      SHALL:handleHead and Neck
      SHALL:handleSarcoma
      6. PatientFollowUp.statusOfDiseaseAtLastFollowUp
      Definition

      Describes the disease status at the last follow-up. This value is redundant as it could be derived from the disease status in EpisodeEvent. If a Patient has 3 follow-ups, but the disease status (e.g., stable disease) did not change during those, the follow-ups will be grouped into a single one with the last date of the three of them.

      ShortStatus of disease at last follow-up (M) type EpisodeEvent
      Comments

      Complete Remission - 32946 Partial Remission - 32947 Stable Disease - 32948 Progression - 32949 Recurrence - 2000100002 recurrence is algorithmically derived from previous episode (if it was complete remission)

      Control1..*
      Typehttp://hl7.eu/fhir/ig/idea4rc/StructureDefinition/EpisodeEvent
      Obligations
        ObligationsActor
        SHALL:handleHead and Neck
        SHALL:handleSarcoma
        8. PatientFollowUp.patientFollowUpDate
        Definition

        Date of the clinical follow-up

        ShortPatient Follow Up date (M)
        Control1..*
        Typedate
        Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
        Obligations
          ObligationsActor
          SHALL:handleHead and Neck
          SHALL:handleSarcoma
          10. PatientFollowUp.newCancerDiagnosis
          Definition

          identifies whether the patient has developed a subsequent primary cancer Check

          ShortNew cancer diagnosis (M)
          Comments

          Yes - 4188539 No - 4188540

          Control1..*
          Typeboolean
          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
          Obligations
            ObligationsActor
            SHALL:handleHead and Neck
            12. PatientFollowUp.dateOfNewCancerDiagnosis
            Definition

            date of subsequent primary cancer diagnosis

            ShortDate of new cancer diagnosis (M)
            Control1..*
            Typedate
            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
            Obligations
              ObligationsActor
              SHALL:handleHead and Neck
              14. PatientFollowUp.newCancerTopography
              Definition

              clarifies the site of the subsequent primary cancer (from a predefined list of sites)

              ShortNew cancer topography (M)
              Comments

              Any value of Class ICDO Condition

              Control1..*
              TypeCodeableConcept
              Obligations
                ObligationsActor
                SHALL:handleHead and Neck
                16. PatientFollowUp.lastContact
                Definition

                Date of the last contact with the patient, of any kind.

                ShortLast Contact (M)
                Control1..*
                Typedate
                Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                Obligations
                  ObligationsActor
                  SHALL:handleSarcoma

                  Guidance on how to interpret the contents of this table can be foundhere

                  0. PatientFollowUp
                  Definition

                  Patient Follow Up Maturity Level: 0 Draft

                  ShortPatient Follow Up
                  Logical ModelInstances of this logical model are not marked to be the target of a Reference
                  2. PatientFollowUp.patient
                  Definition

                  Patient element

                  ShortPatient (M)
                  Control1..*
                  Typehttp://hl7.eu/fhir/ig/idea4rc/StructureDefinition/Subject
                  Obligations
                    ObligationsActor
                    SHALL:handleHead and Neck
                    SHALL:handleSarcoma
                    4. PatientFollowUp.statusOfPatientAtLastFollowUp
                    Definition

                    Describes the status at last follow-up If DOD, DOC or DUC register the death in the DEATH table (with date of last contact as death date). If the death cause is specified use the cause_concept_id. If lost to follow up register an observation. All the other information can be derived from the other data.

                    Maybe it should be moved to Patient entity

                    ShortStatus of patient at last follow-up (M)
                    Comments

                    Alive, No Evidence of Disease (NED) - 2000100071 Dead of Disease (DOD) - 2000100072 Dead of Other Cause (DOC) - 2000100073 Dead of Unknown Cause (DUC) - 2000100074 Alive With Disease (AWD) - 2000100075 Lost to follow-up - 4163894

                    Control1..*
                    TypeCodeableConcept
                    Obligations
                      ObligationsActor
                      SHALL:handleHead and Neck
                      SHALL:handleSarcoma
                      6. PatientFollowUp.statusOfDiseaseAtLastFollowUp
                      Definition

                      Describes the disease status at the last follow-up. This value is redundant as it could be derived from the disease status in EpisodeEvent. If a Patient has 3 follow-ups, but the disease status (e.g., stable disease) did not change during those, the follow-ups will be grouped into a single one with the last date of the three of them.

                      ShortStatus of disease at last follow-up (M) type EpisodeEvent
                      Comments

                      Complete Remission - 32946 Partial Remission - 32947 Stable Disease - 32948 Progression - 32949 Recurrence - 2000100002 recurrence is algorithmically derived from previous episode (if it was complete remission)

                      Control1..*
                      Typehttp://hl7.eu/fhir/ig/idea4rc/StructureDefinition/EpisodeEvent
                      Obligations
                        ObligationsActor
                        SHALL:handleHead and Neck
                        SHALL:handleSarcoma
                        8. PatientFollowUp.patientFollowUpDate
                        Definition

                        Date of the clinical follow-up

                        ShortPatient Follow Up date (M)
                        Control1..*
                        Typedate
                        Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                        Obligations
                          ObligationsActor
                          SHALL:handleHead and Neck
                          SHALL:handleSarcoma
                          10. PatientFollowUp.newCancerDiagnosis
                          Definition

                          identifies whether the patient has developed a subsequent primary cancer Check

                          ShortNew cancer diagnosis (M)
                          Comments

                          Yes - 4188539 No - 4188540

                          Control1..*
                          Typeboolean
                          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                          Obligations
                            ObligationsActor
                            SHALL:handleHead and Neck
                            12. PatientFollowUp.dateOfNewCancerDiagnosis
                            Definition

                            date of subsequent primary cancer diagnosis

                            ShortDate of new cancer diagnosis (M)
                            Control1..*
                            Typedate
                            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                            Obligations
                              ObligationsActor
                              SHALL:handleHead and Neck
                              14. PatientFollowUp.newCancerTopography
                              Definition

                              clarifies the site of the subsequent primary cancer (from a predefined list of sites)

                              ShortNew cancer topography (M)
                              Comments

                              Any value of Class ICDO Condition

                              Control1..*
                              TypeCodeableConcept
                              Obligations
                                ObligationsActor
                                SHALL:handleHead and Neck
                                16. PatientFollowUp.lastContact
                                Definition

                                Date of the last contact with the patient, of any kind.

                                ShortLast Contact (M)
                                Control1..*
                                Typedate
                                Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                Obligations
                                  ObligationsActor
                                  SHALL:handleSarcoma

                                  Guidance on how to interpret the contents of this table can be foundhere

                                  0. PatientFollowUp
                                  Definition

                                  Patient Follow Up Maturity Level: 0 Draft

                                  ShortPatient Follow Up
                                  Control0..*
                                  Is Modifierfalse
                                  Logical ModelInstances of this logical model are not marked to be the target of a Reference
                                  2. PatientFollowUp.patient
                                  Definition

                                  Patient element

                                  ShortPatient (M)
                                  Control1..*
                                  Typehttp://hl7.eu/fhir/ig/idea4rc/StructureDefinition/Subject
                                  Obligations
                                    ObligationsActor
                                    SHALL:handleHead and Neck
                                    SHALL:handleSarcoma
                                    4. PatientFollowUp.statusOfPatientAtLastFollowUp
                                    Definition

                                    Describes the status at last follow-up If DOD, DOC or DUC register the death in the DEATH table (with date of last contact as death date). If the death cause is specified use the cause_concept_id. If lost to follow up register an observation. All the other information can be derived from the other data.

                                    Maybe it should be moved to Patient entity

                                    ShortStatus of patient at last follow-up (M)
                                    Comments

                                    Alive, No Evidence of Disease (NED) - 2000100071 Dead of Disease (DOD) - 2000100072 Dead of Other Cause (DOC) - 2000100073 Dead of Unknown Cause (DUC) - 2000100074 Alive With Disease (AWD) - 2000100075 Lost to follow-up - 4163894

                                    Control1..*
                                    TypeCodeableConcept
                                    Obligations
                                      ObligationsActor
                                      SHALL:handleHead and Neck
                                      SHALL:handleSarcoma
                                      6. PatientFollowUp.statusOfDiseaseAtLastFollowUp
                                      Definition

                                      Describes the disease status at the last follow-up. This value is redundant as it could be derived from the disease status in EpisodeEvent. If a Patient has 3 follow-ups, but the disease status (e.g., stable disease) did not change during those, the follow-ups will be grouped into a single one with the last date of the three of them.

                                      ShortStatus of disease at last follow-up (M) type EpisodeEvent
                                      Comments

                                      Complete Remission - 32946 Partial Remission - 32947 Stable Disease - 32948 Progression - 32949 Recurrence - 2000100002 recurrence is algorithmically derived from previous episode (if it was complete remission)

                                      Control1..*
                                      Typehttp://hl7.eu/fhir/ig/idea4rc/StructureDefinition/EpisodeEvent
                                      Obligations
                                        ObligationsActor
                                        SHALL:handleHead and Neck
                                        SHALL:handleSarcoma
                                        8. PatientFollowUp.patientFollowUpDate
                                        Definition

                                        Date of the clinical follow-up

                                        ShortPatient Follow Up date (M)
                                        Control1..*
                                        Typedate
                                        Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                        Obligations
                                          ObligationsActor
                                          SHALL:handleHead and Neck
                                          SHALL:handleSarcoma
                                          10. PatientFollowUp.newCancerDiagnosis
                                          Definition

                                          identifies whether the patient has developed a subsequent primary cancer Check

                                          ShortNew cancer diagnosis (M)
                                          Comments

                                          Yes - 4188539 No - 4188540

                                          Control1..*
                                          Typeboolean
                                          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                          Obligations
                                            ObligationsActor
                                            SHALL:handleHead and Neck
                                            12. PatientFollowUp.dateOfNewCancerDiagnosis
                                            Definition

                                            date of subsequent primary cancer diagnosis

                                            ShortDate of new cancer diagnosis (M)
                                            Control1..*
                                            Typedate
                                            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                            Obligations
                                              ObligationsActor
                                              SHALL:handleHead and Neck
                                              14. PatientFollowUp.newCancerTopography
                                              Definition

                                              clarifies the site of the subsequent primary cancer (from a predefined list of sites)

                                              ShortNew cancer topography (M)
                                              Comments

                                              Any value of Class ICDO Condition

                                              Control1..*
                                              TypeCodeableConcept
                                              Obligations
                                                ObligationsActor
                                                SHALL:handleHead and Neck
                                                16. PatientFollowUp.lastContact
                                                Definition

                                                Date of the last contact with the patient, of any kind.

                                                ShortLast Contact (M)
                                                Control1..*
                                                Typedate
                                                Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                Obligations
                                                  ObligationsActor
                                                  SHALL:handleSarcoma